Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 7: OpenBao Transit als Schlüsselquelle

Ziel: sops lässt den Datenschlüssel von OpenBao Transit schützen statt von einem age-Schlüssel auf der Platte – mit einer Policy, die nur ver- und entschlüsseln darf, einem rotierten Transit-Schlüssel und einem age-Notfallschlüssel für den Tag, an dem OpenBao seine Schlüssel verliert. · Dauer: ca. 75 min · Voraussetzung: Tag 6

Briefing

  • Transit ist eine Secrets-Engine von OpenBao: „Verschlüsselung als Dienst“. Der Schlüssel verlässt OpenBao nie; Clients schicken Daten zum Ver- und Entschlüsseln.
  • sops schickt nur den Datenschlüssel an Transit (transit/encrypt/sops) und speichert das Ergebnis vault:v1:… im Block sops.hc_vault.
  • Zugriff regelt eine Policy am Token. Wer die Datei lesen will, braucht ein gültiges Token – entziehen heißt: Token oder Policy weg, ohne updatekeys.
  • OpenBao läuft hier im Dev-Modus: Speicher im RAM, Root-Token lab-bao-123. Ein Pod-Neustart löscht alles. Betrieb mit Raft, Unseal und TLS steht in den OpenBao-Büchern der Reihe.
 sops encrypt ──Datenschlüssel──► OpenBao transit/encrypt/sops ──► vault:v1:…
 sops decrypt ──vault:v1:…──────► OpenBao transit/decrypt/sops ──► Datenschlüssel
                Token mit Policy „sops“ (nur encrypt/decrypt)
 zusätzlich:    age-Recipient (ich) ──► Notfallweg ohne OpenBao

Drill 1: bao und OpenBao im Dev-Modus

# auf argo
mkdir -p ~/sops/tag07 && cd ~/sops/tag07
ARCH=$(dpkg --print-architecture)
O=https://github.com/openbao/openbao/releases/download/v2.7.3
curl -fsSLO $O/openbao_2.7.3_linux_$ARCH.tar.gz
curl -fsSLO $O/checksums.txt
grep " openbao_2.7.3_linux_$ARCH.tar.gz$" checksums.txt | sha256sum -c
tar -xzf openbao_2.7.3_linux_$ARCH.tar.gz bao
sudo install -m 0755 bao /usr/local/bin/bao
bao version | cut -c1-30
cat > openbao.yaml <<'EOF'
apiVersion: v1
kind: Namespace
metadata: {name: openbao}
---
apiVersion: apps/v1
kind: Deployment
metadata: {name: openbao, namespace: openbao}
spec:
  replicas: 1
  selector: {matchLabels: {app: openbao}}
  template:
    metadata: {labels: {app: openbao}}
    spec:
      containers:
      - name: openbao
        image: quay.io/openbao/openbao:2.7.3
        args: [server, -dev, -dev-root-token-id=lab-bao-123,
               -dev-listen-address=0.0.0.0:8200]
        ports: [{containerPort: 8200, name: http}]
        readinessProbe:
          httpGet: {path: /v1/sys/health, port: http}
---
apiVersion: v1
kind: Service
metadata: {name: openbao, namespace: openbao}
spec:
  type: NodePort
  selector: {app: openbao}
  ports: [{port: 8200, targetPort: http, nodePort: 30820, name: http}]
EOF
kubectl apply -f openbao.yaml
kubectl -n openbao rollout status deploy/openbao --timeout=120s

Erwartet (gekürzt):

openbao_2.7.3_linux_amd64.tar.gz: OK
OpenBao v2.7.3 (0439ef58125387
namespace/openbao created
deployment.apps/openbao created
service/openbao created
deployment "openbao" successfully rolled out

Die Umgebung für den Rest des Tages legst du in einer Datei ab, damit jeder Block sie mit . laden kann. BAO_* liest die bao-CLI, VAULT_* liest sops.

# auf argo
cd ~/sops/tag07
cat > bao.env <<'EOF'
export BAO_ADDR=http://172.16.0.182:30820
export VAULT_ADDR=$BAO_ADDR
[ -f ~/sops/tag07/sops.token ] && export VAULT_TOKEN=$(cat ~/sops/tag07/sops.token)
EOF
. ~/sops/tag07/bao.env
BAO_TOKEN=lab-bao-123 bao status | grep -E 'Sealed|Storage|Version'

Erwartet:

Sealed          false
Version         2.7.3
Storage Type    inmem

Storage Type inmem ist der Dev-Modus: nichts landet auf einer Platte.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Transit und ein Schlüssel für sops

# auf argo
. ~/sops/tag07/bao.env
export BAO_TOKEN=lab-bao-123
bao secrets enable transit
bao write -f transit/keys/sops >/dev/null
bao read -format=json transit/keys/sops \
  | jq -c '.data | {type, latest_version, exportable, deletion_allowed}'

Erwartet:

Success! Enabled the transit secrets engine at: transit/
{"type":"aes256-gcm96","latest_version":1,"exportable":false,"deletion_allowed":false}

exportable: false: Den Schlüssel bekommt niemand heraus, auch nicht der Admin. deletion_allowed: false schützt vor versehentlichem bao delete – ohne den Transit-Schlüssel wäre jede damit verschlüsselte Datei verloren.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Eine Policy nur für sops

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/tag07
cat > sops-policy.hcl <<'EOF'
path "transit/encrypt/sops" { capabilities = ["update"] }
path "transit/decrypt/sops" { capabilities = ["update"] }
EOF
BAO_TOKEN=lab-bao-123 bao policy write sops sops-policy.hcl
BAO_TOKEN=lab-bao-123 bao token create -policy=sops -ttl=8h -field=token \
  > sops.token
cut -c1-2 sops.token
BAO_TOKEN=$(cat sops.token) bao read transit/keys/sops 2>&1 | grep -E 'Code|denied'

Erwartet:

Success! Uploaded policy: sops
s.
Code: 403. Errors:
    * permission denied

Das Token darf ver- und entschlüsseln, aber nicht einmal die Schlüsseldaten lesen, geschweige denn rotieren oder löschen. Es läuft nach 8 Stunden ab – danach ein neues Token mit derselben Zeile erzeugen.

Fortschritt speichern? Kostenlos registrieren

Drill 4: sops mit Transit

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/tag07
printf 'api_key: lab-key-123\n' > transit.yaml
sops encrypt --hc-vault-transit $VAULT_ADDR/v1/transit/keys/sops transit.yaml \
  > transit.enc.yaml
yq '.sops.hc_vault[0]' transit.enc.yaml | cut -c1-60
XDG_CONFIG_HOME=/nirgends sops decrypt transit.enc.yaml
VAULT_TOKEN= XDG_CONFIG_HOME=/nirgends sops decrypt transit.enc.yaml 2>&1 \
  | grep -E 'FAILED|Code|denied'

Erwartet:

created_at: "2026-11-20T16:34:46Z"
enc: vault:v1:cdli8w3D4KQFlneTmGfAtHG7s/rK/Nakd//jkPhQHHDQ7a
engine_path: transit
key_name: sops
vault_address: http://172.16.0.182:30820
api_key: lab-key-123
Group 0: FAILED
  http://172.16.0.182:30820/v1/transit/keys/sops: FAILED
      | Code: 403. Errors:
      | * permission denied

XDG_CONFIG_HOME=/nirgends blendet deinen age-Schlüssel aus – der Beweis, dass Transit allein entschlüsselt. Ohne Token: 403. vault:v1: heißt: verschlüsselt mit Version 1 des Transit-Schlüssels.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Transit plus Notfallschlüssel in .sops.yaml

Für Plattform-Secrets gilt ab jetzt: Transit im Alltag, dein age-Schlüssel als Notfallweg. Beide stehen in einer Gruppe – einer reicht.

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/repo
ICH=$(age-keygen -y ~/.config/sops/age/keys.txt)
yq -i '.creation_rules += [{"path_regex": "^plattform/.*\\.yaml$",
  "encrypted_regex": "^(data|stringData)$",
  "hc_vault_transit_uri": "'$VAULT_ADDR'/v1/transit/keys/sops", "age": "'$ICH'"}]' \
  .sops.yaml
yq '.creation_rules[-1]' .sops.yaml | cut -c1-80
mkdir -p plattform
kubectl create secret generic grafana-admin -n monitoring \
  --from-literal=password=lab-grafana-123 --dry-run=client -o yaml \
  > plattform/grafana-admin.yaml
sops encrypt -i plattform/grafana-admin.yaml
yq '.sops | keys' plattform/grafana-admin.yaml
git add .sops.yaml plattform
git commit -q -m "tag07: plattform mit Transit und age" && git push -q

Erwartet:

path_regex: ^plattform/.*\.yaml$
encrypted_regex: ^(data|stringData)$
hc_vault_transit_uri: http://172.16.0.182:30820/v1/transit/keys/sops
age: age1rnz4tqupd0f3lm4kfs564cfgys5j80497rk7ajzn2ekxh3d2g3uqdtdnv2
- age
- encrypted_regex
- hc_vault
- lastmodified
- mac
- version

Achtung: Die OpenBao-Adresse steht in jeder Datei (vault_address). Zieht OpenBao um, findet sops den Dienst nicht mehr – Adressen deshalb von Anfang an als stabilen DNS-Namen vergeben, nie als IP wie hier im Labor.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Den Transit-Schlüssel rotieren

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/tag07
BAO_TOKEN=lab-bao-123 bao write -f transit/keys/sops/rotate | grep latest_version
XDG_CONFIG_HOME=/nirgends sops decrypt transit.enc.yaml
yq '.sops.hc_vault[0].enc' transit.enc.yaml | cut -c1-12
XDG_CONFIG_HOME=/nirgends sops rotate -i transit.enc.yaml
yq '.sops.hc_vault[0].enc' transit.enc.yaml | cut -c1-12

Erwartet:

latest_version            2
api_key: lab-key-123
vault:v1:cdl
vault:v2:9DA

Transit hebt alte Versionen auf: v1-Dateien bleiben lesbar. Erst sops rotate bringt die Datei auf v2. Ob alte Versionen noch entschlüsseln dürfen, bestimmt min_decryption_version:

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/tag07
cp transit.enc.yaml v2.yaml
BAO_TOKEN=lab-bao-123 bao write -f transit/keys/sops/rotate | grep latest_version
BAO_TOKEN=lab-bao-123 bao write transit/keys/sops/config min_decryption_version=3 \
  >/dev/null
XDG_CONFIG_HOME=/nirgends sops decrypt v2.yaml 2>&1 | grep -E 'Code|disallowed'
BAO_TOKEN=lab-bao-123 bao write transit/keys/sops/config min_decryption_version=1 \
  >/dev/null
XDG_CONFIG_HOME=/nirgends sops decrypt v2.yaml

Erwartet:

latest_version            3
      | Code: 400. Errors:
      | * ciphertext or signature version is disallowed by policy
api_key: lab-key-123

Reihenfolge im Betrieb: Transit rotieren, alle Dateien mit sops rotate umschlüsseln, erst dann min_decryption_version anheben.

Fortschritt speichern? Kostenlos registrieren

Drill 7: OpenBao verliert seine Schlüssel

Einbauen: Ein Neustart im Dev-Modus – im echten Betrieb entspricht das einem Restore ohne Transit-Daten oder einem gelöschten Schlüssel.

Achtung: Der Neustart löscht alle Transit-Schlüssel unwiderruflich. Jede Datei, die nur für Transit verschlüsselt ist, ist danach verloren – hier rettet dich der age-Recipient.

# auf argo
kubectl -n openbao rollout restart deploy/openbao
kubectl -n openbao rollout status deploy/openbao --timeout=120s

Symptom:

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/repo
XDG_CONFIG_HOME=/nirgends sops decrypt plattform/grafana-admin.yaml 2>&1 \
  | grep -E 'transit/keys/sops: FAILED|Code|denied'
BAO_TOKEN=lab-bao-123 bao secrets list | grep -c transit

Erwartet:

  http://172.16.0.182:30820/v1/transit/keys/sops: FAILED
      | Code: 403. Errors:
      | * permission denied
0

Ursache: Mit dem Speicher sind die Transit-Engine, der Schlüssel, die Policy und das Token weg. Selbst ein neuer Schlüssel gleichen Namens hilft nicht – er hat anderes Schlüsselmaterial.

Fix: Der age-Notfallschlüssel öffnet die Datei weiter. OpenBao neu einrichten, dann mit sops rotate den Datenschlüssel neu für alle Recipients verschlüsseln – auch für den neuen Transit-Schlüssel.

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/repo
sops decrypt plattform/grafana-admin.yaml | yq .data.password | base64 -d; echo
export BAO_TOKEN=lab-bao-123
bao secrets enable transit >/dev/null
bao write -f transit/keys/sops >/dev/null
bao policy write sops ~/sops/tag07/sops-policy.hcl >/dev/null
bao token create -policy=sops -ttl=8h -field=token > ~/sops/tag07/sops.token
unset BAO_TOKEN && . ~/sops/tag07/bao.env
XDG_CONFIG_HOME=/nirgends sops decrypt plattform/grafana-admin.yaml 2>&1 \
  | grep -E 'Code'
sops rotate -i plattform/grafana-admin.yaml

Erwartet:

lab-grafana-123
      | Code: 400. Errors:

Der neue Schlüssel kann den alten Chiffretext nicht lesen (400), sops rotate mit deinem age-Schlüssel repariert das.

Nachweis:

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/repo
XDG_CONFIG_HOME=/nirgends sops decrypt plattform/grafana-admin.yaml \
  | yq .data.password | base64 -d; echo
git commit -qam "tag07: plattform nach Transit-Verlust umgeschlüsselt" && git push -q

Erwartet:

lab-grafana-123

Ohne age-Recipient wäre die Datei jetzt verloren. transit.enc.yaml in ~/sops/tag07 hatte keinen – sie ist verloren.

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Zeig, mit welcher Transit-Version plattform/grafana-admin.yaml verschlüsselt ist. Zeitziel: 20 s
  2. Zeig die Policy sops. Zeitziel: 15 s
  3. Zeig, wie lange dein sops-Token noch gilt. Zeitziel: 30 s

Lösung

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/repo
yq '.sops.hc_vault[0].enc' plattform/grafana-admin.yaml | cut -c1-9
BAO_TOKEN=lab-bao-123 bao policy read sops
bao token lookup -format=json | jq -r '.data.policies[], .data.ttl' 2>&1 | head -3

Erwartet:

vault:v1:
path "transit/encrypt/sops" { capabilities = ["update"] }
path "transit/decrypt/sops" { capabilities = ["update"] }
default
sops
28794

bao token lookup ohne BAO_TOKEN fragt das Token aus VAULT_TOKEN ab – die bao-CLI liest beide Variablen. Die Restlaufzeit steht in Sekunden.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/repo && git status -sb
kubectl -n openbao get deploy openbao
XDG_CONFIG_HOME=/nirgends sops decrypt plattform/grafana-admin.yaml | grep -c password

Erwartet:

## main...origin/main
NAME      READY   UP-TO-DATE   AVAILABLE   AGE
openbao   1/1     1            1           26s
1

Challenge

Nimm den Transit-Schlüssel zusätzlich in die Regel für prod/ auf (der age-Schlüssel für prod bleibt) und schlüssele prod/notes-db.yaml um. Beweise, dass die Datei danach ganz ohne age-Schlüssel lesbar ist – und dass der prod-Schlüssel allein weiter reicht.

Hinweis: updatekeys muss die Datei öffnen können: Du brauchst den prod-Schlüssel dafür.

Lösung

# auf argo
. ~/sops/tag07/bao.env
cd ~/sops/repo
yq -i '(.creation_rules[] | select(.path_regex == "^prod/.*\\.yaml$")
  | .hc_vault_transit_uri) = "'$VAULT_ADDR'/v1/transit/keys/sops"' .sops.yaml
SOPS_AGE_KEY_FILE=~/sops/tag04/prod.key sops updatekeys -y prod/notes-db.yaml \
  2>&1 | grep '^+++'
XDG_CONFIG_HOME=/nirgends sops decrypt --extract '["data"]["password"]' \
  prod/notes-db.yaml | base64 -d; echo
VAULT_TOKEN= XDG_CONFIG_HOME=/nirgends SOPS_AGE_KEY_FILE=~/sops/tag04/prod.key \
  sops decrypt prod/notes-db.yaml | grep -c password
git commit -qam "tag07: prod zusätzlich mit Transit" && git push -q

Erwartet:

+++ http://172.16.0.182:30820/v1/transit/keys/sops
lab-db-prod-123
1

Fortschritt speichern? Kostenlos registrieren

Aufräumen

OpenBao bleibt für Tag 10 und Tag 14 stehen. Übungsdateien ohne Wert weg:

# auf argo
cd ~/sops/tag07
rm -f transit.yaml v2.yaml openbao_2.7.3_linux_*.tar.gz
ls -1

Erwartet:

bao
bao.env
checksums.txt
openbao.yaml
sops-policy.hcl
sops.token
transit.enc.yaml

Achtung: Nach jedem Neustart der VM oder des Pods ist OpenBao leer. Dann Drill 7 („Fix“) wiederholen: Transit, Schlüssel, Policy, Token anlegen und betroffene Dateien mit deinem age-Schlüssel per sops rotate umschlüsseln.

Interview-Notiz

  • Warum Transit/KMS statt age-Dateien? Der Schlüssel verlässt den Dienst nie, Zugriff hängt an Identität und Policy (sofort entziehbar), jede Entschlüsselung ist im Audit-Log sichtbar.
  • Was passiert bei einer Transit-Rotation? Neue Version für neue Verschlüsselungen, alte Versionen entschlüsseln weiter, bis min_decryption_version angehoben wird; sops-Dateien mit sops rotate nachziehen.
  • Was ist das größte Risiko? Verlust des Transit-Schlüssels = Verlust aller Dateien. Deshalb immer einen zweiten Recipient (age im Tresor oder zweites KMS).

Enterprise-Notiz

  • OpenBao im HA-Betrieb (Raft, Auto-Unseal) mit Backups; Transit-Schlüssel mit deletion_allowed: false, Snapshots regelmäßig testweise zurückspielen.
  • Tokens nicht von Hand: Menschen per OIDC, Pipelines und Cluster per Kubernetes- bzw. JWT-Auth mit kurzer TTL.
  • Ein Transit-Schlüssel pro Umgebung (sops-dev, sops-prod) und Policy pro Team.
  • Audit-Device einschalten: Jede Entschlüsselung eines Secrets wird so nachvollziehbar – das kann kein age-Schlüssel.
  • Die Adresse in vault_address ist Teil jeder Datei: stabiler DNS-Name, TLS.