> 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/ldap-and-ad.md).

# LDAP e Active Directory

Autentique os usuários do console contra um servidor LDAP ou Active Directory e provisione seus cadastros a partir dos atributos do diretório, inclusive a participação em grupos que alimenta as autori

## O que é isto e quando usar

Conectar um diretório faz duas coisas ao mesmo tempo: as pessoas entram na solução com as credenciais que já têm, e o cadastro delas é criado aqui a partir dos atributos do diretório, em vez de ser digitado à mão. A participação em grupos vem junto, e é isso que torna as autorizações sustentáveis: você adiciona alguém a um grupo no Active Directory e o acesso dele aqui acompanha.

Use sempre que a organização já tiver um diretório. Mantenha também um pequeno número de contas locais, para emergências e para a administração local, porque uma indisponibilidade do diretório sem isso deixa todo mundo trancado do lado de fora.

{% hint style="warning" %}
Três recursos diferentes tocam o Active Directory, e são confundidos com frequência:

* **Esta página**: o diretório autentica *usuários do console* e fornece os atributos deles. Nada é instalado em lugar nenhum.
* **Descoberta e rotação de contas**: contas do diretório tratadas como *credenciais gerenciadas* que a solução armazena e rotaciona. Isso roda por WinRM ou OpenSSH contra o domínio, não por esta conexão LDAP. Consulte [Descoberta de contas](https://wiki.datadike.com/pt/pam/administration/accounts/discovery-of-accounts.md).
* **AD Bridge**: ingressar *servidores Linux* no domínio para que as identidades do diretório virem contas do sistema operacional no host. Isso é uma propriedade do alvo, não do login no console.
  {% endhint %}

## Antes de começar

* A função **SYSADMIN**.
* Alcance de rede da solução até o diretório, e a conta de serviço com a qual ela fará o bind.
* Se pretender usar LDAPS, os arquivos de certificado e uma janela de manutenção, porque o serviço precisa ser reiniciado (veja abaixo).
* Uma decisão sobre o escopo: qual parte do diretório você realmente quer aqui.

{% hint style="info" %}
Durante um piloto, não aponte a solução para o domínio inteiro. Traga apenas os usuários e as contas com que pretende trabalhar. Reduzir o escopo depois dá muito mais trabalho do que ampliá-lo.
{% endhint %}

## Passos

1. Abra **Configurações do Sistema › Autenticação › LDAP** e habilite o provedor. Só provedores habilitados aparecem na tela de login.
2. Preencha os parâmetros de conexão do diretório e a conta de bind do seu servidor, além da parte da árvore que será pesquisada.
3. Defina o mapa de **Atributos do usuário**, o JSON que diz qual atributo do diretório alimenta qual campo aqui. É este campo que decide se os usuários importados serão utilizáveis; veja [Mapeamento de atributos](#mapeamento-de-atributos).
4. Defina a **Organização** em que os usuários do diretório são criados, se a criação de usuários estiver habilitada. Isso determina em qual tenant eles caem.
5. Para alta disponibilidade, configure o **LDAP HA** com o servidor de contingência. Ele é usado quando o primário não responde.
6. Salve e leia os dois avisos abaixo antes de considerar o trabalho concluído.

### Mapeamento de atributos

O mapa é JSON puro. Um mapeamento completo de Active Directory, com grupos:

```json
{
  "username": "samAccountName",
  "name": "displayName",
  "email": "mail",
  "groups": "memberof"
}
```

Omita `groups` e apenas os usuários serão importados, sem os grupos a que pertencem:

```json
{
  "name": "cn",
  "email": "mail",
  "username": "sAMAccountName"
}
```

Essa segunda forma é deliberada e é uma escolha comum: pertencer a um grupo do diretório (digamos, `XPTO`) é o que qualifica uma pessoa a alcançar a solução, e o acesso que ela recebe uma vez dentro é concedido inteiramente aqui. Você ganha os logins do diretório sem importar a estrutura de grupos dele.

### LDAPS

Para usar LDAP sobre TLS, carregue `ldap_ca.pem`, `ldap_cert.pem` e `ldap_cert.key` no appliance e reinicie o serviço. Os certificados não são enviados por esta tela, e os arquivos novos só passam a valer depois do reinício.

{% hint style="danger" %}
**Desligue a autenticação por chave pública assim que a autenticação pelo diretório entrar em produção.** Em **Configurações do Sistema › Componentes › SSH & Terminal Protocol**, a opção **Chave pública** vem habilitada por padrão. Se ela ficar ligada, um usuário removido do Active Directory ainda alcança ativos com uma chave SSH que registrou antes: a conta de diretório dele acabou, e o offboarding fica silenciosamente incompleto. Desabilite-a para que toda sessão de terminal seja autenticada pelo diretório.
{% endhint %}

## O que você deve ver

A tela de login passa a oferecer o diretório como opção de entrada. Nada mais na tela de configurações indica que a conexão está saudável.

## Como verificar se funcionou

1. Entre como um usuário do diretório que ainda não seja um usuário local aqui.
2. Abra **Usuários › Usuários** e localize-o. A coluna **Origem** precisa mostrar `LDAP/AD`, não `Local`. Se mostrar `Local`, você se autenticou contra uma conta local preexistente e não provou nada.
3. Verifique se **Nome** e **E-mail** estão preenchidos. Campos em branco significam que o mapa de atributos está errado, ainda que o login tenha funcionado.
4. Se você mapeou `groups`, confirme que os **Grupos de usuários** do usuário refletem a participação dele no diretório.
5. Confira se o login aparece na trilha de auditoria com o diretório como fonte de autenticação. Consulte [Trilha de auditoria](https://wiki.datadike.com/pt/pam/administration/audit/audit-trail.md).

O login funcionar, por si só, não é verificação suficiente: a falha comum é um login bem-sucedido que produz um cadastro de usuário inutilizável.

## Erros comuns

| Sintoma                                                            | Causa                                                                            | Solução                                                                              |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Usuários do diretório entram, mas ficam sem nome ou e-mail         | O mapa de **Atributos do usuário** nomeia atributos que o diretório não publica  | Corrija o JSON: `samAccountName`, `displayName` e `mail` para Active Directory       |
| Os usuários são importados, mas não pertencem a grupo nenhum       | `groups` está ausente do mapa                                                    | Adicione `"groups": "memberof"`, ou conceda acesso por grupos definidos aqui         |
| O LDAPS falha depois de carregar os certificados                   | O serviço não foi reiniciado                                                     | Reinicie o serviço; os arquivos são lidos na inicialização                           |
| Um usuário removido do diretório continua alcançando ativos        | A autenticação por **Chave pública** continua habilitada no conector de terminal | Desabilite-a em **Configurações do Sistema › Componentes › SSH & Terminal Protocol** |
| Um usuário do diretório reaparece depois de excluído aqui          | O diretório é a origem do cadastro                                               | Remova ou desative a conta no diretório, não aqui                                    |
| Ninguém consegue entrar durante uma indisponibilidade do diretório | Todas as contas dependem do diretório                                            | Mantenha ao menos uma conta local de emergência                                      |

## Referência de campos

| Campo                | O que significa                                                                                   |
| -------------------- | ------------------------------------------------------------------------------------------------- |
| Ativar               | Caixa de seleção por provedor. Só provedores habilitados aparecem na tela de login                |
| Atributos do usuário | Mapa JSON dos atributos do diretório para `username`, `name`, `email` e `groups`                  |
| Organização          | O tenant em que os usuários do diretório são criados quando a criação de usuários está habilitada |
| LDAP HA              | Um segundo servidor de diretório, de alta disponibilidade, usado como contingência                |

Chaves do mapa e suas origens usuais no Active Directory:

| Chave      | Atributo do diretório  | Observações                                                |
| ---------- | ---------------------- | ---------------------------------------------------------- |
| `username` | `sAMAccountName`       | O login. Precisa ser único                                 |
| `name`     | `displayName`, ou `cn` | Nome de exibição                                           |
| `email`    | `mail`                 | Notificações e recuperação de senha                        |
| `groups`   | `memberof`             | Opcional. Omita para importar usuários sem os grupos deles |

O Radius é configurado junto dos provedores de diretório, mas é um servidor de autenticação externo e não um diretório: na maioria das vezes é usado para acrescentar um fator de senha de uso único. Consulte [Autenticação multifator](https://wiki.datadike.com/pt/pam/administration/identities/mfa.md).

## Páginas relacionadas

* [Usuários e grupos](https://wiki.datadike.com/pt/pam/administration/identities/users-and-groups.md): os cadastros que isto cria
* [Single sign-on](https://wiki.datadike.com/pt/pam/administration/identities/sso.md): os métodos federados, SAML2, OIDC, OAuth2 e CAS
* [Autenticação multifator](https://wiki.datadike.com/pt/pam/administration/identities/mfa.md): acrescentar um segundo fator por cima
* [Autorizações](https://wiki.datadike.com/pt/pam/administration/access/authorizations.md): o que um grupo importado alcança
* [Descoberta de contas](https://wiki.datadike.com/pt/pam/administration/accounts/discovery-of-accounts.md): contas do diretório como credenciais gerenciadas
