> 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/integrations/ad-bridge.md).

# AD Bridge para hosts Linux

Ingresse hosts Linux no Active Directory para que usuários e grupos do diretório virem contas do sistema operacional, com mapeamento de UID, política de sudo e tratamento de keytab gerenciados de form

O AD Bridge ingressa **servidores Linux** no Active Directory ou em um diretório LDAP corporativo, de modo que usuários e grupos do diretório sejam reconhecidos pelo host como contas nativas do sistema operacional. A frota deixa de carregar entradas de contas locais, chaves SSH não gerenciadas e credenciais avulsas por máquina.

{% hint style="warning" %}
**Isto não é a mesma coisa que login no console por diretório.** Autenticar *usuários do console* contra um diretório é configurado em [LDAP e Active Directory](https://wiki.datadike.com/pt/pam/administration/identities/ldap-and-ad.md) e não instala nada em lugar nenhum. O AD Bridge é uma propriedade do *host alvo*: um agente roda no servidor Linux e transforma identidades do diretório em contas locais nele. Os dois recursos são configurados separadamente e podem ser usados de forma independente.
{% endhint %}

## O que é isto e quando usar

Em um parque misto, as máquinas Windows normalmente já estão no domínio, enquanto a frota Linux roda sobre contas locais espalhadas, com política inconsistente de máquina para máquina. Isso amplia a superfície de ataque, dificulta a revogação tempestiva e fragmenta a trilha de auditoria.

O AD Bridge estende a identidade do diretório até o host:

| Propriedade                     | Efeito                                                                                                           |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Uma identidade**              | O `sAMAccountName` / `userPrincipalName` do diretório *é* o login Linux. Sem apelidos locais                     |
| **Grupos como autorização**     | A pertinência a grupos do diretório decide quem alcança quais hosts, e com qual função                           |
| **Provisionamento sob demanda** | A conta e seus grupos são materializados no host apenas quando um usuário autorizado faz login pela primeira vez |
| **Política central**            | As regras de acesso, sudo, shell e diretório home são definidas uma vez e enviadas aos hosts                     |
| **Uma trilha de auditoria**     | Autenticação, provisionamento e ações privilegiadas caem na mesma trilha de todos os outros eventos              |

Como a autorização deriva de grupos do diretório, conceder ou revogar acesso em toda uma frota Linux é uma operação no diretório, e não uma mudança em cada máquina.

{% hint style="info" %}
O diretório continua sendo a fonte autoritativa de identidade. A solução é o ponto de decisão e o ponto de auditoria: toda pergunta sobre quem pode se autenticar, em qual host e sob qual política é avaliada centralmente antes de ser aplicada ao sistema operacional.
{% endhint %}

## Como as peças se encaixam

Três planos, conversando por canais autenticados e cifrados:

| Plano                 | O que contém                                                                                                                                                                            |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Diretório**         | Active Directory ou LDAP: objetos de usuário e de grupo, pertinências, atributos, e se uma conta está habilitada ou bloqueada                                                           |
| **Plano de controle** | O catálogo de hosts Linux ingressados, os conjuntos de grupos autorizados por host ou grupo de hosts, as regras de sudo, os parâmetros de provisionamento e a configuração de auditoria |
| **Host**              | O agente do AD Bridge: executa o ingresso, resolve identidades do diretório para o sistema operacional, aplica a política que recebe e reporta eventos de volta                         |

O agente cuida do ingresso e da renovação da confiança da conta de máquina, resolve usuários e grupos na pilha de serviço de nomes e de autenticação do host, aplica localmente a política recebida e reporta para cima os eventos de autenticação e de provisionamento.

{% hint style="warning" %}
O agente não armazena **nenhuma credencial de usuário em texto claro** no host. As senhas são validadas contra o diretório por Kerberos ou LDAP. O cache offline, quando habilitado, guarda apenas verificadores protegidos, com um tempo de vida definido por política.
{% endhint %}

## Antes de começar

* **DNS.** O host Linux precisa resolver os registros SRV do domínio (`_ldap._tcp`, `_kerberos._tcp`) e os nomes dos controladores de domínio. DNS inconsistente é, de longe, a causa mais comum de um ingresso que falha.
* **Horário.** O Kerberos exige baixa diferença de relógio, tipicamente abaixo de cinco minutos, entre o host, o controlador de domínio e a solução. Rode NTP ou chrony em toda parte.
* **Rede.** Os serviços de diretório (LDAP/LDAPS, Kerberos) precisam estar alcançáveis a partir do host, além do canal autenticado do agente até a solução.
* **Uma conta de ingresso.** Uma conta de serviço do diretório com permissão delegada para criar e gerenciar contas de máquina na OU alvo. Mantenha-a com o menor privilégio possível, restrita à OU que contém os servidores Linux e a mais nada.
* **Uma distribuição suportada**, com a pilha de autenticação do sistema operacional disponível.
* **A credencial de ingresso no cofre.** Ela é custodiada no [cofre de credenciais](https://wiki.datadike.com/pt/pam/administration/accounts/vault.md), nunca em um arquivo no host.

## Passos

1. **Cadastre o host.** O servidor Linux é adicionado ao [Inventário](https://wiki.datadike.com/pt/pam/administration/assets/inventory.md), à mão ou por descoberta, e recebe sua própria identidade e o agente do AD Bridge.
2. **Decida o modelo de autorização** antes de ingressar qualquer coisa: quais *grupos* do diretório podem se autenticar em quais hosts ou grupos de hosts. Modele por grupo, não por usuário individual: é isso que faz a concessão e a revogação escalarem.
3. **Ingresse o host.** O agente solicita a credencial de ingresso; ela é liberada do cofre just-in-time, com escopo e prazo limitados apenas à operação de ingresso. O agente então localiza um controlador de domínio pelos registros SRV do DNS, autentica por Kerberos e cria ou atualiza a **conta de máquina** na OU designada.
4. **A confiança é estabelecida.** Um keytab para a conta de máquina é gerado e armazenado de forma protegida no host, de modo que a autenticação Kerberos deixa de depender de uma senha estática.
5. **A configuração de identidade é enviada.** O domínio e os realms, o esquema de mapeamento de UID/GID, o modelo de diretório home e o shell padrão são enviados ao host.
6. **Confirme e audite.** O agente confirma o ingresso, e o evento é gravado na trilha de auditoria com o host, a OU, a conta de máquina, o operador responsável e o carimbo de tempo.

{% hint style="info" %}
A credencial de ingresso nunca fica fixada no host. Depois do ingresso, a confiança repousa sobre o keytab da conta de máquina, cuja senha é rotacionada automaticamente conforme a política do domínio e a da solução.
{% endhint %}

### Sair do domínio

A remoção segue o mesmo caminho auditado, ao contrário: a política é revogada, o agente remove a confiança local, e a conta de máquina é desabilitada ou apagada na OU, com o evento inteiro registrado. É isso que mantém o descomissionamento livre de contas órfãs.

## Provisionamento no host

Usuários e grupos autorizados do diretório são materializados sem tocar no host à mão:

* **Disparado pelo primeiro login.** Quando um usuário do diretório que pertence a um grupo autorizado se autentica pela primeira vez em um host ingressado, a conta é criada de forma transparente.
* **Home a partir de um modelo.** O diretório home é construído a partir de um modelo definido em política (estrutura, skel, permissões), honrando os atributos POSIX do diretório onde existirem.
* **Grupos espelhados.** Os grupos relevantes do diretório são refletidos no host **com os mesmos nomes**, e governam ali a pertinência e o privilégio.
* **Desprovisionamento por política.** Perder a pertinência a um grupo autorizado, ou ter o acesso revogado centralmente, encerra o acesso. Contas inativas podem ser arquivadas ou removidas conforme a retenção que você definir.

## Mapeamento de UID e GID

A identidade precisa ser a mesma em todos os hosts, e coerente com o diretório:

| Situação                                      | O que acontece                                                                                                              |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| O diretório publica `uidNumber` / `gidNumber` | Esses valores são adotados diretamente                                                                                      |
| Não há atributos POSIX presentes              | Um algoritmo determinístico deriva o UID e o GID do identificador imutável do objeto (SID ou GUID)                          |
| Vários domínios ou florestas                  | Realms e relações de confiança são tratados de modo que identidades de domínios diferentes não colidam no espaço de UID/GID |

{% hint style="warning" %}
Derivação determinística significa que **o mesmo usuário recebe o mesmo UID em todos os hosts**, e é isso que faz sistemas de arquivos compartilhados como o NFS se comportarem corretamente. Se mais tarde você acrescentar atributos POSIX ao diretório para usuários que já foram provisionados a partir de valores derivados, os dois esquemas divergem e a propriedade dos arquivos no armazenamento compartilhado deixa de bater. Decida qual esquema vai usar antes de implantar na frota, e prefira atributos POSIX no diretório sempre que hosts compartilharem arquivos.
{% endhint %}

## Política aplicada centralmente

As políticas são definidas uma vez e propagadas aos hosts ingressados:

* **Acesso, por host e por grupo de hosts.** Quais grupos do diretório podem se autenticar em quais servidores, opcionalmente restringidos por janela de horário e outras restrições contextuais.
* **Elevação de privilégio (sudo).** As regras de `sudo` por grupo e por host são administradas centralmente, em vez de arquivos `sudoers` editados máquina a máquina.
* **GPO onde se aplica.** Onde o ambiente publica política de grupo com semântica que signifique algo no Linux (parâmetros de logon, mensagens, restrições compatíveis), o AD Bridge a interpreta e a aplica localmente.
* **Shell e diretório home.** Shell padrão, skel e política de criação do home são uniformizados pela configuração distribuída.

{% hint style="warning" %}
**Duas regras que discordam são resolvidas por especificidade, não por ordem.** Uma regra escrita para um único host vence uma regra escrita para um grupo de hosts, e o conflito fica registrado para revisão administrativa. Procure esses registros antes de concluir que um host "ignora" uma política.
{% endhint %}

{% hint style="info" %}
Uma diretiva de política de grupo **sem equivalente no Linux é ignorada com segurança e registrada**. Ela não se aplica pela metade e não produz efeitos colaterais. Se você esperava que uma configuração exclusiva do Windows fizesse efeito em um host Linux, é no log que você descobrirá que ela foi pulada.
{% endhint %}

## O que é auditado

Tudo o que é mediado pelo AD Bridge alimenta a [trilha de auditoria](https://wiki.datadike.com/pt/pam/administration/audit/audit-trail.md):

| Família               | Eventos                                                                                                                |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Autenticação**      | Logon bem-sucedido e malsucedido, origem, host, identidade do diretório e método (Kerberos, senha, cache offline)      |
| **Provisionamento**   | Criação, atualização e remoção de contas e grupos, com o operador ou a política responsável                            |
| **Ação privilegiada** | `sudo` e elevações, correlacionados à identidade real do diretório em vez de mascarados por trás de uma conta genérica |
| **Confiança**         | Ingresso e saída do domínio, rotação de keytab e mudanças na confiança                                                 |

Os registros são imutáveis, carimbados no tempo e correlacionáveis com o restante da trilha, de modo que "quem acessou o quê, quando, de onde e sob qual autorização" pode ser reconstruído de ponta a ponta.

## Como isto se combina com o resto da solução

* **Cofre.** As credenciais de ingresso e os keytabs são custodiados e rotacionados pelo [cofre](https://wiki.datadike.com/pt/pam/administration/accounts/vault.md), entregues just-in-time e nunca deixados em arquivos de configuração.
* **Gravação de sessão.** Sessões interativas de SSH e de console abertas por identidades do diretório nesses hosts podem ser mediadas e gravadas, indexadas por comando e por usuário.
* **RBAC.** As [funções](https://wiki.datadike.com/pt/pam/administration/identities/roles.md) decidem quem administra a integração, quem aprova acesso privilegiado e quem pode ler a auditoria, mantendo operador, aprovador e auditor separados.
* **Aprovação e acesso por tempo limitado.** O acesso elevado em hosts Linux pode exigir aprovação e expirar, de acordo com as políticas de [acesso just-in-time](https://wiki.datadike.com/pt/pam/administration/access/just-in-time.md).

## Como verificar se funcionou

Não pare em "o ingresso reportou sucesso". Confira as coisas que de fato quebram depois:

1. **O ingresso está na trilha.** Confirme o evento de ingresso, com o host, a OU, a conta de máquina e o operador. Depois confirme no diretório que a conta de máquina existe na OU que você pretendia, e não no contêiner padrão de computadores.
2. **Uma identidade autorizada é provisionada no primeiro login.** Faça login no host com um usuário do diretório que pertença a um grupo autorizado. A conta precisa ser criada, o diretório home precisa existir a partir do modelo, e `id <user>` precisa retornar os grupos do diretório.
3. **O UID é o mesmo em toda parte.** Rode `id <user>` em um **segundo** host ingressado e compare. UIDs diferentes em dois hosts significam que os dois não estão usando o mesmo esquema de mapeamento, e o armazenamento compartilhado vai mostrar donos errados.
4. **O `sudo` é atribuído à pessoa real.** Execute um comando privilegiado e confirme que o registro de auditoria nomeia a identidade do diretório, e não uma conta genérica. Esse é o objetivo central da integração.
5. **A revogação de fato revoga.** Remova o usuário de teste do grupo autorizado no diretório e confirme que o próximo login é recusado.
6. **Depois de uma saída do domínio**, confirme que a conta de máquina está desabilitada ou apagada na OU e que não restam contas órfãs no host.

## Erros comuns

| Sintoma                                                                              | Causa                                                                                                                       | Correção                                                                                                     |
| ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| O ingresso falha ao localizar o domínio                                              | O host não consegue resolver os registros SRV do domínio                                                                    | Corrija o DNS no host e verifique se `_ldap._tcp` e `_kerberos._tcp` resolvem antes de tentar de novo        |
| O ingresso alcança o controlador e depois falha no Kerberos                          | Diferença de relógio acima da janela permitida                                                                              | Habilite NTP ou chrony no host, no controlador e na solução, e tente de novo                                 |
| O ingresso falha ao criar a conta de máquina                                         | A conta de ingresso não tem direitos delegados na OU alvo                                                                   | Delegue a criação de contas de máquina naquela OU para a conta de ingresso, mantendo o menor privilégio      |
| Um usuário do diretório não consegue fazer login em um host ingressado               | O usuário não está em nenhum grupo autorizado para aquele host                                                              | Acrescente o grupo à autorização do host, não o usuário individual                                           |
| O mesmo usuário tem UIDs diferentes em dois hosts                                    | Um host lê atributos POSIX do diretório e o outro os derivou, ou os atributos foram acrescentados depois do provisionamento | Fixe um único esquema; onde os hosts compartilham arquivos, publique atributos POSIX no diretório            |
| Uma configuração de política de grupo não tem efeito no Linux                        | A diretiva não tem equivalente no Linux e foi ignorada com segurança                                                        | Verifique no log a diretiva pulada; aplique o equivalente pela política Linux central                        |
| Um host se comporta de forma diferente do resto do seu grupo                         | Uma regra específica daquele host sobrepõe a regra do grupo de hosts                                                        | Leia o conflito registrado e depois remova ou corrija a regra mais específica                                |
| A autenticação continua funcionando com o diretório fora do ar, ou para de funcionar | O cache offline está habilitado ou desabilitado, com um tempo de vida definido por política                                 | Decida o comportamento offline por política, em vez de descobri-lo durante uma indisponibilidade             |
| Um host descomissionado ainda tem conta no diretório                                 | O host foi apagado em vez de ter saído do domínio                                                                           | Faça a saída do domínio pela solução, para que a conta de máquina e a política sejam removidas e registradas |

## Referência de campos

### Atributos POSIX honrados a partir do diretório

| Atributo            | Usado para                                |
| ------------------- | ----------------------------------------- |
| `uidNumber`         | O ID numérico de usuário da conta no host |
| `gidNumber`         | O ID numérico do grupo primário da conta  |
| `loginShell`        | O shell de login                          |
| `unixHomeDirectory` | O caminho do diretório home               |

Publicá-los não é condição para a integração. Onde estiverem ausentes, UID e GID são derivados deterministicamente do SID ou GUID do objeto.

### Práticas que vale a pena adotar

| Prática                                                      | Por quê                                                                    |
| ------------------------------------------------------------ | -------------------------------------------------------------------------- |
| Dedique uma OU aos servidores Linux e delegue apenas a ela   | Mantém a conta de ingresso com o menor privilégio                          |
| Padronize NTP e DNS antes de ingressar a frota               | As duas causas de quase todo ingresso que falha                            |
| Publique atributos POSIX onde os hosts compartilham arquivos | Elimina qualquer dependência de UIDs derivados através de NFS              |
| Autorize por grupo, nunca por usuário                        | Conceder e revogar continuam sendo uma operação para a frota inteira       |
| Defina a retenção de gravação e de auditoria desde o início  | Uma pergunta feita fora da janela de retenção não pode mais ser respondida |

## Páginas relacionadas

* [LDAP e Active Directory](https://wiki.datadike.com/pt/pam/administration/identities/ldap-and-ad.md): a outra integração com diretório, que autentica *usuários do console* e não instala nada
* [Descoberta de contas](https://wiki.datadike.com/pt/pam/administration/accounts/discovery-of-accounts.md): tratar contas de diretório como credenciais gerenciadas
* [O cofre de credenciais](https://wiki.datadike.com/pt/pam/administration/accounts/vault.md): onde moram a credencial de ingresso e os keytabs
* [Trilha de auditoria](https://wiki.datadike.com/pt/pam/administration/audit/audit-trail.md): onde caem os eventos de autenticação, de provisionamento e de `sudo`
* [Usuários e grupos](https://wiki.datadike.com/pt/pam/administration/identities/users-and-groups.md): como a pertinência a grupos determina a autorização
