Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 7: kind-Cluster und TLS

Ziel: Ein kind-Cluster mit 3 Workern läuft, und das TLS-Material für OpenBao liegt als Secret im Cluster. · Dauer: ca. 45 min · Voraussetzung: Tag 0

Briefing

  • Ab heute läuft OpenBao in Kubernetes: 3 Pods auf 3 Workern, Raft repliziert zwischen ihnen.
  • Raft-Traffic und API laufen über TLS. Dafür baust du eine eigene Lab-CA und ein Server-Zertifikat.
  • Das Zertifikat muss alle Namen abdecken, unter denen die Pods sich gegenseitig und du sie erreichst.
  • Alle openssl-Befehle brauchen OpenSSL 3 (Tag 0). Zeigt openssl version LibreSSL, scheitern -addext und -verify_hostname.
           kind-Cluster "bao-lab"
 +---------------+  +---------------+  +---------------+
 | bao-lab-worker|  |bao-lab-worker2|  |bao-lab-worker3|
 |   openbao-0   |  |   openbao-1   |  |   openbao-2   |
 +-------+-------+  +-------+-------+  +-------+-------+
         +------ Raft (TLS, :8201) ------------+

Drill 1: Cluster anlegen

mkdir -p ~/bao-lab/k8s ~/bao-lab/tls
cat > ~/bao-lab/k8s/kind.yaml <<'EOF'
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
name: bao-lab
nodes:
  - role: control-plane
  - role: worker
  - role: worker
  - role: worker
EOF
kind create cluster --config ~/bao-lab/k8s/kind.yaml

Erwartet (gekürzt, kann je nach Version abweichen):

Creating cluster "bao-lab" ...
 ...
Set kubectl context to "kind-bao-lab"
You can now use your cluster with:

kubectl cluster-info --context kind-bao-lab

Fortschritt speichern? Kostenlos registrieren

Drill 2: Nodes und Storage prüfen

kubectl config current-context
kubectl get nodes
kubectl get storageclass

Erwartet (gekürzt, kann je nach Version abweichen):

kind-bao-lab
NAME                    STATUS   ROLES           AGE   VERSION
bao-lab-control-plane   Ready    control-plane   60s   v1.3x.x
bao-lab-worker          Ready    <none>          45s   v1.3x.x
bao-lab-worker2         Ready    <none>          45s   v1.3x.x
bao-lab-worker3         Ready    <none>          45s   v1.3x.x
NAME                 PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE
standard (default)   rancher.io/local-path   Delete          WaitForFirstConsumer

Warum? Die Control-Plane hat einen NoSchedule-Taint – OpenBao landet nur auf den 3 Workern. Die StorageClass standard liefert später die Raft-Volumes.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Lab-CA erzeugen

cd ~/bao-lab/tls
openssl req -x509 -newkey rsa:4096 -sha256 -days 365 -nodes \
  -keyout ca.key -out ca.crt -subj "/CN=bao-lab Root CA" \
  -addext "basicConstraints=critical,CA:TRUE" \
  -addext "keyUsage=critical,keyCertSign,cRLSign"
openssl x509 -in ca.crt -noout -subject -ext basicConstraints

Erwartet:

subject=CN=bao-lab Root CA
X509v3 Basic Constraints: critical
    CA:TRUE

Sicherheit: ca.key ist ein Lab-Schlüssel ohne Passphrase. Er signiert alles, was dein Cluster als vertrauenswürdig ansieht.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Server-Zertifikat mit SANs

cat > openbao.ext <<'EOF'
basicConstraints = CA:FALSE
keyUsage = critical, digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth, clientAuth
subjectAltName = @alt_names

[alt_names]
DNS.1 = openbao
DNS.2 = openbao-active
DNS.3 = *.openbao-internal
DNS.4 = *.openbao-internal.openbao.svc.cluster.local
DNS.5 = openbao.openbao.svc
DNS.6 = openbao-0.openbao-internal
DNS.7 = openbao-1.openbao-internal
DNS.8 = openbao-2.openbao-internal
DNS.9 = localhost
IP.1 = 127.0.0.1
EOF
openssl req -newkey rsa:2048 -nodes -keyout tls.key -out tls.csr \
  -subj "/CN=openbao"
openssl x509 -req -in tls.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
  -out tls.crt -days 180 -sha256 -extfile openbao.ext

Erwartet:

Certificate request self-signature ok
subject=CN=openbao

Warum die expliziten openbao-N.openbao-internal? Die Pods sprechen sich für retry_join genau so an (Tag 8). OpenSSL-basierte Clients wie curl akzeptieren *.openbao-internal nicht, weil nach dem Wildcard nur ein Label folgt – siehe Challenge.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Zertifikat prüfen

openssl x509 -in tls.crt -noout -ext subjectAltName | tr ',' '\n'
openssl verify -CAfile ca.crt tls.crt
openssl verify -CAfile ca.crt -verify_hostname openbao-1.openbao-internal tls.crt
openssl verify -CAfile ca.crt -verify_ip 127.0.0.1 tls.crt
diff <(openssl x509 -in tls.crt -noout -pubkey) <(openssl pkey -in tls.key -pubout) \
  && echo "✔ Key passt zum Zertifikat"

Erwartet:

X509v3 Subject Alternative Name:
    DNS:openbao
 DNS:openbao-active
 DNS:*.openbao-internal
 DNS:*.openbao-internal.openbao.svc.cluster.local
 DNS:openbao.openbao.svc
 DNS:openbao-0.openbao-internal
 DNS:openbao-1.openbao-internal
 DNS:openbao-2.openbao-internal
 DNS:localhost
 IP Address:127.0.0.1
tls.crt: OK
tls.crt: OK
tls.crt: OK
✔ Key passt zum Zertifikat

Gegenprobe – ein falscher Name muss scheitern:

openssl verify -CAfile ca.crt -verify_hostname evil.example tls.crt

Erwartet:

CN=openbao
error 62 at 0 depth lookup: hostname mismatch
error tls.crt: verification failed

Fortschritt speichern? Kostenlos registrieren

Drill 6: Namespace und Secret

kubectl create namespace openbao
kubectl -n openbao create secret generic openbao-tls \
  --from-file=tls.crt=$HOME/bao-lab/tls/tls.crt \
  --from-file=tls.key=$HOME/bao-lab/tls/tls.key \
  --from-file=ca.crt=$HOME/bao-lab/tls/ca.crt
kubectl -n openbao describe secret openbao-tls

Erwartet (gekürzt, Größen können abweichen):

Name:         openbao-tls
Namespace:    openbao
Type:  Opaque

Data
====
ca.crt:   1846 bytes
tls.crt:  1834 bytes
tls.key:  1704 bytes

Warum generic statt tls? kubectl create secret tls nimmt nur Zertifikat und Key auf – im Pod brauchst du zusätzlich ca.crt.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

cd ~/bao-lab/tls
check() { if eval "$2" >/dev/null 2>&1; then echo "✔ $1"; else echo "✘ $1"; fi; }
check "Kontext kind-bao-lab" '[ "$(kubectl config current-context)" = kind-bao-lab ]'
check "3 Worker Ready" \
  '[ "$(kubectl get nodes --no-headers | grep -c "worker.*Ready")" -eq 3 ]'
check "Zertifikat von CA signiert" 'openssl verify -CAfile ca.crt tls.crt'
check "SAN openbao-2.openbao-internal" \
  'openssl verify -CAfile ca.crt -verify_hostname openbao-2.openbao-internal tls.crt'
check "Secret openbao-tls mit 3 Keys" \
  '[ "$(kubectl -n openbao get secret openbao-tls -o json | jq ".data|length")" -eq 3 ]'

Challenge

Ein vierter Pod openbao-3 käme dazu. Ist openbao-3.openbao-internal durch das Zertifikat abgedeckt? Prüfe es mit OpenSSL und mit dem Langnamen openbao-3.openbao-internal.openbao.svc.cluster.local.

Hinweis: OpenSSL wendet bei Wildcards strengere Regeln an als Go (und damit bao).

Lösung

cd ~/bao-lab/tls
openssl verify -CAfile ca.crt -verify_hostname openbao-3.openbao-internal tls.crt
openssl verify -CAfile ca.crt \
  -verify_hostname openbao-3.openbao-internal.openbao.svc.cluster.local tls.crt

Erwartet:

CN=openbao
error 62 at 0 depth lookup: hostname mismatch
error tls.crt: verification failed
tls.crt: OK

Der Kurzname scheitert in OpenSSL (Wildcard über nur ein Label), Go würde ihn akzeptieren. Der FQDN passt überall. Konsequenz: Neue Pod-Namen explizit als SAN aufnehmen oder FQDNs verwenden.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Zertifikate per cert-manager oder aus einer internen PKI (z. B. OpenBao PKI, Tag 5) ausstellen, nicht per Hand.
  • CA-Schlüssel offline bzw. im HSM; der Cluster bekommt nur Intermediate-signierte Zertifikate.
  • Kurze Laufzeiten plus automatisierte Rotation; OpenBao lädt Listener-Zertifikate per SIGHUP neu, ab 2.7 mit tls_auto_reload = true im Listener auch selbst.
  • Echte Cluster: Worker über mehrere Zonen verteilen, damit Anti-Affinity auch Zonenausfälle abfängt.