> 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-entra-id.md).

# Single sign-on com o Microsoft Entra ID

Permita que os usuários entrem no console com a conta corporativa da Microsoft, registrando a solução no Microsoft Entra ID e ligando os dois por OIDC.

## O que é isto e quando usar

Esta página liga o console ao Microsoft Entra ID por OpenID Connect (OIDC). Concluída a configuração, a tela de login passa a mostrar um botão **OpenID**, e os usuários entram com a conta corporativa da Microsoft, sem senha local.

O trabalho acontece em dois consoles ao mesmo tempo: o centro de administração do Microsoft Entra (`entra.microsoft.com`), onde você registra o aplicativo, e **Configurações do Sistema › Autenticações › OIDC** aqui, onde você cola os valores que o Entra ID fornece. Deixe os dois abertos em abas separadas do navegador: você vai copiar valores de um para o outro várias vezes.

Para o funcionamento geral do single sign-on (métodos, URLs de serviço, mapeamento de atributos), consulte [Single sign-on](https://wiki.datadike.com/pt/pam/administration/identities/sso.md).

## Antes de começar

* A função **SYSADMIN**. Em uma instalação nova, entre com a conta de administrador que a DataDike entregou junto com ela; depois do primeiro acesso, use o seu próprio usuário administrador.
* Uma conta do Entra ID com permissão para registrar aplicativos no tenant.
* O endereço público desta instalação, por exemplo `https://pam.contoso.example`.
* Um login local de administrador que continue funcionando sem SSO, para que um erro nesta configuração não tranque você do lado de fora.

## Passos

### Registrar o aplicativo no Entra ID

1. No centro de administração do Microsoft Entra, abra **Registros de aplicativo** ("App registrations") e clique em **Novo registro** ("New registration").
2. Em **Nome**, informe um nome que identifique o aplicativo, por exemplo `DataDike PAM`.
3. Em **Tipos de conta com suporte** ("Supported account types"), escolha **Locatário único** ("Single tenant"): contas somente neste diretório organizacional.
4. Em **URI de Redirecionamento** ("Redirect URI"), escolha a plataforma **Web** e informe a URL de callback desta instalação:

   ```
   https://<your-server>/core/auth/openid/callback/
   ```

   Troque `<your-server>` pelo hostname da instalação. Mantenha o caminho `/core/auth/openid/callback/` exatamente como está: é o endereço de retorno que a solução espera do Entra ID.
5. Clique em **Registrar**.
6. Na página **Visão geral** ("Overview") do aplicativo, copie o **ID do aplicativo (cliente)** ("Application (client) ID").

### Criar o segredo do cliente

1. No mesmo registro, abra **Certificados e segredos** ("Certificates & secrets") e clique em **Novo segredo do cliente** ("New client secret").
2. Informe uma descrição e escolha a validade. Um ano ou mais evita renovações frequentes. Quando o segredo expira, o login pelo Entra ID para de funcionar até que um novo segredo seja criado e informado aqui; por isso, anote a data.
3. Copie a coluna **Valor** ("Value"), e não o **ID do segredo** ("Secret ID"). O valor só aparece uma vez: se você sair da página sem copiá-lo, crie outro segredo.

### Preencher a seção Configurações básicas

1. Aqui, abra **Configurações do Sistema › Autenticações** e selecione a aba **OIDC**.
2. Ative **OIDC**.
3. Em **URL DataDike PAM**, informe o endereço público desta instalação, por exemplo `https://pam.contoso.example`. A URL de callback é montada a partir dele.
4. Em **ID do cliente**, cole o **ID do aplicativo (cliente)**.
5. Em **Client Secret**, cole o **Valor** do segredo.
6. Em **Forma de autenticação do cliente**, escolha **Client Secret Post**.

### Preencher a seção Serviços

1. Desmarque **Usar Keycloak**. Os campos de endpoint aparecem.
2. No Entra ID, na página **Visão geral** do aplicativo, clique em **Pontos de extremidade** ("Endpoints"). Copie a URL do **Documento de metadados do OpenID Connect** ("OpenID Connect metadata document") e abra-a em uma nova aba. Ele lista todos os endpoints já com o ID do seu tenant.
3. Preencha os endpoints a partir desse documento:

   | Campo                              | Valor                                                                                                          |
   | ---------------------------------- | -------------------------------------------------------------------------------------------------------------- |
   | Endereço de endpoint               | A base do emissor, até o ID do tenant, com a barra final: `https://login.microsoftonline.com/<tenant-id>/`     |
   | Endpoint de autorização            | `https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize`                                          |
   | Endpoint de token                  | `https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token`                                              |
   | Endpoint JWKS                      | `https://login.microsoftonline.com/<tenant-id>/discovery/v2.0/keys`                                            |
   | Endpoint de informações do usuário | Apague o conteúdo e informe `https://graph.microsoft.com/oidc/userinfo`                                        |
   | Endpoint de encerramento da sessão | `https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/logout`                                             |
   | Algoritmo de assinatura            | O algoritmo que o documento de metadados lista em `id_token_signing_alg_values_supported`, normalmente `RS256` |
   | Chave de assinatura                | Deixe em branco                                                                                                |
   | Habilitar PKCE                     | Deixe desmarcado                                                                                               |

   `<tenant-id>` é o **ID do diretório (locatário)** ("Directory (tenant) ID"), por exemplo `00000000-0000-0000-0000-000000000000`. Copiar as URLs do documento de metadados, em vez de digitá-las, garante que ele esteja certo em todos os campos.
4. Em **Escopos**, mantenha o padrão `openid profile email`.
5. Em **Tempo de validade do token (segundos)**, informe `600`.
6. Deixe marcadas: **Incluir claims no token de ID**, **Usar state**, **Usar nonce**, **Sempre atualizar dados do usuário**, **Ignorar verificação SSL** e **Sessão Compartilhada**.

### Preencher a seção Pesquisar e salvar

1. Em **Pesquisar**, mantenha o mapa padrão de **Mapear atributos dos usuários**:

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

   No OIDC, a chave é o campo daqui e o valor é o claim que o Entra ID envia. O `preferred_username` normalmente traz o nome principal do usuário (UPN), como `maria@contoso.example`, que vira o nome de usuário.
2. Em **Organização**, escolha a organização em que os novos usuários são criados. Os usuários sempre pertencem também à organização Default.
3. Clique em **Salvar**.

### Opcional: aceitar só usuários que já existem

Por padrão, uma conta Microsoft que entra pela primeira vez ganha um cadastro de usuário criado automaticamente. Para aceitar só contas já cadastradas aqui, criadas à 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 de autenticação externos, não só para o OIDC.

## O que você deve ver

A tela de login mostra um botão **OpenID** ao lado do formulário de login local.

## Como verificar se funcionou

1. Saia do console, ou abra uma janela anônima, e vá à página de login. O botão **OpenID** precisa estar lá.
2. Clique em **OpenID** e autentique-se com uma conta corporativa da Microsoft. Você deve ser levado à Microsoft, autenticar-se lá e voltar já logado.
3. Abra **Usuários › Usuários** e localize esse usuário. A coluna **Origem** precisa mostrar OpenID, e não `Local`, e **Nome** e **E-mail** precisam estar preenchidos.
4. Confirme que o usuário caiu na organização escolhida.
5. Se você ativou **Apenas usuários existentes**, tente uma conta que não está cadastrada aqui. Ela precisa ser recusada.

## Erros comuns

| Sintoma                                                     | Causa                                                                                                                     | Solução                                                                                                        |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| A Microsoft mostra `AADSTS50011` depois da escolha da conta | O **URI de Redirecionamento** registrado no Entra ID não coincide com o callback montado a partir da **URL DataDike PAM** | Faça os dois apontarem para `https://<your-server>/core/auth/openid/callback/`, com o mesmo esquema e hostname |
| A Microsoft mostra `AADSTS7000215`                          | **Client Secret** contém o **ID do segredo** em vez do **Valor**, ou um valor digitado errado                             | Crie um novo segredo e cole o **Valor**                                                                        |
| O login funcionou por meses e parou para todo mundo         | O segredo do cliente expirou                                                                                              | Crie um novo segredo em **Certificados e segredos** e atualize o **Client Secret** aqui                        |
| O botão **OpenID** não aparece                              | **OIDC** está desativado, ou o formulário não foi salvo                                                                   | Ative **OIDC** e clique em **Salvar**                                                                          |
| O login funciona, mas o usuário fica sem nome ou e-mail     | O mapa de **Mapear atributos dos usuários** foi alterado, ou **Escopos** não inclui mais `profile email`                  | Restaure o mapa e os escopos padrão                                                                            |
| A validação do token falha na volta da Microsoft            | O **Algoritmo de assinatura** não coincide com o documento de metadados                                                   | Informe o algoritmo listado nos metadados, normalmente `RS256`                                                 |
| Uma conta não cadastrada aqui é recusada                    | **Apenas usuários existentes** está ativado                                                                               | Esperado. Cadastre o usuário antes, ou desative a configuração                                                 |

## Referência de campos

Valores para o Entra ID na aba **OIDC**:

| Seção                 | Campo                                                                                                                                   | Valor para o Entra ID                              |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| Configurações básicas | OIDC                                                                                                                                    | Ativado                                            |
| Configurações básicas | URL DataDike PAM                                                                                                                        | Endereço público desta instalação                  |
| Configurações básicas | ID do cliente                                                                                                                           | **ID do aplicativo (cliente)**                     |
| Configurações básicas | Client Secret                                                                                                                           | O **Valor** do segredo                             |
| Configurações básicas | Forma de autenticação do cliente                                                                                                        | Client Secret Post                                 |
| Serviços              | Usar Keycloak                                                                                                                           | Desativado                                         |
| Serviços              | Endereço de endpoint e endpoints de autorização, de token, JWKS e de encerramento da sessão                                             | Do documento de metadados do OpenID Connect        |
| Serviços              | Endpoint de informações do usuário                                                                                                      | `https://graph.microsoft.com/oidc/userinfo`        |
| Serviços              | Algoritmo de assinatura                                                                                                                 | O listado nos metadados, normalmente `RS256`       |
| Serviços              | Chave de assinatura                                                                                                                     | Em branco                                          |
| Serviços              | Habilitar PKCE                                                                                                                          | Desativado                                         |
| Serviços              | Escopos                                                                                                                                 | `openid profile email`                             |
| Serviços              | Tempo de validade do token (segundos)                                                                                                   | `600`                                              |
| Serviços              | Incluir claims no token de ID, Usar state, Usar nonce, Sempre atualizar dados do usuário, Ignorar verificação SSL, Sessão Compartilhada | Ativados                                           |
| Pesquisar             | Mapear atributos dos usuários                                                                                                           | Mapa padrão                                        |
| Pesquisar             | Organização                                                                                                                             | A organização em que os novos usuários são criados |

## Páginas relacionadas

* [Single sign-on](https://wiki.datadike.com/pt/pam/administration/identities/sso.md): métodos, URLs de serviço e mapeamento de atributos
* [Single sign-on com o Google Workspace](https://wiki.datadike.com/pt/pam/administration/identities/sso-google-workspace.md): o mesmo resultado por SAML2
* [Usuários e grupos](https://wiki.datadike.com/pt/pam/administration/identities/users-and-groups.md): os cadastros que o SSO cria
* [LDAP e Active Directory](https://wiki.datadike.com/pt/pam/administration/identities/ldap-and-ad.md): cadastrar os usuários com antecedência
* [Políticas de login](https://wiki.datadike.com/pt/pam/administration/access/login-policies.md): quando e de onde a entrada é permitida
