Der Sicherheitscheck ist ausgefallen. Jetzt blockiert jedes Deployment.

Admission Webhooks als kritische Betriebsabhängigkeit

Admission Webhooks als kritische Betriebsabhängigkeit

Lesezeit: ca. 5–6 Minuten

Eine Sicherheitskomponente prüft neue Kubernetes-Ressourcen, bevor sie zugelassen werden. Unsichere Konfigurationen werden abgewiesen, Vorgaben konsequent umgesetzt. Das ist zunächst ein Gewinn. Doch nach einer Störung der Prüfkomponente schlagen plötzlich auch korrekte Deployments fehl. Im ungünstigsten Fall lässt sich nicht einmal die Komponente neu starten, die den Fehler beheben soll.

Admission Webhooks liegen im Verarbeitungspfad der Kubernetes API. Dadurch können sie Regeln wirksam durchsetzen. Gleichzeitig entsteht eine Verfügbarkeitsabhängigkeit. Wer einen Webhook einführt, muss deshalb neben seiner fachlichen Prüfung auch sein Verhalten bei Ausfall, Zeitüberschreitung und Wiederherstellung entwerfen.

Eine zusätzliche Entscheidung vor dem Speichern

Ein Admission Webhook wird für passende API-Anfragen aufgerufen. Je nach Typ kann er ein Objekt verändern oder seine Zulässigkeit prüfen. Welche Ressourcen und Operationen betroffen sind, wird über seine Konfiguration eingegrenzt.

Diese Einbindung bedeutet nicht, dass bei jedem Ausfall sofort alle laufenden Anwendungen stoppen. Bestehende Pods können weiterlaufen. Betroffen sind zunächst die passenden neuen oder geänderten API-Vorgänge. Wenn später Ersatz-Pods, Skalierung oder Reparaturen notwendig werden, kann die Störung jedoch weitreichende Folgen haben.

Die Überschrift beschreibt deshalb den besonders ungünstigen Fall eines sehr breit wirkenden Webhooks. Ein bewusst enger Geltungsbereich kann den Auswirkungsradius erheblich reduzieren. Diese Begrenzung ist eine Architekturentscheidung, keine nebensächliche Konfiguration.

Fachliche Ablehnung und technischer Fehler unterscheiden

Ein Webhook kann eine Anfrage bewusst ablehnen, weil sie eine Regel verletzt. Er kann aber auch gar nicht erreichbar sein, zu spät antworten oder eine technisch ungültige Antwort liefern. Diese Situationen dürfen im Betrieb nicht gleich behandelt werden.

Die Einstellung failurePolicy regelt den Umgang mit bestimmten technischen Fehlern und Timeouts. Mit Fail kann eine betroffene Anfrage scheitern, wenn die Prüfung nicht durchgeführt werden kann. Mit Ignore kann der Ablauf trotz dieses Fehlers weitergehen. Eine erfolgreich übermittelte ausdrückliche Ablehnung wird dadurch nicht einfach aufgehoben.

Die Kubernetes-Dokumentation stellt diese Unterscheidung klar. Für Alarme und Runbooks ist sie entscheidend: Ein berechtigt abgewiesenes unsicheres Objekt ist ein anderer Vorgang als ein vollständig ausgefallener Prüfpfad.

Ein Ausfall kann seine eigene Reparatur blockieren

Ein illustratives Szenario: Ein Webhook läuft als Deployment im selben Cluster. Er prüft alle neu erstellten Pods. Nach einem Node-Ausfall müssen seine eigenen Pods neu angelegt werden. Die API ruft dafür den Webhook auf, aber dessen bisherige Instanzen sind nicht mehr erreichbar.

Wenn dieser Pfad ohne passende Ausnahme blockiert, entsteht ein Kreis. Die Prüfung benötigt laufende Pods, und das Erstellen dieser Pods benötigt die Prüfung. Dass die Komponente normalerweise mehrere Instanzen hat, beseitigt dieses grundsätzliche Wiederherstellungsproblem nicht vollständig.

Ein ähnlicher Kreis kann entstehen, wenn der Webhook von einem Dienst abhängt, dessen Reparatur er selbst kontrolliert. Deshalb müssen nicht nur direkte, sondern auch indirekte Abhängigkeiten betrachtet werden: Zertifikate, DNS, Secrets und gegebenenfalls externe Prüfsysteme.

Den Geltungsbereich bewusst klein halten

Ein Webhook sollte nur die Ressourcen und Operationen prüfen, für die seine Entscheidung tatsächlich erforderlich ist. Breite Regeln erhöhen die Zahl der Aufrufe und den Umfang möglicher Störungen. Ebenso sollten unnötige Aufrufe für System- und Wiederherstellungskomponenten vermieden werden.

Dabei ist Sorgfalt nötig. Eine Ausnahme darf nicht unbemerkt zur allgemeinen Umgehungsmöglichkeit werden. Wenn eine Ausnahme beispielsweise an ein veränderbares Label gebunden ist, muss geklärt sein, wer dieses Label setzen darf und wie Missbrauch verhindert wird.

Der richtige Entwurf verbindet deshalb technische Selektoren mit Berechtigungen und einem klaren Sicherheitsziel. „Alles prüfen“ ist leicht zu formulieren. Eine präzise Regel, die genau die relevanten Veränderungen erfasst und ihre eigenen Voraussetzungen erhält, verlangt mehr Arbeit.

Verfügbarkeit und Latenz gemeinsam planen

Mehrere Webhook-Instanzen über geeignete Fehlerdomänen hinweg können einzelne Ausfälle abfangen. Dafür brauchen sie passende Ressourcen und eine Bereitschaftsprüfung, die ihre tatsächliche Funktionsfähigkeit beschreibt. Ein erreichbarer HTTP-Port allein ist kein ausreichender Nachweis, wenn die eigentliche Prüfung blockiert.

Auch die Antwortzeit ist relevant. Jeder zusätzliche Aufruf kann den API-Vorgang verzögern. Lange Timeouts lassen technische Fehler später sichtbar werden und können während einer Störung viele Anfragen aufhalten. Die offiziellen Empfehlungen raten deshalb zu kleinen, bewusst gewählten Zeitgrenzen.

Externe Abhängigkeiten im Prüfpfad sollten besonders kritisch bewertet werden. Muss für jedes Objekt ein entfernter Dienst antworten, übernimmt der Admission-Pfad dessen Verfügbarkeit und Latenz. Wo möglich, können lokal verfügbare Entscheidungsgrundlagen den Ablauf stabiler machen.

Fail-open oder Fail-closed braucht eine Begründung

Es gibt keine allgemeingültige Einstellung für jeden Webhook. Bei einer zwingenden Sicherheitsanforderung kann die Blockierung bei fehlender Prüfung richtig sein. Bei einer ergänzenden Mutation kann ein anderes Verhalten vertretbar sein, sofern die Gesamtarchitektur die notwendigen Eigenschaften weiterhin sicherstellt.

Die Entscheidung muss beschreiben, was bei Ausfall konkret passieren darf. Welche Objekte könnten ungeprüft entstehen? Welche Risiken würden dadurch eingeführt? Welche Betriebsfunktionen würden bei einer Blockierung ausfallen? Erst dieser Vergleich macht die Wahl nachvollziehbar.

Für bestimmte Validierungen können native Admission-Mechanismen eine Alternative zum extern aufgerufenen Webhook sein. Ob sie ausreichen, hängt von der gewünschten Regel und der eingesetzten Kubernetes-Version ab. Die Entscheidung sollte vom benötigten Verhalten ausgehen und nicht von der Gewohnheit, jede Prüfung als eigenen Dienst zu betreiben.

Ein Notfallverfahren muss vorher existieren

Wenn ein fehlerhafter Webhook Reparaturen verhindert, braucht das Betriebsteam einen dokumentierten Weg zur Wiederherstellung. Dazu gehören passende Berechtigungen, eine bekannte sichere Konfiguration und die Möglichkeit, Änderungen nachvollziehbar vorzunehmen. Eine spontane vollständige Abschaltung aller Prüfungen wäre ein sehr weitreichender Eingriff.

Ein sinnvoller Ablauf begrenzt die Maßnahme auf den betroffenen Webhook und die benötigten Vorgänge. Falls eine Prüfung vorübergehend ausgesetzt wird, muss anschließend geklärt werden, welche Ressourcen in diesem Zeitraum erstellt oder verändert wurden und wie sie nachgeprüft werden.

Auch GitOps muss berücksichtigt werden. Eine manuelle Notfalländerung kann sonst unmittelbar durch den Sollzustand rückgängig gemacht werden. Der Reparaturablauf sollte deshalb erklären, wie kurzfristige Abweichung und dauerhafte Korrektur zusammengeführt werden.

Den Ausfall vor der Einführung testen

Ein Abnahmetest sollte den Webhook nicht nur mit erlaubten und verbotenen Objekten prüfen. Er sollte auch fehlende Erreichbarkeit, langsame Antworten und den Neustart seiner eigenen Instanzen abdecken. Dabei werden die Auswirkungen auf normale Deployments und Reparaturvorgänge beobachtet.

Das Monitoring sollte technische Fehler, bewusste Ablehnungen und Latenzen getrennt darstellen. So erkennt das Team, ob eine Regel erfolgreich schützt oder ob die Infrastruktur zur Durchsetzung selbst gestört ist. Diese Trennung verkürzt die Diagnose erheblich.

Sicherheitskontrollen sind Teil der produktiven Plattform. Ihre Wiederherstellbarkeit gehört daher zu ihrer Qualität. Ein gut entworfener Admission-Pfad setzt Regeln verlässlich durch und lässt zugleich einen kontrollierten Weg offen, um seine eigenen Voraussetzungen wiederherzustellen.

Technische Quellen