# Configurar SSO com SAML (/docs/pt/support/security/single-sign-on/set-up-sso-with-saml)

O Circleback funciona com qualquer provedor de identidade compatível com SAML 2.0, para que sua equipe possa fazer login com o provedor que sua empresa já usa.

Se você usa [Google Workspace](/docs/support/security/single-sign-on/set-up-sso-with-google-workspace), [Microsoft Entra ID](/docs/support/security/single-sign-on/set-up-sso-with-microsoft-entra-id) ou [Okta](/docs/support/security/single-sign-on/set-up-sso-with-okta), siga o guia desse provedor. Para qualquer outro provedor SAML, siga as etapas abaixo.

Você precisa ser administrador do workspace no Circleback e ter acesso para gerenciar aplicativos no seu provedor de identidade. Veja [Configurar o login único](/docs/support/security/single-sign-on/sso) para conhecer os requisitos do workspace.

## Criar um aplicativo SAML

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 console de administração do seu provedor e crie um aplicativo SAML 2.0 chamado **Circleback**.
4. Copie a **URL do ACS** e o **ID da entidade** do Circleback para as configurações do aplicativo no seu provedor e defina o Name ID como o endereço de e-mail do membro no Circleback.

Os nomes dos campos podem variar de acordo com o provedor:

| Campo                                                      | Valor                                      |
| ---------------------------------------------------------- | ------------------------------------------ |
| ACS URL, Single sign-on URL, Reply URL ou Destination URL | `https://circleback.ai/api/sso/oauth/saml` |
| Entity ID, Identifier ou Audience URI                     | `https://circleback.ai/api/sso/metadata`   |
| Name ID                                                    | O endereço de e-mail do membro no Circleback      |
| Formato do Name ID                                             | Endereço de e-mail                              |

Configure o aplicativo para assinar as respostas e as asserções SAML usando RSA-SHA256 e deixe a criptografia de asserções desativada.

## Mapear atributos de usuário

Adicione estes atributos para que o Circleback receba o e-mail e o nome de cada pessoa:

| Atributo SAML | Valor do seu diretório             |
| -------------- | ------------------------------------- |
| `email`        | O endereço de e-mail do membro no Circleback |
| `firstName`    | Nome                            |
| `lastName`     | Sobrenome                             |

O Circleback também aceita os nomes de declaração padrão terminados em `emailaddress`, `givenname` e `surname` em `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/`.

Salve as alterações e dê acesso ao aplicativo às pessoas ou aos grupos que devem usar o Circleback.

Copie a URL de metadados SAML do seu provedor ou baixe o arquivo XML de metadados. No formulário do Circleback que está aberto, em **Origem dos metadados**, escolha **URL de metadados**, **Enviar arquivo XML** ou **Colar XML manualmente** e adicione seus metadados. A URL de metadados precisa usar HTTPS.

Selecione **Continuar**. Deixe **Sem sincronização de diretório** selecionado se você só precisa de SSO ou escolha um provedor de diretório para configurar o provisionamento SCIM. Selecione **Conectar**.

Se você escolheu um provedor de diretório, use as credenciais exibidas no Circleback para [configurar a sincronização de diretório](/docs/support/security/single-sign-on/sso).

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).