Doku und Skripte: authentik-LDAP-Outpost mit sshd (SSSD), Self-only-Check in docker-deploy.sh

This commit is contained in:
Jochen Mehlich committed 2026-10-24 10:15:01 +02:00
1 parent f34ddf31de
commit d672afe22c
4 files changed
+326

No files matched your search

+99
View File
@@ -0,0 +1,99 @@
# 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:** 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`). Klartext-LDAP wird vom Setup-Skript abgelehnt.
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, 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_<SERVER>_ssh_access,ou=groups,<BASE_DN>)` – 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=<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
```bash
./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 | Nicht in `server_<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 <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.