Zum Inhalt springen
Trainingslager IT-Trainingslager

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=root

Erwartet (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 list

Erwartet (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/config

Erwartet:

======= 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-42

Erwartet (gekürzt):

version            2

Tipp: Die Kurzform bao kv get secret/webshop/config funktioniert auch. Die CLI-Hilfe nennt sie aber „deprecated“, weil sie den echten API-Pfad secret/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/config

Erwartet (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/config

Erwartet (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 delete liefert kv get keinen Data-Block mehr, aber trotzdem Exit-Code 0. Prüfe in Skripten deshalb deletion_time oder .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; echo

Erwartet:

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/config

Erwartet (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/config

Erwartet:

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 .data

Erwartet:

{"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/config zeigt 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 -dev in 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=@datei oder - für stdin.
  • max_versions und delete_version_after pro Mount festlegen und als Code verwalten (Tag 13).
  • -cas-required oder cas_required verhindert, dass parallele Schreiber sich gegenseitig überschreiben.
  • destroy und metadata delete sind endgültig. Schütze sie per Policy (Tag 2).