Anhang A: Spickzettel
Getestet mit bao v2.7.1 (Cluster ab Tag 12 ebenfalls
2.7.1, Chart 0.30.2). Pfade und Namen entsprechen dem Lab, Passwörter
sind Lab-Werte.
Status und Login
# Ziel und CA setzen (Teil B, per Port-Forward)
export BAO_ADDR=https://127.0.0.1:8200 BAO_CACERT=~/bao-lab/tls/ca.crt
# Seal-Status, Seal-Typ, HA-Modus, Raft-Index; einzelnes Feld (ab 2.7)
bao status
bao status -field=version
# Login mit Token, userpass, AppRole
bao login -method=token
bao login -method=userpass username=thomas
bao write auth/approle/login role_id=$RID secret_id=$SID
# Eigenes Token prüfen (Policies, TTL, Accessor); einzelnes Feld (ab 2.7)
bao token lookup
bao token lookup -field=policies
# Aktuell gespeichertes Token ausgeben
bao print token
# Ohne Token-Helper anmelden, nur Token ausgeben
bao login -no-store -token-only -method=userpass username=thomasKV v2
# Schreiben, lesen, einzelnes Feld
bao kv put -mount=secret webshop/config db_user=webshop db_pass=lab-pw
bao kv get -mount=secret webshop/config
bao kv get -mount=secret -field=db_pass webshop/config
# Ein Feld ändern, Rest behalten
bao kv patch -mount=secret webshop/config db_pass=lab-pw2
# Ältere Version lesen, Pfade auflisten
bao kv get -mount=secret -version=1 webshop/config
bao kv list -mount=secret webshop
# Nur schreiben, wenn aktuelle Version 2 ist (Check-and-Set)
bao kv put -mount=secret -cas=2 webshop/config db_pass=lab-pw3
# Soft-Delete, wiederherstellen, alte Version als neue setzen
bao kv delete -mount=secret webshop/config
bao kv undelete -mount=secret -versions=3 webshop/config
bao kv rollback -mount=secret -version=2 webshop/config
# Endgültig vernichten (Version bzw. alles)
bao kv destroy -mount=secret -versions=1 webshop/config
bao kv metadata delete -mount=secret webshop/config
# Versionen und Aufbewahrung
bao kv metadata get -mount=secret webshop/config
bao kv metadata put -mount=secret -max-versions=5 -delete-version-after=720h \
webshop/configTokens
# Token mit Policy und TTL
bao token create -policy=webshop-read -ttl=1h
# Periodisches Token (beliebig verlängerbar), Orphan, Batch-Token
bao token create -policy=webshop-read -period=24h -orphan
bao token create -policy=webshop-read -type=batch -ttl=10m
# Fremdes Token per Accessor ansehen und widerrufen
bao token lookup -accessor $ACC
bao token revoke -accessor $ACC
# Verlängern, eigenes Token widerrufen
bao token renew -increment=1h
bao token revoke -self
# Alle Tokens einer Auth-Methode widerrufen
bao token revoke -mode=path auth/approle/
# Was darf Token X auf Pfad Y?
bao token capabilities $TOKEN secret/data/webshop/configPolicies
# Policy schreiben (Datei oder stdin), lesen, auflisten, löschen
bao policy write webshop-read webshop-read.hcl
bao policy read webshop-read
bao policy list
bao policy delete webshop-read
# HCL formatieren
bao policy fmt webshop-read.hclpath "secret/data/webshop/*" { capabilities = ["read"] }
path "secret/metadata/webshop/*" { capabilities = ["list"] }
Auth-Methoden
# Aktivieren, auflisten, TTLs tunen
bao auth enable approle
bao auth list -detailed
bao auth tune -default-lease-ttl=1h -max-lease-ttl=24h approle/
# userpass
bao write auth/userpass/users/thomas password=lab-pw token_policies=webshop-read
# AppRole: Rolle, RoleID, SecretID (gewrappt)
bao write auth/approle/role/webshop token_policies=webshop-read token_ttl=1h
bao read -field=role_id auth/approle/role/webshop/role-id
bao write -wrap-ttl=60s -f auth/approle/role/webshop/secret-id
bao unwrap $WRAP_TOKEN
# SecretID per Accessor auflisten und vernichten
bao list auth/approle/role/webshop/secret-id
bao write auth/approle/role/webshop/secret-id-accessor/destroy secret_id_accessor=$SACC
# Kubernetes-Auth (Tag 11)
bao write auth/kubernetes/config kubernetes_host=https://kubernetes.default.svc:443
bao write auth/kubernetes/role/webshop bound_service_account_names=webshop \
bound_service_account_namespaces=webshop audience=openbao \
token_policies=webshop-read token_ttl=1h
# Login mit ServiceAccount-JWT (CLI ab 2.6)
bao login -no-store -method=kubernetes role=webshop jwt="$JWT"Leases
# Leases unter einem Pfad auflisten
bao list sys/leases/lookup/database/creds/webshop-ro
# Lease ansehen, verlängern, widerrufen
bao lease lookup $LEASE_ID
bao lease renew -increment=1h $LEASE_ID
bao lease revoke $LEASE_ID
# Alle Leases unter Präfix (auch Auth-Tokens)
bao lease revoke -prefix database/creds/webshop-ro
bao lease revoke -prefix auth/approle/
# Wenn das Backend nicht erreichbar ist: trotzdem entfernen
bao lease revoke -force -prefix database/creds/webshop-roDatenbank-Secrets
bao secrets enable database
bao write database/config/postgres plugin_name=postgresql-database-plugin \
connection_url="postgresql://{{username}}:{{password}}@127.0.0.1:5432/postgres" \
allowed_roles=webshop-ro username=postgres password=lab-pg-pw
bao write database/roles/webshop-ro db_name=postgres default_ttl=1h max_ttl=24h \
[email protected]
# Dynamische Zugangsdaten holen
bao read database/creds/webshop-ro
# Root-Passwort rotieren (danach kennt nur OpenBao es)
bao write -f database/rotate-root/postgresTransit
bao secrets enable transit
bao write -f transit/keys/webshop
# Verschlüsseln (Base64 rein), entschlüsseln (Base64 raus)
bao write -field=ciphertext transit/encrypt/webshop plaintext=$(echo -n hallo | base64)
bao write -field=plaintext transit/decrypt/webshop ciphertext=$CT | base64 -d
# Key rotieren, Ciphertext auf neueste Version heben
bao write -f transit/keys/webshop/rotate
bao write -field=ciphertext transit/rewrap/webshop ciphertext=$CT
bao read transit/keys/webshopPKI
bao secrets enable pki
bao secrets tune -max-lease-ttl=87600h pki
bao write -field=certificate pki/root/generate/internal common_name=lab-root ttl=87600h
bao write pki/roles/webshop allowed_domains=webshop.lab allow_subdomains=true max_ttl=72h
# Zertifikat ausstellen, Seriennummern auflisten, aufräumen
bao write pki/issue/webshop common_name=api.webshop.lab ttl=24h
bao list pki/certs
bao write pki/tidy tidy_cert_store=true safety_buffer=1h
# Ablaufdatum prüfen
openssl x509 -in tls.crt -noout -enddate -checkend 0Identity
# Entity anlegen, nachschlagen, auflisten
bao write identity/entity name=thomas policies=webshop-read
bao read identity/entity/name/thomas
bao list identity/entity/name
# Alias: userpass-Login gehört zur Entity
bao write identity/entity-alias name=thomas canonical_id=$ENTITY_ID \
mount_accessor=$(bao auth list -format=json | jq -r '."userpass/".accessor')
# Gruppe mit Mitglied
bao write identity/group name=devs policies=webshop-read member_entity_ids=$ENTITY_IDAudit
# Server-Konfiguration (deklarativ; per API: "cannot enable audit device via API")
audit "file" "file" {
options {
file_path = "/openbao/audit/audit.log"
}
}
bao audit list -detailed
# Wert HMACen, um ihn im Log zu finden (Token, Accessor)
bao write -field=hash sys/audit-hash/file input=$ACC
# Wer hat was wann gemacht?
jq -c 'select(.type=="response") | {time, path: .request.path,
op: .request.operation, ip: .request.remote_address}' audit.log
# Log neu öffnen nach Rotation
kubectl -n openbao exec openbao-0 -- sh -c 'kill -HUP $(pidof bao)'Operator und Raft
# Init (Shamir bzw. Auto-Unseal mit Recovery-Keys), Unseal, Seal
bao operator init -key-shares=5 -key-threshold=3 -format=json
bao operator init -recovery-shares=5 -recovery-threshold=3 -format=json
bao operator unseal
bao operator seal
# Raft-Peers, Autopilot, Mitglieder, Leader abgeben
bao operator raft list-peers
bao operator raft autopilot state
bao operator members
bao operator step-down
# Node beitreten lassen / entfernen
bao operator raft join https://openbao-0.openbao-internal:8200
bao operator raft remove-peer openbao-2
# Snapshot sichern, zurückspielen (fremder Cluster: -force)
bao operator raft snapshot save bao.snap
bao operator raft snapshot restore bao.snap
bao operator raft snapshot restore -force bao.snap
# Unseal-/Recovery-Keys neu erzeugen (ersetzt "operator rekey")
bao operator rotate-keys -init -key-shares=5 -key-threshold=3
bao operator rotate-keys -init -target=recovery -key-shares=5 -key-threshold=3
# Neues Root-Token aus Key-Shares (ab 2.6: Token mit Policy auf
# sys/generate-root-token/* nötig, z. B. Break-Glass-User aus Tag 13)
bao operator generate-root -generate-otp
bao operator generate-root -init -otp=$OTP
bao operator generate-root -decode=$ENCODED -otp=$OTP
# Encryption-Key rotieren, Status
bao operator rotate
bao operator key-status
# Namespaces
bao namespace create team-a
bao namespace list
bao secrets enable -namespace=team-a -path=secret kv-v2Kubernetes und Helm
helm repo add openbao https://openbao.github.io/openbao-helm
helm search repo openbao/openbao --versions | head -3
# Chart-Version immer pinnen; Upgrade = server.image.tag ändern, dann rollen
helm -n openbao upgrade openbao openbao/openbao --version 0.30.2 \
-f ~/bao-lab/k8s/values.yaml
helm -n openbao get values openbao
# Pods mit Rolle und Seal-Status
kubectl -n openbao get pods -o wide -L openbao-active,openbao-sealed
kubectl -n openbao exec -ti openbao-0 -- bao status
kubectl -n openbao logs openbao-0 --tail=50
# StatefulSet nutzt OnDelete: Standbys löschen, step-down, Active zuletzt
kubectl -n openbao delete pod openbao-2
# Version je Raft-Node (Upgrade-Kontrolle)
bao operator raft autopilot state -format=json | jq -r '.Servers[] | "\(.ID) \(.Version)"'
kubectl -n openbao port-forward svc/openbao-active 8200:8200
# TLS-Secret ersetzen
kubectl -n openbao create secret generic openbao-tls --from-file=tls.crt \
--from-file=tls.key --from-file=ca.crt --dry-run=client -o yaml | kubectl apply -f -
# danach SIGHUP je Pod (oder tls_auto_reload = true im Listener, ab 2.7)
# ESO-Status und Sofort-Sync
kubectl -n webshop get externalsecret,secretstore
kubectl -n webshop annotate externalsecret --all force-sync=$(date +%s) --overwriteTroubleshooting mit curl
# Health: 200 active, 429 standby, 501 nicht initialisiert, 503 sealed
curl -s --cacert $BAO_CACERT $BAO_ADDR/v1/sys/health | jq
curl -s -o /dev/null -w '%{http_code}\n' --cacert $BAO_CACERT \
"$BAO_ADDR/v1/sys/health?standbyok=true"
curl -s --cacert $BAO_CACERT $BAO_ADDR/v1/sys/seal-status | jq '{sealed,type,t,n}'
curl -s --cacert $BAO_CACERT $BAO_ADDR/v1/sys/leader | jq
# Mit Token: Raft-Konfiguration, KV lesen, Prometheus-Metriken
H="X-Vault-Token: $BAO_TOKEN"
curl -s --cacert $BAO_CACERT -H "$H" $BAO_ADDR/v1/sys/storage/raft/configuration \
| jq '.data.config.servers'
curl -s --cacert $BAO_CACERT -H "$H" $BAO_ADDR/v1/secret/data/webshop/config \
| jq .data.data
curl -s --cacert $BAO_CACERT -H "$H" "$BAO_ADDR/v1/sys/metrics?format=prometheus" | head
# CLI-Befehl als curl ausgeben
bao kv get -output-curl-string -mount=secret webshop/config
# TLS prüfen
openssl s_client -connect 127.0.0.1:8200 -CAfile $BAO_CACERT </dev/null | grep Verify
# Diagnosepaket für den Support
bao debug -duration=1m -interval=10s -output=bao-debug.tar.gz