Doku und Skripte: authentik-LDAP-Outpost mit sshd (SSSD), Self-only-Check in docker-deploy.sh
This commit is contained in:
1 parent
f34ddf31de
commit
d672afe22c
4 files changed
+326
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user