Tag 5: Transit und PKI
Ziel: Daten verschlüsseln lassen, ohne Schlüssel zu sehen, und eine zweistufige CA betreiben · Dauer: ca. 120 min · Voraussetzung: Tag 2
Briefing
- Transit = Encryption as a Service: Die App schickt Daten, bekommt Ciphertext zurück. Der Key verlässt OpenBao nie.
- Ciphertext trägt die Key-Version (
vault:v2:...) – Rotation ohne Re-Encrypt-Zwang. - PKI = eigene CA: Root in
pki/, Intermediate inpki_int/stellt kurzlebige Zertifikate aus.
pki/ Root CA (10 J.) --signiert--> pki_int/ Intermediate (5 J.)
|
roles/webshop --issue--> api.webshop.lab (24 h)
Drill 1: Labor und Transit-Key
Terminal 1:
bao server -dev -dev-root-token-id=rootTerminal 2:
mkdir -p ~/bao-lab/tag05 && cd ~/bao-lab/tag05
export BAO_ADDR=http://127.0.0.1:8200 BAO_TOKEN=root
bao secrets enable transit
bao write -f transit/keys/webshopErwartet (gekürzt):
Success! Enabled the transit secrets engine at: transit/
Key Value
--- -----
deletion_allowed false
exportable false
keys map[1:1791442702]
latest_version 1
min_decryption_version 1
supports_encryption true
type aes256-gcm96
Fortschritt speichern? Kostenlos registrieren
Drill 2: Encrypt und Decrypt
Transit erwartet Klartext immer base64-kodiert.
CT=$(bao write -field=ciphertext transit/encrypt/webshop \
plaintext=$(echo -n "4111-1111-1111-1111" | base64))
echo "$CT"
bao write -field=plaintext transit/decrypt/webshop ciphertext="$CT" | base64 -d; echoErwartet:
vault:v1:IUDSBoxEgTXXEZuDk2GyQP18X93vIy/bOlfgPVd2oSCXv1QHpUHnN6UZMRhW+U4=
4111-1111-1111-1111
Warum vault:? Das Präfix ist aus Kompatibilitätsgründen
geblieben; v1 ist die Key-Version.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Rotate, Rewrap, min_decryption_version
bao write -f transit/keys/webshop/rotate | grep -E 'latest_version|keys '
bao write transit/encrypt/webshop plaintext=$(echo -n "neu" | base64)Erwartet (gekürzt):
keys map[1:1791442702 2:1791442708]
latest_version 2
ciphertext vault:v2:xhgL7lQ+wTAdux7S+W2ZSgq3Pr2UCzKla+gLzvE=
key_version 2
Alte Daten auf die neue Version heben, ohne den Klartext zu sehen:
CT2=$(bao write -field=ciphertext transit/rewrap/webshop ciphertext="$CT")
echo "$CT2"Erwartet:
vault:v2:d7Ifgva7m99eJ5fpjKaHxLve3TMpwsUY+kpYQr2FVNbQ3f6Hvc9l2ThUmyGIT40=
Danach v1 sperren:
bao write transit/keys/webshop/config min_decryption_version=2 | grep min_dec
bao write transit/decrypt/webshop ciphertext="$CT"
bao write -field=plaintext transit/decrypt/webshop ciphertext="$CT2" | base64 -d; echoErwartet (gekürzt):
min_decryption_version 2
Code: 400. Errors:
* ciphertext or signature version is disallowed by policy (too old)
4111-1111-1111-1111
Achtung: Erst alle Datensätze rewrappen, dann
min_decryption_versionanheben – sonst sind alte Daten nicht mehr lesbar.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Datakey (Envelope Encryption)
Für große Dateien: OpenBao erzeugt einen Datenschlüssel, du verschlüsselst lokal.
bao write -f transit/datakey/plaintext/webshop
bao write -f transit/datakey/wrapped/webshopErwartet (gekürzt):
Key Value
--- -----
ciphertext vault:v2:UE2bAO9UwGK/LW/Q8vqjrz1ET9mxdOeHPneil2P1JWtVU1x5...
key_version 2
plaintext +innBfLQ2vB0gIpyWOlZmcZeBHNJi5tbBPCIT8/GPVQ=
Key Value
--- -----
ciphertext vault:v2:4+boJqiYRuC00vrTuCkpQMgT7vtv4griptB00hBVQOq7cCWALckh...
key_version 2
Warum? plaintext nutzt du sofort (AES-256) und verwirfst
ihn; ciphertext speicherst du neben der Datei und lässt ihn
später per transit/decrypt entschlüsseln.
wrapped liefert nur den Ciphertext – für Systeme, die erst
später entschlüsseln.
Fortschritt speichern? Kostenlos registrieren
Drill 5: HMAC, Sign und Verify
HMAC (z. B. für pseudonymisierte Suchindizes):
IN=$(echo -n "[email protected]" | base64)
H=$(bao write -field=hmac transit/hmac/webshop input="$IN")
echo "$H"
bao write transit/verify/webshop input="$IN" hmac="$H"Erwartet:
vault:v2:gF1nI5MRYrhjfJqJqT4YyGIZ0snC8P12ht4HSh5vXZU=
Key Value
--- -----
valid true
Signieren braucht einen asymmetrischen Key:
bao write transit/keys/webshop-sign type=ecdsa-p256 | grep -E '^type|supports_signing'
MSG=$(echo -n "Bestellung 4711: 99.90 EUR" | base64)
SIG=$(bao write -field=signature transit/sign/webshop-sign input="$MSG")
bao write transit/verify/webshop-sign input="$MSG" signature="$SIG"
FAKE=$(echo -n "Bestellung 4711: 0.01 EUR" | base64)
bao write transit/verify/webshop-sign input="$FAKE" signature="$SIG"Erwartet (gekürzt):
supports_signing true
type ecdsa-p256
valid true
valid false
Den Public Key dürfen Dritte haben:
bao read -format=json transit/keys/webshop-sign | jq -r '.data.keys."1".public_key'Erwartet:
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEbxDKoRIXpSXVmCn+4e7vZ29CzpH5
...
-----END PUBLIC KEY-----
Fortschritt speichern? Kostenlos registrieren
Drill 6: exportable=false
bao read transit/export/encryption-key/webshopErwartet (gekürzt):
Code: 400. Errors:
* private key material is not exportable
Warum? Standard ist exportable=false: Niemand – auch
nicht root – kann das Schlüsselmaterial auslesen.
exportable=true lässt sich per
transit/keys/<name>/config setzen, aber nie
wieder zurücknehmen. Nur in begründeten Fällen (z. B.
Migration) verwenden.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Root-CA
bao secrets enable pki
bao secrets tune -max-lease-ttl=87600h pki
bao write -field=certificate pki/root/generate/internal \
common_name="Bao Lab Root CA" issuer_name=root-2026 ttl=87600h > root_ca.crt
openssl x509 -in root_ca.crt -noout -subject -issuer -datesErwartet (gekürzt):
Success! Enabled the pki secrets engine at: pki/
Success! Tuned the secrets engine at: pki/
WARNING! The following warnings were returned from OpenBao:
* This mount hasn't configured any authority information access (AIA)
fields; this may make it harder for systems to find missing certificates
...
subject=CN=Bao Lab Root CA
issuer=CN=Bao Lab Root CA
notBefore=Oct 8 06:58:11 2026 GMT
notAfter=Oct 5 06:58:41 2036 GMT
Warum tune? Die Mount-max_lease_ttl
(Standard 32 Tage) begrenzt jedes Zertifikat, auch die CA selbst. Die
AIA-Warnung landet auf stderr; seit v2.7.0 unterdrückt
-field Warnungen nicht mehr. Die URLs setzt du gleich.
bao write pki/config/urls \
issuing_certificates="$BAO_ADDR/v1/pki/ca" \
crl_distribution_points="$BAO_ADDR/v1/pki/crl"Erwartet (gekürzt):
crl_distribution_points [http://127.0.0.1:8200/v1/pki/crl]
issuing_certificates [http://127.0.0.1:8200/v1/pki/ca]
Fortschritt speichern? Kostenlos registrieren
Drill 8: Intermediate-CA
bao secrets enable -path=pki_int pki
bao secrets tune -max-lease-ttl=43800h pki_int
bao write pki_int/config/urls \
issuing_certificates="$BAO_ADDR/v1/pki_int/ca" \
crl_distribution_points="$BAO_ADDR/v1/pki_int/crl"
# 1. CSR im Intermediate erzeugen (Key bleibt in pki_int/)
bao write -field=csr pki_int/intermediate/generate/internal \
common_name="Bao Lab Intermediate CA" > pki_int.csr
# 2. Root signiert den CSR
bao write -field=certificate pki/root/sign-intermediate \
issuer_ref=root-2026 csr=@pki_int.csr ttl=43800h > int.crt
openssl x509 -in int.crt -noout -subject -issuer
# 3. Signiertes Zertifikat zurück ins Intermediate
bao write pki_int/intermediate/set-signed [email protected]Erwartet (gekürzt):
subject=CN=Bao Lab Intermediate CA
issuer=CN=Bao Lab Root CA
Key Value
--- -----
imported_issuers [ce891cf4-62d6-829e-7a93-cb8375da1afa]
imported_keys <nil>
Tipp: URLs vor
set-signedsetzen, sonst warnt OpenBao wegen fehlender AIA-Felder.
Fortschritt speichern? Kostenlos registrieren
Drill 9: Rolle und Zertifikat
bao write pki_int/roles/webshop \
allowed_domains=webshop.lab allow_subdomains=true max_ttl=72h
bao write -format=json pki_int/issue/webshop \
common_name=api.webshop.lab ttl=24h > cert.json
jq -r '.data | keys[]' cert.json
jq -r .data.certificate cert.json > api.crt
jq -r .data.private_key cert.json > api.keyErwartet:
ca_chain
certificate
expiration
issuing_ca
not_before
private_key
private_key_type
serial_number
openssl verify -CAfile root_ca.crt -untrusted int.crt api.crt
openssl x509 -in api.crt -noout -subject -issuer -enddate -ext subjectAltNameErwartet:
api.crt: OK
subject=CN=api.webshop.lab
issuer=CN=Bao Lab Intermediate CA
notAfter=Oct 9 06:58:51 2026 GMT
X509v3 Subject Alternative Name:
DNS:api.webshop.lab
Gegenprobe:
bao write pki_int/issue/webshop common_name=evil.example.comErwartet (gekürzt):
* common name evil.example.com not allowed by this role
Sicherheit: Der Private Key wird nur einmal ausgeliefert und nicht in OpenBao gespeichert.
cert.jsonundapi.keysind Lab-Dateien – in Produktion nie auf Platte liegen lassen.
Fortschritt speichern? Kostenlos registrieren
Drill 10: Revoke, CRL und Tidy
SER=$(jq -r .data.serial_number cert.json)
bao write pki_int/revoke serial_number="$SER"
bao list pki_int/certs/revoked
curl -s "$BAO_ADDR/v1/pki_int/crl/pem" \
| openssl crl -noout -text | grep -A1 "Serial Number"Erwartet (gekürzt):
revocation_time_rfc3339 2026-10-08T06:58:56.468904Z
state revoked
Keys
----
15:53:13:bb:bf:54:6a:0e:89:75:9e:6c:3a:24:5e:47:d0:32:c4:1e
Serial Number: 155313BBBF546A0E89759E6C3A245E47D032C41E
Revocation Date: Oct 8 06:58:56 2026 GMT
Abgelaufene Zertifikate aus dem Storage räumen:
bao write pki_int/tidy tidy_cert_store=true tidy_revoked_certs=true safety_buffer=1s
bao read pki_int/tidy-status | grep -E '^state|deleted_count'Erwartet (gekürzt):
* Tidy operation successfully started. Any information from the operation
will be printed to OpenBao's server logs.
cert_store_deleted_count 0
revoked_cert_deleted_count 0
state Finished
Warum 0? Tidy löscht nur Zertifikate, die seit mehr als
safety_buffer abgelaufen sind – unser Zertifikat läuft noch
24 h.
Fortschritt speichern? Kostenlos registrieren
Drill 11: ACME (kurz)
OpenBao spricht ACME (RFC 8555) – certbot, cert-manager oder Caddy holen Zertifikate direkt.
bao write pki_int/config/cluster \
path="$BAO_ADDR/v1/pki_int" aia_path="$BAO_ADDR/v1/pki_int"
bao secrets tune \
-passthrough-request-headers=If-Modified-Since \
-allowed-response-headers=Last-Modified \
-allowed-response-headers=Location \
-allowed-response-headers=Replay-Nonce \
-allowed-response-headers=Link \
pki_int
bao write pki_int/config/acme enabled=true | grep enabled
curl -s "$BAO_ADDR/v1/pki_int/acme/directory" | jq .Erwartet (gekürzt):
enabled true
{
"keyChange": "http://127.0.0.1:8200/v1/pki_int/acme/key-change",
"meta": {
"externalAccountRequired": false
},
"newAccount": "http://127.0.0.1:8200/v1/pki_int/acme/new-account",
"newNonce": "http://127.0.0.1:8200/v1/pki_int/acme/new-nonce",
"newOrder": "http://127.0.0.1:8200/v1/pki_int/acme/new-order",
"revokeCert": "http://127.0.0.1:8200/v1/pki_int/acme/revoke-cert"
}
Eine echte Ausstellung braucht einen Client und erreichbare Challenges (HTTP-01/DNS-01) – das ist nicht Teil dieses Labs.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
#!/usr/bin/env bash
cd ~/bao-lab/tag05
check() { if eval "$2" >/dev/null 2>&1; then echo "✔ $1"; else echo "✘ $1"; fi; }
check "Transit-Key webshop" "bao read transit/keys/webshop"
RT=$(bao write -field=ciphertext transit/encrypt/webshop \
plaintext=$(echo -n ok | base64))
check "Encrypt/Decrypt Roundtrip" \
"bao write -field=plaintext transit/decrypt/webshop ciphertext=$RT \
| base64 -d | grep -qx ok"
check "Signing-Key ecdsa" \
"bao read -field=type transit/keys/webshop-sign | grep -q ecdsa-p256"
check "Root-CA" "bao read pki/cert/ca"
check "Kette gültig" "openssl verify -CAfile root_ca.crt -untrusted int.crt api.crt"
check "Rolle webshop" "bao read pki_int/roles/webshop"
check "ACME-Directory" "curl -sf $BAO_ADDR/v1/pki_int/acme/directory"Challenge
Erstelle eine Policy webshop-encrypt, mit der ein Token
nur verschlüsseln, aber nicht entschlüsseln kann, und beweise
beides.
Hinweis: Transit-Operationen sind
update auf dem jeweiligen Pfad.
Lösung
bao policy write webshop-encrypt - <<'EOF'
path "transit/encrypt/webshop" {
capabilities = ["update"]
}
EOF
T=$(bao token create -policy=webshop-encrypt -field=token)
CT=$(BAO_TOKEN=$T bao write -field=ciphertext transit/encrypt/webshop \
plaintext=$(echo -n geheim | base64))
echo "$CT"
BAO_TOKEN=$T bao write transit/decrypt/webshop ciphertext="$CT"Erwartet (gekürzt):
vault:v2:+TxsTcVYofyggN4t5B2b8GvsSrolm9gTpkP309Lnf3gCNA==
...
* permission denied
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Transit:
auto_rotate_periodsetzen und regelmäßig Batch-Rewrap fahren;deletion_allowedbleibtfalse. - Encrypt- und Decrypt-Rechte auf verschiedene Identitäten verteilen (Schreib-Service vs. Lese-Service).
- Root-CA nicht im selben Cluster wie die Intermediate betreiben oder nach dem Signieren abschotten; Root-TTL lang, Leaf-TTL kurz (Stunden bis Tage).
tidyperconfig/auto-tidyautomatisieren, CRL/OCSP-Endpunkte für Clients erreichbar machen.- ACME nur mit
eab_policy(External Account Binding) und eingeschränktenallowed_rolesöffnen.