Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

SPIFFE-IDs, Vertrauensdomänen und SVIDs

Nach dieser Lektion: Ich kann eine SPIFFE-ID lesen und sie in einem X.509- oder JWT-SVID finden.

Lektion, 70 Min.7 BefehleLab zur Workload-Identität: SPIFFE und SPIRE auf k3s, mit mTLS zwischen Diensten, auf einer privaten Ubuntu-VM

Ein Name, den jeder Dienst prüfen kann

Eine SPIFFE-ID ist der Name eines Workloads, geschrieben als URI, etwa spiffe://lab.test/basket. Jeder Dienst einer Firma kann sie lesen und auf dieselbe Weise prüfen.

Ohne gemeinsames Format erfindet jedes Team sein eigenes: hier ein Hostname, dort ein Kontoname. Dann kann niemand eine einzige Regel schreiben, wer wen aufrufen darf.

Am Ende dieser Lektion

Notiz

Ich kann eine SPIFFE-ID lesen und sie in einem X.509- oder JWT-SVID finden.

Schlüsselwörter

BegriffWas er bedeutetBeispiel
SPIFFE-IDder Name eines Workloads als URIspiffe://lab.test/basket
Vertrauensdomäneder Teil nach spiffe://, eine signierende Stellelab.test
X.509-SVIDein Zertifikat, das die ID in seinem URI-SAN trägt
JWT-SVIDein signiertes Token, das die ID im Claim sub trägt
Trust-Bundledie CA-Zertifikate, mit denen man die SVIDs einer Vertrauensdomäne prüft
Registrierungseintrageine Regel, die passenden Workloads eine ID gibt

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Eine SPIFFE-ID hat zwei Teile

Nach spiffe:// folgt die Vertrauensdomäne, etwa lab.test. Alles in einer Vertrauensdomäne signiert dieselbe Stelle. Dann folgt der Pfad, etwa /ns/demo/sa/printer, der den Workload darin benennt.

Die Regeln sind streng. In der Vertrauensdomäne stehen nur Kleinbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche. Es gibt keinen Port, keinen Benutzer, keine Query, kein leeres Segment, kein . oder .. und keinen Schrägstrich am Ende.

Beispiel: gültig oder nicht

TextGültig?Warum
spiffe://lab.test/basketJaVertrauensdomäne lab.test, Pfad /basket
spiffe://lab.testJaEine Vertrauensdomäne ohne Pfad
spiffe://Lab.test/basketNeinGroßbuchstabe in der Vertrauensdomäne
spiffe://lab.test/basket/NeinEin Schrägstrich am Ende
spiffe://lab.test:8443/basketNeinEin Port ist nicht erlaubt
https://lab.test/basketNeinDas Schema muss spiffe sein

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Ein Registrierungseintrag vergibt eine ID

Eine ID vergibt ein Registrierungseintrag. Er nennt die SPIFFE-ID, den Agenten, der sie ausgeben darf (die Parent-ID), und die Selektoren, zu denen ein Workload passen muss. Lektion 4 sieht sich Einträge genau an.

Die nächsten beiden Runs registrieren die Workloads der Lektionen. Der Benutzer catalogue bekommt spiffe://lab.test/catalogue, und basket bekommt spiffe://lab.test/basket. Jeder Run gibt den neuen Eintrag aus; seine Entry ID ist in jeder Kopie anders.

Den Workload catalogue registrieren

Befehl
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/catalogue -selector unix:user:catalogue

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Den Workload basket registrieren

Befehl
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/basket -selector unix:user:basket

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Ein X.509-SVID ist ein kurzes Zertifikat

Ein X.509-SVID ist ein gewöhnliches Zertifikat mit einem Unterschied: Sein Name ist ein URI-SAN mit der SPIFFE-ID. TLS-Bibliotheken können also schon damit umgehen.

Warten Sie nach dem Registrieren ein paar Sekunden und holen Sie es dann als basket. Der Run gibt SPIFFE ID: spiffe://lab.test/basket aus, dann SVID Valid After und SVID Valid Until. Dazwischen liegen etwa eine Stunde und zehn Sekunden. SPIRE lässt das Zertifikat zehn Sekunden früher beginnen, falls Uhren voneinander abweichen.

Das X.509-SVID als basket holen

Befehl
sudo -u basket spire-agent api fetch x509

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Einen Ordner anlegen, der basket gehört

Befehl
sudo -u basket mkdir -p /tmp/basket

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Das SVID in Dateien schreiben

Befehl
sudo -u basket spire-agent api fetch x509 -write /tmp/basket

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Die SPIFFE-ID darin lesen

Befehl
openssl x509 -in /tmp/basket/svid.0.pem -noout -ext subjectAltName

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Drei Dateien, und eine bleibt privat

Der Run mit -write legt svid.0.pem an (das Zertifikat), svid.0.key (seinen privaten Schlüssel, nur für basket lesbar) und bundle.0.pem (das Trust-Bundle). OpenSSL gibt URI:spiffe://lab.test/basket unter X509v3 Subject Alternative Name aus.

Der private Schlüssel wurde auf dieser Maschine erzeugt und hat sie nie verlassen.

Ein JWT-SVID ist ein signiertes Token

Manche Aufrufe können kein Mutual TLS nutzen, etwa durch einen Proxy, der TLS beendet. Dann hilft ein JWT-SVID, ein signiertes Token. Sein Claim sub ist die SPIFFE-ID, und sein Claim aud nennt, wer es annehmen darf.

Der Run gibt token(spiffe://lab.test/basket): aus, dann ein langes Token aus drei Teilen mit Punkten dazwischen und danach die JWT-Schlüssel der Vertrauensdomäne. Das Token gilt hier fünf Minuten.

Ein JWT-SVID für catalogue holen

Befehl
sudo -u basket spire-agent api fetch jwt -audience catalogue

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Ein häufiger Fehler

Warnung

Viele halten ein JWT-SVID für sicherer, weil es neuer wirkt. Wer ein JWT kopiert, kann es bis zum Ablauf erneut senden. Nehmen Sie X.509-SVIDs mit Mutual TLS, wo es geht, und kurze JWTs mit enger Zielgruppe, wo nicht.

Über dieses Lab und seinen Quellcode: Lab zur Workload-Identität: SPIFFE und SPIRE auf k3s, mit mTLS zwischen Diensten, auf einer privaten Ubuntu-VM

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.