Self-hosting

LLDAP sur VPS : un annuaire LDAP léger pour vos applications

Chaque application auto-hébergée arrive avec sa propre liste d'utilisateurs : un compte Gitea, un compte Nextcloud, un compte Grafana, et autant de mots de passe à fermer le jour où quelqu'un quitte l'équipe. Un annuaire LDAP règle ce problème depuis vingt ans, mais OpenLDAP fait reculer la plupart des petites équipes. LLDAP en garde l'essentiel dans un seul conteneur léger. Ce guide l'installe sur un VPS avec Docker Compose, publie son interface en HTTPS derrière nginx, garde le port LDAP privé et y raccorde vos applications.

Déployer sur un VPS Cloud →
7 min de lecture4 étapes

Orbi agent IALe sommaire suit l’article ; les articles liés vous attendent en bas de page.

Sommaire· Ce que fait LLDAP1/12
  1. 01Ce que fait LLDAP
  2. 02Ce que LLDAP vous donne
  3. 03Comptes locaux, OpenLDAP ou LLDAP
  4. 04Préparer le serveur
  5. 05Installer LLDAP avec Docker Compose
  6. 06Changez le mot de passe admin et gardez le port LDAP privé
  7. 07Publier l'interface en HTTPS derrière nginx
  8. 08Brancher vos applications sur l'annuaire
  9. 09Activer la réinitialisation des mots de passe par e-mail
  10. 10Exemple : Authelia adossé à LLDAP
  11. 11Sauvegarde et mise à jour
  12. 12LLDAP en un clic sur ServOrbit

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 applicationOpenLDAPLLDAP
Comptes à gérerUn par applicationUn par personneUn par personne
AdministrationDans chaque applicationFichiers LDIF et ligne de commandeInterface web
Mise en routeAucuneSchémas et ACL à écrireUn conteneur et quatre variables
Mémoire au repos—Quelques dizaines de MoQuelques Mo
Départ d'un collaborateurCompte à fermer partoutUn seul compteUn 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

  1. 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
  2. É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=com par la base de votre choix, par exemple dc=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: {}
  3. Démarrer et vérifier

    Au premier démarrage, LLDAP crée ses groupes système et le compte admin avec 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 1
  4. Tester l'annuaire en LDAP

    Le réseau Docker lldap permet à un conteneur de joindre l'annuaire par son nom. ldapwhoami doit 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 lldap

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

Partager cet articleservorbit.com/ma-fr/blog/self-host-lldap-vps

Un annuaire unique pour vos applications

Prix HT affichés avec leur renouvellement.