Autoalojamiento

LLDAP en un VPS: un directorio LDAP ligero para sus apps

Cada aplicación autoalojada llega con su propia lista de usuarios: una cuenta en Gitea, otra en Nextcloud, otra en Grafana, y otras tantas contraseñas que revocar el día que alguien deja el equipo. Un directorio LDAP resuelve este problema desde hace veinte años, pero OpenLDAP echa para atrás a la mayoría de los equipos pequeños. LLDAP conserva lo esencial en un solo contenedor ligero. Esta guía lo instala en un VPS con Docker Compose, publica su interfaz en HTTPS detrás de nginx, mantiene privado el puerto LDAP y conecta sus aplicaciones.

Desplegar en un VPS Cloud →
7 min de lectura4 pasos

Orbi agente IAEl índice sigue al artículo; los artículos relacionados le esperan al final.

Contenido· Qué hace LLDAP1/12
  1. 01Qué hace LLDAP
  2. 02Lo que le aporta LLDAP
  3. 03Cuentas locales, OpenLDAP o LLDAP
  4. 04Preparar el servidor
  5. 05Instalar LLDAP con Docker Compose
  6. 06Cambie la contraseña de admin y mantenga privado el puerto LDAP
  7. 07Publicar la interfaz en HTTPS detrás de nginx
  8. 08Conectar sus aplicaciones al directorio
  9. 09Activar el restablecimiento de contraseñas por correo
  10. 10Ejemplo: Authelia apoyado en LLDAP
  11. 11Copia de seguridad y actualización
  12. 12LLDAP en un clic en ServOrbit

Qué hace LLDAP

LLDAP es un servidor de directorio libre escrito en Rust. Guarda los usuarios y los grupos en una base SQLite, los presenta a las aplicaciones mediante el protocolo LDAP y ofrece a los administradores una interfaz web para gestionarlos. No pretende hacerlo todo: ningún esquema que escribir, sin replicación, sin ACL detalladas. Hace lo que necesitan Authelia, Gitea, Nextcloud, Keycloak o Jellyfin — comprobar una contraseña, listar los miembros de un grupo — y nada más.

Lo que le aporta LLDAP

  • Una cuenta por persona — el mismo usuario y la misma contraseña en todas sus aplicaciones.
  • Una baja en un clic — desactive la cuenta en LLDAP y el acceso se cierra en todas partes.
  • Grupos que abren el acceso — un grupo por aplicación, y cada aplicación solo deja entrar a sus miembros.
  • Una interfaz web — cree, edite y organice cuentas sin escribir nunca un archivo LDIF.
  • Restablecimiento autónomo — cada usuario cambia su contraseña por correo.
  • Una huella mínima — unos pocos megabytes de memoria, junto a las aplicaciones a las que sirve.

Cuentas locales, OpenLDAP o LLDAP

Desplace la tabla

Cuentas locales por aplicaciónOpenLDAPLLDAP
Cuentas que gestionarUna por aplicaciónUna por personaUna por persona
AdministraciónEn cada aplicaciónArchivos LDIF y línea de comandosInterfaz web
Puesta en marchaNingunaEsquemas y ACL que escribirUn contenedor y cuatro variables
Memoria en reposo—Algunas decenas de MBUnos pocos MB
Cuando alguien se vaCuenta que cerrar en todas partesUna sola cuentaUna sola cuenta

Preparar el servidor

Un VPS Ubuntu 24.04 con 1 GB de RAM es más que suficiente: LLDAP ocupa unos pocos megabytes, y casi siempre compartirá la máquina con las aplicaciones a las que sirve. Instale Docker y el plugin Compose, y prepare un subdominio como ldap.example.com que apunte al VPS: la interfaz de administración debe servirse en HTTPS, porque por ella pasan las contraseñas. El puerto LDAP, en cambio, nunca se publicará en Internet.

Instalar LLDAP con Docker Compose

  1. Preparar la carpeta y el archivo .env

    Tres secretos: la contraseña de la cuenta admin, la clave que firma las sesiones de la interfaz y la semilla de la clave privada del servidor.

    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. Escribir el archivo docker-compose.yml

    Un solo servicio. Los dos puertos solo se publican en la interfaz local: la interfaz web (17170) pasará por nginx, y el puerto LDAP (3890) queda reservado al VPS. Sustituya dc=example,dc=com por la base que prefiera, por ejemplo dc=suempresa,dc=es.

    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. Arrancar y comprobar

    En el primer arranque, LLDAP crea sus grupos de sistema y la cuenta admin con la contraseña del archivo .env. Responde en pocos segundos.

    docker compose up -d
    docker compose logs lldap | grep -i admin
    curl -sI http://127.0.0.1:17170/ | head -n 1
  4. Probar el directorio por LDAP

    La red Docker lldap permite a un contenedor alcanzar el directorio por su nombre. ldapwhoami debe responder con el DN de la cuenta 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"

Cambie la contraseña de admin y mantenga privado el puerto LDAP

La contraseña de LLDAP_LDAP_USER_PASS solo se usa en el primer arranque: cámbiela después en la interfaz y ya no se sobrescribirá. Y nunca publique el puerto 3890 en 0.0.0.0: LDAP sin TLS transporta las contraseñas en claro, y sus aplicaciones no necesitan alcanzarlo desde Internet.

Publicar la interfaz en HTTPS detrás de nginx

Obtenga un certificado con certbot (certbot certonly --nginx -d ldap.example.com) y declare un bloque server que reenvíe al puerto local 17170. Ponga la misma dirección en LLDAP_HTTP_URL: la usan los enlaces de restablecimiento de contraseña.

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;
    }
}

Conectar sus aplicaciones al directorio

Cree primero, para cada aplicación, una cuenta de servicio (por ejemplo svc-gitea) y colóquela en el grupo lldap_strict_readonly: podrá leer el directorio sin modificar nada. Después conecte el contenedor de la aplicación a la red lldap e indique el directorio en sus ajustes de autenticación:

docker network connect lldap gitea
# Server URL     : ldap://lldap:3890
# Bind DN        : uid=svc-gitea,ou=people,dc=example,dc=com
# User base      : ou=people,dc=example,dc=com
# Filter         : (&(objectClass=person)(uid=%s))

El mismo esquema sirve para Nextcloud (la aplicación LDAP user and group backend), Authelia (authentication_backend.ldap con la implementación lldap) o Keycloak (federación de usuarios LDAP). Para dejar entrar solo a algunos usuarios, añada al filtro una condición memberOf sobre el grupo de la aplicación.

Activar el restablecimiento de contraseñas por correo

Sin servidor SMTP, solo el administrador puede cambiar una contraseña olvidada. Añada las siguientes variables al servicio lldap, con una cuenta de envío de su correo, y vuelva a ejecutar docker compose up -d: el enlace «¿Olvidó su contraseña?» aparece en la pantalla de inicio de sesión, y el correo enviado apunta a la dirección 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]>"

Pruebe con una cuenta normal antes de anunciar la función al equipo: un enlace que apunta a localhost indica que la dirección pública no se declaró bien.

Ejemplo: Authelia apoyado en LLDAP

Authelia conoce LLDAP y ofrece una implementación dedicada que ajusta por usted los filtros y los atributos. La cuenta de servicio svc-authelia debe pertenecer al grupo lldap_password_manager si quiere que los usuarios cambien su contraseña desde Authelia; si no, basta con lldap_strict_readonly.

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: '<service-account-password>'

Por último, conecte el contenedor de Authelia a la red lldap, reinícielo e inicie sesión con una cuenta creada en LLDAP: la misma identidad abre ahora todas las aplicaciones protegidas por Authelia.

Copia de seguridad y actualización

Todo el estado de LLDAP vive en el volumen lldap-data: la base SQLite, la configuración y la clave privada del servidor. Un archivo del volumen, con LLDAP detenido unos segundos, basta para restaurarlo todo.

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

Para actualizar, cambie la etiqueta de la imagen en docker-compose.yml, lea las notas de la versión y ejecute docker compose pull && docker compose up -d: LLDAP migra su base al arrancar.

LLDAP en un clic en ServOrbit

El Marketplace de ServOrbit instala exactamente esta pila: la imagen oficial lldap/lldap, secretos generados en la instalación, una cuenta admin creada con una contraseña generada, la interfaz web publicada en HTTPS en un subdominio de su dominio o en el subdominio gratuito del VPS, y el puerto LDAP en la interfaz local. La contraseña aparece en su área de cliente; solo le queda crear sus usuarios y conectar sus aplicaciones.

Compartir este artículoservorbit.com/ma-es/blog/autoalojar-lldap-vps-directorio-ldap

Un único directorio para sus aplicaciones

Precios sin IVA, mostrados con su precio de renovación.