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

+37
View File
@@ -0,0 +1,37 @@
#!/usr/bin/env bash
# check-sshd-ldap.sh <username> [server]
#
# Diagnose der Kette authentik-LDAP-Outpost → SSSD → NSS/PAM → sshd.
set -uo pipefail
export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
USER_NAME="${1:-}"
SERVER="${2:-H1}"
[[ -n "$USER_NAME" ]] || { echo "Verwendung: $(basename "$0") <username> [server]" >&2; exit 1; }
fail=0
check() { # check "Beschreibung" befehl...
local desc="$1"; shift
if "$@" >/dev/null 2>&1; then printf '✅ %s\n' "$desc"; else printf '❌ %s\n' "$desc"; fail=1; fi
}
check "sssd läuft" systemctl is-active --quiet sssd
check "sssd.conf: Rechte 0600 root" test "$(stat -c '%a %u' /etc/sssd/sssd.conf)" = "600 0"
check "sshd-Konfiguration gültig" sshd -t
check "sshd: AuthorizedKeysCommand gesetzt" bash -c "sshd -T | grep -qi '^authorizedkeyscommand .*sss_ssh_authorizedkeys'"
check "NSS: passwd enthält sss" bash -c "grep -Eq '^passwd:.*\bsss\b' /etc/nsswitch.conf"
check "User '$USER_NAME' per NSS auflösbar" getent passwd "$USER_NAME"
check "Gruppe server_${SERVER}_ssh_access" bash -c "id -nG '$USER_NAME' | tr ' ' '\n' | grep -qx 'server_${SERVER}_ssh_access'"
check "Gruppe server_${SERVER}_docker_compose" bash -c "id -nG '$USER_NAME' | tr ' ' '\n' | grep -qx 'server_${SERVER}_docker_compose'"
check "SSH-Keys-Abfrage funktioniert (Aufruf)" sss_ssh_authorizedkeys "$USER_NAME"
echo
echo "── getent passwd $USER_NAME"; getent passwd "$USER_NAME" || true
echo "── id $USER_NAME"; id "$USER_NAME" 2>&1 || true
echo "── sssctl domain-status authentik"; sssctl domain-status authentik 2>&1 | head -n 15 || true
if [[ $fail -ne 0 ]]; then
echo
echo "Hinweis: Debug mit 'sssctl debug-level 6' und 'journalctl -u sssd -u ssh -f'."
fi
exit "$fail"
+4
View File
@@ -84,6 +84,10 @@ fi
[[ "$APP_USER" =~ ^[a-z_][a-z0-9_-]{0,31}$ ]] || die "Ungültiger Username: '$APP_USER'"
id "$APP_USER" &>/dev/null || die "User '$APP_USER' existiert nicht auf diesem System"
user_in_group "$APP_USER" "$DEPLOY_GROUP" || die "User '$APP_USER' ist nicht in Gruppe '$DEPLOY_GROUP'"
# Per sudo darf jeder nur für sich selbst deployen (sudoers erlaubt die ganze Gruppe)
if [[ -n "${SUDO_USER:-}" && "$SUDO_USER" != "root" && "$SUDO_USER" != "$APP_USER" ]]; then
die "'$SUDO_USER' darf nicht für '$APP_USER' deployen"
fi
in_array "$ACTION" "${ALLOWED_ACTIONS[@]}" || die "Unbekannte Aktion: '$ACTION' (erlaubt: ${ALLOWED_ACTIONS[*]})"
if $USE_CACHE && [[ "$ACTION" != "build" && "$ACTION" != "deploy" ]]; then
die "--cache ist nur bei build/deploy sinnvoll"
+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.
+186
View File
@@ -0,0 +1,186 @@
#!/usr/bin/env bash
# setup-sshd-ldap.sh
#
# Bindet sshd über SSSD an den authentik-LDAP-Outpost an (Debian/Ubuntu).
# Siehe docs/authentik-ldap-sshd.md.
#
# Verwendung:
# 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/ca.pem] [--bind-password-file /pfad]
set -Eeuo pipefail
IFS=$'\n\t'
export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
readonly SSSD_CONF="/etc/sssd/sssd.conf"
readonly SSHD_DROPIN="/etc/ssh/sshd_config.d/50-authentik-ldap.conf"
readonly SUDOERS_FILE="/etc/sudoers.d/docker-deploy"
readonly DEPLOY_CONF="/etc/docker-deploy.conf"
readonly CA_TARGET="/etc/sssd/authentik-ldap-ca.pem"
SERVER="H1"
LDAP_URI="" BASE_DN="" BIND_DN="" CA_CERT="" PW_FILE=""
INSTALL_SUDOERS=true
log() { printf '[%(%H:%M:%S)T] %s\n' -1 "$*"; }
die() { printf '❌ %s\n' "$*" >&2; exit 1; }
usage() {
cat >&2 <<EOF
Verwendung: sudo $(basename "$0") --ldap-uri URI --base-dn DN --bind-dn DN [Optionen]
Pflicht:
--ldap-uri URI z. B. ldaps://ldap.example.org:636
--base-dn DN Base-DN des Outposts (authentik-Standard: dc=ldap,dc=goauthentik,dc=io)
--bind-dn DN Bind-DN des LDAP-Service-Accounts
Optional:
--bind-password-file FILE Passwort/Token des Bind-Accounts (sonst Abfrage)
--server NAME Servername, Standard H1 -> server_H1_ssh_access / server_H1_docker_compose
--ca-cert FILE CA-Zertifikat für das LDAPS-Zertifikat des Outposts
--no-sudoers sudoers-Regel für docker-deploy.sh nicht anlegen
EOF
exit 1
}
while [[ $# -gt 0 ]]; do
case "$1" in
--ldap-uri) LDAP_URI="${2:?}"; shift 2 ;;
--base-dn) BASE_DN="${2:?}"; shift 2 ;;
--bind-dn) BIND_DN="${2:?}"; shift 2 ;;
--bind-password-file) PW_FILE="${2:?}"; shift 2 ;;
--server) SERVER="${2:?}"; shift 2 ;;
--ca-cert) CA_CERT="${2:?}"; shift 2 ;;
--no-sudoers) INSTALL_SUDOERS=false; shift ;;
-h|--help) usage ;;
*) usage ;;
esac
done
[[ $EUID -eq 0 ]] || die "Muss als root laufen"
[[ -n "$LDAP_URI" && -n "$BASE_DN" && -n "$BIND_DN" ]] || usage
[[ "$LDAP_URI" == ldaps://* ]] || die "Nur ldaps:// ist erlaubt (Passwörter dürfen nicht im Klartext übertragen werden)"
[[ "$SERVER" =~ ^[A-Za-z0-9_-]+$ ]] || die "Ungültiger Servername: '$SERVER'"
[[ -z "$CA_CERT" || -r "$CA_CERT" ]] || die "CA-Zertifikat nicht lesbar: $CA_CERT"
command -v apt-get >/dev/null || die "Nur Debian/Ubuntu (apt) unterstützt"
if [[ -n "$PW_FILE" ]]; then
[[ -r "$PW_FILE" ]] || die "Passwortdatei nicht lesbar: $PW_FILE"
BIND_PW="$(<"$PW_FILE")"
else
read -rsp "Bind-Passwort für $BIND_DN: " BIND_PW; echo
fi
[[ -n "$BIND_PW" ]] || die "Leeres Bind-Passwort"
SSH_GROUP="server_${SERVER}_ssh_access"
DOCKER_GROUP="server_${SERVER}_docker_compose"
# ── Pakete ───────────────────────────────────────────────────────────────────
log "📦 Pakete installieren"
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
sssd sssd-ldap libnss-sss libpam-sss libsss-sudo openssh-server ldap-utils >/dev/null
# ── CA ───────────────────────────────────────────────────────────────────────
TLS_CACERT_LINE="# ldap_tls_cacert: System-CA-Store"
if [[ -n "$CA_CERT" ]]; then
install -m 0644 -o root -g root "$CA_CERT" "$CA_TARGET"
TLS_CACERT_LINE="ldap_tls_cacert = $CA_TARGET"
fi
# ── SSSD ─────────────────────────────────────────────────────────────────────
log "🔧 $SSSD_CONF schreiben"
install -d -m 0711 /etc/sssd
[[ -e "$SSSD_CONF" ]] && cp -a "$SSSD_CONF" "${SSSD_CONF}.bak.$(date +%s)"
umask 077
cat >"$SSSD_CONF" <<EOF
# Verwaltet von setup-sshd-ldap.sh
[sssd]
services = nss, pam, ssh
domains = authentik
[domain/authentik]
id_provider = ldap
auth_provider = ldap
chpass_provider = none
access_provider = ldap
ldap_uri = $LDAP_URI
ldap_search_base = $BASE_DN
ldap_default_bind_dn = $BIND_DN
ldap_default_authtok_type = password
ldap_default_authtok = $BIND_PW
ldap_tls_reqcert = demand
$TLS_CACERT_LINE
ldap_schema = rfc2307
ldap_user_search_base = ou=users,$BASE_DN
ldap_group_search_base = ou=groups,$BASE_DN
ldap_user_object_class = posixAccount
ldap_group_object_class = posixGroup
ldap_user_name = cn
ldap_user_gecos = name
ldap_user_home_directory = homeDirectory
ldap_user_ssh_public_key = sshPublicKey
ldap_group_member = member
# Nur Mitglieder der Server-Gruppe dürfen sich anmelden
ldap_access_order = filter
ldap_access_filter = (memberOf=cn=$SSH_GROUP,ou=groups,$BASE_DN)
fallback_homedir = /home/%u
default_shell = /bin/bash
enumerate = false
cache_credentials = true
entry_cache_timeout = 300
use_fully_qualified_names = false
EOF
chown root:root "$SSSD_CONF"
chmod 0600 "$SSSD_CONF"
umask 022
# ── NSS / PAM ────────────────────────────────────────────────────────────────
log "🔧 NSS/PAM konfigurieren"
for db in passwd group; do
grep -Eq "^${db}:.*\bsss\b" /etc/nsswitch.conf || sed -i -E "s/^(${db}:.*)$/\1 sss/" /etc/nsswitch.conf
done
install -d -m 0755 /etc/skel/deployment
pam-auth-update --enable sss mkhomedir >/dev/null
# ── sshd ─────────────────────────────────────────────────────────────────────
log "🔧 $SSHD_DROPIN schreiben"
install -d -m 0755 /etc/ssh/sshd_config.d
grep -Eq '^\s*Include\s+/etc/ssh/sshd_config.d/\*\.conf' /etc/ssh/sshd_config \
|| sed -i '1i Include /etc/ssh/sshd_config.d/*.conf' /etc/ssh/sshd_config
cat >"$SSHD_DROPIN" <<EOF
# Verwaltet von setup-sshd-ldap.sh
UsePAM yes
PubkeyAuthentication yes
# Service-Accounts (CI/CD) melden sich mit dem authentik-App-Passwort an
PasswordAuthentication yes
AuthorizedKeysCommand /usr/bin/sss_ssh_authorizedkeys %u
AuthorizedKeysCommandUser nobody
EOF
sshd -t || die "sshd-Konfiguration ungültig – Drop-in $SSHD_DROPIN prüfen"
# ── docker-deploy.sh ─────────────────────────────────────────────────────────
log "🔧 $DEPLOY_CONF schreiben"
printf 'DEPLOY_SERVER=%s\n' "$SERVER" >"$DEPLOY_CONF"
chown root:root "$DEPLOY_CONF"; chmod 0644 "$DEPLOY_CONF"
if $INSTALL_SUDOERS; then
log "🔧 $SUDOERS_FILE schreiben"
tmp="$(mktemp)"
printf '%%%s ALL=(root) NOPASSWD: /usr/local/bin/docker-deploy.sh\n' "$DOCKER_GROUP" >"$tmp"
visudo -cf "$tmp" >/dev/null || { rm -f "$tmp"; die "sudoers-Regel ungültig"; }
install -m 0440 -o root -g root "$tmp" "$SUDOERS_FILE"
rm -f "$tmp"
fi
# ── Dienste ──────────────────────────────────────────────────────────────────
log "🔄 Dienste (neu) starten"
systemctl enable --now sssd >/dev/null
systemctl restart sssd
systemctl reload ssh 2>/dev/null || systemctl reload sshd
log "✅ Fertig. Prüfen mit: ./check-sshd-ldap.sh <username>"