Kai Ole Hartwig
13 Min. Lesezeit
Niedrig
Von

Nichts zum Mitnehmen, Teil 1: Zertifikat statt Passwort

Wer mTLS auf jeder Strecke hat, hat zwei Faktoren für die Anmeldung an Datenbank und Cache: das Client-Zertifikat und ein Passwort. Das Zertifikat ist kurzlebig und wird vom kubelet erzeugt. Das Passwort ist statisch und liegt als Datei im Container. Genau dort sucht ein Angreifer nach einer Lücke in der Anwendung zuerst.

Dieses How-to zeigt, wie du das Passwort ganz streichst. Valkey ordnet jedem Zertifikat einen ACL-Benutzer zu, MariaDB verlangt Subject und Aussteller des Pod-Zertifikats. Der Umstieg läuft in Stufen, bei denen nichts ausfällt.

Teil 1 von 4 der Reihe „Nichts zum Mitnehmen“. Ergänzt Teil 5: mTLS auf jeder Strecke der Serie „TYPO3 auf Kubernetes unter IT-Grundschutz“.

01 — Ausgangslage: zwei Faktoren, einer davon statisch

Die Ausgangslage aus Teil 5 der TYPO3-Serie: Valkey lauscht nur auf dem TLS-Port und verlangt mit tls-auth-clients yes ein Client-Zertifikat. MariaDB erzwingt TLS mit require_secure_transport=ON. Zusätzlich meldet sich die Anwendung bei beiden mit einem Passwort an.

Das Passwort bringt dabei weniger, als es scheint. Wer Code im PHP-Container ausführen kann, liest die Passwortdatei genauso wie die Anwendung. Und es ist statisch. Es gilt so lange, bis jemand es ändert, also oft jahrelang.

Das Pod-Zertifikat hat beide Schwächen nicht. Es gilt 24 Stunden, der kubelet erneuert es automatisch. Im Subject trägt es die Identität des Pods: CN=<namespace>/<serviceaccount>, für die Anwendung zum Beispiel CN=kunde-x/x-app. Wenn Datenbank und Cache genau dieses Subject verlangen, ist das Passwort überflüssig.

Voraussetzung ist ein Signer je Mandant, wie in den Feldnotizen Pod-Zertifikate statt geteilter Geheimnisse und Das ganze Netz auf Pod-Zertifikate beschrieben. Ein Zertifikat von Mandant A darf beim Cache von Mandant B nicht ankommen.

02 — Valkey: ein ACL-Benutzer pro Zertifikat

Valkey 9 kann den Common Name des Client-Zertifikats direkt als Benutzernamen verwenden. Die Einstellung dafür heißt tls-auth-clients-user:

 

tls-auth-clients yes
tls-auth-clients-user CN

user default off
user kunde-x/x-app            on nopass ~* &* +@all -@admin -@dangerous +flushdb +keys +info
user kunde-x/x-cache-exporter on nopass +info +ping +select +dbsize +config|get +client|list +client|info +client|setname +command|info +commandlog|len +slowlog +latency +memory|stats +cluster|info
user kunde-x/x-cache          on nopass +ping +config|set +acl|log +acl|whoami

 

Die Anwendung bekommt alles außer Administration und gefährlichen Befehlen. Dazu kommen die zwei gefährlichen, die ein Cache-Backend wirklich braucht. Der Exporter liest nur. Der Reload-Sidecar setzt Zertifikate und darf zur Kontrolle das ACL-Log lesen.

Drei Dinge daran sind wichtig:

Die Befehlsliste aus dem tatsächlichen Gebrauch

Die Liste der erlaubten Befehle sollte aus dem echten Verhalten der Clients kommen, nicht aus der Dokumentation. Fang großzügig an und engst sie anhand von ACL LOG ein. In der Praxis zeigen sich dabei typische Lücken:

valkey-cli --tls ... ACL LOG 10

 

Der Befehl zeigt, welcher Benutzer welchen Befehl versucht hat. Nach jeder Stufe sollte das Log leer bleiben.

Die Falle: Valkey prüft den Aussteller nicht

Valkey nimmt den CN, sobald der Handshake gelingt. Welche CA das Zertifikat ausgestellt hat, spielt für die Zuordnung keine Rolle. Ein Zertifikat mit dem CN kunde-x/x-app von einer anderen CA, der der Cache ebenfalls vertraut, meldet sich also als Anwendung an. Im Test passierte genau das mit einem gefälschten Zertifikat einer Übergangs-CA.

Das wird zum Problem, wenn das Trust-Bundle des Cache mehrere CAs enthält. Während einer Umstellung von cert-manager auf Pod-Zertifikate ist das der Normalfall. Mit Passwort war das abgesichert, ohne Passwort wäre es der einzige Schutz.

Die Regel ist deshalb: Bevor das Passwort fällt, vertraut der Cache nur noch der aktuellen Mandanten-CA. Mit Pod-Zertifikaten geht das über einen Label-Selektor auf das ClusterTrustBundle:

 

- clusterTrustBundle:
    signerName: example.com/tenant-kunde-x
    labelSelector:
      matchLabels: { example.com/trust: current }
    path: ca.crt

 

Danach enthält die CA-Datei im Cache-Pod genau ein Zertifikat. Das lässt sich vor dem nächsten Schritt prüfen.

03 — Valkey in drei Stufen umstellen

Jede Stufe ändert die Valkey-Konfiguration und startet Valkey damit neu. Ein Neustart leert den Cache und trennt alle Verbindungen. In der Praxis kostet das ein paar Sekunden, in denen einzelne Anfragen mit „went away“ abbrechen. Plane jede Stufe deshalb in ein ruhiges Fenster.

  1. ACL-Benutzer anlegen, default behält das Passwort. Clients, die weiter AUTH mit dem Passwort schicken, landen bei default und haben volle Rechte. Clients, die kein Passwort schicken, werden sofort ihr Zertifikats-Benutzer. Es kann also nichts ausfallen.
  2. Clients einzeln ohne Passwort. Zuerst die Anwendung, dann Exporter und Reload-Sidecar. Nach jedem Schritt zeigt ACL LOG, ob ein Befehl fehlt. Ein PHP-Client wie phpredis meldet sich über TLS ohne AUTH an. Ein leeres Passwort gilt in den gängigen Cache-Bibliotheken als „keines“.
  3. user default off, requirepass entfernen. Erst jetzt, wenn kein Client mehr das Passwort schickt. Danach kann die Passwortdatei aus allen Pods verschwinden, auch aus dem Cache-Pod selbst.

04 — MariaDB: Subject und Aussteller verlangen

MariaDB kann für einen Benutzer ein bestimmtes Client-Zertifikat verlangen:

 

ALTER USER 'x_app'@'%'
  REQUIRE SUBJECT '/CN=kunde-x\\/x-app'
  AND ISSUER '/CN=Mandanten-CA kunde-x 2026';

 

Falle 1: der maskierte Schrägstrich

Der CN eines Pod-Zertifikats enthält einen Schrägstrich. MariaDB vergleicht das Subject in seiner einzeiligen Schreibweise. Dort wird ein Schrägstrich innerhalb eines Werts als \/ maskiert. REQUIRE SUBJECT '/CN=kunde-x/x-app' passt deshalb nie. Gemeint ist /CN=kunde-x\/x-app. Weil der Backslash in einem SQL-String selbst maskiert werden muss, steht im Statement \\/.

Auch die RFC-2253-Schreibweise ohne führenden Schrägstrich passt nicht. Wenn du unsicher bist: Mit log_warnings=4 schreibt MariaDB das tatsächlich gesehene Subject ins Log.

Zum Zurücklesen hilft --raw. Sonst verdoppelt der Batch-Modus des Clients den Backslash in der Ausgabe:

 

mariadb --batch --raw --skip-column-names -e \
  "SELECT CONCAT(ssl_type,'|',x509_subject,'|',x509_issuer)
     FROM mysql.user WHERE user='x_app' AND host='%'"

 

Falle 2: ohne ISSUER zählt jede vertraute CA

Wie beim Cache gilt auch hier: Ein REQUIRE SUBJECT allein lässt ein Zertifikat mit gleichem Subject von jeder CA durch, der der Server vertraut. Erst AND ISSUER beschränkt die Anmeldung auf die Mandanten-CA. Im Test wurde das gefälschte Zertifikat der Übergangs-CA mit ISSUER abgewiesen und ohne angenommen.

Der Aussteller trägt in der Regel ein Jahr oder eine Generation im Namen. Bei einem Wechsel der Mandanten-CA muss das REQUIRE ISSUER mitgezogen werden. Das gehört in den Ablauf des CA-Wechsels, nicht ins Gedächtnis.

05 — Ein eigenes Konto für die Readiness-Probe

Der typische Stolperstein beim ersten Schritt liegt gar nicht bei der Anwendung. Er liegt bei der Readiness-Probe der Datenbank. Viele Images prüfen die Bereitschaft, indem sie sich über den lokalen Unix-Socket mit dem Anwendungsbenutzer und seinem Passwort anmelden. Über den Socket wird kein Client-Zertifikat übertragen.

Sobald der Anwendungsbenutzer ein Zertifikat verlangt, scheitert die Probe. Die Datenbank fällt aus dem Service, obwohl sie läuft. Genau das passiert, wenn man REQUIRE einfach setzt.

Es gibt zwei saubere Wege:

CREATE USER IF NOT EXISTS 'mariadb'@'localhost' IDENTIFIED VIA unix_socket;
-- SHOW GRANTS muss genau das zeigen:
-- GRANT USAGE ON *.* TO `mariadb`@`localhost` IDENTIFIED VIA unix_socket

 

unix_socket authentifiziert über die Benutzer-ID des Prozesses am anderen Ende des Sockets. Die Probe läuft im Datenbank-Container als dessen eigener Systembenutzer und ist damit genau dieser Benutzer. Ein anderer Prozess mit anderer uid wird abgewiesen, und über TCP existiert das Konto gar nicht. Ein Passwort braucht die Probe dann nicht mehr.

Wichtig ist die Reihenfolge. Lege das Konto in einem Deploy an und stelle die Probe erst im nächsten darauf um. Im selben Deploy träfe die neu gestartete Datenbank auf eine Probe, deren Konto noch nicht existiert. Sie würde nie bereit. Ein Hook, der erst nach einem erfolgreichen Rollout läuft, würde das Konto nie anlegen. Der Neustart der Datenbank für die neue Probe bedeutet einen kurzen Moment ohne Datenbank. Auch das gehört in ein ruhiges Fenster.

06 — MariaDB ohne Ausfall auf „kein Passwort“ umstellen

Das Passwort einfach zu entfernen funktioniert nicht, wenn mehrere Pods die Datenbank nutzen. Einige starten mit der neuen Konfiguration, andere laufen noch mit der alten. MariaDB kann aber mehrere Anmeldewege mit OR verketten. Damit wird der Umstieg schrittweise:

  1. Zertifikat zusätzlich zum Passwort.REQUIRE SUBJECT … AND ISSUER … setzen, das Passwort bleibt. Das verschärft nur. Beobachte diese Stufe über mindestens einen Zertifikatswechsel.
  2. Altes Passwort oder keines.
    ALTER USER 'x_app'@'%'   IDENTIFIED VIA mysql_native_password USING PASSWORD('<altes-passwort>')           OR mysql_native_password USING '';
    Ein ALTER USER … IDENTIFIED VIA ohne REQUIRE-Klausel lässt das bestehende REQUIRE SUBJECT … AND ISSUER … aus Stufe 1 stehen. Lies es nach jeder Stufe zurück, statt dich darauf zu verlassen. Jetzt melden sich Clients mit und ohne Passwort an, ein falsches Passwort wird abgewiesen. Das Zertifikat bleibt in beiden Fällen Pflicht.
  3. Passwortdatei aus allen Pods entfernen. Anwendung, Worker, Scheduler, Setup- und Wartungsjobs, in beliebiger Reihenfolge. PDO meldet sich mit null oder '' als Passwort und Client-Zertifikat an. Denk auch an Hilfsskripte, die die Passwortdatei direkt lesen, etwa für ein Setup-Lock. Die müssen eine fehlende Datei vertragen.
  4. Nur noch leer.ALTER USER 'x_app'@'%' IDENTIFIED VIA mysql_native_password USING ''; ohne die OR-Alternative. Achtung: In dieser Stufe wird ein Client, der noch das alte Passwort schickt, abgewiesen, auch mit gültigem Zertifikat. Deshalb kommt sie erst, wenn Stufe 3 überall angekommen ist.
  5. Aufräumen. Den Übergangsbenutzer 'x_app'@'localhost' löschen, sobald die unix_socket-Probe sich bewährt hat.

Ein Statement wie das in Stufe 2 verrät beim Zurücklesen nichts. Lies zur Kontrolle nur, ob die Kette zwei Einträge hat und genau einer davon einen Hash trägt. Den Hash selbst gibst du nicht aus.

07 — Den Zertifikatswechsel beweisen, bevor das Passwort fällt

Ohne Passwort hängt die Anmeldung allein am Zertifikat. Übernimmt ein Client ein erneuertes Zertifikat nicht, fällt er nach spätestens 24 Stunden aus. Diesen Wechsel solltest du deshalb einmal im laufenden Betrieb sehen, bevor du das Passwort streichst. Einen Tag darauf zu warten ist unnötig.

Pod-Zertifikate lassen sich kürzer anfordern. Im Volume des Pods begrenzt maxExpirationSeconds die Laufzeit. Die kleinste erlaubte Laufzeit ist eine Stunde:

 

- podCertificate:
    signerName: example.com/tenant-kunde-x
    keyType: ECDSAP256
    maxExpirationSeconds: 3600
    keyPath: app.key
    certificateChainPath: app.crt

 

Der kubelet erneuert dann nach etwa zwei Dritteln der Laufzeit, also nach rund 40 Minuten statt nach 16 Stunden. Zwei Prüfungen zeigen, ob der Wechsel hält:

Zwei Dinge machen die Beobachtung schwieriger, als sie klingt:

Nach dem Test nimmst du die kurze Laufzeit wieder zurück. Danach gilt wieder die Policy des Signers.

Häufige Fragen

Ist eine Anmeldung ohne Passwort nicht schwächer als mit?+

Nein. Das Zertifikat war vorher schon Pflicht. Weggefallen ist der statische Faktor, den jeder mitnehmen konnte, der die Datei im Container lesen kann. Was bleibt, ist ein Schlüssel, der nach 24 Stunden wertlos ist und an Subject und Aussteller hängt.

Warum reicht REQUIRE X509 nicht?+

REQUIRE X509 verlangt nur irgendein gültiges Zertifikat einer vertrauten CA. Damit könnte sich jede Komponente des Mandanten als Anwendung anmelden, auch der Reverse Proxy oder der Cache. Erst Subject und Aussteller binden die Anmeldung an genau einen Workload.

Was passiert, wenn die Zertifikatserneuerung ausfällt?+

Dann scheitert die Anmeldung, sobald das Zertifikat abläuft, mit oder ohne Passwort. Mit 24 Stunden Laufzeit und Erneuerung nach 16 Stunden bleiben acht Stunden Puffer. Eine Überwachung der Restlaufzeit, wie in Teil 5 der TYPO3-Serie beschrieben, schlägt vorher Alarm.

Geht das auch mit cert-manager statt Pod-Zertifikaten?+

Das Prinzip geht mit jedem Client-Zertifikat, dessen Subject die Komponente eindeutig benennt. Pod-Zertifikate haben den Vorteil, dass der Schlüssel nie in einem Secret liegt. Der kubelet leitet die Identität aus dem ServiceAccount ab.

Wie komme ich zurück, wenn etwas schiefgeht?+

Jede Stufe hat einen Rückweg in einem Schritt. Bei MariaDB ist das die OR-Kette mit dem alten Passwort oder REQUIRE NONE, bei Valkey ein offener default-Benutzer mit requirepass. Halte das Passwort deshalb im Secret-Speicher, bis alle Stufen eine Weile stabil laufen. Erst dann löschst du es.

Fazit

Die Anmeldung per Pod-Zertifikat ist kein großer Umbau. Sie ist eine Reihe kleiner Schritte, bei denen jeder einzelne nichts kaputt machen kann. Die eigentliche Arbeit steckt in den Details, die keine Dokumentation nennt. Valkey prüft den Aussteller nicht, MariaDB maskiert den Schrägstrich. Die Readiness-Probe meldet sich über einen Weg ohne Zertifikat an, und der Exporter braucht Befehle, von denen vorher niemand wusste. Wer diese Stellen kennt, streicht das letzte statische Passwort zwischen Anwendung, Datenbank und Cache ohne eine Minute Ausfall. Nebenbei erfüllt das eine Grundschutz-Anforderung auf die einfachste Art: Am sichersten gespeichert ist ein Passwort, das es nicht mehr gibt (SYS.1.6.A8).

Wie der Schlüssel des Pod-Zertifikats selbst aus dem PHP-Prozess herauskommt, zeigt Teil 2: Der Schlüssel gehört nicht in den PHP-Prozess.

Die Reihe „Nichts zum Mitnehmen“

Vier Teile darüber, wie Zugangsdaten und Schlüssel in einem TYPO3-Cluster dorthin kommen, wo eingeschleuster PHP-Code sie nicht mehr mitnehmen kann.

  1. Teil 1: Zertifikat statt Passwort (dieser Beitrag)
  2. Teil 2: Der Schlüssel gehört nicht in den PHP-Prozess
  3. Teil 3: Was Secrets im Container wirklich schützt
  4. Teil 4: Egress per Hostname statt per IP

Die Reihe baut auf der Serie „TYPO3 auf Kubernetes unter IT-Grundschutz“ auf, vor allem auf deren Teilen 5 (mTLS auf jeder Strecke), 6 (Netz und Mandantentrennung) und 7 (Secrets ohne Git).

Ich stelle Datenbank und Cache deines Clusters auf Zertifikats-Anmeldung um. Ohne Passwort im Container und ohne Ausfall.

ACL-Benutzer je Komponente für Valkey, Subject und Aussteller für MariaDB, ein eigenes Probe-Konto und ein Übergang in Stufen, bei dem jede Stufe einen Rückweg hat.

Auf Wunsch betreibe ich die Zertifikatskette dauerhaft mit.

Termin buchen →

Über den Autor

Foto von Kai Ole Hartwig.

Kai Ole Hartwig

Freiberuflicher DevSecOps-Berater · OnlyOle Consulting

Programmiert seit 2002 – autodidaktisch gelernt, 2012 mit KO-Web selbständig gemacht. Über 100 Projekte, Fokus auf Security, Performance, Automatisierung und Qualität. Heute freiberuflich: DevSecOps-Beratung, Schulungen und Softwareentwicklung.