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). Zeigtopenssl versionLibreSSL, scheitern-addextund-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.yamlErwartet (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 storageclassErwartet (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 basicConstraintsErwartet:
subject=CN=bao-lab Root CA
X509v3 Basic Constraints: critical
CA:TRUE
Sicherheit:
ca.keyist 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.extErwartet:
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.crtErwartet:
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-tlsErwartet (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.crtErwartet:
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
SIGHUPneu, ab 2.7 mittls_auto_reload = trueim Listener auch selbst. - Echte Cluster: Worker über mehrere Zonen verteilen, damit Anti-Affinity auch Zonenausfälle abfängt.