Zum Inhalt springen
Trainingslager IT-Trainingslager

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 repository oder ref.
  • 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"]
}
HCL

Erwartet:

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.sh

Zum Lesen der Claims eine kleine Shell-Funktion (Base64url → JSON):

claims() { jq -R 'split(".")[1] | gsub("-";"+") | gsub("_";"/")
  | @base64d | fromjson'; }
./mint-jwt.sh | claims

Erwartet (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.key ist 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 denied

Erwartet:

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
done

Erwartet:

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

Erwartet:

* error validating token: error verifying token signature: no known key successfully
validated the token signature

Achtung: Ein JWT ist bis exp beliebig 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
done

Erwartet:

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; echo

Erwartet:

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 denied

Erwartet:

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/null

Erwartet:

== 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.sh

Erwartet:

✔ 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 denied

Erwartet:

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_ttl an die Job-Dauer koppeln (5–15 min), token_max_ttl hart setzen; die Pipeline widerruft am Ende mit bao 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 sich does 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.