Zum Inhalt springen
Trainingslager IT-Trainingslager

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. deny schlä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 lookup

Erwartet (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=2h

Erwartet:

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 heute hvs..

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 $T

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

Erwartet (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.orphan

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

Erwartet (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.hcl

Erwartet (gekürzt):

Success! Formatted policy: webshop-read.hcl
Success! Uploaded policy: webshop-read

Achtung: Bei KV v2 schreibst du in der Policy secret/data/…, nicht secret/…. Die CLI ergänzt data/, 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 $W

Erwartet (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=1

Erwartet (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 mit bao policy read default. Sie erlaubt unter anderem lookup-self, renew-self, revoke-self und sys/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)"
done

Erwartet (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=15m

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

Erwartet:

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

Erwartet (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-ttl oder token_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 capabilities in 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>/….