25. November 2025 · Aktualisiert am 31. Oktober 2026 · 8 Min. Lesezeit

Admission Controller und Policies

Automatische Schranke an einer Zufahrtskontrolle, im Hintergrund parkende Fahrzeuge
Foto: Adrian Frentescu / Pexels

Ein Kubernetes Admission Controller prüft oder verändert passende schreibende Anfragen an die Kubernetes-API nach Authentifizierung und Autorisierung, bevor das Objekt gespeichert wird. Für eigene Validierungsregeln kannst du native CEL-Policies nutzen; für zusätzliche Funktionen kommen Webhooks und Engines wie Kyverno oder Gatekeeper infrage. Leseanfragen durchlaufen diesen Admission-Schritt nicht.

Wer diesen Ablauf einmal verstanden hat, versteht auch, wie Werkzeuge wie Gatekeeper oder Kyverno eigene Policies durchsetzen, ohne den Kubernetes-Quellcode anzufassen.

Ich betreibe Kubernetes-Cluster in Produktion und habe das Kubernetes-Praxisbuch bei Rheinwerk geschrieben (2024), mit einem eigenen Kapitel zu Governance und Security. Alle meine Beiträge zu Kubernetes findest du gesammelt auf der Seite Kubernetes.

Was ein Admission Controller in Kubernetes prüft

Eine schreibende Anfrage an den Kubernetes-API-Server durchläuft mehrere Stationen, bevor ein Objekt tatsächlich im Cluster ankommt. Zuerst stellt der API-Server fest, wer die Anfrage schickt, meist über das Zertifikat aus deiner Kubeconfig. Danach prüft er, ob dieser Nutzer die Aktion überhaupt darf, das übernimmt RBAC. Wie das Rechtemodell dahinter aufgebaut ist, steht in Kubernetes RBAC: Rollen und Rechte.

Erst danach kommen die Admission Controller ins Spiel, in zwei Durchgängen. Im ersten Durchgang dürfen Mutating Admission Controller das Manifest noch verändern, etwa ein Standard-Label ergänzen oder ein CPU-Limit setzen. Danach prüft Kubernetes, ob das veränderte Manifest formal gültig ist. Im zweiten Durchgang dürfen Validating Admission Controller das Ergebnis nur noch annehmen oder ablehnen, verändern dürfen sie nichts mehr. Erst wenn auch dieser Schritt durch ist, landet das Objekt im etcd und wird für den Cluster aktiv.

Kubernetes bringt schon eine Reihe fertiger Admission Controller mit, etwa für Standard-Storage-Klassen oder für Ressourcengrenzen je Namespace. Welche davon aktiv sind, entscheidet die Konfiguration des API-Servers, das ist Sache deiner Cluster-Admins. Eine vollständige Übersicht bietet die Kubernetes-Dokumentation zu Admission Controllern.

Kubernetes Admission Controller Webhook: eigene Regeln einhängen

Die eingebauten Admission Controller decken viele Standardfälle ab, aber eigene Regeln, etwa welche Image-Registries erlaubt sind, brauchen mehr Flexibilität. Dafür gibt es zwei besondere Admission Controller, die selbst keine Logik enthalten, sondern eine Anfrage an einen externen Dienst weiterreichen: den MutatingAdmissionWebhook und den ValidatingAdmissionWebhook.

Ein Kubernetes Admission Controller Webhook ist technisch nichts anderes als ein HTTPS-Endpunkt, den du selbst betreiben kannst oder der von einem fertigen Werkzeug mitgebracht wird. Kubernetes schickt bei jeder passenden Anfrage das Manifest an diesen Endpunkt und wartet auf eine Antwort: erlaubt, abgelehnt, oder im Fall des Mutating Webhooks ein verändertes Manifest. Genau diesen Mechanismus nutzen die beiden bekanntesten Policy-Werkzeuge im Kubernetes-Umfeld, Gatekeeper und Kyverno. Für einfache Prüfungen gibt es seit einigen Releases zusätzlich Validating Admission Policies: Regeln in der Common Expression Language, die der API-Server selbst auswertet, ganz ohne eigenen Webhook-Dienst.

Native CEL-Policy, Kyverno oder Gatekeeper?

Für einfache Validierungen zuerst die native ValidatingAdmissionPolicy prüfen. Sie ist seit Kubernetes 1.30 stabil: CEL-Ausdrücke laufen im API-Server, eine Binding-Ressource legt Geltungsbereich und Reaktion fest. Dafür ist kein zusätzlicher Webhook-Dienst nötig. Voraussetzung ist, dass dein Cluster die API und den Admission Controller bereitstellt und du die nötigen Rechte hast.

Bedarf Vorauswahl Grenze bzw. zusätzlicher Betrieb
Labels, Image-Präfixe, Feldwerte am eingehenden Objekt prüfen native ValidatingAdmissionPolicy mit CEL validiert, verändert das Objekt nicht; kein nachträglicher Scan aller bestehenden Objekte
Validieren, mutieren, Ressourcen erzeugen oder Images verifizieren Kyverno zusätzliche Controller; Fähigkeiten hängen von Policy-Typ und Version ab
vorhandene OPA-/Rego-Regeln wiederverwenden, Constraints und Audit-Berichte Gatekeeper zusätzlicher Controller und Pflege von Templates/Constraints

Kyverno unterstützt neben YAML-Mustern auch CEL. Gatekeeper nutzt für Validierung ConstraintTemplate und Constraint; Rego ist ein etablierter Weg, aktuelle Versionen unterstützen auch CEL-Code. Mutation ist dort separat konfiguriert. „YAML gegen Rego“ allein reicht deshalb als heutige Auswahlregel nicht. Wähle nach benötigter Funktion, vorhandenen Regeln und dem Betrieb, den dein Team tragen kann.

Dokumentationsbeispiel: Registry mit nativer CEL-Policy prüfen

Dokumentationsbasiert, kein eigener Cluster-Test. Stand der Quellen: 31.10.2026. Das Beispiel leitet sich aus der offiziellen VAP-Dokumentation ab. Es braucht Kubernetes ab 1.30 mit verfügbarer admissionregistration.k8s.io/v1-API, aktivem ValidatingAdmissionPolicy-Controller und passenden Administratorrechten. Vor einer Übernahme in einem isolierten Testcluster gegen dessen Version prüfen.

Das Binding gilt nur im Namespace policy-demo. Die Regel erfasst normale Container, Init-Container und nachträglich hinzugefügte Ephemeral Container. Registry und Objektnamen sind Platzhalter.

apiVersion: v1
kind: Namespace
metadata:
  name: policy-demo
---
apiVersion: admissionregistration.k8s.io/v1
kind: ValidatingAdmissionPolicy
metadata:
  name: trusted-registry.example.com
spec:
  failurePolicy: Fail
  matchConstraints:
    resourceRules:
      - apiGroups: [""]
        apiVersions: ["v1"]
        operations: ["CREATE", "UPDATE"]
        resources: ["pods", "pods/ephemeralcontainers"]
  variables:
    - name: allContainers
      expression: >-
        object.spec.containers +
        (has(object.spec.initContainers) ? object.spec.initContainers : []) +
        (has(object.spec.ephemeralContainers) ? object.spec.ephemeralContainers : [])
  validations:
    - expression: >-
        variables.allContainers.all(c,
          c.image.startsWith('registry.example.internal/'))
      message: "Images must use registry.example.internal/"
---
apiVersion: admissionregistration.k8s.io/v1
kind: ValidatingAdmissionPolicyBinding
metadata:
  name: trusted-registry-demo
spec:
  policyName: trusted-registry.example.com
  validationActions: [Warn, Audit]
  matchResources:
    namespaceSelector:
      matchLabels:
        kubernetes.io/metadata.name: policy-demo

So ist das Ergebnis zu prüfen, nicht als ausgeführter Test zu lesen:

Eingabe im Namespace policy-demo Erwartung bei Warn, Audit Nach bewusster Umstellung auf Deny, Audit
alle Images beginnen mit registry.example.internal/ diese Regel beanstandet sie nicht diese Regel beanstandet sie nicht
ein Container nutzt docker.io/library/nginx:latest Warnung, Audit-Eintrag, Anfrage nicht durch diese Regel blockiert Anfrage abgelehnt
ein Init-/Ephemeral-Container nutzt eine fremde Registry ebenso Warnung/Audit Anfrage abgelehnt

Eine erfolgreiche Admission sagt nichts darüber aus, ob das Image existiert oder heruntergeladen werden kann. Der abschließende Schrägstrich verhindert, dass ein ähnlich beginnender Hostname als gültiger Präfix durchgeht. Die Regel prüft keine Signatur, keinen Digest und keine Sicherheitslücken. Andere Admission-Regeln dürfen dieselbe Anfrage weiterhin ablehnen. Bei Deployments wird erst der erzeugte Pod geprüft, nicht schon das Deployment-Manifest.

Warn meldet Verstöße am Client, Audit schreibt sie ins konfigurierte Kubernetes-Audit-Protokoll; es entsteht dadurch kein Kyverno-/Gatekeeper-Policy-Report und kein Scan vorhandener Pods. Deny und Warn dürfen nicht gemeinsam gesetzt werden. failurePolicy: Fail steuert den Umgang mit Auswertungsfehlern; die tatsächliche Reaktion wird durch die Actions des Bindings bestimmt. Erst nach Prüfung der Negativfälle, des Geltungsbereichs und des Rückwegs auf Warn, Audit auf Deny, Audit umstellen.

Resource Quotas und Limit Ranges: Policy ohne Webhook

Nicht jede Regel braucht einen Webhook. Zwei eingebaute Objekte lösen eine ähnliche Aufgabe, ohne dass du eine Policy-Engine installierst: ResourceQuota und LimitRange. Eine ResourceQuota begrenzt, wie viele Pods oder wie viel CPU und Speicher ein ganzer Namespace insgesamt anfordern darf, das schützt den Cluster davor, dass ein einzelnes Team alle Ressourcen belegt. Eine LimitRange setzt dagegen Minimum, Maximum und Standardwerte für einen einzelnen Pod oder Container, unabhängig von der Quota des Namespace.

Beide Objekte ergänzen Gatekeeper und Kyverno, sie ersetzen sie nicht. Eine ResourceQuota verhindert nicht, dass jemand ein Image aus einer falschen Registry zieht, und eine reine Validierung setzt keine Standardwerte für Requests. Mutierende Policy-Regeln können Werte hingegen ergänzen. Eine mögliche Kombination ist LimitRange und ResourceQuota für Ressourcengrenzen und eine passende Policy für weitere Vorgaben.

Erst beobachten, dann blockieren

Beginne mit kleinem Geltungsbereich und Warnungen bzw. Audit-Berichten. Native VAP prüft passende neue Anfragen; für eine Bestandsaufnahme brauchst du zusätzlich einen Scan oder eine Engine mit Audit-Funktion. Teste erlaubte und unerlaubte Objekte, Init-/Ephemeral-Container und Änderungen an vorhandenen Pods. Verifiziere, wo Warnungen und Audit-Einträge tatsächlich ankommen.

Aktiviere blockierende Regeln erst nach diesem Abgleich, mit dokumentiertem Verantwortlichen und Rückweg. Admission ändert bestehende Objekte nicht rückwirkend, kann aber spätere Updates und Ersatz-Pods eines Deployments blockieren. Genau diese Betriebsfälle gehören in die Abnahme.

Häufige Fragen

Was ist der Unterschied zwischen Mutating und Validating Admission Webhook?

Ein Mutating Admission Webhook darf ein Manifest noch verändern, etwa ein Label ergänzen. Ein Validating Admission Webhook darf ein Manifest nur noch annehmen oder ablehnen. Kubernetes ruft immer zuerst alle Mutating Webhooks auf und erst danach die Validating Webhooks, damit die Validierung das endgültige, schon veränderte Manifest sieht.

Brauche ich Gatekeeper oder Kyverno, wenn ich schon RBAC nutze?

Nicht zwingend: Für Feldprüfungen kann eine native CEL-Policy reichen. RBAC entscheidet, wer eine Aktion ausführen darf, etwa einen Pod anlegen. Eine Policy-Engine wie Gatekeeper oder Kyverno entscheidet, wie dieser Pod aussehen darf, etwa welche Registry oder welcher Security Context erlaubt ist. Beide Ebenen ergänzen sich, keine ersetzt die andere.

Ersetzen Resource Quotas eine Policy Engine?

Nein. ResourceQuota und LimitRange setzen Grenzen für Ressourcen wie CPU und Speicher je Namespace oder Pod, mehr aber auch nicht. Für Regeln zu Images, Labels oder Security-Einstellungen brauchst du zusätzliche Validierung, etwa native CEL-Policies, Gatekeeper oder Kyverno.

Wie teste ich eine neue Kyverno Policy, ohne den Cluster zu blockieren?

Bei einer aktuellen Kyverno-ClusterPolicy setzt du spec.rules[].validate.failureAction zunächst auf Audit. Prüfe mit geeignetem Background-Scan die Policy-Reports, bevor du blockierende Regeln aktivierst. Das ältere Feld spec.validationFailureAction ist seit Kyverno 1.13 veraltet; für andere Policy-Typen gelten andere Felder. Siehe die Kyverno-Einstellungen.

Wie du weitermachst

Admission Controller und Policies sind der dritte Baustein neben RBAC und Pod Security Standards, mit dem du einen Kubernetes-Cluster gegen unsichere Manifeste absicherst. Wie RBAC im Detail funktioniert, steht in Kubernetes RBAC: Rollen und Rechte, die Grundeinstellungen für Pods in Pod Security Standards in Kubernetes. Wer eigene Objekte statt fertiger Policy-Engines bauen möchte, findet den Einstieg in Kubernetes Operator und CRD erklärt.

Zum Einstieg: Prüfe in einem Testcluster eine native CEL-Regel mit Warnungen. Brauchst du zusätzliche Funktionen, vergleiche Kyverno und Gatekeeper anhand einer konkreten Policy und ihrer Audit-Ausgabe.

Ausführlich mit allen Beispielen steht das in Kapitel 7 meines Kubernetes-Praxisbuchs bei Rheinwerk.

Kevin Welter

Kevin Welter

Entwickler, IT-Architekt, Fachbuchautor (Kubernetes, Cloud-Infrastrukturen) und Speaker. Betreibt sein Business mit einer KI-Belegschaft aus fünfzehn KI-Mitarbeitern und zeigt Selbstständigen in seiner Community, wie sie ihren ersten KI-Mitarbeiter einstellen.

Mehr über KI-Mitarbeiter

Kubernetes von den Grundlagen bis zum produktionsreifen Cluster

Zum Buch