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

106 lines
6.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`).
```bash
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:
```bash
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
```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 | 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.