Tag 2: Tokens und Policies
Ziel: Tokens gezielt erzeugen, verlängern und widerrufen sowie Least-Privilege-Policies schreiben und testen. · Dauer: ca. 75 min · Voraussetzung: Tag 1
Briefing
- Jeder Zugriff braucht ein Token. Jedes Token hat Policies, eine TTL und meist ein Eltern-Token.
- Wird ein Eltern-Token widerrufen, sind auch alle Kinder weg. Die Ausnahme sind Orphan-Tokens.
- Eine Policy erlaubt Capabilities auf Pfaden. Alles, was nicht
erlaubt ist, ist verboten.
denyschlägt jede Erlaubnis. - Der Accessor ist eine Referenz auf ein Token. Damit kannst du das Token nachschlagen oder widerrufen, aber nicht benutzen.
root
├─ Token A (default, ttl 1h, max 2h)
│ └─ Kind A1 <- stirbt mit A
└─ Orphan B <- überlebt A
Drill 1: Frischer Server und erstes Token
Terminal 1: bao server -dev -dev-root-token-id=root
Terminal 2:
cd ~/bao-lab/tag02
export BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=root
bao token lookupErwartet (gekürzt):
accessor 251a0VhPOrWfPFAGGybachGV
explicit_max_ttl 0s
id root
orphan true
policies [root]
ttl 0s
Das Root-Token läuft nie ab (ttl 0s). Genau deshalb ist
es gefährlich (Tag 13).
bao token create -policy=default -ttl=1h -explicit-max-ttl=2hErwartet:
Key Value
--- -----
token s.uY94PuSeZJF7uxLcW35LwQux
token_accessor vD0klFhFClKaV1nxS1IEvPNc
token_duration 1h
token_renewable true
token_policies ["default"]
identity_policies []
policies ["default"]
Tipp: OpenBao-Service-Tokens beginnen mit
s.. Vault verwendet heutehvs..
Fortschritt speichern? Kostenlos registrieren
Drill 2: Renew und harte Obergrenze
T=$(bao token create -field=token -policy=default -ttl=1h -explicit-max-ttl=2h)
bao token renew -increment=90m $T | grep duration
bao token renew -increment=3h $TErwartet (gekürzt):
token_duration 1h30m
WARNING! The following warnings were returned from OpenBao:
* TTL of "3h" exceeded the effective max_ttl of "2h"; TTL value is capped
accordingly
token_duration 2h
Nach 2 Stunden ist das Token tot, egal wie oft du es verlängerst.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Periodisch, begrenzt, Orphan
Ein periodisches Token hat keine Obergrenze, solange es innerhalb von
period erneuert wird. Das passt für langlebige Dienste:
P=$(bao token create -field=token -policy=default -period=24h)
bao token lookup -format=json $P | jq -c '.data | {period, ttl, explicit_max_ttl}'Erwartet:
{"period":86400,"ttl":86399,"explicit_max_ttl":0}
Ein Token mit Nutzungslimit:
U=$(bao token create -field=token -policy=default -use-limit=2)
BAO_TOKEN=$U bao token lookup -format=json | jq .data.num_uses
BAO_TOKEN=$U bao token lookup -format=json | jq .data.num_uses
BAO_TOKEN=$U bao token lookupErwartet (gekürzt):
1
-1
Code: 403. Errors:
* permission denied
Jeder Request verbraucht eine Nutzung. Nach dem zweiten Request ist das Token widerrufen.
Eltern, Kind und Orphan. Das Token default darf keine
Kinder erzeugen. Darum bekommt der Elternteil eine kleine Policy:
bao policy write token-creator - <<'EOF'
path "auth/token/create" {
capabilities = ["create", "update"]
}
EOF
PARENT=$(bao token create -field=token -policy=token-creator)
CHILD=$(BAO_TOKEN=$PARENT bao token create -field=token -policy=default)
ORPH=$(bao token create -field=token -policy=default -orphan)
bao token revoke $PARENT
bao token lookup $CHILD
bao token lookup -format=json $ORPH | jq .data.orphanErwartet (gekürzt):
Success! Uploaded policy: token-creator
Success! Revoked token (if it existed)
Code: 403. Errors:
* bad token
true
Tipp:
bao token revoke -mode=orphan <token>widerruft nur das Eltern-Token. Die Kinder werden dann zu Orphans.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Accessor und Capabilities
J=$(bao token create -format=json -policy=default -ttl=1h)
TOK=$(echo "$J" | jq -r .auth.client_token)
ACC=$(echo "$J" | jq -r .auth.accessor)
bao token lookup -accessor $ACC | grep -E '^(id|policies|ttl) '
bao token capabilities $TOK auth/token/lookup-self
bao token capabilities $TOK secret/data/webshop/config
bao token revoke -accessor $ACC
bao list auth/token/accessorsErwartet (gekürzt):
id n/a
policies [default]
ttl 59m59s
read
deny
Success! Revoked token (if it existed)
Keys
----
251a0VhPOrWfPFAGGybachGV
...
Warum id n/a? Über den Accessor siehst du nie das Token
selbst. Deshalb darf ein Operator mit Accessor-Rechten Tokens verwalten,
ohne sie stehlen zu können.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Policy
webshop-read schreiben
bao kv put -mount=secret webshop/config db_user=webshop db_pass=lab-pw-1
bao kv put -mount=secret webshop/admin root_pw=lab-admin
bao kv put -mount=secret billing/config iban=DE00-LAB
cat > webshop-read.hcl <<'EOF'
# Inhalte lesen (KV v2: data/)
path "secret/data/webshop/*" {
capabilities = ["read"]
}
# Auflisten und Versionen sehen (KV v2: metadata/)
path "secret/metadata/webshop/*" {
capabilities = ["read", "list"]
}
# Admin-Secret sperren – deny gewinnt immer
path "secret/data/webshop/admin" {
capabilities = ["deny"]
}
EOF
bao policy fmt webshop-read.hcl
bao policy write webshop-read webshop-read.hclErwartet (gekürzt):
Success! Formatted policy: webshop-read.hcl
Success! Uploaded policy: webshop-read
Achtung: Bei KV v2 schreibst du in der Policy
secret/data/…, nichtsecret/…. Die CLI ergänztdata/, die Policy nicht.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Policy testen und 403 provozieren
Melde dich mit einem eingeschränkten Token an. bao login
speichert das Token in ~/.vault-token. Ein gesetztes
BAO_TOKEN hätte aber Vorrang, deshalb kommt zuerst
unset:
W=$(bao token create -field=token -policy=webshop-read -ttl=30m)
unset BAO_TOKEN
bao login $WErwartet (gekürzt):
Success! You are now authenticated. The token information displayed below is
already stored in the token helper. You do NOT need to run "bao login" again.
token_duration 29m59s
token_policies ["default" "webshop-read"]
bao kv get -mount=secret -field=db_user webshop/config; echo
bao kv list -mount=secret webshop
bao kv get -mount=secret webshop/admin
bao kv get -mount=secret billing/config
bao kv put -mount=secret webshop/config x=1Erwartet (gekürzt):
webshop
Keys
----
admin
config
Error reading secret/data/webshop/admin: Error making API request.
Code: 403. Errors:
* permission denied
Error reading secret/data/billing/config: Error making API request.
Code: 403. Errors:
* permission denied
Error writing data to secret/data/webshop/config: Error making API request.
Code: 403. Errors:
* permission denied
Jetzt prüfst du, ohne etwas auszuprobieren:
bao token capabilities secret/data/webshop/config
bao token capabilities secret/data/webshop/admin
bao token capabilities secret/metadata/webshop/Erwartet:
read
deny
list, read
Zurück zu root:
bao token revoke -self && export BAO_TOKEN=root.
Tipp: Jede Policy erhält automatisch die Policy
default. Lies sie einmal mitbao policy read default. Sie erlaubt unter anderemlookup-self,renew-self,revoke-selfundsys/capabilities-self. Willst du sie nicht, nutze-no-default-policy.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Glob * und Segment
+
* steht nur am Ende und passt auf alles, auch auf
/. + passt auf genau ein Pfadsegment:
bao kv put -mount=secret apps/shop/config k=1
bao kv put -mount=secret apps/crm/extra/deep k=3
bao policy write apps-config - <<'EOF'
path "secret/data/apps/+/config" {
capabilities = ["read"]
}
EOF
A=$(bao token create -field=token -policy=apps-config)
for p in apps/shop/config apps/crm/config apps/crm/extra/deep; do
echo "$p: $(bao token capabilities $A secret/data/$p)"
doneErwartet (gekürzt):
apps/shop/config: read
apps/crm/config: read
apps/crm/extra/deep: deny
Fortschritt speichern? Kostenlos registrieren
Drill 8: Parameter einschränken
cat > shop-writer.hcl <<'EOF'
# Feature-Flags schreiben – nur mit Feld "data"
path "secret/data/webshop/feature-*" {
capabilities = ["create", "update"]
required_parameters = ["data"]
}
# Kind-Tokens nur mit webshop-read und TTL 15m/30m (die CLI sendet "15m0s")
path "auth/token/create" {
capabilities = ["update"]
allowed_parameters = {
"policies" = [["webshop-read"]]
"ttl" = ["15m0s", "30m0s"]
"*" = []
}
}
EOF
bao policy write shop-writer shop-writer.hcl
export BAO_TOKEN=$(bao token create -field=token -policy=shop-writer -policy=webshop-read)
bao token create -policy=webshop-read -ttl=15m | grep duration
bao token create -policy=webshop-read -ttl=24h
bao token create -policy=default -ttl=15mErwartet (gekürzt):
token_duration 15m
Error creating token: Error making API request.
Code: 403. Errors:
* permission denied
Error creating token: Error making API request.
Code: 403. Errors:
* permission denied
Warum "*" = []? Die CLI sendet immer auch
period, renewable, num_uses und
weitere Felder. Ohne * wären diese verboten. Und warum
bekommt der Elternteil auch webshop-read? Die Policies
eines Kind-Tokens müssen eine Teilmenge der Policies des Elternteils
sein. Sonst antwortet OpenBao mit
child policies must be subset of parent.
Tipp: Welche Felder ein Befehl wirklich sendet, zeigt
-output-curl-string.
required_parameters testest du per curl:
curl -s -X POST -H "X-Vault-Token: $BAO_TOKEN" -d '{"options":{}}' \
$BAO_ADDR/v1/secret/data/webshop/feature-y
export BAO_TOKEN=rootErwartet:
{"errors":["1 error occurred:\n\t* permission denied\n\n"]}
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
export BAO_TOKEN=root
W=$(bao token create -field=token -policy=webshop-read -ttl=10m)
c() { [ "$(bao token capabilities $W "$1")" = "$2" ] \
&& echo "✔ $1 = $2" || echo "✘ $1 != $2"; }
c secret/data/webshop/config read
c secret/data/webshop/admin deny
c secret/data/billing/config deny
c secret/metadata/webshop/ "list, read"
bao policy list | grep -qx shop-writer && echo "✔ shop-writer" || echo "✘ shop-writer"Challenge
Schreib eine Policy webshop-ops. Sie darf unter
secret/webshop/ lesen, schreiben und Versionen soft-löschen
und wiederherstellen. Sie darf aber nie destroy ausführen
und keine Metadaten löschen.
Hinweis: destroy hat einen eigenen
API-Pfad. Metadaten löscht delete auf
metadata/.
Lösung
bao policy write webshop-ops - <<'EOF'
path "secret/data/webshop/*" {
capabilities = ["create", "read", "update", "patch", "delete"]
}
path "secret/delete/webshop/*" {
capabilities = ["update"]
}
path "secret/undelete/webshop/*" {
capabilities = ["update"]
}
path "secret/metadata/webshop/*" {
capabilities = ["read", "list"]
}
path "secret/destroy/webshop/*" {
capabilities = ["deny"]
}
EOF
O=$(bao token create -field=token -policy=webshop-ops)
BAO_TOKEN=$O bao kv delete -mount=secret webshop/config
BAO_TOKEN=$O bao kv undelete -mount=secret -versions=1 webshop/config
BAO_TOKEN=$O bao kv destroy -mount=secret -versions=1 webshop/config
BAO_TOKEN=$O bao kv metadata delete -mount=secret webshop/configErwartet (gekürzt):
Success! Data deleted (if it existed) at: secret/data/webshop/config
Success! Data written to: secret/undelete/webshop/config
Error writing data to secret/destroy/webshop/config: Error making API request.
Code: 403. Errors:
Error deleting secret/metadata/webshop/config: Error making API request.
Code: 403. Errors:
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Vergib nie Root-Tokens an Menschen oder Apps. Nutze Auth-Methoden (Tag 3) mit kurzen TTLs.
- Setze
-explicit-max-ttlodertoken_max_ttl. Periodische Tokens nur für Dienste, die sich selbst erneuern. - Verwalte Policies als Code mit Review, zum Beispiel per
Terraform/OpenTofu (Tag 13), und teste sie mit
token capabilitiesin der CI. - Arbeite mit Accessors in Runbooks und Audit-Analysen, nie mit Tokens.
- Lege Pfade so an, dass Policies einfach bleiben, etwa
secret/<team>/<app>/….