Ce que fait LLDAP
LLDAP est un serveur d'annuaire libre écrit en Rust. Il stocke les utilisateurs et les groupes dans une base SQLite, les présente aux applications par le protocole LDAP, et offre aux administrateurs une interface web pour les gérer. Il ne cherche pas à tout faire : pas de schéma à écrire, pas de réplication, pas d'ACL fines. Il fait ce dont Authelia, Gitea, Nextcloud, Keycloak ou Jellyfin ont besoin — vérifier un mot de passe, lister les membres d'un groupe — et rien de plus.
Ce que LLDAP vous donne
- Un compte par personne — le même identifiant et le même mot de passe dans toutes vos applications.
- Un départ géré en un clic — désactivez le compte dans LLDAP, l'accès se ferme partout.
- Des groupes qui ouvrent les accès — un groupe par application, et chaque application ne laisse entrer que ses membres.
- Une interface web — créer, modifier et ranger les comptes sans jamais écrire un fichier LDIF.
- La réinitialisation en libre-service — chaque utilisateur change son mot de passe par e-mail.
- Une empreinte minuscule — quelques mégaoctets de mémoire, à côté des applications qu'il sert.
Comptes locaux, OpenLDAP ou LLDAP
Faites défiler le tableau
| Comptes locaux par application | OpenLDAP | LLDAP | |
|---|---|---|---|
| Comptes à gérer | Un par application | Un par personne | Un par personne |
| Administration | Dans chaque application | Fichiers LDIF et ligne de commande | Interface web |
| Mise en route | Aucune | Schémas et ACL à écrire | Un conteneur et quatre variables |
| Mémoire au repos | — | Quelques dizaines de Mo | Quelques Mo |
| Départ d'un collaborateur | Compte à fermer partout | Un seul compte | Un seul compte |
Préparer le serveur
Un VPS Ubuntu 24.04 avec 1 Go de RAM suffit largement : LLDAP occupe quelques mégaoctets, et il partagera le plus souvent la machine avec les applications qu'il sert. Installez Docker et le plugin Compose, et prévoyez un sous-domaine, par exemple ldap.example.com, pointé vers le VPS : l'interface d'administration doit être servie en HTTPS, puisque les mots de passe y transitent. Le port LDAP, lui, ne sera jamais publié sur Internet.
Installer LLDAP avec Docker Compose
Préparer le dossier et le fichier .env
Trois secrets : le mot de passe du compte
admin, la clé qui signe les sessions de l'interface et la graine de la clé privée du serveur.mkdir -p /opt/lldap && cd /opt/lldap cat > .env <<EOF ADMIN_PASSWORD=$(openssl rand -hex 16) JWT_SECRET=$(openssl rand -hex 32) KEY_SEED=$(openssl rand -hex 32) EOF chmod 600 .envÉcrire le fichier docker-compose.yml
Un seul service. Les deux ports ne sont publiés que sur la boucle locale : l'interface web (17170) passera par nginx, et le port LDAP (3890) reste réservé au VPS. Remplacez
dc=example,dc=compar la base de votre choix, par exempledc=votre-entreprise,dc=ma.services: lldap: image: lldap/lldap:v0.6.3-alpine restart: unless-stopped ports: - "127.0.0.1:17170:17170" - "127.0.0.1:3890:3890" environment: TZ: UTC LLDAP_LDAP_BASE_DN: "dc=example,dc=com" LLDAP_LDAP_USER_PASS: ${ADMIN_PASSWORD} LLDAP_JWT_SECRET: ${JWT_SECRET} LLDAP_KEY_SEED: ${KEY_SEED} LLDAP_HTTP_URL: "https://ldap.example.com" volumes: - lldap-data:/data networks: - lldap networks: lldap: name: lldap volumes: lldap-data: {}Démarrer et vérifier
Au premier démarrage, LLDAP crée ses groupes système et le compte
adminavec le mot de passe du fichier.env. Il répond en quelques secondes.docker compose up -d docker compose logs lldap | grep -i admin curl -sI http://127.0.0.1:17170/ | head -n 1Tester l'annuaire en LDAP
Le réseau Docker
lldappermet à un conteneur de joindre l'annuaire par son nom.ldapwhoamidoit répondre avec le DN du compte admin.docker run --rm --network lldap alpine:3.20 sh -c \ "apk add -q openldap-clients && ldapwhoami -x -H ldap://lldap:3890 \ -D uid=admin,ou=people,dc=example,dc=com -W"
Changez le mot de passe admin et gardez le port LDAP privé
Le mot de passe de LLDAP_LDAP_USER_PASS n'est utilisé qu'au premier démarrage : changez-le ensuite dans l'interface, il ne sera plus écrasé. Et ne publiez jamais le port 3890 sur 0.0.0.0 : LDAP sans TLS transporte les mots de passe en clair, et vos applications n'ont aucun besoin de le joindre depuis Internet.
Publier l'interface en HTTPS derrière nginx
Obtenez un certificat avec certbot (certbot certonly --nginx -d ldap.example.com), puis déclarez un server block qui transmet au port local 17170. Pensez à mettre la même adresse dans LLDAP_HTTP_URL : c'est elle qu'utilisent les liens de réinitialisation de mot de passe.
server {
listen 443 ssl;
server_name ldap.example.com;
ssl_certificate /etc/letsencrypt/live/ldap.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/ldap.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:17170;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}
}Brancher vos applications sur l'annuaire
Créez d'abord, pour chaque application, un compte de service (par exemple svc-gitea) et placez-le dans le groupe lldap_strict_readonly : il pourra lire l'annuaire sans rien modifier. Raccordez ensuite le conteneur de l'application au réseau lldap, et renseignez l'annuaire dans ses réglages d'authentification :
docker network connect lldap gitea
# URL du serveur : ldap://lldap:3890
# Bind DN : uid=svc-gitea,ou=people,dc=example,dc=com
# Base des users : ou=people,dc=example,dc=com
# Filtre : (&(objectClass=person)(uid=%s))Le même schéma vaut pour Nextcloud (application LDAP user and group backend), Authelia (authentication_backend.ldap avec l'implémentation lldap) ou Keycloak (fédération d'utilisateurs LDAP). Pour ne laisser entrer que certains utilisateurs, ajoutez au filtre une condition memberOf sur le groupe de l'application.
Activer la réinitialisation des mots de passe par e-mail
Sans serveur SMTP, seul l'administrateur peut changer un mot de passe oublié. Ajoutez les variables suivantes au service lldap, avec un compte d'envoi de votre messagerie, puis relancez docker compose up -d : le lien « Mot de passe oublié » apparaît sur l'écran de connexion, et l'e-mail envoyé pointe vers l'adresse de LLDAP_HTTP_URL.
environment:
LLDAP_SMTP_OPTIONS__ENABLE_PASSWORD_RESET: "true"
LLDAP_SMTP_OPTIONS__SERVER: smtp.example.com
LLDAP_SMTP_OPTIONS__PORT: "587"
LLDAP_SMTP_OPTIONS__SMTP_ENCRYPTION: STARTTLS
LLDAP_SMTP_OPTIONS__USER: [email protected]
LLDAP_SMTP_OPTIONS__PASSWORD: ${SMTP_PASSWORD}
LLDAP_SMTP_OPTIONS__FROM: "LLDAP <[email protected]>"Testez avec un compte ordinaire avant d'annoncer la fonction à l'équipe : un lien qui pointe vers localhost signale une adresse publique mal déclarée.
Exemple : Authelia adossé à LLDAP
Authelia connaît LLDAP et propose une implémentation dédiée, qui règle d'office les filtres et les attributs. Le compte de service svc-authelia doit appartenir au groupe lldap_password_manager si vous voulez que les utilisateurs changent leur mot de passe depuis Authelia ; sinon, lldap_strict_readonly suffit.
authentication_backend:
ldap:
implementation: lldap
address: ldap://lldap:3890
base_dn: dc=example,dc=com
user: uid=svc-authelia,ou=people,dc=example,dc=com
password: '<mot-de-passe-du-compte-de-service>'Raccordez enfin le conteneur d'Authelia au réseau lldap, redémarrez-le, et connectez-vous avec un compte créé dans LLDAP : la même identité ouvre désormais toutes les applications protégées par Authelia.
Sauvegarde et mise à jour
Tout l'état de LLDAP tient dans le volume lldap-data : la base SQLite, la configuration et la clé privée du serveur. Une archive du volume, LLDAP arrêté quelques secondes, suffit à tout restaurer.
cd /opt/lldap
docker compose stop lldap
docker run --rm -v lldap_lldap-data:/data -v "$PWD":/backup alpine:3.20 \
tar czf /backup/lldap-$(date +%F).tar.gz -C /data .
docker compose start lldapPour mettre à jour, changez le tag de l'image dans docker-compose.yml, lisez les notes de version, puis lancez docker compose pull && docker compose up -d : LLDAP migre sa base au démarrage.
LLDAP en un clic sur ServOrbit
Le Marketplace ServOrbit installe exactement cette pile : image officielle lldap/lldap, secrets tirés à l'installation, compte admin créé avec un mot de passe généré, interface web publiée en HTTPS sur un sous-domaine de votre domaine ou sur le sous-domaine gratuit du VPS, et port LDAP gardé sur la boucle locale. Le mot de passe s'affiche dans votre espace client ; il ne vous reste qu'à créer vos utilisateurs et à brancher vos applications.
servorbit.com/ma-fr/blog/self-host-lldap-vps
