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 Ergebnisvault:v1:…im Blocksops.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=120sErwartet (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 -qErwartet:
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-12Erwartet:
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.yamlErwartet:
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=120sSymptom:
# 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 transitErwartet:
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.yamlErwartet:
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 -qErwartet:
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
- Zeig, mit welcher Transit-Version
plattform/grafana-admin.yamlverschlüsselt ist. Zeitziel: 20 s - Zeig die Policy
sops. Zeitziel: 15 s - 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 -3Erwartet:
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 passwordErwartet:
## 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 -qErwartet:
+++ 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 -1Erwartet:
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 rotateumschlü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_versionangehoben wird; sops-Dateien mitsops rotatenachziehen. - 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_addressist Teil jeder Datei: stabiler DNS-Name, TLS.