Tag 14: Registries, Signaturen und statische Analyse
Ziel: Du lässt nur Images aus der eigenen Registry und per Digest zu, signierst und prüfst notes-api mit cosign, kennst den Aufbau von ImagePolicyWebhook und findest unsichere Manifeste mit kubesec und KubeLinter. · Dauer: ca. 75 min · Voraussetzung: Tag 13
Briefing
- CKS: Supply Chain Security – „Secure your supply chain: permitted registries, sign and validate artifacts“ und „Perform static analysis of user workloads“.
- Ein Tag wie
:1.0ist veränderlich, ein Digest (@sha256:…) nicht. Erlaubte Registry plus Digest heißt: genau dieses Image aus genau dieser Quelle. - ValidatingAdmissionPolicy (VAP) prüft per CEL direkt im API-Server – kein Webhook, kein Neustart. ImagePolicyWebhook fragt einen externen Dienst und braucht Flags.
- Statische Analyse prüft YAML, bevor es den Cluster erreicht (CI, Pre-Commit).
YAML --kubesec/KubeLinter--> k apply --> API-Server: VAP (CEL) / ImagePolicyWebhook
|
Image --cosign sign--> Registry 172.16.0.126:30500 <---+-- kubelet zieht per Digest
mkdir -p ~/cks/tag14/backup && cd ~/cks/tag14
k create ns tag14
k config set-context --current --namespace=tag14
curl -s http://172.16.0.126:30500/v2/notes-api/tags/list; echoErwartet:
{"name":"notes-api","tags":["1.0","1.0-min"]}
Fehlen die Tags (Registry-Pod neu gestartet), aus podman neu pushen wie in Tag 13 (Drill 2 und 3).
Drill 1: Nur erlaubte Registry
cat > vap.yaml <<'EOF'
apiVersion: admissionregistration.k8s.io/v1
kind: ValidatingAdmissionPolicy
metadata:
name: tag14-allowed-registries
spec:
failurePolicy: Fail
matchConstraints:
resourceRules:
- apiGroups: [""]
apiVersions: ["v1"]
operations: ["CREATE", "UPDATE"]
resources: ["pods"]
validations:
- expression: >-
object.spec.containers.all(c, c.image.startsWith('172.16.0.126:30500/'))
&& (!has(object.spec.initContainers) ||
object.spec.initContainers.all(c, c.image.startsWith('172.16.0.126:30500/')))
message: "Nur Images aus 172.16.0.126:30500/ erlaubt"
reason: Forbidden
EOF
cat > vap-binding.yaml <<'EOF'
apiVersion: admissionregistration.k8s.io/v1
kind: ValidatingAdmissionPolicyBinding
metadata:
name: tag14-allowed-registries
spec:
policyName: tag14-allowed-registries
validationActions: ["Deny"]
matchResources:
namespaceSelector:
matchLabels:
kubernetes.io/metadata.name: tag14
EOF
k apply -f vap.yaml -f vap-binding.yamlDie Policy allein tut nichts – erst das Binding legt fest, wo
(namespaceSelector) und wie (Deny,
Warn, Audit) sie greift. Der Schrägstrich am
Ende des Präfixes verhindert, dass etwa
172.16.0.126:305001/… durchrutscht.
k run web --image=nginx:1.29
k run api --image=172.16.0.126:30500/notes-api:1.0-min --env=NOTES_API_KEY=lab-key-123
k create deploy web --image=nginx:1.29
k get deploy web
k get events --field-selector reason=FailedCreate -o custom-columns=MSG:.message \
| tail -1Erwartet (gekürzt):
Error from server (Forbidden): pods "web" is forbidden: ValidatingAdmissionPolicy
'tag14-allowed-registries' with binding 'tag14-allowed-registries' denied request: Nur
Images aus 172.16.0.126:30500/ erlaubt
pod/api created
deployment.apps/web created
NAME READY UP-TO-DATE AVAILABLE AGE
web 0/1 0 0 3s
... Error creating: pods "web-689b9bdbdd-t98hz" is forbidden: ValidatingAdmission...
Das Deployment wird angelegt, erst der ReplicaSet-Controller scheitert am Pod. Wie du schon das Deployment ablehnst, zeigt die Challenge.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Images per Digest
Den Digest liefert ein laufender Pod oder die Registry selbst:
k get pod api -o jsonpath='{.status.containerStatuses[0].imageID}{"\n"}'
curl -sI -H "Accept: application/vnd.oci.image.manifest.v1+json" \
http://172.16.0.126:30500/v2/notes-api/manifests/1.0-min | grep -i digestErwartet (gekürzt):
172.16.0.126:30500/notes-api@sha256:890cf194a609df6ddfbacfe1691362efcc87b00c48a2...
Docker-Content-Digest: sha256:890cf194a609df6ddfbacfe1691362efcc87b00c48a2cb3a48c2...
Zweite Regel an die Policy hängen:
cat >> vap.yaml <<'EOF'
- expression: "object.spec.containers.all(c, c.image.contains('@sha256:'))"
messageExpression: >-
"Image ohne Digest: " + object.spec.containers.map(c, c.image).join(", ")
EOF
k apply -f vap.yaml
I=$(k get pod api -o jsonpath='{.status.containerStatuses[0].imageID}')
k run api2 --image=172.16.0.126:30500/notes-api:1.0-min --env=NOTES_API_KEY=lab-key-123
k run api2 --image=$I --env=NOTES_API_KEY=lab-key-123Erwartet (gekürzt):
validatingadmissionpolicy.admissionregistration.k8s.io/tag14-allowed-registries
configured
The pods "api2" is invalid: : ValidatingAdmissionPolicy 'tag14-allowed-registries' with
binding 'tag14-allowed-registries' denied request: Image ohne Digest:
172.16.0.126:30500/notes-api:1.0-min
pod/api2 created
Ohne reason meldet die Regel Invalid statt
Forbidden. messageExpression baut die Meldung
per CEL und nennt das schuldige Image.
Fortschritt speichern? Kostenlos registrieren
Drill 3: cosign installieren
mkdir -p dl && cd dl
V=v3.1.4
ARCH=$(dpkg --print-architecture)
curl -sLO https://github.com/sigstore/cosign/releases/download/$V/cosign-linux-${ARCH}
curl -sLO https://github.com/sigstore/cosign/releases/download/$V/cosign_checksums.txt
grep " cosign-linux-${ARCH}$" cosign_checksums.txt | sha256sum -c
sudo install cosign-linux-${ARCH} /usr/local/bin/cosign
cosign version 2>&1 | grep GitVersion
cd ..Erwartet:
cosign-linux-amd64: OK
GitVersion: v3.1.4
export COSIGN_PASSWORD=lab-cosign-pw
cosign generate-key-pair
ls -l cosign.*Erwartet:
Private key written to cosign.key
Public key written to cosign.pub
-rw------- 1 ubuntu ubuntu 653 Nov 18 18:30 cosign.key
-rw-r--r-- 1 ubuntu ubuntu 178 Nov 18 18:30 cosign.pub
COSIGN_PASSWORD ist ein reiner Lab-Wert; ohne die
Variable fragt cosign interaktiv.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Signieren und prüfen
Signiert wird immer per Digest. cosign 3 lädt Signaturen standardmäßig in das öffentliche Transparenz-Log Rekor – für ein Lab-Image unerwünscht. Eine leere Signing-Config schaltet das ab:
cosign signing-config create --out signing-config.json
cat signing-config.json; echo
cosign sign --key cosign.key --signing-config signing-config.json \
--allow-http-registry --yes $IErwartet:
{"mediaType":"application/vnd.dev.sigstore.signingconfig.v0.2+json",
"rekorTlogConfig":{}, "tsaConfig":{}}
Signing artifact...
Pushing signature to: 172.16.0.126:30500/notes-api
Das ältere --tlog-upload=false lehnt cosign 3 mit
Verweis auf die Signing-Config ab. --allow-http-registry
braucht es nur, weil die Lab-Registry kein TLS spricht.
curl -s http://172.16.0.126:30500/v2/notes-api/tags/list; echo
R=172.16.0.126:30500/notes-api
cosign verify --key cosign.pub --allow-http-registry --insecure-ignore-tlog \
$R:1.0-min 2>/dev/null | jq -c '.[0].critical.image'
cosign verify --key cosign.pub --allow-http-registry --insecure-ignore-tlog \
$R:1.0 2>&1 | tail -1Erwartet (gekürzt):
{"name":"notes-api","tags":["1.0","1.0-min","sha256-890cf194a609df6ddfbacfe1691..."]}
{"docker-manifest-digest":"sha256:890cf194a609df6ddfbacfe1691362efcc87b00c48a2cb..."}
error during command execution: no signatures found
Die Signatur liegt als eigenes Artefakt unter dem Tag
sha256-<digest> in derselben Registry.
1.0 ist nicht signiert. --insecure-ignore-tlog
passt zur Signatur ohne Rekor-Eintrag. Mit einem fremden Schlüssel:
mkdir other && cd other
COSIGN_PASSWORD=x cosign generate-key-pair >/dev/null 2>&1
cosign verify --key cosign.pub --allow-http-registry --insecure-ignore-tlog \
$R:1.0-min 2>&1 | tail -1
cd ..Erwartet (gekürzt):
error during command execution: no matching attestations: failed to verify signature:
could not verify envelope: accepted signatures do not match threshold, Found: 0,
Expected 1
Im Cluster erzwingt das ein Admission-Webhook (Sigstore policy-controller, Kyverno); der API-Server selbst prüft keine Signaturen.
Fortschritt speichern? Kostenlos registrieren
Drill 5: ImagePolicyWebhook
Der eingebaute Admission-Controller schickt für jeden Pod ein
ImageReview an einen externen Dienst. Die Konfiguration
besteht aus zwei Dateien – gezeigt mit einem Backend, das es (noch)
nicht gibt:
M=/etc/kubernetes/manifests
sudo cp $M/kube-apiserver.yaml ~/cks/tag14/backup/kube-apiserver.yaml
sudo mkdir -p /etc/kubernetes/admission
sudo tee /etc/kubernetes/admission/admission-config.yaml <<'EOF'
apiVersion: apiserver.config.k8s.io/v1
kind: AdmissionConfiguration
plugins:
- name: ImagePolicyWebhook
configuration:
imagePolicy:
kubeConfigFile: /etc/kubernetes/admission/imagepolicy.kubeconfig
allowTTL: 50
denyTTL: 50
retryBackoff: 500
defaultAllow: true
EOF
sudo tee /etc/kubernetes/admission/imagepolicy.kubeconfig <<'EOF'
apiVersion: v1
kind: Config
clusters:
- name: image-checker
cluster:
server: https://127.0.0.1:8443/image-policy
certificate-authority: /etc/kubernetes/pki/ca.crt
users:
- name: api-server
user: {}
contexts:
- name: default
context:
cluster: image-checker
user: api-server
current-context: default
EOF
sudo vim $M/kube-apiserver.yamlPlugin aktivieren, Konfigurationsdatei setzen, Ordner einhängen:
sudo diff ~/cks/tag14/backup/kube-apiserver.yaml $M/kube-apiserver.yamlErwartet:
19c19,20
< - --enable-admission-plugins=NodeRestriction
---
> - --enable-admission-plugins=NodeRestriction,ImagePolicyWebhook
> - --admission-control-config-file=/etc/kubernetes/admission/admission-config.yaml
84a86,88
> - mountPath: /etc/kubernetes/admission
> name: admission
> readOnly: true
112a117,120
> - hostPath:
> path: /etc/kubernetes/admission
> type: Directory
> name: admission
Nach dem Neustart:
sudo crictl logs $(sudo crictl ps --name kube-apiserver -q) 2>&1 \
| grep -o "following order: .*ImagePolicyWebhook"
k run ipw --image=$I --env=NOTES_API_KEY=lab-key-123Erwartet:
following order: LimitRanger,ServiceAccount,ImagePolicyWebhook
pod/ipw created
Das Backend ist nicht erreichbar, und defaultAllow: true
lässt trotzdem alles durch (fail open; vermerkt wird das nur als
Audit-Annotation, Tag 15). Mit defaultAllow: false lehnt
der API-Server dann jeden Pod im Cluster ab – auch
DaemonSet-Pods anderer Teams:
Error from server (Forbidden): pods "ipw" is forbidden: Post
"https://127.0.0.1:8443/image-policy?timeout=30s": dial tcp 127.0.0.1:8443: connect:
connection refused
(gekürzt, kann je nach Version abweichen – im geteilten Labor nicht ausgeführt.) Zurückbauen, ImagePolicyWebhook bleibt nicht aktiv:
sudo cp ~/cks/tag14/backup/kube-apiserver.yaml $M/kube-apiserver.yaml
sudo rm -r /etc/kubernetes/admission
k delete pod ipwNach etwa einer Minute meldet k get --raw /readyz wieder
ok.
Fortschritt speichern? Kostenlos registrieren
Drill 6: kubesec
cd dl
K=v2.15.0
B=https://github.com/controlplaneio/kubesec/releases/download/$K
ARCH=$(dpkg --print-architecture)
curl -sLO $B/kubesec_linux_${ARCH}.tar.gz
curl -sLO $B/kubesec_checksums.txt
grep " kubesec_linux_${ARCH}.tar.gz$" kubesec_checksums.txt | sha256sum -c
tar xzf kubesec_linux_${ARCH}.tar.gz kubesec
sudo install kubesec /usr/local/bin/
kubesec version | head -1
cd ..Erwartet:
kubesec_linux_amd64.tar.gz: OK
version 2.15.0
Ein typisches Prüfungs-Manifest, absichtlich schlecht:
k create deploy notes --image=172.16.0.126:30500/notes-api:1.0-min --port=8080 \
$do > notes.yaml
sed -i -e "s/^ spec:/&\n hostNetwork: true/" \
-e "s/^ resources: {}/ securityContext:\n privileged: true/" \
notes.yaml
kubesec scan notes.yaml | jq -r '.[0] | .score, .message'
kubesec scan notes.yaml | jq -r '.[0].scoring.critical[] | .id + ": " + .selector'Erwartet:
-39
Failed with a score of -39 points
Privileged: containers[] .securityContext .privileged == true
HostNetwork: .spec .hostNetwork == true
critical zieht Punkte ab und lässt den Scan scheitern
(Exit-Code 2), advise listet, was Punkte bringt. Ohne
Installation geht es auch als Container:
podman run -i --rm docker.io/kubesec/kubesec:v2.15.0 scan /dev/stdin < notes.yaml \
2>/dev/null | jq -r '.[0].message'Erwartet:
Failed with a score of -39 points
Achtung: Das Image
kubesec/kubesecgibt es nur für amd64. Auf einer ARM64-VM (Apple Silicon) scheitertpodman runmitexec format error– dort nimmst du das Binary von oben.
Fortschritt speichern? Kostenlos registrieren
Drill 7: KubeLinter
L=v0.8.3
F=kube-linter-linux$(dpkg --print-architecture | sed 's/amd64//;s/arm64/_arm64/')
curl -sLO https://github.com/stackrox/kube-linter/releases/download/$L/$F
sudo install $F /usr/local/bin/kube-linter
kube-linter version
kube-linter lint notes.yaml 2>&1 | grep -o "check: [a-z-]*"Erwartet:
0.8.3
check: host-network
check: no-read-only-root-fs
check: privilege-escalation-container
check: privileged-container
check: run-as-non-root
check: unset-cpu-requirements
check: unset-memory-requirements
KubeLinter liefert für diese Version keine Prüfsummendatei, nur Sigstore-Bundles mit Projektschlüssel. Jetzt die gehärtete Fassung – Digest, Nicht-Root, nur lesbares Dateisystem, keine Capabilities, Limits:
cat > notes-sicher.yaml <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
name: notes
labels:
app: notes
spec:
replicas: 1
selector:
matchLabels:
app: notes
template:
metadata:
labels:
app: notes
spec:
automountServiceAccountToken: false
securityContext:
runAsNonRoot: true
runAsUser: 65532
seccompProfile:
type: RuntimeDefault
containers:
- name: notes-api
image: $I
env:
- name: NOTES_API_KEY
value: lab-key-123
ports:
- containerPort: 8080
securityContext:
allowPrivilegeEscalation: false
readOnlyRootFilesystem: true
capabilities:
drop: ["ALL"]
resources:
requests:
cpu: 50m
memory: 32Mi
limits:
cpu: 200m
memory: 64Mi
EOF
kubesec scan notes-sicher.yaml | jq -r '.[0].message'
kube-linter lint notes-sicher.yaml 2>&1 | tail -1
k apply -f notes-sicher.yaml
k get pod -l app=notesErwartet:
Passed with a score of 11 points
No lint errors found!
deployment.apps/notes created
NAME READY STATUS RESTARTS AGE
notes-7f6bf4447f-vrxtf 1/1 Running 0 15s
Beide Werkzeuge und die VAP sind zufrieden. Exit-Code 0
macht das Manifest CI-tauglich.
Fortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Mit welchem Digest läuft der Pod
api? Zeitziel: 20 s - Ist
notes-api:1.0mitcosign.pubsigniert? Zeitziel: 30 s - Welchen kubesec-Score hat
notes.yaml? Zeitziel: 20 s - Welche VAP-Bindings gibt es, und mit welcher Aktion? Zeitziel: 30 s
Lösung
k get pod api -o jsonpath='{.status.containerStatuses[0].imageID}{"\n"}'
cosign verify --key cosign.pub --allow-http-registry --insecure-ignore-tlog \
172.16.0.126:30500/notes-api:1.0 2>&1 | tail -1
kubesec scan notes.yaml | jq '.[0].score'
k get validatingadmissionpolicybinding \
-o custom-columns=NAME:.metadata.name,ACTIONS:.spec.validationActionsErwartet (gekürzt):
172.16.0.126:30500/notes-api@sha256:890cf194a609df6ddfbacfe1691362efcc87b00c48a2...
error during command execution: no signatures found
-39
NAME ACTIONS
tag14-allowed-registries [Deny]
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
k run nginx --image=nginx:1.29 2>&1 | grep -o "Nur Images aus [0-9.:]*/"Erwartet:
Nur Images aus 172.16.0.126:30500/
cosign verify --key cosign.pub --allow-http-registry --insecure-ignore-tlog \
172.16.0.126:30500/notes-api:1.0-min >/dev/null 2>&1; echo $?Erwartet: 0
kube-linter lint notes-sicher.yaml >/dev/null 2>&1; echo $?Erwartet: 0
sudo grep -c ImagePolicyWebhook /etc/kubernetes/manifests/kube-apiserver.yamlErwartet: 0
Im Labor bleiben nur die Werkzeuge (cosign, kubesec,
kube-linter), das Schlüsselpaar in ~/cks/tag14 und die
Signatur in der Registry.
Challenge
Ein Deployment mit fremdem Image soll schon beim create
scheitern, nicht erst still im ReplicaSet. Schreibe dafür eine zweite
Policy tag14-deploy-registries samt Binding.
Hinweis: Bei Deployments stecken die Container unter
spec.template.spec.
Lösung
cat > vap-deploy.yaml <<'EOF'
apiVersion: admissionregistration.k8s.io/v1
kind: ValidatingAdmissionPolicy
metadata:
name: tag14-deploy-registries
spec:
matchConstraints:
resourceRules:
- apiGroups: ["apps"]
apiVersions: ["v1"]
operations: ["CREATE", "UPDATE"]
resources: ["deployments"]
validations:
- expression: >-
object.spec.template.spec.containers.all(c,
c.image.startsWith('172.16.0.126:30500/'))
message: "Nur Images aus 172.16.0.126:30500/ erlaubt"
---
apiVersion: admissionregistration.k8s.io/v1
kind: ValidatingAdmissionPolicyBinding
metadata:
name: tag14-deploy-registries
spec:
policyName: tag14-deploy-registries
validationActions: ["Deny"]
matchResources:
namespaceSelector:
matchLabels:
kubernetes.io/metadata.name: tag14
EOF
k apply -f vap-deploy.yaml
k create deploy web2 --image=nginx:1.29
k set image deploy/notes notes-api=nginx:1.29Erwartet (gekürzt):
error: failed to create deployment: deployments.apps "web2" is forbidden:
ValidatingAdmissionPolicy 'tag14-deploy-registries' with binding ... denied request
error: failed to patch image update to pod template: deployments.apps "notes" is
forbidden: ValidatingAdmissionPolicy 'tag14-deploy-registries' ...
Auch das UPDATE (neues Image) wird abgelehnt.
Aufräumen – die Policies sind nur für heute (ohne Challenge melden
die beiden tag14-deploy-registries-Zeilen
NotFound, das ist in Ordnung):
k delete validatingadmissionpolicybinding tag14-allowed-registries
k delete validatingadmissionpolicy tag14-allowed-registries
k delete validatingadmissionpolicybinding tag14-deploy-registries
k delete validatingadmissionpolicy tag14-deploy-registries
k delete ns tag14
k config set-context --current --namespace=defaultFortschritt speichern? Kostenlos registrieren
Prüfungstipp
- VAP braucht immer zwei Objekte: Policy und Binding.
Ohne Binding passiert nichts,
validationActionsfehlt nie. CEL-Fehler zeigtk get validatingadmissionpolicy <name> -o yamlunterstatus.typeChecking. - ImagePolicyWebhook: Plugin in
--enable-admission-plugins,--admission-control-config-file, Volume – unddefaultAllow: false, wenn die Aufgabe „deny if backend unreachable“ fordert. Die Pfade liest der API-Server in seinem Container – den Host-Ordner also perhostPatheinhängen. - Doku: kubernetes.io → Reference → „Validating Admission Policy“ und „Admission Controllers“ (Abschnitt ImagePolicyWebhook, mit Beispielkonfiguration).
Enterprise-Notiz
- Signaturen keyless prüfen (Fulcio + Rekor, OIDC-Identität der CI-Pipeline) statt Schlüsseldateien zu verwalten; im Cluster per Sigstore policy-controller oder Kyverno.
- Eine interne Registry als Proxy/Mirror für Docker Hub & Co., freigegeben nach Scan – die VAP lässt dann nur noch diese zu.
- Images im Deployment per Digest pinnen; Renovate oder Dependabot heben den Digest kontrolliert an.
- kubesec, KubeLinter, Trivy (
trivy config) als CI-Gate mit Exit-Code; dieselben Regeln als Admission-Policy, damit niemand am Gate vorbei deployt. - SBOM und Provenance (SLSA) als Attestation neben die Signatur legen
(
cosign attest).