For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Pular para o conteúdo
September 22 — Documentation updated for compatibility with the latest PAM version (5.3.0).

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.

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.

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.

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.

  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:

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

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.

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.

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.

Páginas relacionadas

Atualizado

Isto foi útil?