Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 3: Auth-Methoden – userpass, AppRole und Response Wrapping

Ziel: Menschen per userpass und Maschinen per AppRole anmelden und die SecretID sicher per Response Wrapping zustellen. · Dauer: ca. 75 min · Voraussetzung: Tag 2

Briefing

  • Eine Auth-Methode tauscht einen Nachweis gegen ein Token. Policies und TTLs kommen aus der Konfiguration von User oder Rolle.
  • userpass ist für Menschen im Lab gedacht. AppRole ist für Maschinen: Die RoleID ist wie ein Benutzername, die SecretID wie ein kurzlebiges Passwort.
  • Response Wrapping packt eine Antwort in ein Einmal-Token. Nur wer es auspackt, sieht den Inhalt. Wird es abgefangen, merkt der Empfänger das.
CI/Orchestrator --(wrap-ttl)--> Wrapping-Token --> App
App: unwrap -> SecretID; RoleID steckt im Image/Config
App: login(RoleID, SecretID) -> Token (webshop-read, 20m)

Drill 1: Vorbereitung

Terminal 1: bao server -dev -dev-root-token-id=root

Terminal 2:

cd ~/bao-lab/tag03
export BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=root
cp ../tag02/webshop-read.hcl .
bao policy write webshop-read webshop-read.hcl
bao kv put -mount=secret webshop/config db_user=webshop db_pass=lab-pw-1

Erwartet (gekürzt):

Success! Uploaded policy: webshop-read
version            1

Fortschritt speichern? Kostenlos registrieren

Drill 2: userpass

bao auth enable userpass
bao write auth/userpass/users/thomas password=lab-pw-thomas \
  token_policies=webshop-read token_ttl=1h
bao read auth/userpass/users/thomas

Erwartet (gekürzt):

Success! Enabled userpass auth method at: userpass/
Success! Data written to: auth/userpass/users/thomas
Key                        Value
---                        -----
token_bound_cidrs          []
token_max_ttl              0s
token_policies             [webshop-read]
token_ttl                  1h
token_type                 default

Login per CLI. Lässt du password= weg, fragt die CLI danach, und das Passwort landet nicht in der History:

unset BAO_TOKEN
bao login -method=userpass username=thomas
bao token lookup | grep -E '^(display_name|path|policies|meta)'
bao kv get -mount=secret -field=db_user webshop/config; echo

Erwartet (gekürzt):

Password (will be hidden):
Success! You are now authenticated. ...
token_duration         1h
token_policies         ["default" "webshop-read"]
token_meta_username    thomas
display_name        userpass-thomas
meta                map[username:thomas]
path                auth/userpass/login/thomas
policies            [default webshop-read]
webshop

Dasselbe per API:

curl -s -X POST -d '{"password":"lab-pw-thomas"}' \
  $BAO_ADDR/v1/auth/userpass/login/thomas \
  | jq -c '.auth | {policies, lease_duration, metadata}'
rm ~/.vault-token && export BAO_TOKEN=root

Erwartet:

{"policies":["default","webshop-read"],"lease_duration":3600,
 "metadata":{"username":"thomas"}}

Fortschritt speichern? Kostenlos registrieren

Drill 3: AppRole webshop anlegen

bao auth enable approle
bao write auth/approle/role/webshop \
  token_policies=webshop-read token_ttl=20m token_max_ttl=1h \
  bind_secret_id=true secret_id_ttl=10m secret_id_num_uses=1 \
  secret_id_bound_cidrs=127.0.0.1/32
bao read auth/approle/role/webshop

Erwartet (gekürzt):

Success! Enabled approle auth method at: approle/
Success! Data written to: auth/approle/role/webshop
Key                        Value
---                        -----
bind_secret_id             true
secret_id_bound_cidrs      [127.0.0.1/32]
secret_id_num_uses         1
secret_id_ttl              10m
token_max_ttl              1h
token_policies             [webshop-read]
token_ttl                  20m
Parameter Wirkung
bind_secret_id Für den Login ist eine SecretID nötig. Lass es auf true.
secret_id_ttl Wie lange eine SecretID gültig ist.
secret_id_num_uses Wie oft eine SecretID benutzt werden darf. 1 heißt Einmal-Passwort.
secret_id_bound_cidrs Von welchen Quell-IPs ein Login erlaubt ist.

Fortschritt speichern? Kostenlos registrieren

Drill 4: RoleID, SecretID, Login

bao read auth/approle/role/webshop/role-id
bao write -f auth/approle/role/webshop/secret-id

Erwartet:

Key        Value
---        -----
role_id    e6d4b29c-ea95-33ab-e221-e222acd87c6c
Key                   Value
---                   -----
secret_id             c0fbd747-8419-035d-be8d-6c2f3e7e5b47
secret_id_accessor    1737860f-c4c6-26a2-d5e3-a65bca0c008f
secret_id_num_uses    1
secret_id_ttl         10m

Login per CLI. Für AppRole gibt es kein bao login -method=approle. Du schreibst direkt auf den Login-Pfad:

ROLE_ID=$(bao read -field=role_id auth/approle/role/webshop/role-id)
SECRET_ID=$(bao write -f -field=secret_id auth/approle/role/webshop/secret-id)
bao write auth/approle/login role_id=$ROLE_ID secret_id=$SECRET_ID
bao write auth/approle/login role_id=$ROLE_ID secret_id=$SECRET_ID

Erwartet (gekürzt):

Key                     Value
---                     -----
token                   s.nFjFikeldgveVuN6umToj95T
token_duration          20m
token_policies          ["default" "webshop-read"]
token_meta_role_name    webshop
Error writing data to auth/approle/login: Error making API request.
Code: 400. Errors:

* invalid role or secret ID

Der zweite Login scheitert, weil secret_id_num_uses=1 gilt.

Achtung: bao login -method=approle meldet Unknown auth method: approle. Die CLI hat für AppRole keinen Login-Helfer.

Per curl, so wie es eine App tun würde:

SECRET_ID=$(bao write -f -field=secret_id auth/approle/role/webshop/secret-id)
curl -s -X POST -d "{\"role_id\":\"$ROLE_ID\",\"secret_id\":\"$SECRET_ID\"}" \
  $BAO_ADDR/v1/auth/approle/login | jq -c '.auth | {policies, lease_duration, metadata}'

Erwartet:

{"policies":["default","webshop-read"],"lease_duration":1200,
 "metadata":{"role_name":"webshop"}}

Fortschritt speichern? Kostenlos registrieren

Drill 5: CIDR-Bindung prüfen

bao write auth/approle/role/webshop secret_id_bound_cidrs=10.0.0.0/8
SECRET_ID=$(bao write -f -field=secret_id auth/approle/role/webshop/secret-id)
bao write auth/approle/login role_id=$ROLE_ID secret_id=$SECRET_ID
bao write auth/approle/role/webshop secret_id_bound_cidrs=127.0.0.1/32

Erwartet (gekürzt):

Code: 400. Errors:

* source address "127.0.0.1" unauthorized by CIDR restrictions on the role: %!w(<nil>)

Das Anhängsel %!w(<nil>) ist ein Formatierungsfehler (noch in v2.7.1) und kein Problem deiner Konfiguration. bao write auf eine bestehende Rolle ändert nur die übergebenen Felder. token_policies bleibt also erhalten.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Response Wrapping

bao write -wrap-ttl=5m -f auth/approle/role/webshop/secret-id

Erwartet:

Key                              Value
---                              -----
wrapping_token:                  s.U2jG7vG91s440vXGikEIhpy0
wrapping_accessor:               pzz6YYhUUYSEP00moOEdEP9b
wrapping_token_ttl:              5m
wrapping_token_creation_time:    2026-10-08 09:00:39.508782 +0200 CEST
wrapping_token_creation_path:    auth/approle/role/webshop/secret-id
wrapped_accessor:                ed2e8be6-e375-8c95-c07c-ea980da81d76

Prüfen, auspacken, ein zweites Mal auspacken:

WRAP=$(bao write -wrap-ttl=5m -field=wrapping_token -f \
  auth/approle/role/webshop/secret-id)
bao write sys/wrapping/lookup token=$WRAP
SECRET_ID=$(BAO_TOKEN=$WRAP bao unwrap -field=secret_id); echo $SECRET_ID
BAO_TOKEN=$WRAP bao unwrap

Erwartet (gekürzt):

Key              Value
---              -----
creation_path    auth/approle/role/webshop/secret-id
creation_time    2026-10-08T09:00:48.524487+02:00
creation_ttl     5m
b5e26b57-4ac3-8426-5a25-3b11bbe9f959
Error unwrapping: Error making API request.
Code: 400. Errors:

* wrapping token is not valid or does not exist

Warum lookup vor unwrap? Der Empfänger prüft damit, ob creation_path stimmt. Kommt das Token von einem anderen Pfad oder ist es schon verbraucht, hat jemand manipuliert. Dann: Alarm statt Login.

Wrapping geht mit jeder Antwort, auch mit KV:

KW=$(bao kv get -mount=secret -wrap-ttl=2m -format=json webshop/config \
  | jq -r .wrap_info.token)
bao unwrap -format=json $KW | jq -c '.data.data'

Erwartet:

{"db_pass":"lab-pw-1","db_user":"webshop"}

Achtung: bao kv get -wrap-ttl=… -field=wrapping_token funktioniert nicht. Es meldet No data found. Nimm -format=json und .wrap_info.token.

Per curl setzt du den Header X-Vault-Wrap-TTL:

curl -s -X POST -H "X-Vault-Token: $BAO_TOKEN" -H "X-Vault-Wrap-TTL: 60s" \
  $BAO_ADDR/v1/auth/approle/role/webshop/secret-id \
  | jq -c '.wrap_info | {ttl, creation_path}'

Erwartet:

{"ttl":60,"creation_path":"auth/approle/role/webshop/secret-id"}

Fortschritt speichern? Kostenlos registrieren

Drill 7: Secure Introduction erzwingen

Der Deployer darf SecretIDs nur verpackt erzeugen und die RoleID nicht lesen. Wer nur eine Hälfte kennt, kommt nicht rein:

cat > webshop-deployer.hcl <<'EOF'
# Nur SecretIDs fuer webshop – und nur verpackt
path "auth/approle/role/webshop/secret-id" {
  capabilities = ["update"]
  min_wrapping_ttl = "1m"
  max_wrapping_ttl = "10m"
}
EOF
bao policy write webshop-deployer webshop-deployer.hcl
D=$(bao token create -field=token -policy=webshop-deployer -ttl=1h)
BAO_TOKEN=$D bao write -f auth/approle/role/webshop/secret-id
BAO_TOKEN=$D bao write -wrap-ttl=5m -f auth/approle/role/webshop/secret-id | grep ttl
BAO_TOKEN=$D bao read auth/approle/role/webshop/role-id

Erwartet (gekürzt):

Code: 403. Errors:
    * permission denied
wrapping_token_ttl:              5m
Code: 403. Errors:
    * permission denied

Fortschritt speichern? Kostenlos registrieren

Drill 8: Auth-Methoden tunen

bao auth tune -default-lease-ttl=30m -max-lease-ttl=2h userpass/
bao read sys/auth/userpass/tune
bao auth list -detailed

Erwartet (gekürzt):

Success! Tuned the auth method at: userpass/
Key                  Value
---                  -----
default_lease_ttl    30m
max_lease_ttl        2h
token_type           default-service
Path         Plugin      Accessor                  Default TTL    Max TTL    ...
approle/     approle     auth_approle_e866d912     system         system     ...
token/       token       auth_token_c7cfa6a7       system         system     ...
userpass/    userpass    auth_userpass_75a6bdfb    1800           7200       ...

Ein neuer User ohne eigenes token_ttl erbt jetzt 30 Minuten:

bao write auth/userpass/users/anna password=lab-pw-anna token_policies=webshop-read
bao write -format=json auth/userpass/login/anna password=lab-pw-anna \
  | jq .auth.lease_duration

Erwartet:

1800

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

export BAO_TOKEN=root
R=$(bao read -field=role_id auth/approle/role/webshop/role-id)
W=$(bao write -wrap-ttl=2m -field=wrapping_token -f auth/approle/role/webshop/secret-id)
SID=$(BAO_TOKEN=$W bao unwrap -field=secret_id)
T=$(bao write -field=token auth/approle/login role_id=$R secret_id=$SID)
[ -n "$T" ] && echo "✔ AppRole-Login mit Wrapped SecretID" || echo "✘ AppRole-Login"
[ "$(BAO_TOKEN=$T bao kv get -mount=secret -field=db_user webshop/config)" = webshop ] \
  && echo "✔ webshop liest Secret" || echo "✘ Secret lesen"
bao auth list | grep -q '^userpass/' && echo "✔ userpass" || echo "✘ userpass"
[ "$(bao read -field=default_lease_ttl sys/auth/userpass/tune)" = 1800 ] \
  && echo "✔ userpass-TTL 30m" || echo "✘ userpass-TTL"

Challenge

Lege die AppRole batch-job an. Ihre SecretID soll 3 Logins erlauben, und ihre Tokens sollen nach 5 Minuten hart enden, ohne Verlängerung. Beweise, dass der vierte Login scheitert.

Hinweis: token_max_ttl gleich token_ttl verhindert jede Verlängerung über die Start-TTL hinaus.

Lösung

bao write auth/approle/role/batch-job token_policies=webshop-read \
  token_ttl=5m token_max_ttl=5m secret_id_num_uses=3 secret_id_ttl=10m
R=$(bao read -field=role_id auth/approle/role/batch-job/role-id)
S=$(bao write -f -field=secret_id auth/approle/role/batch-job/secret-id)
for i in 1 2 3 4; do
  bao write -field=token auth/approle/login role_id=$R secret_id=$S >/dev/null 2>&1 \
    && echo "Login $i ✔" || echo "Login $i ✘"
done

Erwartet:

Success! Data written to: auth/approle/role/batch-job
Login 1 ✔
Login 2 ✔
Login 3 ✔
Login 4 ✘

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • RoleID und SecretID über zwei verschiedene Kanäle liefern: RoleID per Config-Management, SecretID per Wrapping aus der CI.
  • Erzwinge Wrapping per Policy mit min_wrapping_ttl. Alarmiere, wenn ein Unwrap scheitert oder creation_path nicht stimmt (Audit-Log, Tag 6 und 12).
  • In Kubernetes nimmst du statt AppRole besser die Kubernetes-Auth (Tag 11). Dann gibt es kein Secret-Zero.
  • userpass gehört nicht in Produktion. Nimm OIDC oder LDAP mit MFA und Gruppen-Mapping (Tag 6). LDAP ist seit v2.7.0 nicht mehr eingebaut, sondern ein Plugin aus openbao-plugins.
  • Setze secret_id_bound_cidrs und token_bound_cidrs auf echte Quellnetze, sonst ist eine gestohlene SecretID überall nutzbar.