From cd1891a2fd8e83a607ca6c93393435332b97d673 Mon Sep 17 00:00:00 2001 From: Jochen Mehlich Date: Sat, 24 Oct 2026 13:20:44 +0200 Subject: [PATCH] =?UTF-8?q?setup-sshd-ldap.sh:=20Abfrage=20f=C3=BCr=20Serv?= =?UTF-8?q?er/Bind-User,=20Bind-User=20nur=20als=20Name,=20Standards=20f?= =?UTF-8?q?=C3=BCr=20URI,=20Base-DN=20und=20kein=20TLS=20(--starttls)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/authentik-ldap-sshd.md | 23 +++++++++-------- setup-sshd-ldap.sh | 49 +++++++++++++++++++++++-------------- 2 files changed, 43 insertions(+), 29 deletions(-) diff --git a/docs/authentik-ldap-sshd.md b/docs/authentik-ldap-sshd.md index 1485164..6bc40ac 100644 --- a/docs/authentik-ldap-sshd.md +++ b/docs/authentik-ldap-sshd.md @@ -32,9 +32,8 @@ App-Passwort an, normale User per Passwort oder SSH-Key. - 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. +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/` - `notes`: Link zum Gitea-Repo @@ -43,15 +42,19 @@ App-Passwort an, normale User per Passwort oder SSH-Key. ## 2. SSH-Server einrichten -Voraussetzung: Debian/Ubuntu, root-Zugriff, Netzwerkzugang zum Outpost auf Port 636. +Voraussetzung: Debian/Ubuntu, root-Zugriff, Outpost erreichbar (Standard `127.0.0.1:389`). ```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 +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=,`. 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`): diff --git a/setup-sshd-ldap.sh b/setup-sshd-ldap.sh index d347c19..8efc49b 100755 --- a/setup-sshd-ldap.sh +++ b/setup-sshd-ldap.sh @@ -5,10 +5,10 @@ # 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] +# sudo ./setup-sshd-ldap.sh +# fragt Server, Bind-User und Passwort ab; Standard ist ldap://127.0.0.1:389 ohne TLS. +# 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/ca.pem ... set -Eeuo pipefail IFS=$'\n\t' export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" @@ -19,10 +19,12 @@ 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="" +DEFAULT_SERVER="H1" +DEFAULT_LDAP_URI="ldap://127.0.0.1:389" +DEFAULT_BASE_DN="dc=ldap,dc=goauthentik,dc=io" +SERVER="" LDAP_URI="$DEFAULT_LDAP_URI" BASE_DN="$DEFAULT_BASE_DN" BIND_DN="" CA_CERT="" PW_FILE="" INSTALL_SUDOERS=true -NO_TLS=false +NO_TLS=true ACCESS_FILTER="(objectClass=posixAccount)" log() { printf '[%(%H:%M:%S)T] %s\n' -1 "$*"; } @@ -30,20 +32,22 @@ die() { printf '❌ %s\n' "$*" >&2; exit 1; } usage() { cat >&2 < server_NAME_ssh_access / server_NAME_docker_compose (Standard: $DEFAULT_SERVER) + --bind-dn USER|DN Bind-Account: nur der Username (wird zu cn=USER,) oder ein vollständiger DN --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 + --ldap-uri URI Standard: $DEFAULT_LDAP_URI; auch ldaps://host:636 + --base-dn DN Standard: $DEFAULT_BASE_DN + --starttls bei ldap:// StartTLS verwenden statt Klartext (Outpost braucht ein Zertifikat) + --ca-cert FILE CA-Zertifikat für LDAPS/StartTLS --access-filter FILTER LDAP-Filter für erlaubte User (Standard: (objectClass=posixAccount); sonst steuert authentik den Zugriff) - --no-tls ldap:// ganz ohne TLS (Outpost ohne Zertifikat); NUR in vertrauenswürdigen Netzen --no-sudoers sudoers-Regel für docker-deploy.sh nicht anlegen + +Standard ist Klartext-LDAP (ldap://, kein TLS): nur für Loopback/vertrauenswürdige Netze. EOF exit 1 } @@ -58,16 +62,23 @@ while [[ $# -gt 0 ]]; do --ca-cert) CA_CERT="${2:?}"; shift 2 ;; --no-sudoers) INSTALL_SUDOERS=false; shift ;; --access-filter) ACCESS_FILTER="${2:?}"; shift 2 ;; - --no-tls) NO_TLS=true; shift ;; + --starttls) NO_TLS=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://* || "$LDAP_URI" == ldap://* ]] || die "ldap-uri muss mit ldaps:// oder ldap:// beginnen" -[[ "$LDAP_URI" == ldap://* || $NO_TLS == false ]] || die "--no-tls ist nur mit ldap:// sinnvoll" +if [[ -z "$SERVER" ]]; then + read -rp "Server [$DEFAULT_SERVER]: " SERVER + SERVER="${SERVER:-$DEFAULT_SERVER}" +fi +if [[ -z "$BIND_DN" ]]; then + read -rp "Bind-User (z. B. server_APPS_systemaccount): " BIND_DN +fi +[[ -n "$BIND_DN" ]] || die "Kein Bind-User angegeben" +[[ "$BIND_DN" == *=* ]] || BIND_DN="cn=$BIND_DN,$BASE_DN" [[ "$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"