Zum Inhalt springen
Trainingslager IT-Trainingslager

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 in pki_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=root

Terminal 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/webshop

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

Erwartet:

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

Erwartet (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_version anheben – 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/webshop

Erwartet (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/webshop

Erwartet (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 -dates

Erwartet (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-signed setzen, 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.key

Erwartet:

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 subjectAltName

Erwartet:

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

Erwartet (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.json und api.key sind 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_period setzen und regelmäßig Batch-Rewrap fahren; deletion_allowed bleibt false.
  • 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).
  • tidy per config/auto-tidy automatisieren, CRL/OCSP-Endpunkte für Clients erreichbar machen.
  • ACME nur mit eab_policy (External Account Binding) und eingeschränkten allowed_roles öffnen.