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
| Begriff | Was er bedeutet | Beispiel |
|---|---|---|
| SPIFFE-ID | der Name eines Workloads als URI | spiffe://lab.test/basket |
| Vertrauensdomäne | der Teil nach spiffe://, eine signierende Stelle | lab.test |
| X.509-SVID | ein Zertifikat, das die ID in seinem URI-SAN trägt | |
| JWT-SVID | ein signiertes Token, das die ID im Claim sub trägt | |
| Trust-Bundle | die CA-Zertifikate, mit denen man die SVIDs einer Vertrauensdomäne prüft | |
| Registrierungseintrag | eine 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
| Text | Gültig? | Warum |
|---|---|---|
| spiffe://lab.test/basket | Ja | Vertrauensdomäne lab.test, Pfad /basket |
| spiffe://lab.test | Ja | Eine Vertrauensdomäne ohne Pfad |
| spiffe://Lab.test/basket | Nein | Großbuchstabe in der Vertrauensdomäne |
| spiffe://lab.test/basket/ | Nein | Ein Schrägstrich am Ende |
| spiffe://lab.test:8443/basket | Nein | Ein Port ist nicht erlaubt |
| https://lab.test/basket | Nein | Das 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
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/catalogue -selector unix:user:catalogueHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Den Workload basket registrieren
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/basket -selector unix:user:basketHier 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
sudo -u basket spire-agent api fetch x509Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Einen Ordner anlegen, der basket gehört
sudo -u basket mkdir -p /tmp/basketHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Das SVID in Dateien schreiben
sudo -u basket spire-agent api fetch x509 -write /tmp/basketHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Die SPIFFE-ID darin lesen
openssl x509 -in /tmp/basket/svid.0.pem -noout -ext subjectAltNameHier 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
sudo -u basket spire-agent api fetch jwt -audience catalogueHier 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.