d0072 - lldap — Nutzer-/Gruppenverwaltung
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/d-sicherheit/d0072-lldap.md
lldap — Nutzer-/Gruppenverwaltung
lldap ist ein leichtgewichtiger
LDAP-Server (SQLite, ein Container, eigene Web-UI). Er war die Nutzerquelle
für Authentik (ursprünglich für Authelia aufgesetzt).
Stand Oktober 2026: Authentik ist aus dem Repo entfernt, lldap läuft
ohne angebundenen Dienst weiter. Die Abschnitte unten beschreiben das
frühere Setup mit Authentik als Konsument (Docsd0073,d0074und40070
sind gelöscht und nur noch in der Git-Historie) und bleiben als Referenz für
einen späteren Anschluss eines anderen Dienstes stehen.
Architektur
Authentik ──▶ lldap (ldap://lldap.lldap.svc.cluster.local:3890)
│
Bind als "authentik-bind" (lldap_strict_readonly)
Du ──▶ https://lldap.tech.homeserver (Web-UI, Port 17170, Tailscale/LAN-only)
- SQLite (
local-path-PVC, 1 Gi), kein externer DB-Server. - Zwei Ports:
3890(LDAP, nur cluster-intern, kein Ingress) und17170
(Web-UI, per Ingress erreichbar). - Base DN:
dc=homeserver(frei gewählt, keine echte Domain nötig). - Der eingebaute lldap-Superuser heißt nicht
admin, sondern
lldap-root(LLDAP_LDAP_USER_DN) — bewusst umbenannt, damit er
nicht mit dem App-seitigenadmin-Identität (Authelia-Fallback-Login)
kollidiert. Getrennte Accounts für getrennte Zwecke:lldap-root
verwaltet lldap selbst,administ nur ein regulärer App-Nutzer. - Kein SMTP-Relay — Passwort-Reset läuft ausschließlich manuell über die
Web-UI (lldap-rootkann jedes Nutzerpasswort direkt setzen).
1. Secrets (bereits erledigt)
Erzeugt am 22.08.2026 per openssl rand und mit
kubeseal --raw --namespace lldap --name lldap-secrets versiegelt
(argocd/apps/tech/lldap/templates/sealedsecret.yaml):
| Key | Zweck |
|---|---|
jwt-secret |
signiert lldaps eigene Web-UI-Sessions |
key-seed |
leitet den Schlüssel für den Passwort-Storage ab — einmalig, niemals rotieren (macht sonst alle gesetzten Passwörter ungültig) |
root-password |
Login für lldap-root (Web-UI-Superuser) |
bind-password |
Passwort für den (im Zuge der Authentik-Ablösung zu löschenden) Service-Account authelia-bind — bleibt bis zur manuellen Löschung des Accounts stehen |
authentik-bind-password |
Passwort für den Service-Account authentik-bind — identischer Wert zusätzlich als ldap-bind-password im authentik-credentials-SealedSecret (Authentik liest sein eigenes Namespace-Secret, kann nicht direkt auf lldaps Secret zugreifen) |
Das lldap-root-Passwort wurde einmalig im Chat mitgeteilt (analog zum
initialen Authelia-Admin-Passwort beim Pilot) — sofort nach dem ersten
Login über die Web-UI ändern.
2. Manuelles Setup über die Web-UI
Bewusst kein deklarativer Bootstrap-Job (siehe Rückfrage/Entscheidung
in 40000-authelia-sso.md) — lldaps
bootstrap.sh bräuchte einen root-laufenden Einmal-Job mit curl/jq/jo,
das ist für 5 Nutzer mehr Infrastruktur als nötig. Stattdessen: einmaliges
manuelles Setup, gleiches Muster wie der "Erster Start" bei Uptime
Kuma/Vaultwarden in diesem Repo.
2.1 Login
https://lldap.tech.homeserver öffnen, mit lldap-root + dem mitgeteilten
Passwort einloggen.
2.2 Gruppen anlegen
Group Management → Create a group, zwei neue Gruppen:
admins— Vollzugriff mit 2FA (aktuell:pke)dlrg-einsatz— ursprünglich für Grafana-Zugriff gedacht, seit 22.08.2026
ohne aktive Zugriffsregel (Grafana bewusst nicht hinter SSO) —
Gruppe bleibt für spätere Verwendung bestehen
(Die eingebauten Gruppen lldap_admin, lldap_password_manager,
lldap_strict_readonly sind lldap-intern — nicht anfassen, außer für
Schritt 2.3.)
2.3 Service-Account authentik-bind anlegen
User Management → Create a user:
| Feld | Wert |
|---|---|
| User ID | authentik-bind |
[email protected] (Platzhalter, wird nie versendet) |
|
| Display Name | Authentik Bind |
Danach den Nutzer öffnen → Groups → Mitglied von
lldap_strict_readonly machen (read-only, nicht lldap_admin —
Least Privilege, gleiches Prinzip wie zuvor bei authelia-bind). Passwort
setzen: muss exakt dem authentik-bind-password-Wert aus Schritt 1
entsprechen (einmalig im Chat mitgeteilt), sonst schlägt Authentiks
LDAP-Source-Sync fehl (Symptom siehe Troubleshooting unten).
Aufräumen nach vollständig verifiziertem Rollout (letzter Schritt der
Ablösung von Authelia, Rollout-Batch 7): alten Service-Account authelia-bind löschen
(User Management → authelia-bind → Delete) und den verwaisten Key
bind-password aus argocd/apps/tech/lldap/values.yaml +
templates/sealedsecret.yaml entfernen.
2.4 Die 5 App-Identitäten anlegen
Für jede Zeile: User Management → Create a user (User-ID, E-Mail,
Display Name), danach Passwort selbst setzen (Reset password in der
Nutzeransicht, min. 8 Zeichen) und ggf. Gruppenzugehörigkeit zuweisen:
| User-ID | Gruppe | Zugriff |
|---|---|---|
admin |
— (keine Gruppe, eigene Regel/Fallback) | Fallback/Break-Glass, alles, nur intern, kein 2FA |
pke |
admins |
Vollzugriff, nur intern, 2FA Pflicht |
dlrg-einsatz-1 |
dlrg-einsatz |
aktuell keine aktive Regel (siehe oben) |
ake |
— (keine Gruppe) | Immich (intern + extern) |
rdn |
— (keine Gruppe) | Mealie (intern + extern) |
Weitere echte Personen für den DLRG-Einsatzdienst: einfach als neuer Nutzer
anlegen und der dlrg-einsatz-Gruppe hinzufügen — keine Authentik-Config
nötig, die Gruppen-Synchronisierung + Policy greift automatisch.
2.5 2FA für pke einrichten
pke braucht TOTP, weil er/sie Mitglied der admins-Gruppe ist (siehe
argocd/apps/tech/authentik/blueprints/01-admin-2fa-policy.yaml, gelöscht, nur in der Git-Historie)
— das passiert nicht in lldap, sondern beim ersten Login über Authentiks
eigenes Portal (https://authentik.tech.homeserver, QR-Code-Enrollment).
3. Verifikation
# LDAP-Bind manuell testen (Werkzeug: ldapsearch)
ldapsearch -x -H ldap://lldap.tech.homeserver:3890 \
-D "uid=authentik-bind,ou=people,dc=homeserver" -w '<authentik-bind-password>' \
-b "dc=homeserver" "(uid=pke)"
kubectl -n authentik logs deploy/authentik-server -c server | grep -i ldap
— bei Startup/Sync sollte kein LDAP-Fehler erscheinen.- Login-Test je Identität über das jeweils zugewiesene App-Frontend (siehe die Access-Control-Tabelle in
d0073, nur in der Git-Historie). - Negativ-Test:
akedarf nicht auf Mealie kommen,rdnnicht auf
Immich usw. — jede Policy erlaubt nur die explizit zugewiesene Identität.
Troubleshooting
| Symptom | Ursache |
|---|---|
Authentik-Login schlägt für ALLE Nutzer fehl, kubectl -n authentik logs deploy/authentik-worker -c worker zeigt LDAP-Fehler |
ldap-bind-password in authentik-credentials stimmt nicht mit dem tatsächlich in lldap gesetzten Passwort für authentik-bind überein — in der Web-UI neu setzen und beide Secrets synchron halten (authentik-bind-password in lldap-secrets UND ldap-bind-password in authentik-credentials). |
| Ein Nutzer kommt trotz korrektem Passwort nicht rein | Gruppenzugehörigkeit prüfen (Web-UI → User → Groups) — default_policy: deny heißt: keine passende access_control-Regel = kein Zugriff, unabhängig vom korrekten Login. |
| lldap-Pod crasht beim Start | /data-PVC-Berechtigungen — Image startet bewusst als root und droppt selbst per gosu auf UID/GID 1000 (siehe values.yaml-Kommentar); mit erzwungenem runAsNonRoot scheitert der chown-Schritt. |
lldap-root-Passwort vergessen |
force_ldap_user_pass_reset in der Config auf true setzen (Redeploy erzwingt Reset auf den Wert aus LLDAP_LDAP_USER_PASS), danach wieder zurücksetzen. |