Configure o SCIM com o Microsoft Entra ID

Last Updated outubro 21, 2026

Breve Visão Geral

O WalkMe oferece suporte ao provisionamento do SCIM (System for Cross-domain Identity Management) por meio do Microsoft Entra ID (antigo Azure AD). O Entra ID atua como a fonte de identidade, e o WalkMe cria, atualiza e remove Usuários e Grupos atribuídos automaticamente com base nos seus Ajustes de provisionamento.

Observação:

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

Acesso

Acesse a Integração SCIM no console:

  1. Abra o Console do WalkMe
  2. Vá para a categoria Admin
  3. Selecione Segurança e Auditoria
  4. Escolha a Integração SCIM

Como Funciona

Configurar o SCIM com o Entra ID requer quatro etapas:

  1. Crie um aplicativo corporativo que não seja de galeria no Entra ID
  2. Conecte o Entra ID ao WalkMe com suas credenciais do SCIM
  3. Consulte os mapeamentos de atributos
  4. Atribua Usuários e Grupos e comece a provisionar

Antes de começar

Crie uma integração SCIM no WalkMe Console e copie a URL base e as credenciais do SCIM. Saiba mais.

Etapa 1: crie o aplicativo no Entra ID

  1. Faça login no centro de Admin do Microsoft Entra
  2. Vá para Entra ID >Aplicativos corporativos >Todos os aplicativos
  3. Selecione Novo aplicativo
  4. Selecione Crie seu próprio aplicativo
  5. Adicione um nome descritivo, por exemplo: Integração WalkMe SCIM
  6. Selecione Integrar qualquer outro aplicativo que não encontre na galeria (Não galeria)
  7. Selecione Criar
Observação:

Use um nome claro para que os administradores possam identificar a finalidade do aplicativo, especialmente em ambientes com muitos aplicativos corporativos.

Etapa 2: conecte o Entra ID ao WalkMe

  1. No menu esquerdo do aplicativo, selecione Provisionamento
  2. Selecione Começar
  3. Altere o Modo de Provisionamento de Manual para Automático
  4. Expanda Credenciais do Admin e adicione o seguinte:
    • URL do locatário: a URL base do SCIM para o seu centro de Dados do WalkMe
    • Token Secreto: o valor de autenticação para o tipo de autorização definido no WalkMe:
      1. Autenticação básica: Converta o valor de Username:Senha gerado pelo WalkMe para Base64 e adicione-o como Basic <your_base64_string>
      2. Bearer Token: cole o token gerado pelo WalkMe
  5. Selecione Teste de Conexão
  6. Quando o teste for bem-sucedido, selecione Salvar

Centros de dados do WalkMe:

  • Centro de dados dos EUA
    • URL do locatário (URL base do SCIM): https://papi.walkme.com/deepui/api/scim/v2
  • Centro de dados da UE:
    • URL do locatário (URL base do SCIM): https://eu-papi.WalkMe.com/DeepUI/api/scim/v2
  • Centro de Dados SAP dos EUA (US01):
    • URL do locatário (URL base do SCIM): https://papi-us01.walkme.cloud.sap/DeepUI/api/scim/v2
  • Centro de Dados SAP UE (EU01):
    • URL do locatário (URL base do SCIM): https://papi-eu01.walkme.cloud.sap/DeepUI/api/scim/v2
  • Centro de dados do FedRAMP:
    • URL do locatário (URL base do SCIM): https://papi.walkmegov.com/DeepUI/api/scim/v2
  • Centro de dados do Canadá:
    • URL do locatário (URL base do SCIM): https://papi-ca1.walkmedap.com/DeepUI/api/scim/v2

Etapa 3: revise os mapeamentos de atributos

  1. Na página Provisionamento, expanda Mapeamentos
  2. Selecione Provisionar Usuários do Microsoft Entra ID
  3. Certifique-se de que os atributos do WalkMe necessários estejam mapeados:
  • Atributo WalkMe: UserName
    • Requisito: deve mapear um identificador exclusivo e estável, normalmente userPrincipalName ou mail
  • Atributo WalkMe: emails
    • Requisito: deve incluir pelo menos um endereço de e-mail marcado como principal: true

Para sincronizar grupos:

  1. Em Mapeamentos, selecione Provisionar grupos do Microsoft Entra ID
  2. Certifique-se de que displayName esteja mapeado
  3. Selecione Salvar se você fez alterações

Etapa 4: atribua usuários e comece a provisionar

  1. No Menu esquerdo do aplicativo, vá para Usuários ou Grupos
  2. Selecione Adicionar Usuário ou Grupo
  3. Selecione os Usuários ou Grupos para sincronizar com o WalkMe
  4. Volte para a guia Provisionamento
  5. Selecione Iniciar provisionamento
Observação:

O provisionamento não é iniciado até que você selecione Iniciar provisionamento.

O primeiro ciclo pode levar cerca de 40 minutos. Após a conclusão, os Usuários atribuídos aparecem no WalkMe Console.

Resolução de problemas

O teste de conexão falha

  • Certifique-se de que o URL do locatário corresponde aos Dados do WalkMe
  • Certifique-se de que o formato do Secret Token corresponda ao tipo de autorização definido no WalkMe

Usuários ou grupos que não estão sincronizando

  • Certifique-se de que o aplicativo foi criado como um aplicativo corporativo que não pertence à galeria
  • Certifique-se de que o Modo de Provisionamento esteja definido como Automático
  • Certifique-se de que os Usuários ou Grupos estejam atribuídos ao aplicativo
  • Aguarde por conclusão do primeiro ciclo de provisionamento antes de verificar os resultados

Problemas de mapeamento de atributos

Mapeamentos incorretos podem causar falha na criação de usuários, dados de perfil incompletos ou problemas de sincronização de grupos

  • Vá para Provisionar > Mapeamentos e certifique-se de que userName, e-mails e o displayName do grupo estejam mapeados corretamente

Notas técnicas

  • Somente os Usuários e Grupos atribuídos ao aplicativo corporativo são provisionados. Outros Usuários do Entra ID não sincronizam com o WalkMe.
  • As alterações feitas no Entra ID serão sincronizadas com o WalkMe no próximo ciclo de provisionamento

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
×
×