# 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__docker_compose` | ## 1. authentik vorbereiten 1. **Gruppen** anlegen (Verzeichnis *Gruppen*): - `server__ssh_access` (Login auf dem Server erlaubt) - `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:** Der Outpost liefert LDAPS auf 636. Für ein vertrauenswürdiges Zertifikat dem Outpost ein Zertifikat zuweisen (Provider → *TLS Server name* / Zertifikat) und die CA auf dem SSH-Server hinterlegen (`--ca-cert`). Hat der Outpost kein Zertifikat (LDAPS/StartTLS nicht verfügbar), geht das Setup mit `--ldap-uri ldap://… --no-tls`. Dabei laufen Bind-Passwort und Anmeldedaten unverschlüsselt – nur in einem vertrauenswürdigen Netz (z. B. Docker-Netz/Loopback) verwenden. Mit `ldap://` ohne `--no-tls` nutzt SSSD StartTLS. 6. **User-Attribute** (setzt `create-deploy-user.py` für Deploy-User automatisch): - `homeDirectory`: Home-Verzeichnis, Standard `/home/` - `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, Netzwerkzugang zum Outpost auf Port 636. ```bash sudo ./setup-sshd-ldap.sh \ --ldap-uri ldaps://ldap.example.org:636 \ --base-dn dc=ldap,dc=goauthentik,dc=io \ --bind-dn cn=ldapsvc,ou=users,dc=ldap,dc=goauthentik,dc=io \ --server H1 \ --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) mit Zugriffsfilter `(memberOf=cn=server__ssh_access,ou=groups,)` – nur Gruppenmitglieder dürfen sich per LDAP anmelden - 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=`) und `/etc/sudoers.d/docker-deploy` (`%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 ```bash ./check-sshd-ldap.sh [server] ssh @ ``` Typische Fehler: | Symptom | Ursache / Lösung | |---|---| | `getent passwd ` 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 | Nicht in `server__ssh_access` (SSSD-Access-Filter) | | 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 ` 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 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__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 -W -b "(cn=)"` verifizieren.