Ir al contenido

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...

0lecturas

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.

  • 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)»

Primeiro, instalaremos o daemon LDAP (slapd) e as utilidades de gerenciamento.

Ventana de terminal
sudo apt update
sudo apt install slapd ldap-utils -y

Agora reconfiguraremos o pacote para criar o banco de dados com o nosso domínio específico.

Ventana de terminal
sudo dpkg-reconfigure slapd

Respostas ao assistente de configuração:

  1. Omitir configuração? No
  2. Nome do domínio DNS? portelcore.local
  3. Nome da organização? portelcore
  4. Senha de administrador? (Definimos uma senha segura e a memorizamos)
  5. Motor de banco de dados? MDB
  6. Eliminar o banco a ser purgado? No
  7. Mover o banco antigo? Sí

Assim que terminar, verificaremos se o banco foi criado corretamente verificando o contexto do domínio:

Ventana de terminal
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.ldif

Colamos o seguinte conteúdo dentro do arquivo:

# Estructura Base: Unidades Organizativas
dn: ou=people,dc=portelcore,dc=local
objectClass: organizationalUnit
ou: people
dn: ou=groups,dc=portelcore,dc=local
objectClass: organizationalUnit
ou: groups
# ---------------------------------------------------------
# DEFINICIÓN DE GRUPOS
# ---------------------------------------------------------
# Grupo 1: Administrador (GID 5000)
dn: cn=Administrador,ou=groups,dc=portelcore,dc=local
objectClass: posixGroup
cn: Administrador
gidNumber: 5000
# Grupo 2: Empleados (GID 5001)
dn: cn=Empleats,ou=groups,dc=portelcore,dc=local
objectClass: posixGroup
cn: Empleats
gidNumber: 5001
# Grupo 3: Helpdesk (GID 5002)
dn: cn=Helpdesk,ou=groups,dc=portelcore,dc=local
objectClass: posixGroup
cn: Helpdesk
gidNumber: 5002
# ---------------------------------------------------------
# DEFINICIÓN DE USUARIOS
# ---------------------------------------------------------
# Usuario 1: admin (Dentro de Administrador)
dn: uid=admin,ou=people,dc=portelcore,dc=local
objectClass: inetOrgPerson
objectClass: posixAccount
objectClass: shadowAccount
uid: admin
sn: System
givenName: Administrator
cn: Admin System
displayName: Admin System
uidNumber: 10000
gidNumber: 5000
userPassword: nolose123
gecos: Admin System
loginShell: /bin/bash
homeDirectory: /home/admin
# Usuario 2: user.portelcore (Dentro de Empleados)
dn: uid=user.portelcore,ou=people,dc=portelcore,dc=local
objectClass: inetOrgPerson
objectClass: posixAccount
objectClass: shadowAccount
uid: user.portelcore
sn: User
givenName: Portelcore
cn: User Portelcore
displayName: User Portelcore
uidNumber: 10001
gidNumber: 5001
userPassword: nolose123
gecos: User Portelcore
loginShell: /bin/bash
homeDirectory: /home/user.portelcore
# Usuario 3: becario (Dentro de Helpdesk)
dn: uid=becario,ou=people,dc=portelcore,dc=local
objectClass: inetOrgPerson
objectClass: posixAccount
objectClass: shadowAccount
uid: becario
sn: Tech
givenName: Becario
cn: Becario Tech
displayName: Becario Tech
uidNumber: 10002
gidNumber: 5002
userPassword: nolose123
gecos: Becario Tech
loginShell: /bin/bash
homeDirectory: /home/becario

Injetaremos o arquivo de mapeamento no servidor LDAP.

ldapadd -x -D "cn=admin,dc=portelcore,dc=local" -W -f usuaris_grups.ldif

Será 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.

Instalaremos os pacotes necessários para conectar o sistema de autenticação (PAM) e o de nomes (NSS) com o LDAP.

Ventana de terminal
sudo apt update
sudo apt install libnss-ldapd libpam-ldapd nscd -y

Configuração do assistente gráfico:

  1. URI do servidor LDAP: ldap://172.20.0.153
  2. Base de busca (Search Base): dc=portelcore,dc=local
  3. Serviços: Certifique-se de marcar passwd, group e shadow com 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:

Ventana de terminal
cat /etc/nsswitch.conf | grep passwd

Se 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.

O cliente deve ser capaz de “ver” os usuários do servidor.

getent passwd user.portelcore

Resultado esperado: user.portelcore:x:10001:5001:User Portelcore:/home/user.portelcore:/bin/bash

Configuraremos o PAM para que crie automaticamente a pasta /home no primeiro login.

Editamos o arquivo common-session:

Ventana de terminal
sudo nano /etc/pam.d/common-session

Adicionamos esta linha ao final do arquivo:

session required pam_mkhomedir.so skel=/etc/skel umask=0077

Reiniciamos o serviço nscd para limpar o cache:

Ventana de terminal
sudo systemctl restart nscd

Entramos com o usuário admin (senha: nolose123) em um terminal do Desktop.

id

Resultado: Deve mostrar uid=10000(admin) e gid=5000(Administrador).

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.

Instalaremos o OpenSSL e criaremos os certificados. Importante: Quando nos pedirem o “Common Name (CN)”, colocaremos portelcore.local.

Ventana de terminal
sudo apt install openssl -y
sudo mkdir /etc/ldap/certs
# 1. Crear clave privada CA
sudo 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 Servidor
sudo 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 CA
sudo 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 -sha256

Atribuiremos permissões para que o LDAP possa ler as chaves:

Ventana de terminal
sudo chown -R openldap:openldap /etc/ldap/certs/
sudo chmod 600 /etc/ldap/certs/*.key

4.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.ldif

Conteúdo:

dn: cn=config
changetype: modify
replace: olcTLSCACertificateFile
olcTLSCACertificateFile: /etc/ldap/certs/ca.crt
-
replace: olcTLSCertificateFile
olcTLSCertificateFile: /etc/ldap/certs/ldap_server.crt
-
replace: olcTLSCertificateKeyFile
olcTLSCertificateKeyFile: /etc/ldap/certs/ldap_server.key

Aplicaremos a configuração:

Ventana de terminal
sudo ldapmodify -Y EXTERNAL -H ldapi:/// -f tls_config.ldif

Editaremos o /etc/default/slapd para garantir que ele aceite conexões seguras:

Ventana de terminal
sudo nano /etc/default/slapd

Buscaremos SLAPD_SERVICES e o deixaremos assim: SLAPD_SERVICES="ldap:/// ldapi:/// ldaps:///"

Reiniciaremos:

Ventana de terminal
sudo systemctl restart slapd

4.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.

  1. Editaremos o arquivo hosts do cliente:

    Ventana de terminal
    sudo nano /etc/hosts
  2. Adicionaremos esta linha ao final:

    172.20.0.153 portelcore.local

Passos de configuração SSL:

  1. Transferir o CA: Precisamos baixar o certificado da autoridade do servidor para o cliente.

    Abriremos um terminal no Cliente e executaremos: (Substituiremos usuari_remot pelo nosso usuário do servidor, por exemplo, alex)

    Ventana de terminal
    # 1. Descargar archivo
    scp user.portelcore@172.20.0.153:/etc/ldap/certs/ca.crt .
    # 2. Mover al lugar correcto
    sudo mv ca.crt /etc/ssl/certs/
    # 3. Asignar permisos de lectura para todos
    sudo chmod 644 /etc/ssl/certs/ca.crt
  2. Configurar o demônio LDAP: Editaremos o arquivo de configuração:

    Ventana de terminal
    sudo nano /etc/nslcd.conf

    Faremos DUAS mudanças importantes:

    Mudança A: Modificaremos a URI para usar o nome de domínio, não o IP: uri ldap://portelcore.local

    Mudança B: Ativaremos o TLS e o certificado:

    ssl start_tls
    tls_reqcert demand
    tls_cacertfile /etc/ssl/certs/ca.crt
  3. Reiniciar serviços do cliente:

    Ventana de terminal
    sudo systemctl restart nslcd
  4. 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.

  1. Instalaremos a ferramenta de captura:

    Ventana de terminal
    sudo apt install tcpdump -y
  2. 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).

  1. Abriremos um terminal no Cliente (Ubuntu Desktop).

  2. Faremos uma consulta para gerar tráfego:

    getent passwd user.portelcore
  3. Voltaremos ao Servidor e interromperemos a captura com Ctrl + C.

Agora transferiremos o arquivo de captura para o Cliente para analisá-lo com o Wireshark (que possui interface gráfica).

  1. No Cliente, baixaremos o arquivo:

    scp usuari@172.20.0.153:/tmp/ldap_capture.pcap .
  2. Instalaremos e abriremos o Wireshark:

    Ventana de terminal
    sudo apt install wireshark -y
    wireshark 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.

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:

Ventana de terminal
sudo dpkg-reconfigure nslcd

Inseriremos o novo IP quando a URI for solicitada (ldap://172.20.0.153).

Opção B (Manual):

  1. Editaremos o arquivo de configuração do daemon nslcd:

    Ventana de terminal
    sudo nano /etc/nslcd.conf
  2. Modificaremos a linha URI: Buscaremos a linha que começa por uri e 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)

  3. Reiniciaremos os serviços para aplicar as alterações:

    Ventana de terminal
    sudo systemctl restart nslcd
    sudo systemctl restart nscd
  4. 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.

Ventana de terminal
sudo systemctl stop nslcd
sudo nslcd -d

Leremos 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á).