9 changed files with 10 additions and 466 deletions

No files matched your search

-13
View File
@@ -1,13 +0,0 @@
# Beispiel für create-deploy-user.py – kopieren nach .env (wird nicht eingecheckt):
# cp .env.example .env && chmod 600 .env
# Laden und ausführen:
# set -a; source .env; set +a
# ./create-deploy-user.py --project-path owner/repo
# Das Skript liest nur die Umgebungsvariablen; fehlen sie, wird interaktiv gefragt.
# authentik-API-Token (authentik → Benutzer-Einstellungen → Tokens und App-Passwörter)
AUTHENTIK_TOKEN=
# Gitea-Access-Token mit Scope write:repository
# (https://git.share-fix.de/user/settings/applications)
GITEA_TOKEN=
-30
View File
@@ -1,30 +0,0 @@
name: lint
on:
push:
branches: [main]
pull_request:
jobs:
shell:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: bash -n
run: for f in *.sh; do bash -n "$f"; done
- name: shellcheck
run: |
sudo apt-get update -qq && sudo apt-get install -y -qq shellcheck
shellcheck --severity=warning *.sh
python:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.12"
- name: Syntax-Check
run: python -m py_compile create-deploy-user.py
- name: ruff
run: pip install -q ruff && ruff check create-deploy-user.py
-5
View File
@@ -1,5 +0,0 @@
__pycache__/
*.pyc
.claude/
.codegraph/
.env
-37
View File
@@ -1,37 +0,0 @@
#!/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"
+8 -16
View File
@@ -15,7 +15,7 @@ from authentik_client.rest import ApiException
DEFAULT_AUTHENTIK_URL = "https://auth.systems.cogsys.wiai.uni-bamberg.de/api/v3" DEFAULT_AUTHENTIK_URL = "https://auth.systems.cogsys.wiai.uni-bamberg.de/api/v3"
DEFAULT_GITEA_URL = "https://git.share-fix.de" DEFAULT_GITEA_URL = "https://git.share-fix.de"
DEFAULT_SERVER = "H1" DEFAULT_DOCKER_GROUP = "server_APPS_docker_compose"
HOME_DIR_BASE = "/home" HOME_DIR_BASE = "/home"
USERNAME_RE = re.compile(r"^[a-z_][a-z0-9_-]{0,31}$") USERNAME_RE = re.compile(r"^[a-z_][a-z0-9_-]{0,31}$")
@@ -72,18 +72,12 @@ def authentik_get_group_by_name(client: authentik_client.CoreApi, name: str):
raise RuntimeError(f"Gruppe '{name}' nicht gefunden") raise RuntimeError(f"Gruppe '{name}' nicht gefunden")
def authentik_create_user(client: authentik_client.CoreApi, username: str, home_directory: str, groups, repo_url: str) -> str: def authentik_create_user(client: authentik_client.CoreApi, username: str, home_directory: str, groups) -> str:
print(f"Creating user: {username}") print(f"Creating user: {username}")
users = client.core_users_list(username=username) users = client.core_users_list(username=username)
if users.results: if users.results:
print(f"User {username} already exists") print(f"User {username} already exists")
user = users.results[0] user = users.results[0]
client.core_users_partial_update(
id=user.pk,
patched_user_request=authentik_client.PatchedUserRequest(
attributes={**(user.attributes or {}), "notes": repo_url, "homeDirectory": home_directory}
),
)
else: else:
user = client.core_users_create( user = client.core_users_create(
user_request=authentik_client.UserRequest( user_request=authentik_client.UserRequest(
@@ -93,7 +87,6 @@ def authentik_create_user(client: authentik_client.CoreApi, username: str, home_
is_active=True, is_active=True,
path="goauthentik.io/service-accounts", path="goauthentik.io/service-accounts",
attributes={ attributes={
"notes": repo_url,
"homeDirectory": home_directory, "homeDirectory": home_directory,
"goauthentik.io/user/token-expires": False, "goauthentik.io/user/token-expires": False,
}, },
@@ -126,12 +119,12 @@ def authentik_create_user(client: authentik_client.CoreApi, username: str, home_
# ── CLI ────────────────────────────────────────────────────────────────────── # ── CLI ──────────────────────────────────────────────────────────────────────
def parse_args() -> argparse.Namespace: def parse_args() -> argparse.Namespace:
p = argparse.ArgumentParser(description="Deploy-User für ein Gitea-Repository in authentik anlegen") p = argparse.ArgumentParser(description="Deploy-User für ein Gitea-Repository in authentik anlegen")
p.add_argument("--server", default=DEFAULT_SERVER, p.add_argument("--server", required=True,
help=f"Zielserver; bestimmt server_<SERVER>_ssh_access und server_<SERVER>_docker_compose (Standard: {DEFAULT_SERVER})") help="Zielserver; bestimmt die Gruppe server_<SERVER>_ssh_access (z. B. APPS -> server_APPS_ssh_access)")
p.add_argument("--project-path", help="Gitea-Repository: 'owner/repo' oder URL") p.add_argument("--project-path", help="Gitea-Repository: 'owner/repo' oder URL")
p.add_argument("--username", help="Username des Deploy-Users (Standard: deploy_<owner>_<repo>)") p.add_argument("--username", help="Username des Deploy-Users (Standard: deploy_<owner>_<repo>)")
p.add_argument("--docker-group", p.add_argument("--docker-group", default=DEFAULT_DOCKER_GROUP,
help="Gruppe für Docker-Deploys (Standard: server_<SERVER>_docker_compose)") help=f"Zusätzliche Gruppe für Docker-Deploys (Standard: {DEFAULT_DOCKER_GROUP})")
p.add_argument("--no-docker-group", action="store_true", help="Docker-Deploy-Gruppe nicht zuweisen") p.add_argument("--no-docker-group", action="store_true", help="Docker-Deploy-Gruppe nicht zuweisen")
p.add_argument("--authentik-url", default=DEFAULT_AUTHENTIK_URL) p.add_argument("--authentik-url", default=DEFAULT_AUTHENTIK_URL)
p.add_argument("--authentik-token", default=os.environ.get("AUTHENTIK_TOKEN"), p.add_argument("--authentik-token", default=os.environ.get("AUTHENTIK_TOKEN"),
@@ -175,13 +168,12 @@ def main() -> int:
group_names = [f"server_{args.server}_ssh_access"] group_names = [f"server_{args.server}_ssh_access"]
if not args.no_docker_group: if not args.no_docker_group:
group_names.append(args.docker_group or f"server_{args.server}_docker_compose") group_names.append(args.docker_group)
print(f"\nRepository: {repo_path} (id {repo['id']})") print(f"\nRepository: {repo_path} (id {repo['id']})")
print(f"Deploy-User: {username}") print(f"Deploy-User: {username}")
print(f"Home-Verz.: {home_dir}") print(f"Home-Verz.: {home_dir}")
print(f"Gruppen: {', '.join(group_names)}") print(f"Gruppen: {', '.join(group_names)}")
print(f"Notes: {repo['html_url']}")
print(f"Gitea-Secrets: deploy_user, deploy_pass") print(f"Gitea-Secrets: deploy_user, deploy_pass")
if args.dry_run: if args.dry_run:
print("\n[dry-run] Es wurde nichts angelegt.") print("\n[dry-run] Es wurde nichts angelegt.")
@@ -194,7 +186,7 @@ def main() -> int:
core_api = authentik_client.CoreApi(api_client) core_api = authentik_client.CoreApi(api_client)
try: try:
groups = [authentik_get_group_by_name(core_api, n) for n in group_names] groups = [authentik_get_group_by_name(core_api, n) for n in group_names]
key = authentik_create_user(core_api, username, home_dir, groups, repo["html_url"]) key = authentik_create_user(core_api, username, home_dir, groups)
except (ApiException, RuntimeError) as e: except (ApiException, RuntimeError) as e:
sys.exit(f"Fehler in authentik: {e}") sys.exit(f"Fehler in authentik: {e}")
+2 -24
View File
@@ -7,28 +7,10 @@ IFS=$'\n\t'
export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
readonly SCRIPT_NAME="$(basename "$0")" readonly SCRIPT_NAME="$(basename "$0")"
readonly DEPLOY_SUBDIR="deployment" readonly DEPLOY_SUBDIR="its-deploy"
readonly CONFIG_FILE="/etc/docker-deploy.conf" readonly DEPLOY_GROUP="server_APPS_docker_compose"
readonly ALLOWED_ACTIONS=(build up down restart logs pull deploy) readonly ALLOWED_ACTIONS=(build up down restart logs pull deploy)
# ── Konfiguration ────────────────────────────────────────────────────────────
# Optional: /etc/docker-deploy.conf (root-owned, nicht group/world-writable) mit
# DEPLOY_SERVER=H1
# Berechtigte Gruppe: server_${DEPLOY_SERVER}_docker_compose.
# Bewusst keine Umgebungsvariable/kein Parameter: sudo-Aufrufer sollen die
# Berechtigungsprüfung nicht selbst umstellen können.
DEPLOY_SERVER="H1"
if [[ -e "$CONFIG_FILE" ]]; then
IFS=' ' read -r cfg_owner cfg_mode < <(stat -c '%u %a' "$CONFIG_FILE")
if [[ "$cfg_owner" != 0 ]] || (( 8#$cfg_mode & 8#022 )); then
echo "❌ $CONFIG_FILE muss root gehören und darf nicht group/world-writable sein" >&2
exit 1
fi
DEPLOY_SERVER="$(sed -n 's/^DEPLOY_SERVER=//p' "$CONFIG_FILE" | tail -n1 | tr -d "\"' ")"
fi
[[ "$DEPLOY_SERVER" =~ ^[A-Za-z0-9_-]+$ ]] || { echo "❌ Ungültiger DEPLOY_SERVER: '$DEPLOY_SERVER'" >&2; exit 1; }
readonly DEPLOY_GROUP="server_${DEPLOY_SERVER}_docker_compose"
# ── Hilfsfunktionen ────────────────────────────────────────────────────────── # ── Hilfsfunktionen ──────────────────────────────────────────────────────────
log() { printf '[%(%Y-%m-%d %H:%M:%S)T] %s\n' -1 "$*"; } log() { printf '[%(%Y-%m-%d %H:%M:%S)T] %s\n' -1 "$*"; }
die() { printf '❌ %s\n' "$*" >&2; exit 1; } die() { printf '❌ %s\n' "$*" >&2; exit 1; }
@@ -84,10 +66,6 @@ fi
[[ "$APP_USER" =~ ^[a-z_][a-z0-9_-]{0,31}$ ]] || die "Ungültiger Username: '$APP_USER'" [[ "$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" 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'" 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[*]})" in_array "$ACTION" "${ALLOWED_ACTIONS[@]}" || die "Unbekannte Aktion: '$ACTION' (erlaubt: ${ALLOWED_ACTIONS[*]})"
if $USE_CACHE && [[ "$ACTION" != "build" && "$ACTION" != "deploy" ]]; then if $USE_CACHE && [[ "$ACTION" != "build" && "$ACTION" != "deploy" ]]; then
die "--cache ist nur bei build/deploy sinnvoll" die "--cache ist nur bei build/deploy sinnvoll"
-99
View File
@@ -1,99 +0,0 @@
# 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.
-56
View File
@@ -1,56 +0,0 @@
# Beispiel: .gitea/workflows/deploy.yml im Repo eines Dienstes
#
# Voraussetzungen (Setup mit create-deploy-user.py --project-path owner/repo):
# Variable deploy_user – Deploy-User (wird vom Skript gesetzt)
# Secret deploy_pass – Passwort/App-Token des Users (wird vom Skript gesetzt)
# Variable deploy_host – Hostname/IP des Zielservers (manuell setzen)
#
# Das Repo enthält docker-compose.yml (und optional docker-compose.override.yml)
# im Wurzelverzeichnis; sie landen in ~/deployment auf dem Server.
name: deploy
on:
push:
branches: [main]
workflow_dispatch:
# Nie zwei Deploys gleichzeitig für denselben Dienst
concurrency:
group: deploy-${{ gitea.repository }}
cancel-in-progress: false
env:
DEPLOY_USER: ${{ vars.deploy_user }}
DEPLOY_HOST: ${{ vars.deploy_host }}
SSHPASS: ${{ secrets.deploy_pass }}
SSH_OPTS: -o StrictHostKeyChecking=accept-new -o PubkeyAuthentication=no
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Compose-Datei validieren
run: docker compose -f docker-compose.yml config --quiet
- name: Tools installieren
run: sudo apt-get update -qq && sudo apt-get install -y -qq sshpass rsync
- name: Dateien nach ~/deployment synchronisieren
run: |
sshpass -e rsync -az --delete \
--exclude '.git' --exclude '.gitea' --exclude '.env' \
-e "ssh $SSH_OPTS" \
./ "$DEPLOY_USER@$DEPLOY_HOST:deployment/"
- name: Deploy (pull → build → up)
run: |
sshpass -e ssh $SSH_OPTS "$DEPLOY_USER@$DEPLOY_HOST" \
"sudo /usr/local/bin/docker-deploy.sh $DEPLOY_USER deploy"
- name: Logs bei Fehler
if: failure()
run: |
sshpass -e ssh $SSH_OPTS "$DEPLOY_USER@$DEPLOY_HOST" \
"sudo /usr/local/bin/docker-deploy.sh $DEPLOY_USER logs" || true
-186
View File
@@ -1,186 +0,0 @@
#!/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>"