Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 4: Dynamische Datenbank-Secrets

Ziel: Postgres-Zugangsdaten on demand erzeugen, verlängern, widerrufen und rotieren · Dauer: ca. 90 min · Voraussetzung: Tag 3

Briefing

  • Die Database Engine legt pro Anfrage einen eigenen DB-User mit Ablaufdatum an.
  • Jeder User hängt an einer Lease: Läuft sie ab oder wird sie widerrufen, löscht OpenBao den User.
  • Static Roles verwalten bestehende User und rotieren nur deren Passwort.
  • Das Admin-Passwort (rotate-root) kennt danach nur noch OpenBao.
App --read creds--> OpenBao --CREATE ROLE ... VALID UNTIL--> Postgres
          <-- user/pass + lease_id --
Lease abgelaufen/revoked --DROP ROLE--> Postgres

Drill 1: Labor starten

Terminal 1:

bao server -dev -dev-root-token-id=root

Terminal 2:

mkdir -p ~/bao-lab/tag04 && cd ~/bao-lab/tag04
export BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=root

# Lab-Passwort, nur für dieses Labor
docker run -d --name bao-pg -e POSTGRES_PASSWORD=lab-pg-pw \
  -p 5432:5432 postgres:16
until docker exec bao-pg pg_isready -U postgres; do sleep 1; done

Erwartet (gekürzt, kann abweichen):

/var/run/postgresql:5432 - accepting connections

Testdaten anlegen:

docker exec -i bao-pg psql -U postgres <<'SQL'
CREATE TABLE products (id serial PRIMARY KEY, name text, price numeric);
INSERT INTO products (name, price) VALUES ('Tasse', 9.90), ('Shirt', 19.90);
SQL

Erwartet:

CREATE TABLE
INSERT 0 2

Tipp: docker exec ... psql ohne -h nutzt den lokalen Socket – im Image ohne Passwort (trust). Das bleibt auch nach rotate-root dein Notzugang.

Für echte Passwort-Logins brauchst du TCP über die Container-IP; Loopback im Container ist ebenfalls trust und würde jedes Passwort akzeptieren:

PG_IP=$(docker inspect bao-pg \
  -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}')
echo "$PG_IP"

Erwartet (kann abweichen):

172.17.0.2

Fortschritt speichern? Kostenlos registrieren

Drill 2: Database Engine und Verbindung

bao secrets enable database

PG_URL='postgresql://{{username}}:{{password}}@127.0.0.1:5432/postgres'

bao write database/config/webshop-db \
  plugin_name=postgresql-database-plugin \
  connection_url="$PG_URL?sslmode=disable" \
  username=postgres \
  password=lab-pg-pw \
  allowed_roles="webshop-ro,webshop-app" \
  password_authentication=scram-sha-256

Erwartet:

Success! Enabled the database secrets engine at: database/
Success! Data written to: database/config/webshop-db

Warum? {{username}}/{{password}} sind Platzhalter, die OpenBao selbst füllt; so landet das Passwort nie im Klartext in der URL. password_authentication=scram-sha-256 sorgt dafür, dass OpenBao Passwörter als SCRAM-Hash statt im Klartext an Postgres schickt.

bao read database/config/webshop-db

Erwartet (gekürzt):

allowed_roles         [webshop-ro webshop-app]
connection_details    map[connection_url:postgresql://{{username}}:{{password}}@...
                      password_authentication:scram-sha-256 username:postgres]
plugin_name           postgresql-database-plugin

Das Passwort wird nie zurückgegeben.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Root-Passwort rotieren

bao write -f database/rotate-root/webshop-db
docker exec -e PGPASSWORD=lab-pg-pw bao-pg \
  psql -h "$PG_IP" -U postgres -c 'select 1'

Erwartet (gekürzt, kann abweichen):

Success! Data written to: database/rotate-root/webshop-db
psql: error: ... FATAL:  password authentication failed for user "postgres"

Achtung: Ab jetzt kennt niemand außer OpenBao das Passwort von postgres. In Produktion nie mit dem Superuser machen, den Menschen brauchen – eigenen Admin-User für OpenBao anlegen.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Dynamische Rolle webshop-ro

cat > webshop-ro.sql <<'EOF'
CREATE ROLE "{{name}}" WITH LOGIN PASSWORD '{{password}}' VALID UNTIL '{{expiration}}';
GRANT SELECT ON ALL TABLES IN SCHEMA public TO "{{name}}";
EOF

bao write database/roles/webshop-ro \
  db_name=webshop-db \
  [email protected] \
  default_ttl=1h \
  max_ttl=24h

Erwartet:

Success! Data written to: database/roles/webshop-ro
bao read database/creds/webshop-ro

Erwartet (Werte variieren):

Key                Value
---                -----
lease_id           database/creds/webshop-ro/h1jlcn7wLQwBMWxYp0L7N5X0
lease_duration     1h
lease_renewable    true
password           wIKwnNIajk5-V1EZlAAK
username           v-token-webshop--1UcSq5kzQEKAVeQsajVI-1791442902

Warum? Der Username kodiert Auth-Methode (token), Rolle und Zeitstempel – im DB-Log siehst du sofort, woher ein User kommt.

Fortschritt speichern? Kostenlos registrieren

Drill 5: In Postgres prüfen

bao read -format=json database/creds/webshop-ro > creds.json
U=$(jq -r .data.username creds.json)
P=$(jq -r .data.password creds.json)
L=$(jq -r .lease_id creds.json)

docker exec bao-pg psql -U postgres -c '\du'
docker exec -e PGPASSWORD="$P" bao-pg \
  psql -h "$PG_IP" -U "$U" -d postgres -c 'SELECT * FROM products;'
docker exec -e PGPASSWORD="$P" bao-pg \
  psql -h "$PG_IP" -U "$U" -d postgres -c "INSERT INTO products (name) VALUES ('x');"

Erwartet (gekürzt, kann abweichen):

 Role name                                        | Attributes
--------------------------------------------------+---------------------------------
 postgres                                         | Superuser, Create role, ...
 v-token-webshop--1UcSq5kzQEKAVeQsajVI-1791442902 | Password valid until 2026-...
 v-token-webshop--twbUGop2PLWgGtbGKUjA-1791442908 | Password valid until 2026-...

 id | name  | price
----+-------+-------
  1 | Tasse |  9.90
  2 | Shirt | 19.90

ERROR:  permission denied for table products

Fortschritt speichern? Kostenlos registrieren

Drill 6: Lease lookup, renew, revoke

bao lease lookup "$L"
bao lease renew -increment=2h "$L"
docker exec bao-pg psql -U postgres -c '\du' | grep "$U"

Erwartet (gekürzt):

expire_time     2026-10-08T10:01:48.243427+02:00
id              database/creds/webshop-ro/0F6WHISLDv1yBkAGlMFGXLPE
path            database/creds/webshop-ro
renewable       true
ttl             1h
...
lease_duration     2h
lease_renewable    true
 v-token-webshop--... | Password valid until 2026-10-08 12:01:53+02

Warum? Renew verschiebt VALID UNTIL in Postgres mit. Über max_ttl hinaus geht es nicht – OpenBao kappt und warnt (TTL ... exceeded the effective max_ttl).

bao lease revoke "$L"
sleep 1
docker exec -e PGPASSWORD="$P" bao-pg \
  psql -h "$PG_IP" -U "$U" -d postgres -c 'select 1'

Erwartet (gekürzt, kann abweichen):

All revocation operations queued successfully!
psql: error: ... FATAL:  password authentication failed for user "v-token-webshop--..."

Fortschritt speichern? Kostenlos registrieren

Drill 7: Notbremse revoke -prefix

Szenario: Credentials einer Rolle sind geleakt. Alle auf einmal weg:

for i in 1 2 3; do bao read -field=username database/creds/webshop-ro; echo; done
bao list sys/leases/lookup/database/creds/webshop-ro

bao lease revoke -prefix database/creds/webshop-ro
sleep 1
bao list sys/leases/lookup/database/creds/webshop-ro
docker exec bao-pg psql -U postgres -c '\du' | grep -c v-token

Erwartet:

Keys
----
h1jlcn7wLQwBMWxYp0L7N5X0
p3zTCbvMLx0xzcUFrz0Rxkb4
vMMyLKRreID7Gey0e0nz9lIE
wpvHTl6qWECIhG1qXT77CvtG
All revocation operations queued successfully!
No value found at sys/leases/lookup/database/creds/webshop-ro
0

Fortschritt speichern? Kostenlos registrieren

Drill 8: Static Role für einen bestehenden Service-User

Der Legacy-User webshop_app existiert schon und darf nicht neu angelegt werden – nur sein Passwort wird rotiert.

docker exec bao-pg psql -U postgres \
  -c "CREATE ROLE webshop_app WITH LOGIN PASSWORD 'lab-alt-pw';" \
  -c "GRANT SELECT, INSERT ON products TO webshop_app;"

bao write database/static-roles/webshop-app \
  db_name=webshop-db \
  username=webshop_app \
  rotation_period=24h

bao read database/static-creds/webshop-app

Erwartet (Werte variieren):

Success! Data written to: database/static-roles/webshop-app
Key                    Value
---                    -----
last_vault_rotation    2026-10-08T09:02:04.617182+02:00
password               rQAquKpI-H57-ptZpZuC
rotation_period        24h
ttl                    24h
username               webshop_app

Warum? OpenBao rotiert beim Anlegen sofort – lab-alt-pw ist danach ungültig. Static Creds haben keine Lease, sondern eine ttl bis zur nächsten Rotation.

Manuell rotieren und prüfen:

bao write -f database/rotate-role/webshop-app
P2=$(bao read -field=password database/static-creds/webshop-app)
docker exec -e PGPASSWORD="$P2" bao-pg \
  psql -h "$PG_IP" -U webshop_app -d postgres -tAc 'select current_user'

Erwartet:

Success! Data written to: database/rotate-role/webshop-app
webshop_app

Fortschritt speichern? Kostenlos registrieren

Drill 9: Policy für die App

bao policy write webshop-db - <<'EOF'
path "database/creds/webshop-ro" {
  capabilities = ["read"]
}
path "database/static-creds/webshop-app" {
  capabilities = ["read"]
}
EOF

T=$(bao token create -policy=webshop-db -field=token)
BAO_TOKEN=$T bao read -field=username database/creds/webshop-ro; echo
BAO_TOKEN=$T bao read database/config/webshop-db
BAO_TOKEN=$T bao write -f database/rotate-root/webshop-db

Erwartet (gekürzt):

Success! Uploaded policy: webshop-db
v-token-webshop--X8llUY9OAO9ZoRAU0dYL-1791442931
...
    * permission denied
...
    * permission denied

Tipp: Hänge webshop-db an die AppRole webshop aus Tag 3 (token_policies), dann beginnen die Usernamen mit v-approle-.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

#!/usr/bin/env bash
check() { if eval "$2" >/dev/null 2>&1; then echo "✔ $1"; else echo "✘ $1"; fi; }

check "Database Engine gemountet" "bao secrets list | grep -q '^database/'"
check "Config webshop-db lesbar" "bao read database/config/webshop-db"
check "Rolle webshop-ro existiert" "bao read database/roles/webshop-ro"
check "Static Role webshop-app existiert" "bao read database/static-roles/webshop-app"
U=$(bao read -field=username database/creds/webshop-ro)
check "Dynamischer User in Postgres" \
  "docker exec bao-pg psql -U postgres -tAc '\du' | grep -q '$U'"
check "Policy webshop-db existiert" "bao policy read webshop-db"
bao lease revoke -prefix database/creds/webshop-ro >/dev/null

Challenge

Lege eine Rolle webshop-short mit default_ttl=1m und max_ttl=2m an, erzeuge Credentials und versuche sie auf 1 h zu verlängern. Beobachte, wann der User aus \du verschwindet.

Hinweis: Die Rolle muss erst in allowed_roles der Verbindung stehen.

Lösung

bao write database/config/webshop-db \
  allowed_roles="webshop-ro,webshop-app,webshop-short"
bao write database/roles/webshop-short db_name=webshop-db \
  [email protected] default_ttl=1m max_ttl=2m

L=$(bao read -format=json database/creds/webshop-short | jq -r .lease_id)
bao lease renew -increment=1h "$L"
sleep 125
docker exec bao-pg psql -U postgres -c '\du' | grep -c v-token

Erwartet (gekürzt):

WARNING! The following warnings were returned from OpenBao:
  * TTL of "1h" exceeded the effective max_ttl of "1m59s"; TTL value is capped
  accordingly
lease_duration     1m59s
0

Ein Update auf database/config/... ändert nur die übergebenen Felder; das rotierte Root-Passwort bleibt erhalten.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Eigener DB-Admin für OpenBao (CREATEROLE, minimale Rechte) statt postgres; rotate-root direkt nach dem Einrichten.
  • TLS zur Datenbank (sslmode=verify-full) statt sslmode=disable.
  • revocation_statements explizit setzen (Sessions beenden, Objekte übertragen), sonst scheitert DROP ROLE bei Abhängigkeiten.
  • Kurze TTLs plus Lease-Renewal im Client (OpenBao Agent, Tag 11); Lease-Anzahl überwachen (Tag 12).
  • Static Roles für Legacy-Apps nur mit Plan, wie die App das neue Passwort ohne Downtime lädt.