# Configurar o SSO com o Microsoft Entra ID (/docs/pt/support/security/single-sign-on/set-up-sso-with-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](/docs/support/security/single-sign-on/sso).

1\. No Circleback, acesse [Configurações → Geral](https://circleback.ai/settings?tab=workspace) (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

| Campo                                      | Valor                                      |
| ------------------------------------------ | ------------------------------------------ |
| 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ção                                                           | Atributo de origem |
| -------------------------------------------------------------------- | ---------------- |
| `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress` | `user.mail`      |
| `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname`    | `user.givenname` |
| `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname`      | `user.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](/docs/support/security/single-sign-on/sso).

## 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ção | Valor    |
| ------------ | -------- |
| Administrador | `Admin`  |
| Membro       | `Member` |
| Visualizador | `Viewer` |

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:

| Campo            | Valor                                           |
| ---------------- | ----------------------------------------------- |
| Expressão        | `SingleAppRoleAssignment([appRoleAssignments])` |
| Atributo de destino | `roles[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](/docs/support/security/single-sign-on/sso).