Configurar o SSO com o Microsoft Entra ID

Permita que sua equipe faça login no Circleback com o Microsoft Entra ID

Você pode conectar o Microsoft Entra ID ao Circleback criando um aplicativo SAML personalizado no centro de administração do Entra.

Você precisa ter acesso para gerenciar aplicativos empresariais no Entra e ser administrador do seu workspace do Circleback. Antes de começar, confira os requisitos em Configurar o login único.

1. No Circleback, acesse Configurações → Geral (em Workspace).

2. Em Login único, selecione Conectar ao lado de Provedor de identidade. Escolha SAML e selecione Continuar. Mantenha este formulário aberto.

3. Em outra aba, abra o centro de administração do Entra e acesse Enterprise applications.

Microsoft Entra ID: Enterprise applications

4. Selecione New application → Create your own application.

Microsoft Entra ID: New application

5. Insira Circleback como nome e escolha integrar um aplicativo que não está na galeria.

6. Selecione Create.

Microsoft Entra ID: Create your own application

7. Abra o aplicativo, selecione Single sign-on em Manage e escolha SAML.

Microsoft Entra ID: escolher o login único SAML

8. No Entra, em Basic SAML Configuration, selecione Edit. Copie o ID da entidade e a URL do ACS do formulário aberto do Circleback para os campos abaixo:

Microsoft Entra ID: editar a Basic SAML Configuration

CampoValor
Identifier (Entity ID)https://circleback.ai/api/sso/metadata
Reply URL (Assertion Consumer Service URL)https://circleback.ai/api/sso/oauth/saml

9. Selecione Save.

Microsoft Entra ID: campos Identifier e Reply URL; use as URLs do Circleback acima

10. Em Attributes & Claims, selecione Edit.

Microsoft Entra ID: editar Attributes and Claims

11. Defina Unique User Identifier (Name ID) como o e-mail que o membro da sua equipe usa no Circleback, com o formato Email address. Use user.mail se ele contiver esse e-mail para cada usuário atribuído. Só use user.userprincipalname se ele corresponder ao e-mail do usuário no Circleback.

12. Verifique estas declarações e adicione as que estiverem faltando:

DeclaraçãoAtributo de origem
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddressuser.mail
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givennameuser.givenname
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surnameuser.surname

A declaração de e-mail também deve corresponder ao e-mail do membro no Circleback. Se você usar outro atributo de origem para o e-mail, use-o tanto na declaração de e-mail quanto no Name ID.

13. Salve suas alterações.

Microsoft Entra ID: exemplo de declarações de atributos; siga as instruções de mapeamento de e-mail acima

14. Volte para Single sign-on no Entra. Em SAML Signing Certificate, baixe o Federation Metadata XML.

Microsoft Entra ID: baixar o Federation Metadata XML

15. No formulário aberto do Circleback, em Origem dos metadados, escolha Enviar arquivo XML e envie o arquivo que você baixou.

16. No Entra, abra Users and groups no aplicativo.

17. Selecione Add user/group e escolha as pessoas ou os grupos que devem usar o Circleback.

18. Selecione Assign.

19. Volte ao Circleback e selecione Continuar. Deixe Sem sincronização de diretório selecionado para usar apenas o login, ou selecione Microsoft Entra ID se você pretende configurar o provisionamento SCIM. Selecione Conectar.

Se você selecionou o Microsoft Entra ID para a sincronização de diretório, use as credenciais exibidas no Circleback para configurar a sincronização de diretório.

Atribuir funções do workspace

Se você configurou a sincronização de diretório, o Entra também pode definir a função de cada membro no Circleback.

1. No centro de administração do Entra, acesse App registrations → All applications e abra Circleback.

2. Selecione App roles → Create app role. Crie estas três funções, permitindo Users/Groups em cada uma:

Nome de exibiçãoValor
AdministradorAdmin
MembroMember
VisualizadorViewer

3. Acesse Enterprise applications → Circleback → Users and groups. Atribua a cada usuário ou grupo a função que ele deve ter. Dê apenas uma função a cada pessoa.

4. Selecione Provisioning → Attribute mapping → Users.

5. Selecione Add New Mapping, escolha o tipo de mapeamento Expression e insira:

CampoValor
ExpressãoSingleAppRoleAssignment([appRoleAssignments])
Atributo de destinoroles[primary eq "True"].value

6. Selecione OK e depois Save.

7. Em Settings, defina Scope como Sync only assigned users and groups.

Para exigir que todos no seu workspace façam login com SSO, siga Impor o SSO no seu workspace.

Artigos relacionados