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.
Passos
Abra Configurações do Sistema › Autenticação › LDAP e habilite o provedor. Só provedores habilitados aparecem na tela de login.
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.
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.
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.
Para alta disponibilidade, configure o LDAP HA com o servidor de contingência. Ele é usado quando o primário não responde.
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
Entre como um usuário do diretório que ainda não seja um usuário local aqui.
Abra Usuários › Usuários e localize-o. A coluna Origem precisa mostrar
LDAP/AD, nãoLocal. Se mostrarLocal, você se autenticou contra uma conta local preexistente e não provou nada.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.
Se você mapeou
groups, confirme que os Grupos de usuários do usuário refletem a participação dele no diretório.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
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
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:
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
Usuários e grupos: os cadastros que isto cria
Single sign-on: os métodos federados, SAML2, OIDC, OAuth2 e CAS
Autenticação multifator: acrescentar um segundo fator por cima
Autorizações: o que um grupo importado alcança
Descoberta de contas: contas do diretório como credenciais gerenciadas
Atualizado
Isto foi útil?