Esta página explica o processo de configuração do provisionamento de usuários e equipes com SCIM usando o método de autenticação Credenciais do cliente, necessário para a integração com o Microsoft Entra. Para obter uma visão geral da funcionalidade SCIM, consulte Gerenciamento de usuários e equipes com o provisionamento SCIM.

• Instruções passo a passo
  • Etapa 1: gerar credenciais SCIM no Read AI
  • Etapa 2: configurar o SCIM no Microsoft Entra
  • Etapa 3: mapeamento de atributos
  • Etapa 4: selecionar usuários e grupos para sincronização
  • Etapa 5: concluir e monitorar o provisionamento
• Observações e solução de problemas

Instruções passo a passo

Certifique-se de seguir estas etapas cuidadosamente, pois uma configuração incorreta pode impedir o funcionamento da integração ou resultar em um comportamento inesperado do provisionamento.

Etapa 1: gerar credenciais SCIM no Read AI

1. Acesse Configurações do espaço de trabalho e expanda a seção Avançado.

   

2. Ative a configuração Ativar provisionamento SCIM.

   

3. Selecione a opção Credenciais do cliente OAuth 2.0.

   

4. Clique em Gerar credenciais para obter seu ID do cliente e Segredo do cliente (copie-os; o segredo será exibido apenas uma vez e precisará ser gerado novamente se você o perder).

   

5. Anote a URL do locatário e a URL do token; você também precisará delas mais tarde.

   

6. Decida se deseja ativar a cobrança automática de licenças. Se desativada, o provisionamento falhará e exibirá erros no Entra sempre que você ficar sem licenças disponíveis no seu espaço de trabalho. Você pode configurar um limite para o número máximo de licenças que seu espaço de trabalho pode atingir por meio da cobrança automática (mais licenças sempre podem ser adquiridas manualmente).

   

Etapa 2: configurar o SCIM no Microsoft Entra

1. No portal de administração do Entra, acesse Aplicativos empresariais (em Entra ID, no menu do lado esquerdo).

   

2. Crie um novo aplicativo para o Read AI.

   

3. Clique em Criar seu próprio aplicativo, informe um nome (por exemplo, "Read AI SCIM") e certifique-se de selecionar Integrar qualquer outro aplicativo que você não encontre na galeria (fora da galeria). Não use o aplicativo Read AI da galeria.

   

4. Clique em Criar (pode levar cerca de um minuto para o Entra criar o aplicativo).

5. Clique em Provisionamento.

   

6. Clique em Nova configuração.

   

7. Para o método de autenticação, selecione Concessão de credenciais do cliente OAuth2.

   

8. Agora você precisará colar a URL do locatário, a URL do token, o ID do cliente e o Segredo do cliente das configurações do seu espaço de trabalho do Read AI nos campos correspondentes.

   

9. Selecione "Corpo" em “Como as credenciais são enviadas”.

   

10. Clique em Testar conexão ; depois, você deverá ver uma notificação no canto superior direito informando que o teste foi bem-sucedido.

    

11. Clique em Criar na parte inferior para salvar a configuração (pode levar cerca de um minuto para ser concluída).

Etapa 3: mapeamento de atributos

1. Clique em Provisionamento (o modo deve estar definido como Automático).

   

2. Expanda Mapeamentos e clique em Provisionar grupos do Microsoft Entra ID.

   

3. Decida se deseja que seus grupos do Entra se tornem equipes no Read AI.
   • Para provisionar equipes: deixe Ativado definido como Sim (o padrão) e mantenha inalterados os mapeamentos de atributos padrão (displayName, members, objectId). Observe que qualquer equipe existente do Read AI cujo nome corresponda ao de um grupo se tornará gerenciada pelo IdP, e seus membros serão substituídos pelos membros do grupo. Para saber mais sobre esse recurso, consulte Provisionamento de equipes.

   • Apenas para usuários: defina Ativado como Não. Os grupos atribuídos ao aplicativo ainda provisionarão seus membros como usuários, mas nenhuma equipe será criada. 

     

4. Clique em Salvar e depois em Sim para confirmar.

   

5. Clique no X no canto superior direito ou no link da navegação superior para voltar à página Provisionamento.

6. Clique em Provisionar usuários do Microsoft Entra ID. 

   

7. Em Mapeamentos de atributos, você deve excluir todos os atributos, exceto:
   • userName
   • active
   • emails[type eq "work"].value
   • name.givenName
   • name.familyName

   • externalId

     

8. Clique em Salvar e depois em Sim para confirmar.

   

9. Clique no X no canto superior direito ou no link da navegação superior para voltar à página Provisionamento.

10. Clique em Mapeamento de atributos (Visualização) para confirmar que Usuários está ativado e que Grupos corresponde à escolha feita na etapa 3.

    

Etapa 4: selecionar usuários e grupos para sincronização

1. Clique em Usuários e grupos.

   

2. Use Adicionar usuário/grupo para atribuir usuários individuais e/ou grupos ao aplicativo (essas são as pessoas  que você deseja autorizar a usar o Read AI).

   

3. Somente os usuários que você atribuir aqui (individualmente ou por meio de um grupo atribuído) serão provisionados e gerenciados pelo SCIM/Entra.
4. Se o provisionamento de grupos estiver ativado, cada grupo atribuído aqui também se tornará uma equipe no Read AI, com o nome do grupo. Somente os membros diretos de um grupo são provisionados — a associação não é propagada para grupos aninhados. Os usuários provisionados por meio de um grupo podem não aparecer individualmente na lista de usuários atribuídos.

Etapa 5: concluir e monitorar o provisionamento

1. Clique em Visão geral (Visualização) e depois em Iniciar provisionamento.

   

2. O provisionamento é executado automaticamente a cada aproximadamente 40 minutos, criando e desativando usuários no seu espaço de trabalho do Read AI conforme necessário para mantê-lo sincronizado com o aplicativo Entra. Se você ativou o provisionamento de grupos na etapa 3, as equipes e seus membros serão sincronizados no mesmo ciclo.
3. Você pode monitorar o status e os erros da sincronização no Entra. Também enviaremos notificações por e-mail caso o provisionamento de usuários falhe por qualquer motivo.

Observações e solução de problemas

Leia as observações aqui para entender completamente como funciona o provisionamento SCIM e, se tiver algum problema, consulte as dicas de solução de problemas. 

Algumas observações estão especificamente relacionadas ao provisionamento com grupos do Entra ID:

• Desatribuir um grupo exclui a equipe correspondente no Read AI, revogando o acesso a todos os relatórios compartilhados com essa equipe.
• Definir novamente o mapeamento de Grupos como Não mantém as equipes existentes, mas o Read AI deixa de receber atualizações. Assim, a equipe permanecerá gerenciada pelo IdP sem uma forma de alterar seus membros, a menos que você desative totalmente o provisionamento SCIM (consulte abaixo).
• Desatribuir um usuário que ainda pertence a um grupo atribuído não tem efeito — ele continuará provisionado. Um usuário que for desatribuído e removido de todos os grupos atribuídos será desativado no Read AI.

Para devolver todos os usuários e equipes ao gerenciamento manual, basta desativar o provisionamento SCIM nas configurações do seu espaço de trabalho do Read AI. Todas as equipes e os usuários permanecerão como estão, mas deixarão de ser gerenciados pelo IdP.

Para obter informações detalhadas sobre mapeamento de atributos e cenários avançados, consulte a documentação oficial do SCIM do Microsoft Entra.