Configurar o SCIM com Okta

Last Updated janeiro 6, 2026

Breve Visão Geral

O WalkMe oferece suporte ao provisionamento SCIM (System for Cross-domain Identity Management) por meio do Okta. Você pode usar o aplicativo WalkMe Okta ou o aplicativo SCIM 2.0 Test (Header Auth) para adicionar e remover usuários da organização automaticamente.

Observação

Você deve ser um administrador do WalkMe para ativar o SCIM para sua organização.

Como Funciona

Há duas maneiras de configurar o SCIM:

  1. App Okta
  2. Aplicativo de teste SCIM 2.0 (Header Auth)

Usar o aplicativo Okta

O WalkMe está disponível como um aplicativo na Rede de Integração Okta, permitindo que você ative o provisionamento de usuários diretamente por meio do Okta.

Antes de começar

  1. Adicione o aplicativo WalkMe no Okta
  2. Configurar o Okta SSO para a sua conta WalkMe

Etapa 1: Ativar SCIM no WalkMe

  1. Faça login no Centro de Administração do WalkMe
  2. Vá para Integrações IDP selecione Integração SCIM
  3. Selecionar + Criar Integração SCIM
  4. No painel de integração Criar SCIM, insira o seguinte:
    1. Nome da integração: insira um nome descritivo para a integração, por exemplo: Produção, Staging, Integração Okta
    2. Tipo de autorização: isso é predefinido para Autenticação Básica e não pode ser alterado
  5. Selecione Gerar Detalhes
  6. Uma janela popup é aberta exibindo as credenciais do SCIM geradas para essa integração:
    1. URL base do SCIM: a URL do endpoint usada para configurar o SCIM no seu provedor de identidade
    2. Nome de usuário: o nome de usuário gerado automaticamente para autenticação
    3. Senha: a senha gerada automaticamente para autenticação
      Observação

      A senha é exibida apenas uma vez, depois de fechar a janela pop-up, ela não pode ser recuperada. Se perder a senha, exclua a integração e crie uma nova.

  7. Copie as credenciais e mantenha-as disponíveis para a configuração do Okta
  8. Selecione Concluído para concluir a configuração da integração SCIM no WalkMe

Etapa 2: Configurar a Integração da API

  1. No Okta, abra o aplicativo WalkMe.
  2. Vá para Provisionamento e selecione Configurar Integração de API
  3. Selecione Ativar integração de API
  4. Insira o seguinte:
    1. URL base
      1. Para locatários dos EUA: https://papi.walkme.com/deepui/api/scim/v2
      2. Para locatários da UE: https://eu-papi.walkme.com/deepui/api/scim/v2
    2. Token de API: insira sua chave da API SCIM do Centro de Administração do WalkMe (a API deve ser Basic <base64(user:password)>)
  5. Selecione Credenciais de Teste da API
  6. Em caso de sucesso, uma mensagem de verificação é exibida

    Observação

    Se a verificação falhar, certifique-se de que o SCIM está ativado, que a chave da API está correta e que a região do locatário (EUA ou UE) corresponde. Se o problema persistir, entre em contato com o Suporte do WalkMe.

  7. Clique em Salvar

Etapa 3: Definir recursos de provisionamento

O aplicativo WalkMe Okta oferece suporte aos recursos de provisionamento listados na Visão Geral do Provisionamento do WalkMe SCIM.

Para ativar ou desativar esses recursos, faça o seguinte:

  1. No Okta, abra o aplicativo WalkMe.
  2. Selecione Para o Aplicativo no painel esquerdo
  3. Selecione Editar
  4. Ativar ou desativar os recursos necessários
  5. Selecione Salvar

Observação

Saiba como atribuir usuários abaixo.

Use o aplicativo de teste SCIM 2.0 (Header Auth)

Se preferir configurar o SCIM manualmente, você pode usar o aplicativo de teste SCIM 2.0 (Header Auth) na Rede de Integração Okta.

Observação

Recomendamos usar o aplicativo WalkMe Okta para facilitar a configuração.

Antes de começar

  1. Configurar o Okta SSO para a sua conta WalkMe

Etapa 1: Ativar SCIM no WalkMe

  1. Faça login no Centro de Administração do WalkMe
  2. Vá para Integrações IDP selecione Integração SCIM
  3. Selecionar + Criar Integração SCIM
  4. Insira os seguintes detalhes:
    1. Nome da integração: insira um nome descritivo para a integração, por exemplo: Okta SCIM
    2. Tipo de autorização: selecione Autenticação Básica
    3. Nome de usuário: insira o nome de usuário que será usado pelo Okta para autenticação
    4. Senha: insira uma senha forte que será a chave da API SCIM
  5. Selecione Criar

Etapa 2: adicionar o aplicativo de teste SCIM 2.0 (Header Auth) no Okta

  1. Abra o Console do Administrador do Okta em uma nova aba
  2. Vá para Aplicativos e selecione Procurar Catálogo de Aplicativos
  3. Pesquisar pelo aplicativo de teste SCIM 2.0 (Autenticação de Cabeçalho)
  4. Selecione Adicionar Integração
  5. Insira um nome para o aplicativo e selecione Avançar, depois Concluído

Etapa 3: Configurar a Integração da API

  1. No Okta, abra o aplicativo de teste SCIM 2.0 (Autenticação de Cabeçalho)
  2. Vá para Provisionamento e selecione Configurar Integração de API
  3. Selecione Ativar integração de API
  4. Insira o seguinte:
    1. URL base
      1. Para locatários dos EUA: https://papi.walkme.com/deepui/api/scim/v2
      2. Para locatários da UE: https://eu-papi.walkme.com/deepui/api/scim/v2
    2. Token API: insira sua chave API SCIM do Centro de Administração do WalkMe.
  5. Selecione Testar Credenciais da API para verificar
  6. Selecione Salvar

Etapa 4: Definir recursos de provisionamento

O aplicativo de teste SCIM 2.0 oferece suporte aos mesmos recursos de provisionamento listados na Visão Geral do Provisionamento WalkMe SCIM. O aplicativo oferece suporte à criação, atualização e desativação de usuários, bem como à sincronização de dados de grupo.

Para ativar ou desativar esses recursos, faça o seguinte:

  1. Em Okta, acesse SCIM 2.0 Test App (Header Auth)
  2. Selecione Provisionamento e selecione Para o Aplicativo no painel esquerdo
  3. Selecione Editar
  4. Ative os seguintes recursos:
    1. Criar Usuários
    2. Atualizar atributos de usuário
    3. Desativar usuários
  5. Selecione Salvar
  6. Na seção Mapeamentos de Atributos, certifique-se de que apenas os seguintes itens sejam mapeados (remova outros atributos, se presentes):
    1. Nome de usuário
    2. Nome dado
    3. Nome da família

Atribuir usuários ao WalkMe no Okta

Recomendamos sincronizar grupos do Okta para manter permissões e associações atualizadas.

Para atribuir usuários ou grupos ao WalkMe:

  1. Faça login no Console do Administrador da Okta
  2. Vá para Aplicativos e selecione o aplicativo WalkMe
  3. Selecione Atribuições
  4. Selecione Atribuir e depois Atribuir a Pessoas ou Atribuir a Grupos
  5. Pesquise usuários ou grupos e selecione Atribuir

Enviar grupos do Okta para o WalkMe

Você pode usar o push de grupo para sincronizar grupos Okta com o WalkMe.

Vincular um grupo WalkMe existente

Você pode vincular um grupo WalkMe existente a um grupo AD ou Okta.

  1. No Okta, abra o aplicativo WalkMe.
  2. Vá para Grupos Push e selecione Por Nome
  3. Pesquise um grupo WalkMe existente e selecione Vincular Grupo
  4. Ativar a associação ao grupo Push imediatamente
  5. Selecione Salvar
  6. Confirme que o status do grupo está ativo

Criar um novo grupo WalkMe

Para criar um novo grupo no WalkMe usando um grupo Okta ou AD:

  1. No Console do Administrador Okta, abra o aplicativo WalkMe.
  2. Vá para Grupos Push e selecione Por Nome
  3. Insira um nome de grupo e selecione Criar Grupo
  4. Ativar a associação ao grupo Push imediatamente
  5. Selecione Salvar
  6. Confirme que o grupo aparece como Ativo na guia Todos

Was this article helpful?

Thanks for your feedback!

Faça parte de algo maior.

Interaja com colegas, tire dúvidas e compartilhe ideias.

Explore nossa comunidade
×