Files
admin-toolsuite/docs/authentik-ldap-sshd.md
T

6.6 KiB
Raw Blame History

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

  1. Gruppen anlegen (Verzeichnis Gruppen):
    • server_<SERVER>_ssh_access (Login auf dem Server erlaubt)
    • server_<SERVER>_docker_compose (darf docker-deploy.sh nutzen)
    • Server-Standard ist H1.
  2. Bind-Account für SSSD: Service-Account ldapsvc anlegen (Verzeichnis → User → Service-Account), Token/Passwort notieren. Eine Gruppe ldap-search anlegen, den Account hinzufügen und dieser Gruppe die Berechtigung Search full LDAP directory geben. Ohne diese Berechtigung sieht SSSD keine Gruppen.
  3. 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)
  4. Application zum Provider anlegen, dann einen LDAP-Outpost erstellen und die Application zuweisen.
  5. 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:636 oder --starttls (bei ldap://) verwenden.
  6. User-Attribute (setzt create-deploy-user.py für Deploy-User automatisch):
    • homeDirectory: Home-Verzeichnis, Standard /home/<username>
    • notes: Link zum Gitea-Repo
    • sshPublicKey (optional): öffentlicher SSH-Schlüssel für Key-Login
    • uidNumber/gidNumber berechnet 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, Objektklassen user/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_access wird nicht mehr von SSSD geprüft
  • ergänzt sss in /etc/nsswitch.conf und aktiviert pam_sss sowie pam_mkhomedir (Home wird beim ersten Login angelegt; /etc/skel/deployment legt 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

  1. create-deploy-user.py --project-path owner/repo [--server H1] legt User und Gruppen an und setzt deploy_user/deploy_pass im Gitea-Repo.
  2. Die CI meldet sich per SSH als Deploy-User an, lädt docker-compose.yml nach ~/deployment/ und ruft sudo docker-deploy.sh <username> deploy auf.

Sicherheitshinweise

  • Bind-Passwort steht in /etc/sssd/sssd.conf (0600, root) – für den Bind-Account nur minimale Rechte vergeben.
  • Wer docker compose als root aus einem User-Verzeichnis ausführen lässt, gibt dem User faktisch root-Rechte (Compose-Datei kann beliebige Mounts definieren). Die Gruppe server_<SERVER>_docker_compose nur 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 mit ldapsearch -H ldaps://… -D <bind-dn> -W -b <base-dn> "(cn=<user>)" verifizieren.