LDAPper Svogliati
Dieci servizi, dieci utenti, dieci password diverse, e quando qualcuno se ne va ti dimentichi sempre di toglierlo da uno. LDAP è la rubrica unica a cui tutti chiedono chi sei e in quali gruppi stai. Capito l'albero, il resto è ldapsearch.
"Il collega se n'è andato a marzo. Il suo account VPN funziona ancora." — Ogni rete senza una directory.
Dall'elenco telefonico mondiale ad Active Directory
Doveva essere la rubrica di tutto il pianeta. È diventata la rubrica di ogni azienda, che è già tanto.
Negli anni '80 le compagnie telefoniche volevano un elenco unico e mondiale di persone, organizzazioni e indirizzi, consultabile da qualsiasi computer. Nacque X.500, completo e pesantissimo. LDAP (Lightweight Directory Access Protocol) è la versione "leggera" per accederci da TCP/IP. L'elenco mondiale non è mai arrivato; in compenso quasi ogni azienda oggi ha la sua directory, e quasi sempre parla LDAP.
X.500
Lo standard delle directory: un albero di voci con attributi. Il protocollo per consultarlo, DAP, richiede la pila OSI, che quasi nessuno ha.
LDAP
All'Università del Michigan Tim Howes e colleghi scrivono un accesso semplificato a X.500 che gira su TCP/IP. Presto diventa una directory a sé, senza X.500 dietro.
LDAPv3 e OpenLDAP
La versione 3, quella di oggi, aggiunge TLS, autenticazione SASL ed estensioni. Nasce OpenLDAP, il server libero di riferimento.
Active Directory
Windows 2000 porta LDAP, Kerberos e DNS in ogni azienda, in un unico prodotto. Da allora, per molti, "LDAP" e "il dominio" sono la stessa cosa.
Le alternative libere
Il server di Netscape diventa 389 Directory Server, la base di FreeIPA (Red Hat). Samba 4 (2012) fa da controller di dominio Active Directory su Linux.
LDAP sotto, SSO sopra
Le applicazioni web preferiscono il login centralizzato con OIDC e SAML (Keycloak, Authentik, Entra ID). Ma dietro c'è quasi sempre una directory LDAP con utenti e gruppi, e i server Linux, il Wi-Fi e le stampanti continuano a parlarle direttamente.
Perché ti serve
Perché sopra i tre utenti e i tre servizi, gestire gli account a mano diventa la fonte principale di problemi di sicurezza.
Una password sola
La stessa per server, VPN, Wi-Fi, Nextcloud, Gitea. La cambi una volta e vale ovunque.
Chi esce, esce da tutto
Disattivi un account e sparisce da ogni servizio. Niente più accessi dimenticati di chi se n'è andato.
Permessi per gruppi
"Chi sta in sysadmin entra in SSH, chi sta in wifi usa il Wi-Fi." Aggiungi una persona a un gruppo e ha tutto quello che le serve.
Utenti uguali su ogni server
Stesso UID, stessa home, stessa chiave SSH su cento macchine, senza copiare /etc/passwd.
La rubrica
Nome, email, telefono, ufficio: i client di posta e i telefoni VoIP leggono la rubrica aziendale da LDAP.
Prima o poi arriva AD
In azienda c'è quasi sempre un Active Directory, e prima o poi ti chiederanno di collegarci un server Linux o un'applicazione.
Quale server, per chi
Parlano tutti LDAP, ma fanno mestieri diversi. Scegliere quello sbagliato vuol dire anni di configurazione inutile.
| Server | Cos'è | Va bene per | Attenzione |
|---|---|---|---|
| lldap | Un server LDAP minimale in Rust, con un'interfaccia web per utenti e gruppi | Casa e piccoli uffici: login unico per Nextcloud, Gitea, Jellyfin, Authentik | Schema fisso, niente login Linux completi con tutti gli attributi POSIX personalizzati, niente repliche |
| OpenLDAP | Il server classico, flessibile, con repliche | Chi vuole il controllo completo e sa cosa fa | Configurazione dentro la directory stessa (cn=config), documentazione dura |
| FreeIPA | 389 Directory Server + Kerberos + DNS + CA + interfaccia web | Reti di server Linux: utenti, sudo, chiavi SSH, regole di accesso, tutto centralizzato | Vuole Fedora, RHEL o derivate per il server e un suo DNS |
| Samba AD | Un controller di dominio Active Directory su Linux | Uffici con PC Windows, senza licenze Windows Server | Fa AD, quindi porta tutta la complessità di AD |
| Active Directory | La directory di Microsoft | Aziende con Windows: c'è già, usalo | Linux e applicazioni ci si collegano come client (sezione 12) |
Il concetto chiave: l'albero
Una directory LDAP è un albero di voci. Ogni voce ha un nome unico, che è il suo percorso fino alla radice.
Su una busta scrivi prima la persona, poi la via, poi la città, poi la nazione: dal particolare al generale. Un nome LDAP (il DN, Distinguished Name) funziona allo stesso modo: uid=renzo.panocia,ou=persone,dc=example,dc=com vuol dire "Renzo Panocia, nel reparto persone, dell'organizzazione example.com". Ogni pezzo (RDN) è un gradino dell'albero. Se due persone si chiamano allo stesso modo, non possono stare nello stesso ramo.
Albero piatto
Tre rami bastano quasi sempre: persone, gruppi, servizi. Rami per reparto o per sede sembrano ordinati, ma quando una persona cambia reparto cambia anche il suo DN, e si rompono tutti i gruppi che la contengono.
La radice è il tuo dominio
dc=example,dc=com per example.com. Non deve per forza esistere nel DNS, ma usare il tuo dominio evita confusione.
Gli account di servizio sono utenti
Ogni applicazione che legge la directory ha il suo utente, con il minimo dei permessi. Mai l'amministratore della directory dentro la configurazione di Nextcloud.
Voci, attributi e LDIF
Ogni voce è una scheda con attributi. Le objectClass dicono quali attributi può e deve avere. LDIF è il modo di scriverla in un file di testo.
dn: uid=renzo.panocia,ou=persone,dc=example,dc=com
objectClass: inetOrgPerson # persona: nome, email, telefono
objectClass: posixAccount # utente Linux: uid, gid, home, shell
objectClass: ldapPublicKey # chiave SSH (schema openssh-lpk)
uid: renzo.panocia
cn: Renzo Panocia
sn: Panocia
givenName: Renzo
mail: renzo.panocia@example.com
uidNumber: 10001
gidNumber: 10001
homeDirectory: /home/renzo.panocia
loginShell: /bin/bash
sshPublicKey: ssh-ed25519 AAAAC3Nza… renzo@portatile
userPassword: {SSHA}… # mai in chiaro: la mette ldappasswd
| Sigla | Vuol dire | Esempio |
|---|---|---|
dc | Domain Component, un pezzo del dominio | dc=example,dc=com |
ou | Organizational Unit, un ramo, una "cartella" | ou=persone |
cn | Common Name, il nome. In AD anche degli utenti | cn=sysadmin |
uid | Il nome utente, quello del login | uid=renzo.panocia |
objectClass | Il "tipo" della voce: decide gli attributi obbligatori e quelli permessi | inetOrgPerson, posixAccount, groupOfNames |
| Schema | L'elenco di tutte le objectClass e degli attributi che il server conosce | Un attributo non nello schema = errore 17 o 65 |
| Attributi operativi | Calcolati dal server, non restituiti se non li chiedi | memberOf, createTimestamp, entryUUID |
Bind e ricerca: come un'applicazione ti fa entrare
"Bind" vuol dire autenticarsi verso la directory. Un'applicazione ne fa due: uno con il suo account, uno con il tuo.
🔍 Perché due bind
L'utente scrive renzo.panocia, ma per autenticarsi serve il DN completo, e l'applicazione non lo conosce. Quindi prima entra col suo account di servizio e lo cerca, poi prova il bind con il DN trovato e la password scritta dall'utente. La password non viene mai letta né confrontata dall'applicazione: è il server LDAP a dire sì o no.
🙈 Bind anonimo e bind vuoto
Molti server permettono di cercare senza autenticarsi (bind anonimo): comodo, ma chiunque in rete legge l'elenco di utenti e gruppi. Peggio: un bind con un DN valido e password vuota per molti server è un bind anonimo riuscito. Un'applicazione scritta male lo prende per un login andato a buon fine. Vietare le password vuote nel codice è obbligatorio.
ldapsearch e i filtri
Prima di configurare qualsiasi applicazione, fai la stessa ricerca a mano. Se ldapsearch non trova l'utente, non lo troverà nemmeno lei.
# -x bind semplice, -H server, -D chi sei, -W chiede la password, -b da dove cercare
ldapsearch -x -H ldaps://ldap.example.com \
-D "uid=svc-nextcloud,ou=servizi,dc=example,dc=com" -W \
-b "ou=persone,dc=example,dc=com" "(uid=renzo.panocia)" cn mail memberOf
# chi sono, per il server? (controlla DN e password)
ldapwhoami -x -H ldaps://ldap.example.com -D "uid=renzo.panocia,ou=persone,dc=example,dc=com" -W
# cosa c'è su questo server: radici e versioni supportate (Root DSE)
ldapsearch -x -H ldap://ldap.example.com -s base -b "" namingContexts supportedLDAPVersion
# StartTLS sulla 389 invece di LDAPS sulla 636: -ZZ (fallisce se TLS non parte)
ldapsearch -x -ZZ -H ldap://ldap.example.com -D "…" -W -b "dc=example,dc=com" "(uid=renzo.panocia)"
# cambiare una password
ldappasswd -x -H ldaps://ldap.example.com -D "cn=admin,dc=example,dc=com" -W -S "uid=renzo.panocia,ou=persone,dc=example,dc=com"
| Filtro | Trova |
|---|---|
(uid=renzo.panocia) | Uguaglianza |
(mail=*) | Chi ha l'attributo, con qualsiasi valore |
(cn=Renzo*) | Inizia con |
(&(objectClass=inetOrgPerson)(mail=*@example.com)) | Tutte e due le condizioni (E). L'operatore va prima, non in mezzo |
(|(uid=renzo.panocia)(mail=renzo.panocia@example.com)) | Una delle due (O): login con nome utente o email |
(!(pwdAccountLockedTime=*)) | Negazione: chi non è bloccato (OpenLDAP con ppolicy) |
(memberOf=cn=sysadmin,ou=gruppi,dc=example,dc=com) | Chi sta nel gruppo: serve il DN completo del gruppo |
-b) e scende: -s base solo quella voce, -s one il livello subito sotto, -s sub (il default) tutto il sottoalbero. Una base troppo stretta è la causa più comune di "utente non trovato".
Installare: lldap in cinque minuti, OpenLDAP in un pomeriggio
Per casa e piccoli uffici lldap basta e avanza. OpenLDAP quando ti servono schema su misura, repliche o login Linux completi.
services:
lldap:
image: lldap/lldap:stable
restart: unless-stopped
ports:
- "127.0.0.1:3890:3890" # LDAP, solo in locale o in rete interna
- "127.0.0.1:17170:17170" # interfaccia web
volumes:
- ./data:/data
environment:
LLDAP_LDAP_BASE_DN: dc=example,dc=com
LLDAP_JWT_SECRET_FILE: /data/jwt_secret # generati con openssl rand -base64 32
LLDAP_KEY_SEED_FILE: /data/key_seed
LLDAP_LDAP_USER_PASS_FILE: /data/admin_password
ou=people, gruppi in ou=groups, l'amministratore è uid=admin,ou=people,dc=example,dc=com. Il gruppo lldap_strict_readonly serve per gli account di servizio: leggono tutto ma non cambiano niente. Le applicazioni hanno quasi tutte una pagina di esempio nella documentazione di lldap.
sudo apt install slapd ldap-utils
sudo dpkg-reconfigure slapd # chiede il dominio (diventa la radice) e la password dell'admin
# la configurazione è anch'essa una directory: cn=config, si legge come root dal socket locale
sudo ldapsearch -Y EXTERNAL -H ldapi:/// -b cn=config -LLL dn | head
# creare i rami: un file LDIF e ldapadd
cat > rami.ldif <<'EOF'
dn: ou=persone,dc=example,dc=com
objectClass: organizationalUnit
ou: persone
dn: ou=gruppi,dc=example,dc=com
objectClass: organizationalUnit
ou: gruppi
dn: ou=servizi,dc=example,dc=com
objectClass: organizationalUnit
ou: servizi
EOF
ldapadd -x -H ldapi:/// -D "cn=admin,dc=example,dc=com" -W -f rami.ldif
/etc/ldap/slapd.d/, ma quei file non si editano: hanno un checksum e il server li riscrive. Si cambiano con ldapmodify -Y EXTERNAL -H ldapi:/// e un file LDIF. Le guide in rete che parlano di slapd.conf sono vecchie di quindici anni. Ed è uno dei motivi per cui lldap esiste.
Gruppi: il vero motivo per cui usi LDAP
Le applicazioni non decidono chi entra guardando le persone, ma i gruppi. E di gruppi in LDAP ne esistono di tre tipi, incompatibili tra loro.
| Tipo | Come elenca i membri | Chi lo usa | Attenzione |
|---|---|---|---|
groupOfNames | member: con il DN completo | Quasi tutte le applicazioni, lldap, memberOf | Deve avere almeno un membro: un gruppo vuoto non può esistere. Si mette un membro fittizio |
posixGroup | memberUid: con il solo nome utente | Linux (con gidNumber) | Niente memberOf: per le applicazioni web non esiste |
group (AD) | member: con il DN | Active Directory | Gruppi annidati: un utente sta in un gruppo perché sta in un altro gruppo |
dn: cn=sysadmin,ou=gruppi,dc=example,dc=com
objectClass: groupOfNames
objectClass: posixGroup # con lo schema rfc2307bis, che permette le due classi insieme
cn: sysadmin
gidNumber: 20001
member: uid=renzo.panocia,ou=persone,dc=example,dc=com
🔁 memberOf
È l'attributo che dice, su ogni utente, in quali gruppi sta. Non lo scrivi tu: lo calcola il server. In Active Directory c'è sempre; in OpenLDAP serve l'overlay memberof (con refint, che tiene i gruppi in ordine quando sposti o cancelli un utente), attivato prima di creare i gruppi: quelli già esistenti non vengono ricalcolati. Ed è un attributo operativo: se non lo chiedi per nome, ldapsearch non te lo mostra.
🪆 Gruppi annidati
In AD "sysadmin" può contenere il gruppo "sysadmin-junior". memberOf mostra solo i gruppi diretti. Per tutti, anche quelli ereditati, AD ha un filtro speciale:(memberOf:1.2.840.113556.1.4.1941:=cn=sysadmin,ou=gruppi,dc=example,dc=com)
Sì, quel numero è davvero il nome dell'operatore.
Login Linux con SSSD
SSSD fa vedere a Linux gli utenti LDAP come se fossero in /etc/passwd, li tiene in cache e funziona anche se la directory è irraggiungibile.
[sssd]
services = nss, pam, ssh, sudo
domains = example
[domain/example]
id_provider = ldap
auth_provider = ldap
ldap_uri = ldaps://ldap.example.com
ldap_search_base = dc=example,dc=com
ldap_default_bind_dn = uid=svc-sssd,ou=servizi,dc=example,dc=com
ldap_default_authtok = LA_PASSWORD_DEL_SERVIZIO
ldap_tls_reqcert = demand # certificato verificato, sempre
ldap_schema = rfc2307bis # gruppi con member: e DN completi
ldap_user_ssh_public_key = sshPublicKey
cache_credentials = true # login anche se il server LDAP è giù
access_provider = simple # chi può entrare in QUESTO server
simple_allow_groups = sysadmin
sudo apt install sssd-ldap libpam-sss libnss-sss sssd-tools
sudo chmod 600 /etc/sssd/sssd.conf && sudo systemctl restart sssd
sudo pam-auth-update --enable mkhomedir # crea la home al primo login
# prova: se compare, Linux vede l'utente
getent passwd renzo.panocia
id renzo.panocia # deve mostrare anche i gruppi LDAP
# chiavi SSH prese dalla directory: in /etc/ssh/sshd_config
AuthorizedKeysCommand /usr/bin/sss_ssh_authorizedkeys
AuthorizedKeysCommandUser nobody
# la cache confonde le prove: svuotala dopo ogni modifica nella directory
sudo sss_cache -E
Collegare le applicazioni
Ogni applicazione chiede le stesse sei cose con nomi diversi. Le hai già trovate con ldapsearch: ricopiale.
| Cosa chiede l'applicazione | Cosa metterci |
|---|---|
| Server / URL | ldaps://ldap.example.com:636 (o 389 con StartTLS) |
| Bind DN / utente di servizio | uid=svc-nextcloud,ou=servizi,dc=example,dc=com |
| Base utenti | ou=persone,dc=example,dc=com |
| Filtro utenti / login | (&(objectClass=inetOrgPerson)(uid=%s)), dove %s (o %u, {username}, dipende) è quello che l'utente scrive |
| Filtro di accesso | Aggiungi (memberOf=cn=nextcloud,ou=gruppi,dc=example,dc=com) per far entrare solo un gruppo |
| Attributi | Nome utente uid, email mail, nome visualizzato cn, ID stabile entryUUID (in AD objectGUID) |
Active Directory visto da Linux
AD è LDAP più Kerberos più DNS più criteri di gruppo. Un server Linux può entrare nel dominio come un PC Windows.
sudo apt install realmd sssd sssd-tools adcli libnss-sss libpam-sss packagekit
realm discover example.lan # il DNS del server deve essere quello del dominio
sudo realm join -U amministratore example.lan # crea l'account computer e configura SSSD
sudo realm permit -g sysadmin@example.lan # solo questo gruppo entra
id renzo.panocia@example.lan
| AD ha in più | Cosa vuol dire per te |
|---|---|
| Kerberos | Ore e date sincronizzate: con più di 5 minuti di differenza nessuno entra. NTP verso i controller di dominio |
| DNS integrato | I client trovano i controller con record SRV. Il server Linux deve usare il DNS del dominio |
| Global Catalog (porta 3268) | Ricerca su tutta la foresta. Per una ricerca su più domini usa la 3268 invece della 389 |
| sAMAccountName e userPrincipalName | Il nome di login è sAMAccountName (rpanocia) o userPrincipalName (rpanocia@example.lan), non uid. Filtro: (sAMAccountName=%s) |
| Firma LDAP obbligatoria | Le versioni recenti di Windows Server rifiutano i bind semplici in chiaro: usa LDAPS (636) o StartTLS |
| userAccountControl | Un numero a bit con lo stato dell'account. Disabilitato = bit 2. Filtro utenti attivi: (!(userAccountControl:1.2.840.113556.1.4.803:=2)) |
Sicurezza
La directory contiene le chiavi di tutto. Chi la legge sa chi c'è; chi ci scrive diventa chi vuole.
✅ Fai
- Sempre TLS: LDAPS sulla 636 o StartTLS obbligatorio sulla 389, con certificato verificato (Certificati per Svogliati)
- Un account di servizio per applicazione, in sola lettura, con password lunga
- Bind anonimo disattivato, o limitato al Root DSE
- Password salvate con hash moderni (
{ARGON2}in OpenLDAP 2.5+, almeno{SSHA}) - Filtro di accesso per gruppo in ogni applicazione
- Backup della directory:
slapcatper OpenLDAP, la cartella dati per lldap - Porta 389/636 aperta solo verso la rete interna o la VPN
❌ Non fare
- LDAP sulla 389 in chiaro: le password dei bind viaggiano leggibili
- L'amministratore della directory nella configurazione delle applicazioni
ldap_tls_reqcert = nevero "ignora certificato" per farlo funzionare- Accettare password vuote nel codice: il bind diventa anonimo e "riesce"
- Mettere quello che scrive l'utente in un filtro senza escape
- Esporre la directory su Internet
(&(uid= + quello che scrive l'utente + )(objectClass=person)), un utente che scrive * o *)(uid=* cambia il significato della ricerca. I caratteri ( ) * \ e il NUL vanno sempre convertiti (\28 \29 \2a \5c \00). Ogni libreria LDAP seria ha una funzione per farlo: usala.
Errori tipici, tradotti
LDAP risponde con un numero. Imparati i sei più comuni, il resto lo trovi in una tabella.
| Cosa vedi | Cosa vuol dire | Cosa fare |
|---|---|---|
Invalid credentials (49) | DN o password sbagliati. Spesso il DN: manca un pezzo, o hai usato cn= invece di uid= | Prova con ldapwhoami. In AD guarda il codice dopo data: 52e password, 775 bloccato, 532 scaduta, 773 da cambiare al primo accesso |
No such object (32) | La base della ricerca o il DN non esiste | Controlla -b: ou=people o ou=persone? dc=example,dc=com o dc=example,dc=lan? |
Can't contact LDAP server (-1) | Server irraggiungibile, porta chiusa, o TLS fallito | Con -d 1 ldapsearch mostra il motivo. Quasi sempre è il certificato (sotto) |
TLS: hostname does not match / certificate verify failed | Il nome usato non è nel certificato, o il client non conosce la CA | Usa il nome scritto nel certificato, non l'IP. CA in /etc/ldap/ldap.conf (TLS_CACERT) o tra le radici del sistema |
Confidentiality required (13) / Strong(er) authentication required (8) | Il server rifiuta i bind senza TLS (in AD: firma obbligatoria) | LDAPS o StartTLS |
Insufficient access (50) | L'account non ha il permesso di leggere o scrivere quella voce | ACL di OpenLDAP o gruppo lldap_strict_readonly / lldap_password_manager |
Object class violation (65) | Manca un attributo obbligatorio, o ne hai messo uno non permesso dalle objectClass | Esempio classico: groupOfNames senza nessun member |
Size limit exceeded (4) | Troppi risultati per una sola risposta (in AD 1000) | Ricerca paginata (-E pr=500/noprompt) o un filtro più stretto |
| Il login funziona, ma l'utente non ha i gruppi | memberOf non c'è (overlay non attivo, o gruppi creati prima) o l'applicazione legge un tipo di gruppo diverso | ldapsearch … memberOf sull'utente. Se è vuoto, il problema è nel server, non nell'applicazione |
Linux: getent passwd non trova l'utente | SSSD non parte (permessi di sssd.conf), base sbagliata, utente senza posixAccount | journalctl -u sssd, sss_cache -E, e la stessa ricerca con ldapsearch |
AD: Clock skew too great | Orologio del server oltre 5 minuti dal controller | NTP verso il dominio |
Da dove continuare
Una directory si costruisce in un pomeriggio e si usa per dieci anni. Il pomeriggio vale la pena.
🗺️ Un percorso in quattro tappe
- Oggi: conta servizi e account. Se le stesse persone hanno più di tre password per cose tue, ti serve una directory.
- Questa settimana: lldap in un container, tre rami, i gruppi, un account di servizio in sola lettura, e un'applicazione collegata.
- Poi: LDAPS con un certificato vero, le altre applicazioni una alla volta, filtro di accesso per gruppo.
- Dopo: Authentik o Keycloak sopra la directory per il login web con 2FA; SSSD sui server Linux, o FreeIPA se sono tanti.
| Risorsa | Cos'è |
|---|---|
| github.com/lldap/lldap | lldap, con gli esempi di configurazione per decine di applicazioni |
| openldap.org/doc/admin26 | La guida dell'amministratore di OpenLDAP |
| sssd.io | Documentazione di SSSD, con le pagine di risoluzione dei problemi |
| freeipa.org | FreeIPA, per reti di server Linux |
| ldap.com | Spiegazioni chiare di filtri, codici di errore e protocollo |
| RFC 4510-4519 | LDAPv3: protocollo, filtri, DN, schema |
| Certificati · Linux Admin · Docker per Svogliati | Le guide da leggere insieme a questa |
ldapsearch, con lo stesso account di servizio, la stessa base e lo stesso filtro. Se funziona a mano, il problema è nell'applicazione. Se non funziona, non perdere tempo con l'applicazione.