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-1Erwartet (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/thomasErwartet (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; echoErwartet (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=rootErwartet:
{"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/webshopErwartet (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-idErwartet:
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_IDErwartet (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=approlemeldetUnknown 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/32Erwartet (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-idErwartet:
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 unwrapErwartet (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_tokenfunktioniert nicht. Es meldetNo data found. Nimm-format=jsonund.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-idErwartet (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 -detailedErwartet (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_durationErwartet:
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 ✘"
doneErwartet:
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 odercreation_pathnicht 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_cidrsundtoken_bound_cidrsauf echte Quellnetze, sonst ist eine gestohlene SecretID überall nutzbar.