Manual de Configuração de Autenticação Centralizada com OpenLDAP
Autor: Full-Stack Innovator Pro (Revisão Técnica) Objetivo: Configurar um servidor OpenLDAP para permitir Single Sign-On (SSO) em clientes Ubuntu...
Autor: Full-Stack Innovator Pro (Revisão Técnica) Objetivo: Configurar um servidor OpenLDAP para permitir Single Sign-On (SSO) em clientes Ubuntu Desktop, incluindo a criação automática de diretórios pessoais e segurança SSL/TLS.
📋 Dados da Prática
Sección titulada «📋 Datos de la Práctica»- Domínio:
portelcore.local - Organização:
portelcore - Servidor (IP Estático):
172.20.0.153 - Cliente: Ubuntu Desktop
- Base DN:
dc=portelcore,dc=local
PARTE 1: Configuração do Servidor (Ubuntu Server)
Sección titulada «PARTE 1: Configuración del Servidor (Ubuntu Server)»1. Instalação e Configuração Inicial
Sección titulada «1. Instalación y Configuración Inicial»Primeiro, instalaremos o daemon LDAP (slapd) e as utilidades de gerenciamento.
sudo apt updatesudo apt install slapd ldap-utils -yAgora reconfiguraremos o pacote para criar o banco de dados com o nosso domínio específico.
sudo dpkg-reconfigure slapdRespostas ao assistente de configuração:
- Omitir configuração?
No - Nome do domínio DNS?
portelcore.local - Nome da organização?
portelcore - Senha de administrador? (Definimos uma senha segura e a memorizamos)
- Motor de banco de dados?
MDB - Eliminar o banco a ser purgado?
No - Mover o banco antigo?
Sí
Assim que terminar, verificaremos se o banco foi criado corretamente verificando o contexto do domínio:
slapcat | grep "dc=portelcore"2. Criação do arquivo de mapeamento (LDIF)
Sección titulada «2. Creación del archivo de mapeo (LDIF)»Este passo é crucial para definir a arquitetura do diretório. Criaremos um arquivo .ldif que define a estrutura (Unidades Organizativas), os grupos e os usuários.
Criamos o arquivo:
nano usuaris_grups.ldifColamos o seguinte conteúdo dentro do arquivo:
# Estructura Base: Unidades Organizativasdn: ou=people,dc=portelcore,dc=localobjectClass: organizationalUnitou: people
dn: ou=groups,dc=portelcore,dc=localobjectClass: organizationalUnitou: groups
# ---------------------------------------------------------# DEFINICIÓN DE GRUPOS# ---------------------------------------------------------
# Grupo 1: Administrador (GID 5000)dn: cn=Administrador,ou=groups,dc=portelcore,dc=localobjectClass: posixGroupcn: AdministradorgidNumber: 5000
# Grupo 2: Empleados (GID 5001)dn: cn=Empleats,ou=groups,dc=portelcore,dc=localobjectClass: posixGroupcn: EmpleatsgidNumber: 5001
# Grupo 3: Helpdesk (GID 5002)dn: cn=Helpdesk,ou=groups,dc=portelcore,dc=localobjectClass: posixGroupcn: HelpdeskgidNumber: 5002
# ---------------------------------------------------------# DEFINICIÓN DE USUARIOS# ---------------------------------------------------------
# Usuario 1: admin (Dentro de Administrador)dn: uid=admin,ou=people,dc=portelcore,dc=localobjectClass: inetOrgPersonobjectClass: posixAccountobjectClass: shadowAccountuid: adminsn: SystemgivenName: Administratorcn: Admin SystemdisplayName: Admin SystemuidNumber: 10000gidNumber: 5000userPassword: nolose123gecos: Admin SystemloginShell: /bin/bashhomeDirectory: /home/admin
# Usuario 2: user.portelcore (Dentro de Empleados)dn: uid=user.portelcore,ou=people,dc=portelcore,dc=localobjectClass: inetOrgPersonobjectClass: posixAccountobjectClass: shadowAccountuid: user.portelcoresn: UsergivenName: Portelcorecn: User PortelcoredisplayName: User PortelcoreuidNumber: 10001gidNumber: 5001userPassword: nolose123gecos: User PortelcoreloginShell: /bin/bashhomeDirectory: /home/user.portelcore
# Usuario 3: becario (Dentro de Helpdesk)dn: uid=becario,ou=people,dc=portelcore,dc=localobjectClass: inetOrgPersonobjectClass: posixAccountobjectClass: shadowAccountuid: becariosn: TechgivenName: Becariocn: Becario TechdisplayName: Becario TechuidNumber: 10002gidNumber: 5002userPassword: nolose123gecos: Becario TechloginShell: /bin/bashhomeDirectory: /home/becario3. Importação do Banco de Dados
Sección titulada «3. Importación de la Base de Datos»Injetaremos o arquivo de mapeamento no servidor LDAP.
ldapadd -x -D "cn=admin,dc=portelcore,dc=local" -W -f usuaris_grups.ldifSerá solicitada a senha de administrador configurada no passo 1.
Verificação:
Se tudo estiver correto, veremos mensagens de adding new entry. Verificamos que o usuário “becário” existe:
aldapsearch -x -b "dc=portelcore,dc=local" "(uid=becario)"PARTE 2: Configuração do Cliente (Ubuntu Desktop)
Sección titulada «PARTE 2: Configuración del Cliente (Ubuntu Desktop)»Vamos para a máquina cliente. Este equipamento não tem os usuários criados localmente; ele terá que lê-los do servidor.
1. Instalação do cliente LDAP
Sección titulada «1. Instalación del cliente LDAP»Instalaremos os pacotes necessários para conectar o sistema de autenticação (PAM) e o de nomes (NSS) com o LDAP.
sudo apt updatesudo apt install libnss-ldapd libpam-ldapd nscd -yConfiguração do assistente gráfico:
- URI do servidor LDAP:
ldap://172.20.0.153 - Base de busca (Search Base):
dc=portelcore,dc=local - Serviços: Certifique-se de marcar
passwd,groupeshadowcom a tecla de espaço.
⚠️ IMPORTANTE: Verificar nsswitch.conf Se após a instalação não funcionarem os usuários, verificamos manualmente que o sistema busca em LDAP:
cat /etc/nsswitch.conf | grep passwdSe a palavra ldap não aparecer ao final da linha, editamos o arquivo sudo nano /etc/nsswitch.conf e adicionamos ldap ao final das linhas passwd, group e shadow.
2. Verificar visibilidade de usuários
Sección titulada «2. Verificar visibilidad de usuarios»O cliente deve ser capaz de “ver” os usuários do servidor.
getent passwd user.portelcoreResultado esperado: user.portelcore:x:10001:5001:User Portelcore:/home/user.portelcore:/bin/bash
3. Automatização do Diretório Home
Sección titulada «3. Automatización del Directorio Home»Configuraremos o PAM para que crie automaticamente a pasta /home no primeiro login.
Editamos o arquivo common-session:
sudo nano /etc/pam.d/common-sessionAdicionamos esta linha ao final do arquivo:
session required pam_mkhomedir.so skel=/etc/skel umask=0077Reiniciamos o serviço nscd para limpar o cache:
sudo systemctl restart nscdPARTE 3: Testes Básicos
Sección titulada «PARTE 3: Pruebas Básicas»Teste 1: Validação de Grupos
Sección titulada «Prueba 1: Validación de Grupos»Entramos com o usuário admin (senha: nolose123) em um terminal do Desktop.
idResultado: Deve mostrar uid=10000(admin) e gid=5000(Administrador).
Teste 2: Login Gráfico (SSO)
Sección titulada «Prueba 2: Inicio de Sesión Gráfico (SSO)»Encerramos a sessão e entramos com becario / nolose123.
PARTE 4: Segurança do Servidor e Cliente (SSL/TLS)
Sección titulada «PARTE 4: Seguridad del Servidor y Cliente (SSL/TLS)»Para cumprir com as normas de segurança, iremos criptografar a conexão.
4.1 Geração de Certificados (No Servidor)
Sección titulada «4.1 Generación de Certificados (En el Servidor)»Instalaremos o OpenSSL e criaremos os certificados. Importante: Quando nos pedirem o “Common Name (CN)”, colocaremos portelcore.local.
sudo apt install openssl -ysudo mkdir /etc/ldap/certs
# 1. Crear clave privada CAsudo openssl genrsa -out /etc/ldap/certs/ca.key 2048
# 2. Crear certificado CA (Autoridad)sudo openssl req -x509 -new -nodes -key /etc/ldap/certs/ca.key -sha256 -days 3650 -out /etc/ldap/certs/ca.crt -subj "/C=ES/ST=Barcelona/L=Granollers/O=Portelcore/CN=portelcore.local"
# 3. Crear clave privada del Servidorsudo openssl genrsa -out /etc/ldap/certs/ldap_server.key 2048
# 4. Crear petición de firma (CSR)sudo openssl req -new -key /etc/ldap/certs/ldap_server.key -out /etc/ldap/certs/ldap_server.csr -subj "/C=ES/ST=Barcelona/L=Granollers/O=Portelcore/CN=portelcore.local"
# 5. Firmar el certificado del servidor con nuestra CAsudo openssl x509 -req -in /etc/ldap/certs/ldap_server.csr -CA /etc/ldap/certs/ca.crt -CAkey /etc/ldap/certs/ca.key -CAcreateserial -out /etc/ldap/certs/ldap_server.crt -days 365 -sha256Atribuiremos permissões para que o LDAP possa ler as chaves:
sudo chown -R openldap:openldap /etc/ldap/certs/sudo chmod 600 /etc/ldap/certs/*.key4.2 Configuração do OpenLDAP para usar TLS (Servidor)
Sección titulada «4.2 Configuración de OpenLDAP para usar TLS (Servidor)»Criaremos um arquivo tls_config.ldif para indicar onde estão os certificados:
nano tls_config.ldifConteúdo:
dn: cn=configchangetype: modifyreplace: olcTLSCACertificateFileolcTLSCACertificateFile: /etc/ldap/certs/ca.crt-replace: olcTLSCertificateFileolcTLSCertificateFile: /etc/ldap/certs/ldap_server.crt-replace: olcTLSCertificateKeyFileolcTLSCertificateKeyFile: /etc/ldap/certs/ldap_server.keyAplicaremos a configuração:
sudo ldapmodify -Y EXTERNAL -H ldapi:/// -f tls_config.ldifEditaremos o /etc/default/slapd para garantir que ele aceite conexões seguras:
sudo nano /etc/default/slapdBuscaremos SLAPD_SERVICES e o deixaremos assim:
SLAPD_SERVICES="ldap:/// ldapi:/// ldaps:///"
Reiniciaremos:
sudo systemctl restart slapd4.3 Configuração do Cliente para SSL (Ubuntu Desktop)
Sección titulada «4.3 Configuración del Cliente para SSL (Ubuntu Desktop)»⚠️ PASSO PRÉVIO CRÍTICO: Configuração de DNS
Como o certificado está emitido para portelcore.local, não podemos usar o IP diretamente na configuração SSL.
-
Editaremos o arquivo hosts do cliente:
Ventana de terminal sudo nano /etc/hosts -
Adicionaremos esta linha ao final:
172.20.0.153 portelcore.local
Passos de configuração SSL:
-
Transferir o CA: Precisamos baixar o certificado da autoridade do servidor para o cliente.
Abriremos um terminal no Cliente e executaremos: (Substituiremos
usuari_remotpelo nosso usuário do servidor, por exemplo,alex)Ventana de terminal # 1. Descargar archivoscp user.portelcore@172.20.0.153:/etc/ldap/certs/ca.crt .# 2. Mover al lugar correctosudo mv ca.crt /etc/ssl/certs/# 3. Asignar permisos de lectura para todossudo chmod 644 /etc/ssl/certs/ca.crt -
Configurar o demônio LDAP: Editaremos o arquivo de configuração:
Ventana de terminal sudo nano /etc/nslcd.confFaremos DUAS mudanças importantes:
Mudança A: Modificaremos a URI para usar o nome de domínio, não o IP:
uri ldap://portelcore.localMudança B: Ativaremos o TLS e o certificado:
ssl start_tlstls_reqcert demandtls_cacertfile /etc/ssl/certs/ca.crt -
Reiniciar serviços do cliente:
Ventana de terminal sudo systemctl restart nslcd -
Verificar Conexão:
getent passwd admin
PARTE 5: Auditoria Profissional (tcpdump + Wireshark)
Sección titulada «PARTE 5: Auditoría Profesional (tcpdump + Wireshark)»Em ambientes de produção (Servidores sem GUI), a boa prática é capturar o tráfego no servidor e analisá-lo posteriormente em um computador de desktop.
5.1 Captura de Tráfego (No Servidor)
Sección titulada «5.1 Captura de Tráfico (En el Servidor)»-
Instalaremos a ferramenta de captura:
Ventana de terminal sudo apt install tcpdump -y -
Iniciaremos a captura filtrando a porta LDAP (389) e salvando-a em um arquivo
.pcap:Ventana de terminal sudo tcpdump -i any port 389 -w /tmp/ldap_capture.pcap(Manteremos o terminal aberto enquanto realizamos o próximo passo).
5.2 Geração de Tráfego (No Cliente)
Sección titulada «5.2 Generación de Tráfico (En el Cliente)»-
Abriremos um terminal no Cliente (Ubuntu Desktop).
-
Faremos uma consulta para gerar tráfego:
getent passwd user.portelcore -
Voltaremos ao Servidor e interromperemos a captura com
Ctrl + C.
5.3 Análise do Arquivo (No Cliente)
Sección titulada «5.3 Análisis del Archivo (En el Cliente)»Agora transferiremos o arquivo de captura para o Cliente para analisá-lo com o Wireshark (que possui interface gráfica).
-
No Cliente, baixaremos o arquivo:
scp usuari@172.20.0.153:/tmp/ldap_capture.pcap . -
Instalaremos e abriremos o Wireshark:
Ventana de terminal sudo apt install wireshark -ywireshark ldap_capture.pcap
O que devemos procurar?
- Procuraremos pacotes com protocolo
LDAP. - Procuraremos o pacote “startTLSRequest”.
- Logo em seguida, deverão aparecer pacotes TLSv1.2 ou TLSv1.3.
- Teste de sucesso: Tentaremos ler o conteúdo de um pacote “Application Data”. Se apenas virmos caracteres ilegíveis (criptografados), a segurança funciona corretamente.
ANEXO 1: Solução se o IP do Servidor mudar
Sección titulada «ANEXO 1: Solución si cambia la IP del Servidor»Se já temos o cliente configurado e o IP do servidor mudar (por exemplo, de 192.168.1.100 para 172.20.0.153), não é necessário reinstalar.
Opção A (Recomendada - Assistente):
Executaremos a reconfiguração do pacote nslcd:
sudo dpkg-reconfigure nslcdInseriremos o novo IP quando a URI for solicitada (ldap://172.20.0.153).
Opção B (Manual):
-
Editaremos o arquivo de configuração do daemon nslcd:
Ventana de terminal sudo nano /etc/nslcd.conf -
Modificaremos a linha URI: Buscaremos a linha que começa por
urie cambiaremos o IP antigo pela nova. Antes:uri ldap://192.168.1.100Agora:uri ldap://172.20.0.153(Salvaremos com Ctrl+O e sairemos com Ctrl+X)
-
Reiniciaremos os serviços para aplicar as alterações:
Ventana de terminal sudo systemctl restart nslcdsudo systemctl restart nscd -
Verificaremos a conexão:
getent passwd user.portelcore
ANEXO 2: Resolução de Problemas (Troubleshooting)
Sección titulada «ANEXO 2: Resolución de Problemas (Troubleshooting)»Se o getent passwd não retornar nada, mas tivermos conexão de rede, o problema costuma ser o SSL.
Passo 1: Diagnóstico em tempo real Detiremos o daemon e o executaremos manualmente em modo depuração (debug) para ver por que ele rejeita a conexão.
sudo systemctl stop nslcdsudo nslcd -dLeremos as últimas linhas. Se virmos “hostname does not match CN”, é porque colocamos o IP no arquivo de configuração em vez do nome.
Passo 2: Verificação de URI
Nos certificaremos de que em /etc/nslcd.conf tenhamos exatamente o seguinte:
uri ldap://portelcore.local
(Se tivermos ldap://172.20.0.153, o certificado falhará).

