Tag 1: Dev-Server und KV v2
Ziel: Secrets in KV v2 schreiben, versionieren, löschen und retten, per CLI und per API. · Dauer: ca. 60 min · Voraussetzung: Tag 0
Briefing
- Der Dev-Server läuft im RAM, ist schon entsiegelt und hat
secret/als KV v2. Nach einem Neustart sind alle Daten weg. - KV v2 speichert jede Änderung als neue Version. Die API trennt die
Inhalte (
secret/data/…) von den Metadaten (secret/metadata/…). - Diese Trennung brauchst du ab Tag 2 für die Policies.
secret/data/webshop/config -> Inhalt (Version n)
secret/metadata/webshop/config -> Versionen, max_versions, custom_metadata
secret/delete|undelete|destroy/ -> Versionen löschen, retten, vernichten
Drill 1: Dev-Server starten
Terminal 1:
bao server -dev -dev-root-token-id=rootErwartet (gekürzt):
==> OpenBao server configuration:
Api Address: http://127.0.0.1:8200
Storage: inmem
Version: OpenBao v2.7.1, committed 2026-10-01T15:32:54Z
WARNING! dev mode is enabled! In this mode, OpenBao runs entirely in-memory
Unseal Key: vz52pbAft3HVEPB+8o4BV1GHJB5PXsmbw2/I2Ckol84=
Root Token: root
Terminal 2:
cd ~/bao-lab/tag01
export BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=root
bao status
bao secrets listErwartet (gekürzt):
Key Value
--- -----
Seal Type shamir
Initialized true
Sealed false
Total Shares 1
Threshold 1
Version 2.7.1
Commit Date 2026-10-01T15:32:54Z
Storage Type inmem
HA Enabled false
Path Type Accessor Description
---- ---- -------- -----------
cubbyhole/ cubbyhole cubbyhole_46e09526 per-token private secret storage
identity/ identity identity_5764417f identity store
secret/ kv kv_68a32e3c key/value secret storage
sys/ system system_0406b0f9 system endpoints used for control, ...
Fortschritt speichern? Kostenlos registrieren
Drill 2: Schreiben, lesen, patchen
bao kv put -mount=secret webshop/config db_user=webshop db_pass=lab-pw-1
bao kv get -mount=secret webshop/configErwartet:
======= Secret Path =======
secret/data/webshop/config
======= Metadata =======
Key Value
--- -----
created_time 2026-10-08T06:58:26.847918Z
custom_metadata <nil>
deletion_time n/a
destroyed false
version 1
===== Data =====
Key Value
--- -----
db_pass lab-pw-1
db_user webshop
Die Werte sind Lab-Secrets. put ersetzt immer das ganze
Secret. patch ändert nur einzelne Felder:
bao kv patch -mount=secret webshop/config api_key=lab-key-42Erwartet (gekürzt):
version 2
Tipp: Die Kurzform
bao kv get secret/webshop/configfunktioniert auch. Die CLI-Hilfe nennt sie aber „deprecated“, weil sie den echten API-Pfadsecret/data/…verschleiert. Nimm-mount=.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Ausgaben für Skripte
bao kv get -mount=secret -field=db_pass webshop/config; echo
bao kv get -mount=secret -format=json webshop/config | jq '.data.data'
bao kv get -mount=secret -format=json webshop/config | jq '.data.metadata.version'Erwartet:
lab-pw-1
{
"api_key": "lab-key-42",
"db_pass": "lab-pw-1",
"db_user": "webshop"
}
2
Warum das echo? -field gibt den Wert ohne
Zeilenumbruch aus. Das ist ideal für $(…), im Terminal aber
unschön.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Versionen
bao kv put -mount=secret webshop/config \
db_user=webshop db_pass=lab-pw-3 api_key=lab-key-42
bao kv get -mount=secret -version=1 -field=db_pass webshop/config; echo
bao kv metadata get -mount=secret webshop/configErwartet (gekürzt):
lab-pw-1
======== Metadata Path ========
secret/metadata/webshop/config
============ Metadata ============
Key Value
--- -----
cas_required false
current_version 3
custom_metadata <nil>
delete_version_after 0s
max_versions 0
oldest_version 0
====== Version 1 ======
...
====== Version 3 ======
created_time 2026-10-08T06:58:27.32184Z
deletion_time n/a
destroyed false
max_versions 0 heißt: Es gilt der Mount-Standard von 10
Versionen.
Fortschritt speichern? Kostenlos registrieren
Drill 5: delete, undelete, destroy
bao kv delete -mount=secret webshop/config
bao kv get -mount=secret webshop/configErwartet (gekürzt):
Success! Data deleted (if it existed) at: secret/data/webshop/config
======= Metadata =======
deletion_time 2026-10-08T06:58:33.145983Z
destroyed false
version 3
Achtung: Nach einem
deleteliefertkv getkeinenData-Block mehr, aber trotzdem Exit-Code 0. Prüfe in Skripten deshalbdeletion_timeoder.data.data == null.
delete ist ein Soft-Delete. Du kannst die Version
zurückholen:
bao kv undelete -mount=secret -versions=3 webshop/config
bao kv get -mount=secret -field=db_pass webshop/config; echoErwartet:
Success! Data written to: secret/undelete/webshop/config
lab-pw-3
destroy löscht endgültig:
bao kv destroy -mount=secret -versions=1 webshop/config
bao kv get -mount=secret -version=1 webshop/configErwartet (gekürzt):
Success! Data written to: secret/destroy/webshop/config
destroyed true
version 1
Fortschritt speichern? Kostenlos registrieren
Drill 6: Metadaten und Rollback
bao kv metadata put -mount=secret -max-versions=5 -delete-version-after=720h \
-custom-metadata=owner=team-shop -custom-metadata=env=lab webshop/config
bao kv metadata get -mount=secret -format=json webshop/config \
| jq '.data | {max_versions, delete_version_after, custom_metadata}'Erwartet:
Success! Data written to: secret/metadata/webshop/config
{
"max_versions": 5,
"delete_version_after": "720h0m0s",
"custom_metadata": {
"env": "lab",
"owner": "team-shop"
}
}
Ein Rollback schreibt den Inhalt einer alten Version als neue Version:
bao kv rollback -mount=secret -version=2 webshop/config
bao kv get -mount=secret -format=json webshop/config \
| jq -c '.data.data, .data.metadata.version'Erwartet (gekürzt):
custom_metadata map[env:lab owner:team-shop]
deletion_time 2026-11-07T06:58:33.667548Z
version 4
{"api_key":"lab-key-42","db_pass":"lab-pw-1","db_user":"webshop"}
4
Warum hat Version 4 eine deletion_time? Wegen
delete_version_after=720h wird sie in 30 Tagen automatisch
gelöscht.
Fortschritt speichern? Kostenlos registrieren
Drill 7: KV v1 und eigener Mount
bao secrets enable -path=kv1 -version=1 kv
bao kv put -mount=kv1 webshop/config db_pass=lab-pw-1
bao kv get -mount=kv1 webshop/configErwartet:
Success! Enabled the kv secrets engine at: kv1/
Success! Data written to: kv1/webshop/config
===== Data =====
Key Value
--- -----
db_pass lab-pw-1
| Merkmal | KV v1 | KV v2 |
|---|---|---|
| Versionen, Undelete, Rollback | nein | ja |
| API-Pfad für Daten | kv1/<pfad> |
<mount>/data/<pfad> |
| Metadaten, Check-and-Set | nein | ja |
Eigener KV-v2-Mount für ein Team:
bao secrets enable -path=team-shop -version=2 -description="Webshop-Team" kv
bao kv put -mount=team-shop app/flags beta=true
bao secrets list -detailed | grep -E '^(Path|kv1|secret|team-shop)'Erwartet (gekürzt):
Path Plugin Accessor Default TTL Max TTL ...
kv1/ kv kv_6a873da7 system system ...
secret/ kv kv_68a32e3c system system ...
team-shop/ kv kv_87cf6012 system system ...
Fortschritt speichern? Kostenlos registrieren
Drill 8: Die API mit curl
curl -s -H "X-Vault-Token: $BAO_TOKEN" \
$BAO_ADDR/v1/secret/data/webshop/config | jq -c '.data.data'
curl -s -H "Authorization: Bearer $BAO_TOKEN" \
$BAO_ADDR/v1/secret/data/webshop/config | jq -c '.data.data'
curl -s -X POST -H "X-Vault-Token: $BAO_TOKEN" \
-d '{"data":{"db_user":"webshop","db_pass":"lab-pw-5"}}' \
$BAO_ADDR/v1/secret/data/webshop/config | jq -c '.data.version'
curl -s -H "X-Vault-Token: $BAO_TOKEN" \
"$BAO_ADDR/v1/secret/metadata/webshop?list=true" | jq -c .dataErwartet:
{"api_key":"lab-key-42","db_pass":"lab-pw-1","db_user":"webshop"}
{"api_key":"lab-key-42","db_pass":"lab-pw-1","db_user":"webshop"}
5
{"keys":["config"]}
Der Header heißt auch bei OpenBao X-Vault-Token. Einen
X-Bao-Token-Header gibt es nicht:
curl -s -H "X-Bao-Token: $BAO_TOKEN" $BAO_ADDR/v1/secret/data/webshop/config
curl -s $BAO_ADDR/v1/sys/health | jq -c '{initialized, sealed, version}'Erwartet:
{"errors":["permission denied"]}
{"initialized":true,"sealed":false,"version":"2.7.1"}
Tipp:
bao kv get -mount=secret -output-curl-string webshop/configzeigt dir den passenden curl-Befehl, ohne ihn auszuführen.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
ok() { "$@" >/dev/null 2>&1 && echo "✔ $*" || echo "✘ $*"; }
ok bao status
ok bao kv get -mount=secret webshop/config
ok bao kv get -mount=team-shop app/flags
[ "$(bao kv metadata get -mount=secret -format=json webshop/config \
| jq .data.max_versions)" = 5 ] && echo "✔ max_versions=5" || echo "✘ max_versions"
bao secrets list | grep -q '^kv1/' && echo "✔ kv1/" || echo "✘ kv1/"Challenge
Begrenze den ganzen Mount team-shop/ auf 3 Versionen.
Schreib dann fünf Versionen von app/flags und beweise, dass
nur noch die Versionen 3 bis 5 existieren.
Hinweis: Einstellungen für den ganzen Mount stehen
unter <mount>/config.
Lösung
bao write team-shop/config max_versions=3
for i in 2 3 4 5; do bao kv put -mount=team-shop app/flags beta=$i >/dev/null; done
bao kv metadata get -mount=team-shop -format=json app/flags \
| jq -c '.data.versions | keys'Erwartet:
Success! Data written to: team-shop/config
["3","4","5"]
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Nie
-devin Produktion: Speicher im RAM, kein TLS, Root-Token bekannt. - Secrets nie als Argument auf der Kommandozeile übergeben, sonst
landen sie in der Shell-History. Besser:
bao kv put -mount=secret app/x db_pass=@dateioder-für stdin. max_versionsunddelete_version_afterpro Mount festlegen und als Code verwalten (Tag 13).-cas-requiredodercas_requiredverhindert, dass parallele Schreiber sich gegenseitig überschreiben.destroyundmetadata deletesind endgültig. Schütze sie per Policy (Tag 2).