Tag 10: Pipeline-Identität
Ziel: Deine Pipeline meldet sich mit einem kurzlebigen, signierten JWT statt mit einem statischen Token an, und Legacy-CI bekommt AppRole mit Response Wrapping. · Dauer: ca. 90 min · Voraussetzung: Tag 2
Briefing
- Ein statischer CI-Token ist ein Bearer-Secret ohne Kontext: Wer ihn hat, ist „die Pipeline”, egal aus welchem Repo, Branch oder Fork.
- Moderne CI-Systeme stellen pro Job ein signiertes JWT aus (OIDC).
OpenBao prüft Signatur, Issuer, Audience, Ablauf und Claims wie
repositoryoderref. - Die Rolle entscheidet: welcher Claim-Wert welche Policy bekommt, und wie lange.
- Heute spielst du den CI-Issuer selbst: RSA-Schlüssel plus Skript, das GitHub-artige Tokens signiert. Tag 11 und 12 tauschen nur den Issuer aus.
- Wer kein OIDC kann (alter Jenkins), nutzt AppRole. Die Secret-ID wird nur verpackt und einmalig nutzbar übergeben.
CI-Job ── JWT (iss, aud, sub, repository, ref …) ──▶ auth/jwt-ci/login role=deploy-main
│ Signatur? aud? exp? Claims?
▼
Token (5 min, Policy ci-deploy) ──▶ secret/ci/deploy
Drill 1: Das Problem mit statischen Tokens
Lege zuerst die Lab-Daten für Teil C an. Das ist ein Admin-Schritt, daher mit Root-Token.
mkdir -p ~/secrets-lab/tag10 && cd ~/secrets-lab/tag10
export BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=root
bao kv put secret/ci/deploy registry_password=lab-reg-pw \
kubeconfig_token=lab-kube-token >/dev/null
bao policy write ci-deploy - <<'HCL'
path "secret/data/ci/deploy" {
capabilities = ["read"]
}
HCLErwartet:
Success! Uploaded policy: ci-deploy
So sah CI früher aus: ein langlebiger Token als „Jenkins-Credential”.
OLD=$(bao token create -policy=ci-deploy -period=768h \
-display-name=jenkins-legacy -field=token)
bao token lookup "$OLD" | grep -E 'display_name|^meta|period|policies|^ttl'
bao token revoke "$OLD"Erwartet:
display_name token-jenkins-legacy
meta <nil>
period 768h
policies [ci-deploy default]
ttl 768h
Success! Revoked token (if it existed)
Warum? 32 Tage gültig, verlängerbar, keine Metadaten. Im Audit-Log siehst du nie, welches Repo oder welcher Branch ihn benutzt hat.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Lab-CI-Issuer bauen
Ein Schlüsselpaar spielt den Signierschlüssel von GitHub oder GitLab.
Das Skript baut Header und Payload, signiert mit RS256 und braucht nur
openssl und python3.
openssl genrsa -out ci-issuer.key 2048
openssl rsa -in ci-issuer.key -pubout -out ci-issuer.pub
cat > mint-jwt.sh <<'EOF'
#!/usr/bin/env bash
# Lab-CI-Issuer: signiert ein JWT (RS256) mit GitHub-artigen Claims. Nur fürs Lab!
# Nutzung: ./mint-jwt.sh [claim=wert ...] (leerer Wert löscht den Claim)
# Sonderfall ttl=<sek>: Lebensdauer ab jetzt, negativ = schon abgelaufen
# BASE=<datei.json> ersetzt die GitHub-artigen Standard-Claims (Tag 12)
set -euo pipefail
KEY="${KEY:-ci-issuer.key}"
b64url() { openssl base64 -A | tr '+/' '-_' | tr -d '='; }
payload=$(python3 - "$@" <<'PY'
import json, os, sys, time
now = int(time.time())
c = json.load(open(os.environ["BASE"])) if os.environ.get("BASE") else {
"iss": "https://ci.lab.example", "aud": "openbao",
"sub": "repo:acme/shop:ref:refs/heads/main",
"repository": "acme/shop", "repository_owner": "acme", "repository_id": "100001",
"ref": "refs/heads/main", "ref_type": "branch", "actor": "zachmann",
"workflow": "deploy", "event_name": "push", "run_id": "4711",
"workflow_ref": "acme/shop/.github/workflows/deploy.yml@refs/heads/main",
"job_workflow_ref": "acme/shop/.github/workflows/deploy.yml@refs/heads/main",
}
ttl = 300
for arg in sys.argv[1:]:
k, _, v = arg.partition("=")
if k == "ttl":
ttl = int(v)
elif v == "":
c.pop(k, None)
else:
c[k] = v
iat = min(now, now + ttl - 300)
c.update(iat=iat, nbf=iat, exp=now + ttl)
print(json.dumps(c, separators=(",", ":")))
PY
)
header=$(printf '{"alg":"RS256","typ":"JWT","kid":"lab-ci-1"}' | b64url)
body=$(printf '%s' "$payload" | b64url)
sig=$(printf '%s.%s' "$header" "$body" \
| openssl dgst -sha256 -sign "$KEY" -binary | b64url)
printf '%s.%s.%s\n' "$header" "$body" "$sig"
EOF
chmod +x mint-jwt.shZum Lesen der Claims eine kleine Shell-Funktion (Base64url → JSON):
claims() { jq -R 'split(".")[1] | gsub("-";"+") | gsub("_";"/")
| @base64d | fromjson'; }
./mint-jwt.sh | claimsErwartet (gekürzt):
{
"iss": "https://ci.lab.example",
"aud": "openbao",
"sub": "repo:acme/shop:ref:refs/heads/main",
"repository": "acme/shop",
"repository_owner": "acme",
"repository_id": "100001",
"ref": "refs/heads/main",
...
"iat": 1791785367,
"nbf": 1791785367,
"exp": 1791785667
}
Sicherheit:
ci-issuer.keyist im Lab der „CI-Anbieter”. Wer diesen Schlüssel hat, kann sich jede Pipeline-Identität ausstellen. In echt liegt er nur beim CI-System.
Fortschritt speichern? Kostenlos registrieren
Drill 3: JWT-Auth-Mount jwt-ci/
OpenBao bekommt nur den öffentlichen Schlüssel und den erwarteten Issuer.
bao auth enable -path=jwt-ci jwt
bao write auth/jwt-ci/config [email protected] \
bound_issuer=https://ci.lab.example
bao read -format=json auth/jwt-ci/config \
| jq '.data | {bound_issuer, jwks_url, oidc_discovery_url, status}'Erwartet:
Success! Enabled jwt auth method at: jwt-ci/
Success! Data written to: auth/jwt-ci/config
{
"bound_issuer": "https://ci.lab.example",
"jwks_url": "",
"oidc_discovery_url": "",
"status": "valid"
}
Warum jwt_validation_pubkeys? Dein Lab-Issuer hat keinen
Discovery-Endpunkt. Echte CI-Anbieter konfigurierst du über
oidc_discovery_url oder jwks_url (Tag 11,
12).
Fortschritt speichern? Kostenlos registrieren
Drill 4: Rolle deploy-main und
erster Login
Die Rolle bindet Audience und Claims. Nur Pushes auf
main aus acme/shop kommen rein.
bao write auth/jwt-ci/role/deploy-main - <<'EOF'
{
"role_type": "jwt",
"user_claim": "sub",
"bound_audiences": ["openbao"],
"bound_claims_type": "string",
"bound_claims": {
"repository": "acme/shop",
"ref": "refs/heads/main"
},
"token_policies": ["ci-deploy"],
"token_ttl": "5m",
"token_max_ttl": "10m"
}
EOF
unset BAO_TOKEN
bao write auth/jwt-ci/login role=deploy-main jwt="$(./mint-jwt.sh)"Erwartet:
Success! Data written to: auth/jwt-ci/role/deploy-main
Key Value
--- -----
token s.7886d9X54gUgGKkHLprJx9Ym
token_accessor s44GnLsjBqAEgcAOhLGQvwBS
token_duration 5m
token_renewable true
token_policies ["ci-deploy" "default"]
identity_policies []
policies ["ci-deploy" "default"]
token_meta_role deploy-main
So nutzt ein Pipeline-Schritt den Token:
export BAO_TOKEN=$(bao write -field=token auth/jwt-ci/login role=deploy-main \
jwt="$(./mint-jwt.sh)")
bao kv get -field=registry_password secret/ci/deploy; echo
bao kv get secret/shop/api 2>&1 | grep -m1 deniedErwartet:
lab-reg-pw
* permission denied
Warum user_claim=sub? Der Wert wird zum Namen des
Entity-Alias. Im Audit-Log steht damit
repo:acme/shop:ref:refs/heads/main statt „irgendein
CI-Token”.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Negativtests
Jede Bindung muss einmal rot werden. Das Skript verändert pro Lauf genau einen Claim.
unset BAO_TOKEN
for args in ref=refs/heads/feature-x repository=acme/other aud=github \
iss=https://evil.example ttl=-60 ref=; do
echo "== $args"
bao write auth/jwt-ci/login role=deploy-main \
jwt="$(./mint-jwt.sh $args)" 2>&1 | tail -1
doneErwartet:
== ref=refs/heads/feature-x
* error validating claims: claim "ref" does not match any associated bound claim values
== repository=acme/other
* error validating claims: claim "repository" does not match any associated bound
claim values
== aud=github
* error validating token: invalid audience (aud) claim: audience claim does not match
any expected audience
== iss=https://evil.example
* error validating token: invalid issuer (iss) claim
== ttl=-60
* error validating token: invalid expiration time (exp) claim: token is expired
== ref=
* error validating claims: claim "ref" is missing
Und ein Token mit fremdem Schlüssel, also ein gefälschter Issuer:
openssl genrsa -out evil.key 2048 2>/dev/null
bao write auth/jwt-ci/login role=deploy-main \
jwt="$(KEY=evil.key ./mint-jwt.sh)" 2>&1 | tail -1Erwartet:
* error validating token: error verifying token signature: no known key successfully
validated the token signature
Achtung: Ein JWT ist bis
expbeliebig oft verwendbar. OpenBao toleriert dabei rund 60 s Uhrzeitabweichung (clock_skew_leeway). Kurze Token-Laufzeiten beim CI-Anbieter sind daher Teil der Sicherheit.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Glob-Bindung und
claim_mappings
Release-Branches und Versions-Tags sollen über eine Rolle deployen dürfen. Claims landen zusätzlich als Metadaten am Token und im Audit-Log.
export BAO_TOKEN=root
bao write auth/jwt-ci/role/deploy-release - <<'EOF'
{
"role_type": "jwt",
"user_claim": "sub",
"bound_audiences": ["openbao"],
"bound_claims_type": "glob",
"bound_claims": {
"repository": "acme/shop",
"ref": ["refs/heads/release-*", "refs/tags/v*"]
},
"claim_mappings": {
"repository": "repository",
"ref": "ref",
"actor": "actor",
"run_id": "run_id"
},
"token_policies": ["ci-deploy"],
"token_ttl": "5m",
"token_max_ttl": "10m"
}
EOF
for r in refs/heads/release-1.4 refs/tags/v1.4.0 refs/heads/main \
refs/heads/my-release-x; do
printf '%-26s ' "$r"
BAO_TOKEN= bao write -field=token_policies auth/jwt-ci/login role=deploy-release \
jwt="$(./mint-jwt.sh ref=$r sub=repo:acme/shop:ref:$r)" 2>&1 | tail -1
echo
doneErwartet:
Success! Data written to: auth/jwt-ci/role/deploy-release
refs/heads/release-1.4 [ci-deploy default]
refs/tags/v1.4.0 [ci-deploy default]
refs/heads/main * error validating claims: claim "ref" does not match any
associated bound claim values
refs/heads/my-release-x * error validating claims: claim "ref" does not match any
associated bound claim values
Mehrere Werte in einer Liste sind ein ODER, mehrere Claims ein UND.
Das Glob * passt auch über / hinweg, deshalb
immer mit festem Präfix arbeiten.
T=$(BAO_TOKEN= bao write -field=token auth/jwt-ci/login role=deploy-release \
jwt="$(./mint-jwt.sh ref=refs/tags/v1.4.0 sub=repo:acme/shop:ref:refs/tags/v1.4.0)")
bao token lookup -format=json "$T" | jq '.data | {display_name, meta, ttl}'Erwartet:
{
"display_name": "jwt-ci-repo:acme/shop:ref:refs/tags/v1.4.0",
"meta": {
"actor": "zachmann",
"ref": "refs/tags/v1.4.0",
"repository": "acme/shop",
"role": "deploy-release",
"run_id": "4711"
},
"ttl": 300
}
Fortschritt speichern? Kostenlos registrieren
Drill 7: AppRole für Legacy-CI
Ein alter Jenkins kann kein OIDC. Er bekommt eine AppRole: Die Role-ID ist der „Benutzername”, die Secret-ID das kurzlebige, einmalige „Passwort”.
bao auth enable approle
bao write auth/approle/role/jenkins-deploy \
token_policies=ci-deploy token_ttl=10m token_max_ttl=30m \
secret_id_ttl=15m secret_id_num_uses=1 \
secret_id_bound_cidrs=127.0.0.1/32 token_bound_cidrs=127.0.0.1/32
bao read -field=role_id auth/approle/role/jenkins-deploy/role-id; echoErwartet:
Success! Enabled approle auth method at: approle/
Success! Data written to: auth/approle/role/jenkins-deploy
67d3f71b-a0ff-da1b-cb2b-ce241424caa6
Secret-IDs erzeugt ein „Trusted Orchestrator”, zum Beispiel ein Seed-Job. Seine Policy erlaubt nur dieses eine Endpoint und erzwingt Wrapping:
bao policy write approle-issuer - <<'HCL'
path "auth/approle/role/jenkins-deploy/secret-id" {
capabilities = ["update"]
min_wrapping_ttl = "1s"
max_wrapping_ttl = "300s"
}
HCL
ISSUER=$(bao token create -policy=approle-issuer -ttl=1h -field=token)
BAO_TOKEN=$ISSUER bao write -f auth/approle/role/jenkins-deploy/secret-id 2>&1 \
| grep -m1 deniedErwartet:
Success! Uploaded policy: approle-issuer
* permission denied
Warum? Ohne -wrap-ttl würde die Secret-ID im Klartext
zurückkommen. Die Policy lässt das gar nicht erst zu.
Fortschritt speichern? Kostenlos registrieren
Drill 8: Secret-ID per Response Wrapping übergeben
Der Orchestrator gibt nur ein Wrapping-Token weiter. Der Jenkins-Agent packt es einmal aus und meldet sich an.
WRAP=$(BAO_TOKEN=$ISSUER bao write -wrap-ttl=120s -field=wrapping_token \
-f auth/approle/role/jenkins-deploy/secret-id)
bao write -format=json sys/wrapping/lookup token="$WRAP" | jq -r .data.creation_path
ROLE_ID=$(bao read -field=role_id auth/approle/role/jenkins-deploy/role-id)
SECRET_ID=$(BAO_TOKEN=$WRAP bao unwrap -field=secret_id)
BAO_TOKEN= bao write auth/approle/login role_id="$ROLE_ID" secret_id="$SECRET_ID"Erwartet:
auth/approle/role/jenkins-deploy/secret-id
Key Value
--- -----
token s.9BmC0AWMqAbrO9QAb5NnC4Yd
token_accessor av6dQpi8euMs2trPCygMI6SR
token_duration 10m
token_renewable true
token_policies ["ci-deploy" "default"]
identity_policies []
policies ["ci-deploy" "default"]
token_meta_role_name jenkins-deploy
creation_path prüft der Empfänger vor dem Auspacken:
Stammt das Paket wirklich vom erwarteten Endpoint? Jetzt alle drei
Sperren:
echo "== Wrapping-Token zweites Mal"
BAO_TOKEN=$WRAP bao unwrap 2>&1 | tail -1
echo "== Secret-ID zweites Mal"
BAO_TOKEN= bao write auth/approle/login role_id="$ROLE_ID" \
secret_id="$SECRET_ID" 2>&1 | tail -1
echo "== falsches Quellnetz"
bao write auth/approle/role/jenkins-deploy secret_id_bound_cidrs=10.20.0.0/16 >/dev/null
WRAP=$(BAO_TOKEN=$ISSUER bao write -wrap-ttl=120s -field=wrapping_token \
-f auth/approle/role/jenkins-deploy/secret-id)
SECRET_ID=$(BAO_TOKEN=$WRAP bao unwrap -field=secret_id)
BAO_TOKEN= bao write auth/approle/login role_id="$ROLE_ID" \
secret_id="$SECRET_ID" 2>&1 | tail -1
bao write auth/approle/role/jenkins-deploy secret_id_bound_cidrs=127.0.0.1/32 >/dev/nullErwartet:
== Wrapping-Token zweites Mal
* wrapping token is not valid or does not exist
== Secret-ID zweites Mal
* invalid role or secret ID
== falsches Quellnetz
* source address "127.0.0.1" unauthorized by CIDR restrictions on the role: %!w(<nil>)
Schlägt das Auspacken beim echten Empfänger fehl, hat jemand das
Paket schon geöffnet: Alarm, nicht neu versuchen. Über den Port-Forward
sieht OpenBao 127.0.0.1 als Quelle, in Produktion sind es
die Agent-Netze.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
cat > check.sh <<'EOF'
#!/usr/bin/env bash
cd ~/secrets-lab/tag10
export BAO_ADDR="${BAO_ADDR:-http://127.0.0.1:8200}"
login() { BAO_TOKEN= bao write -field=token auth/jwt-ci/login role=$1 \
jwt="$(./mint-jwt.sh "${@:2}")" 2>/dev/null; }
T=$(login deploy-main)
[ "$(BAO_TOKEN=$T bao kv get -field=registry_password secret/ci/deploy 2>/dev/null)" \
= lab-reg-pw ] && echo "✔ main darf secret/ci/deploy lesen" || echo "✘ main-Login"
login deploy-main ref=refs/heads/dev >/dev/null && echo "✘ dev-Branch kommt rein" \
|| echo "✔ dev-Branch abgewiesen"
login deploy-main ttl=-120 >/dev/null && echo "✘ abgelaufenes JWT akzeptiert" \
|| echo "✔ abgelaufenes JWT abgewiesen"
login deploy-release ref=refs/tags/v2.0.0 >/dev/null && echo "✔ Tag-Release per Glob" \
|| echo "✘ Glob-Rolle"
[ "$(BAO_TOKEN=root bao read -field=secret_id_num_uses \
auth/approle/role/jenkins-deploy)" = 1 ] && echo "✔ Secret-ID einmalig" \
|| echo "✘ secret_id_num_uses"
EOF
bash check.shErwartet:
✔ main darf secret/ci/deploy lesen
✔ dev-Branch abgewiesen
✔ abgelaufenes JWT abgewiesen
✔ Tag-Release per Glob
✔ Secret-ID einmalig
Challenge
Eine Rolle build-any soll allen Repos der Organisation
acme dienen. Jedes Repo darf aber nur seine eigenen Secrets
unter secret/ci/repos/<repo>/ lesen, gesteuert über
eine templated Policy.
Hinweis: Template-Werte dürfen kein /
enthalten, acme/shop scheidet also aus. Nimm den stabilen
Claim repository_id.
Lösung
export BAO_TOKEN=root
ACC=$(bao auth list -format=json | jq -r '."jwt-ci/".accessor')
P="identity.entity.aliases.${ACC}.metadata.repository_id"
bao policy write ci-repo - <<EOF
path "secret/data/ci/repos/{{${P}}}/*" {
capabilities = ["read"]
}
EOF
bao kv put secret/ci/repos/100001/sonar token=lab-sonar-1 >/dev/null
bao kv put secret/ci/repos/100002/sonar token=lab-sonar-2 >/dev/null
bao write auth/jwt-ci/role/build-any - <<'EOF'
{
"role_type": "jwt", "user_claim": "sub", "bound_audiences": ["openbao"],
"bound_claims": {"repository_owner": "acme"},
"claim_mappings": {"repository_id": "repository_id"},
"token_policies": ["ci-repo"], "token_ttl": "5m"
}
EOF
T=$(BAO_TOKEN= bao write -field=token auth/jwt-ci/login role=build-any \
jwt="$(./mint-jwt.sh)")
BAO_TOKEN=$T bao kv get -field=token secret/ci/repos/100001/sonar; echo
BAO_TOKEN=$T bao kv get -field=token secret/ci/repos/100002/sonar 2>&1 \
| grep -m1 deniedErwartet:
lab-sonar-1
* permission denied
Mit metadata.repository statt repository_id
meldet das Server-Log:
template substitution contains forbidden value: "/", und
jeder Zugriff endet mit 403.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Pro Repo/Environment eine Rolle, immer an eine unveränderliche ID
binden (
repository_id,project_id), nicht nur an Namen, die man umbenennen kann. token_ttlan die Job-Dauer koppeln (5–15 min),token_max_ttlhart setzen; die Pipeline widerruft am Ende mitbao token revoke -self.- AppRole nur als Übergangslösung: Role-ID und Secret-ID über getrennte Kanäle, Secret-ID einmalig, gewrappt, mit CIDR-Bindung; Orchestrator-Token selbst kurzlebig.
- Audit-Log auf
auth/jwt-ci/login-Fehler alarmieren: Häufen sichdoes not match-Fehler, probiert jemand fremde Branches oder Forks aus (Tag 14). - Schlüsselrotation beim CI-Anbieter:
jwks_url/Discovery statt fest eingetragener Public Keys, sonst bricht der Login bei jedem Key-Wechsel.