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:
user default offist der Kern. Findet Valkey zu einem Zertifikat keinen passenden Benutzer, landet die Verbindung beim Benutzerdefault. Wäre der offen, käme jedes gültige Zertifikat des Mandanten ohne Passwort hinein, auch das der Datenbank oder des Reverse Proxy. Mitoffwird jede nicht zugeordnete Verbindung abgewiesen.nopassist hier kein Leichtsinn. Ohne passendes Client-Zertifikat kommt niemand bis zur Anmeldung, weil der TLS-Handshake vorher scheitert.- Der Schrägstrich im Benutzernamen funktioniert.
kunde-x/x-appist ein gültiger ACL-Name.
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:
- Ein Cache-Backend, das beim Leeren
FLUSHDBschickt, braucht+flushdb. Der Befehl gehört zur Kategorie@dangerousund fällt sonst weg. Dasselbe gilt fürKEYS, wenn ein Backend damit Schlüssel nach Muster sucht. - Der redis_exporter fragt beim Verbinden
CLIENT SETNAMEundCOMMAND INFOab, auf Valkey 9 außerdem bei jedem ScrapeCOMMANDLOG LEN. Fehlt eines davon, liefern die Metriken Lücken, undACL LOGfüllt sich mitNOPERM-Einträgen. - Ein Sidecar, der erneuerte Zertifikate per
CONFIG SETnachlädt, braucht genau dieses Recht und sonst fast nichts. Wer ihn zusätzlich das ACL-Log lesen lässt, sieht nach jedem Nachladen, ob etwas abgewiesen wurde.
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.
- ACL-Benutzer anlegen,
defaultbehält das Passwort. Clients, die weiterAUTHmit dem Passwort schicken, landen beidefaultund haben volle Rechte. Clients, die kein Passwort schicken, werden sofort ihr Zertifikats-Benutzer. Es kann also nichts ausfallen. - 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 ohneAUTHan. Ein leeres Passwort gilt in den gängigen Cache-Bibliotheken als „keines“. user default off,requirepassentfernen. 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:
- Übergang: ein eigener Benutzer
'x_app'@'localhost'ohne jedes Recht außerUSAGE. Socket-Verbindungen zählen alslocalhost. Die Probe meldet sich dort an, und dasREQUIREgilt nur für'%'. - Ziel: ein Probe-Konto, das sich per
unix_socketanmeldet.
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:
- Zertifikat zusätzlich zum Passwort.
REQUIRE SUBJECT … AND ISSUER …setzen, das Passwort bleibt. Das verschärft nur. Beobachte diese Stufe über mindestens einen Zertifikatswechsel. - Altes Passwort oder keines.
EinALTER USER 'x_app'@'%' IDENTIFIED VIA mysql_native_password USING PASSWORD('<altes-passwort>') OR mysql_native_password USING '';ALTER USER … IDENTIFIED VIAohneREQUIRE-Klausel lässt das bestehendeREQUIRE 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. - Passwortdatei aus allen Pods entfernen. Anwendung, Worker, Scheduler, Setup- und Wartungsjobs, in beliebiger Reihenfolge. PDO meldet sich mit
nulloder''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. - Nur noch leer.
ALTER USER 'x_app'@'%' IDENTIFIED VIA mysql_native_password USING '';ohne dieOR-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. - Aufräumen. Den Übergangsbenutzer
'x_app'@'localhost'löschen, sobald dieunix_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:
- Neues Zertifikat ohne Neustart. Jeder Pod bekommt ein zweites Zertifikat, ohne dass ein Container neu startet.
- Neue Verbindungen nach Ablauf des alten. Erst wenn das alte Zertifikat abgelaufen ist und danach neue Verbindungen zu Datenbank und Cache gelingen, ist sicher: Der Client zeigt wirklich das neue vor.
Zwei Dinge machen die Beobachtung schwieriger, als sie klingt:
- PodCertificateRequests verschwinden. Kubernetes räumt die Anfrageobjekte kurz nach der Ausstellung weg. Wer zählt, wie viele Anfragen ein Pod hatte, sieht nach ein paar Minuten nichts mehr. Verlässlicher ist das Log des Signers, der jede Ausstellung mit Pod-Namen protokolliert.
- Jeder Neustart setzt die Uhr zurück. Ein neuer Pod bekommt ein frisches Zertifikat. Ein Deploy, der während der Beobachtung die Pods neu startet, verschiebt den Wechsel um die volle Laufzeit.
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.
- Teil 1: Zertifikat statt Passwort (dieser Beitrag)
- Teil 2: Der Schlüssel gehört nicht in den PHP-Prozess
- Teil 3: Was Secrets im Container wirklich schützt
- 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.
Über den Autor

Kai Ole Hartwig
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.
