Todos os produtos
Search
Central de documentação

CloudSSO:Synchronize users or groups in Microsoft Entra ID by using SCIM

Última atualização: Sep 23, 2026

Sincronize usuários ou grupos do Microsoft Entra ID (anteriormente Azure AD) para o CloudSSO usando SCIM.

Pré-requisitos

Todas as operações do Microsoft Entra ID descritas neste guia exigem a função de Administrador Global. Para criar um usuário e atribuir essa função, consulte a documentação oficial do Microsoft Entra ID.

Etapa 1: Criar credenciais SCIM no console do CloudSSO

  1. Acesse o console do Cloud SSO.

  2. No painel de navegação à esquerda, clique em Settings.

  3. Na aba User Setting, na seção SCIM user provisioning, clique em Generate New SCIM Credential.

    Verifique se o switch SCIM synchronization está ativado.

  4. Na caixa de diálogo SCIM Credential Generated, copie a credencial SCIM e clique em OK.

Etapa 2: Ativar a sincronização SCIM no console do CloudSSO

  1. Acesse o console do CloudSSO.

  2. No painel de navegação à esquerda, clique em Settings.

  3. Na aba User Setting, na seção SCIM User Synchronization Configuration, ative o switch de sincronização SCIM.

Nota

Copie e salve o valor do SCIM endpoint para uso posterior.

Etapa 3: Configurar o SAML no Microsoft Entra ID

  1. Acesse o portal do Azure como administrador global do Microsoft Entra ID.

  2. No canto superior esquerdo da página inicial, clique no ícone SSO_AAD_icon.

  3. No painel de navegação à esquerda, escolha Microsoft Entra ID > Manage > Enterprise applications > All applications.

  4. Clique em New application.

  5. Na página Browse Microsoft Entra App Gallery, clique em Create your own application.

  6. No painel Create your own application, insira um nome para a aplicação. Neste exemplo, insira CloudSSODemo. Em seguida, selecione Integrate any other application you don't find in the gallery (Non-gallery) e clique em Create.

Etapa 4: Atribuir usuários ou grupos à aplicação no Microsoft Entra ID

  1. Na página CloudSSODemo, escolha Manage > Users and Groups.

  2. Na página exibida, clique em Add user/group.

  3. Selecione os usuários ou grupos desejados.

  4. Clique em Assign.

Etapa 5: Configurar a sincronização SCIM no Microsoft Entra ID

  1. Na página CloudSSODemo, escolha Manage > Provisioning.

  2. Clique em New configuration e configure as credenciais de administrador.

    1. Insira o endpoint SCIM no campo Tenant URL.

      Copie o valor de SCIM Endpoint da página de configurações do console do CloudSSO.

    2. Insira uma credencial SCIM no campo Secret token.

      Para obter a credencial, siga as instruções em Step 1: Create SCIM credentials in the CloudSSO console.

    3. Clique em Test Connectivity.

    4. Se o teste for bem-sucedido, clique em Create.

  3. Na página Provisioning, escolha Manage > Settings.

    1. Na seção Mappings, configure os mapeamentos de atributos.

      • Clique em Provision Microsoft Entra ID Users para configurar os mapeamentos de atributos para usuários.

        1. Localize externalId na coluna customappsso Attribute, clique no valor de Azure Active Directory Attribute correspondente e altere Source attribute para objectId.

        2. Mantenha apenas os mapeamentos de atributos exibidos abaixo e exclua os demais.User attribute mappings

      • Clique em Provision Microsoft Entra ID Groups para configurar os mapeamentos de atributos para grupos. Mantenha apenas os mapeamentos de atributos exibidos abaixo e exclua os demais.Group attribute mappings

      Nota

      Os nomes de usuários e grupos do CloudSSO têm restrições de caracteres. Se o nome de um usuário ou grupo do Microsoft Entra ID contiver caracteres não suportados, o mapeamento falhará. Para corrigir isso, clique em displayName na coluna Azure Active Directory Attribute, defina o tipo de mapeamento como Expression e insira uma expressão para remover ou substituir os caracteres não suportados. A sintaxe das expressões está descrita na documentação do Microsoft Entra ID.

    2. Na seção Settings, selecione Sync only assigned users and groups para o campo Scope.

    3. Na seção Provisioning Status, ative o switch.

    4. Clique em Save.

  4. Acesse a página Overview e atualize-a para visualizar os resultados da sincronização.

Verificar os resultados da sincronização

  1. Acesse o console do CloudSSO.

  2. Acesse a página de Usuários ou Grupos para visualizar os usuários ou grupos sincronizados.

    O campo Source dos usuários ou grupos sincronizados exibe o valor SCIM Synchronization. Para mais informações, consulte View user information e View group details.

Referências

Example: SSO from Microsoft Entra ID to CloudSSO