6.6 KiB
authentik-LDAP-Outpost ↔ sshd
Anmeldung per SSH gegen authentik: sshd → PAM/NSS → SSSD → LDAP-Outpost (LDAPS) → authentik.
Die Deploy-User aus create-deploy-user.py (Service-Accounts) melden sich mit ihrem
App-Passwort an, normale User per Passwort oder SSH-Key.
Client ──ssh──▶ sshd ──PAM/NSS──▶ SSSD ──ldaps:636──▶ LDAP-Outpost ──API──▶ authentik
│ (Bind: Service-Account)
└─ AuthorizedKeysCommand: sss_ssh_authorizedkeys
| Baustein | Aufgabe |
|---|---|
setup-sshd-ldap.sh |
Konfiguriert SSSD, NSS, PAM, sshd, docker-deploy.sh-Gruppe und sudoers |
check-sshd-ldap.sh |
Diagnose der gesamten Kette |
create-deploy-user.py |
Legt Deploy-User + Gruppenmitgliedschaften in authentik an |
docker-deploy.sh |
Deployt per sudo; Berechtigung über server_<SERVER>_docker_compose |
1. authentik vorbereiten
- Gruppen anlegen (Verzeichnis Gruppen):
server_<SERVER>_ssh_access(Login auf dem Server erlaubt)server_<SERVER>_docker_compose(darfdocker-deploy.shnutzen)- Server-Standard ist
H1.
- Bind-Account für SSSD: Service-Account
ldapsvcanlegen (Verzeichnis → User → Service-Account), Token/Passwort notieren. Eine Gruppeldap-searchanlegen, den Account hinzufügen und dieser Gruppe die Berechtigung Search full LDAP directory geben. Ohne diese Berechtigung sieht SSSD keine Gruppen. - LDAP-Provider anlegen (Anwendungen → Provider → LDAP Provider):
- Bind-Flow:
default-authentication-flow(oder ein Flow ohne MFA, wenn Service-Accounts per App-Passwort binden – MFA lässt sich per LDAP nicht beantworten) - Search-Group:
ldap-search - Base-DN: z. B.
dc=ldap,dc=goauthentik,dc=io - Bind mode / Search mode: Direct (keine Cached-Variante, damit Gruppenänderungen sofort greifen)
- Bind-Flow:
- Application zum Provider anlegen, dann einen LDAP-Outpost erstellen und die Application zuweisen.
- TLS: Standard des Setups ist Klartext-LDAP auf
ldap://127.0.0.1:389(Outpost auf demselben Host). Bind-Passwort und Anmeldedaten laufen dann unverschlüsselt – nur über Loopback oder in einem vertrauenswürdigen Netz (z. B. Docker-Netz) verwenden. Für ein anderes Netz dem Outpost ein Zertifikat zuweisen (Provider → TLS Server name / Zertifikat), die CA auf dem SSH-Server hinterlegen (--ca-cert) und--ldap-uri ldaps://host:636oder--starttls(beildap://) verwenden. - User-Attribute (setzt
create-deploy-user.pyfür Deploy-User automatisch):homeDirectory: Home-Verzeichnis, Standard/home/<username>notes: Link zum Gitea-ReposshPublicKey(optional): öffentlicher SSH-Schlüssel für Key-LoginuidNumber/gidNumberberechnet authentik selbst.
2. SSH-Server einrichten
Voraussetzung: Debian/Ubuntu, root-Zugriff, Outpost erreichbar (Standard 127.0.0.1:389).
sudo ./setup-sshd-ldap.sh
Das Skript fragt Server (Standard H1), Bind-User und Passwort ab. Beim Bind-User genügt der Username,
daraus wird cn=<user>,<base-dn>. Standards: --ldap-uri ldap://127.0.0.1:389,
--base-dn dc=ldap,dc=goauthentik,dc=io, kein TLS. Alles lässt sich per Option vorgeben:
sudo ./setup-sshd-ldap.sh --server H1 --bind-dn ldapsvc --bind-password-file /pfad
sudo ./setup-sshd-ldap.sh --ldap-uri ldaps://ldap.example.org:636 --ca-cert /pfad/zur/ca.pem
Das Skript (idempotent, sichert vorhandene sssd.conf):
- installiert
sssd,sssd-ldap,libnss-sss,libpam-sss - schreibt
/etc/sssd/sssd.conf(0600) im authentik-Schema (rfc2307bis, Objektklassenuser/group, Suche ab der Base-DN) mit Zugriffsfilter(objectClass=posixAccount)(änderbar mit--access-filter). Wer sich anmelden darf, steuert authentik (Application-Bindings, Gruppen);server_<SERVER>_ssh_accesswird nicht mehr von SSSD geprüft - ergänzt
sssin/etc/nsswitch.confund aktiviertpam_ssssowiepam_mkhomedir(Home wird beim ersten Login angelegt;/etc/skel/deploymentlegt das Deploy-Verzeichnis gleich mit an) - schreibt
/etc/ssh/sshd_config.d/50-authentik-ldap.conf(UsePAM,AuthorizedKeysCommand sss_ssh_authorizedkeys) - schreibt
/etc/docker-deploy.conf(DEPLOY_SERVER=<SERVER>) und/etc/sudoers.d/docker-deploy(%server_<SERVER>_docker_compose ALL=(root) NOPASSWD: /usr/local/bin/docker-deploy.sh; abschaltbar mit--no-sudoers)
Danach docker-deploy.sh nach /usr/local/bin/ kopieren (install -m 0755 docker-deploy.sh /usr/local/bin/).
3. Prüfen
./check-sshd-ldap.sh <username> [server]
ssh <username>@<host>
Typische Fehler:
| Symptom | Ursache / Lösung |
|---|---|
getent passwd <user> leer |
Bind-Account ohne Search full LDAP directory; falsche Base-DN; Outpost nicht erreichbar → sssctl domain-status authentik |
Gruppen fehlen in id |
Nutzer nicht in der Gruppe; ldap_group_*-Suchbasis falsch; Cache: sss_cache -E |
| Login abgelehnt trotz korrektem Passwort | User in authentik nicht freigegeben (Application-Bindings/Gruppe) oder --access-filter trifft nicht zu |
| TLS-Fehler | CA fehlt oder Hostname passt nicht zum Zertifikat (ldap_tls_reqcert = demand) |
| Key-Login klappt nicht | Attribut sshPublicKey fehlt/falsch benannt; sss_ssh_authorizedkeys <user> testen |
sudo: darf nicht für … deployen |
Gewollt: Aufrufer darf nur für sich selbst deployen (Admins als echter root) |
Debug: sssctl debug-level 6, journalctl -u sssd -u ssh -f.
4. Deploy-Ablauf
create-deploy-user.py --project-path owner/repo [--server H1]legt User und Gruppen an und setztdeploy_user/deploy_passim Gitea-Repo.- Die CI meldet sich per SSH als Deploy-User an, lädt
docker-compose.ymlnach~/deployment/und ruftsudo docker-deploy.sh <username> deployauf.
Sicherheitshinweise
- Bind-Passwort steht in
/etc/sssd/sssd.conf(0600, root) – für den Bind-Account nur minimale Rechte vergeben. - Wer
docker composeals root aus einem User-Verzeichnis ausführen lässt, gibt dem User faktisch root-Rechte (Compose-Datei kann beliebige Mounts definieren). Die Gruppeserver_<SERVER>_docker_composenur an vertrauenswürdige Projekte vergeben. - Passwort-Login ist für Service-Accounts nötig; für normale User sollte zusätzlich Key-Login bevorzugt und MFA auf einem separaten Flow gehalten werden.
- Die genauen Attributnamen (
sshPublicKey,homeDirectory,memberOf) und die Berechtigung des Search-Accounts hängen von der authentik-Version ab. Beim ersten Einsatz mitldapsearch -H ldaps://… -D <bind-dn> -W -b <base-dn> "(cn=<user>)"verifizieren.