PKR-Lab

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 (Docs d0073, d0074 und 40070
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)

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:

(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
E-Mail [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)"

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.