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ón | OpenLDAP | LLDAP | |
|---|---|---|---|
| Cuentas que gestionar | Una por aplicación | Una por persona | Una por persona |
| Administración | En cada aplicación | Archivos LDIF y línea de comandos | Interfaz web |
| Puesta en marcha | Ninguna | Esquemas y ACL que escribir | Un contenedor y cuatro variables |
| Memoria en reposo | — | Algunas decenas de MB | Unos pocos MB |
| Cuando alguien se va | Cuenta que cerrar en todas partes | Una sola cuenta | Una 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
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 .envEscribir 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=compor la base que prefiera, por ejemplodc=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: {}Arrancar y comprobar
En el primer arranque, LLDAP crea sus grupos de sistema y la cuenta
admincon 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 1Probar el directorio por LDAP
La red Docker
lldappermite a un contenedor alcanzar el directorio por su nombre.ldapwhoamidebe 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 lldapPara 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.
servorbit.com/ma-es/blog/autoalojar-lldap-vps-directorio-ldap
