> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/pam/administration/identities/sso.md).

# Single sign-on

Delegue o login no console a um provedor de identidade corporativo por SAML2, OIDC, OAuth2, CAS ou Slack, e mapeie os atributos do provedor para os cadastros de usuário daqui.

## O que é isto e quando usar

Com single sign-on, o provedor de identidade autentica a pessoa e a solução confia na asserção que recebe de volta. Os usuários chegam ao console sem uma senha separada, e o segundo fator e as regras de acesso condicional configurados no provedor corporativo também valem neste login.

Use quando a organização já opera um provedor de identidade: Entra ID (Azure AD)/ADFS, Okta, Keycloak, PingFederate, OneLogin, Google Workspace. Se o que você tem é um diretório e não um provedor de federação, consulte [LDAP e Active Directory](https://wiki.datadike.com/pt/pam/administration/identities/ldap-and-ad.md).

{% hint style="warning" %}
A solução atua **exclusivamente como Service Provider**. Ela consome asserções de um provedor de identidade e não pode agir como provedor de identidade para outras aplicações.
{% endhint %}

Os métodos podem ser habilitados individualmente e coexistem, de modo que uma migração não precisa ser uma virada de chave: mantenha o login local e o método antigo habilitados até o novo estar comprovado.

Dois provedores têm um guia passo a passo: [Microsoft Entra ID por OIDC](https://wiki.datadike.com/pt/pam/administration/identities/sso-entra-id.md) e [Google Workspace por SAML2](https://wiki.datadike.com/pt/pam/administration/identities/sso-google-workspace.md).

## Qual método escolher

| Método     | Use para                                                                    |
| ---------- | --------------------------------------------------------------------------- |
| **SAML2**  | O padrão corporativo. Entra ID/ADFS, Okta, PingFederate, OneLogin           |
| **OIDC**   | SSO moderno sobre OAuth 2.0. Keycloak, Entra ID, Google Workspace, Okta     |
| **OAuth2** | Um provedor sem suporte a OIDC ou SAML, em que você liga os endpoints à mão |
| **CAS**    | Uma implantação CAS existente. Baseado em tickets; a versão 3 é suportada   |
| **Slack**  | Equipes que já vivem no Slack. Requer um Slack App                          |

## Antes de começar

* A função **SYSADMIN**.
* Acesso administrativo ao provedor de identidade, ou alguém que o tenha: a configuração é simétrica e as duas metades precisam ser feitas.
* A URL pública desta instalação. A URL de callback para a qual o provedor redireciona deriva dela, e uma divergência é a primeira falha habitual.
* Para SAML2, o certificado do Service Provider a ser enviado e os metadados do provedor de identidade.
* Para OAuth2, os endpoints de autorização, de token e de userinfo.
* Para Slack, um Slack App com seu Client ID e Client Secret.

## Passos

1. Abra **Configurações do Sistema › Autenticação** e selecione o método.
2. Habilite o provedor. Só provedores habilitados aparecem na tela de login.
3. Informe a configuração específica do provedor:
   * **SAML2**: envie o certificado do SP e configure o lado do IdP.
   * **OIDC**: os dados do provedor, mais o **Realm** para Keycloak e a configuração de sessão compartilhada.
   * **OAuth2**: os endpoints de autorização, de token e de userinfo, configurados manualmente.
   * **CAS**: o servidor CAS, usando as URLs abaixo.
   * **Slack**: o Client ID e o Client Secret do Slack App.
4. Preencha **Mapear atributos dos usuários**, o JSON que diz qual claim ou atributo do provedor alimenta `username`, `name` e `email` aqui. Veja [Mapeamento de atributos](#mapeamento-de-atributos).
5. Defina a **Organização** em que os usuários do provedor são criados, se a criação de usuários estiver habilitada. Isso decide em qual tenant eles caem.
6. Registre a URL de callback do lado do provedor, exatamente como a solução a publica.
7. Salve e teste em uma janela anônima do navegador, para não perder a sessão atual.

### URLs de serviço

Cada provedor expõe três endpoints sob o próprio hostname da instalação:

| Finalidade                     | Caminho                                                |
| ------------------------------ | ------------------------------------------------------ |
| Login                          | `https://<your-server>/core/auth/<provider>/login/`    |
| Callback de login bem-sucedido | `https://<your-server>/core/auth/<provider>/callback/` |
| Logout                         | `https://<your-server>/core/auth/<provider>/logout/`   |

`<provider>` é o nome do próprio método na URL: `openid` para OIDC, `saml2`, `cas`, `oauth2` e assim por diante. A URL de callback é a que precisa ser registrada no provedor de identidade.

O SAML2 publica também os metadados do provedor de serviços, com o Entity ID e a URL de callback (ACS) de que o provedor de identidade precisa, em `https://<your-server>/core/auth/saml2/metadata/`. Eles só ficam disponíveis depois que a chave privada e o certificado do SP são salvos.

### Mapeamento de atributos

O mapa é JSON puro, e **a direção dele depende do método**:

| Método              | Chave                                                 | Valor                        |
| ------------------- | ----------------------------------------------------- | ---------------------------- |
| OIDC, OAuth2, Slack | O campo de usuário daqui: `username`, `name`, `email` | O claim que o provedor envia |
| SAML2, CAS          | O atributo que o provedor envia                       | O campo de usuário daqui     |

No SAML2, só `username`, `name`, `email`, `comment`, `phone` e `groups` são lidos; qualquer outro atributo é ignorado.

O CAS publica nomes de atributo com prefixo:

```json
{
  "cas:user": "username",
  "cas:fullname": "name",
  "cas:mail": "email"
}
```

Um provedor OAuth2 que expõe um claim de e-mail com escopo:

```json
{
  "name": "user",
  "username": "name",
  "email": "user:email"
}
```

Tire os nomes dos atributos da documentação do próprio provedor ou de uma asserção de teste. Adivinhar produz um login bem-sucedido e um cadastro de usuário com campos em branco.

### Aceitar só usuários que já existem

Por padrão, quem entra pela primeira vez por um método externo ganha um cadastro de usuário criado automaticamente. Para aceitar só pessoas já cadastradas aqui, à mão ou sincronizadas do LDAP, abra **Configurações do Sistema › Segurança › Restrições de login** e ative **Apenas usuários existentes**. A configuração vale para todos os métodos externos de uma vez.

## O que você deve ver

A tela de login ganha um botão para o provedor. O login local continua disponível, a menos que você o desabilite.

## Como verificar se funcionou

1. Em uma janela anônima do navegador, abra o console e escolha o provedor. Você deve ser redirecionado ao provedor de identidade, autenticar-se lá e voltar já logado.
2. Abra **Usuários › Usuários** e localize o usuário. A coluna **Origem** precisa mostrar o provedor externo, e não `Local`; caso contrário, você entrou em uma conta local preexistente e não testou nada.
3. Verifique **Nome** e **E-mail** nesse cadastro. Campos em branco significam que o mapa de atributos está errado, mesmo que o login tenha funcionado.
4. Confirme que o usuário caiu na organização pretendida.
5. Confira se a entrada está registrada na trilha de auditoria com o provedor como fonte de autenticação. Consulte [Trilha de auditoria](https://wiki.datadike.com/pt/pam/administration/audit/audit-trail.md).
6. Saia e confirme que você não é logado de volta silenciosamente: a URL de logout faz parte da configuração por um motivo.

## Erros comuns

| Sintoma                                                    | Causa                                                                            | Solução                                                                                    |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| O provedor não aparece na tela de login                    | Está configurado, mas não habilitado                                             | Marque a caixa de habilitação do provedor                                                  |
| O provedor de identidade recusa o redirecionamento         | A URL de callback registrada lá não coincide com a publicada aqui                | Registre exatamente a URL `/core/auth/<provider>/callback/`, incluindo esquema e hostname  |
| O login funciona, mas o usuário fica sem nome ou e-mail    | O campo **Mapear atributos dos usuários** nomeia claims que o provedor não envia | Corrija o JSON com base em uma asserção real do provedor                                   |
| Os usuários aparecem no tenant errado                      | A **Organização** do provedor não é a que você esperava                          | Defina-a antes do primeiro login; mover usuários depois é trabalho manual                  |
| Você fica trancado do lado de fora no meio da configuração | O único método habilitado é justamente o que está sendo alterado                 | Mantenha o login local habilitado até o SSO estar comprovado e teste em uma janela anônima |
| Sair devolve você direto ao console                        | A sessão no provedor continua aberta                                             | Configure a URL de logout para que a sessão também seja encerrada no provedor              |

## Referência de campos

Campos comuns a todos os provedores:

| Campo                         | O que significa                                                                                  |
| ----------------------------- | ------------------------------------------------------------------------------------------------ |
| Ativar                        | Caixa de seleção por provedor. Só provedores habilitados aparecem na tela de login               |
| Mapear atributos dos usuários | Mapa JSON dos atributos do provedor para `username`, `name` e `email`                            |
| Organização                   | O tenant em que os usuários do provedor são criados quando a criação de usuários está habilitada |

Configuração específica documentada para cada método:

| Método | Configuração                                                                    |
| ------ | ------------------------------------------------------------------------------- |
| SAML2  | Envio do certificado do Service Provider, mais a configuração do IdP            |
| OIDC   | Dados do provedor, **Realm** (para Keycloak) e controle de sessão compartilhada |
| OAuth2 | Endpoints de autorização, de token e de userinfo, informados manualmente        |
| CAS    | Servidor CAS, com as URLs de login, callback e logout. Suporta a versão 3       |
| Slack  | Client ID e Client Secret de um Slack App                                       |

## Páginas relacionadas

* [LDAP e Active Directory](https://wiki.datadike.com/pt/pam/administration/identities/ldap-and-ad.md): login por diretório e sincronização de usuários
* [Autenticação multifator](https://wiki.datadike.com/pt/pam/administration/identities/mfa.md): um segundo fator aqui, ou delegado ao provedor de identidade
* [Usuários e grupos](https://wiki.datadike.com/pt/pam/administration/identities/users-and-groups.md): os cadastros que o SSO cria
* [Políticas de login](https://wiki.datadike.com/pt/pam/administration/access/login-policies.md): quando e de onde a entrada é permitida
* [Funções e permissões](https://wiki.datadike.com/pt/pam/administration/identities/roles.md): o que um usuário pode fazer uma vez dentro
