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=rootTerminal 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; doneErwartet (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);
SQLErwartet:
CREATE TABLE
INSERT 0 2
Tipp:
docker exec ... psqlohne-hnutzt den lokalen Socket – im Image ohne Passwort (trust). Das bleibt auch nachrotate-rootdein 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-256Erwartet:
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-dbErwartet (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=24hErwartet:
Success! Data written to: database/roles/webshop-ro
bao read database/creds/webshop-roErwartet (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-tokenErwartet:
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-appErwartet (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-dbErwartet (gekürzt):
Success! Uploaded policy: webshop-db
v-token-webshop--X8llUY9OAO9ZoRAU0dYL-1791442931
...
* permission denied
...
* permission denied
Tipp: Hänge
webshop-dban die AppRolewebshopaus Tag 3 (token_policies), dann beginnen die Usernamen mitv-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/nullChallenge
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-tokenErwartet (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) stattpostgres;rotate-rootdirekt nach dem Einrichten. - TLS zur Datenbank (
sslmode=verify-full) stattsslmode=disable. revocation_statementsexplizit setzen (Sessions beenden, Objekte übertragen), sonst scheitertDROP ROLEbei 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.