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

Knoten- und Workload-Attestierung in SPIRE

Nach dieser Lektion: Ich kann aus den Selektoren eines Workloads ableiten, welche Registrierungseinträge zu ihm passen.

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

Wer bürgt für die Maschine?

Attestierung heißt in SPIRE: nachweisen, was etwas ist, bevor es eine Identität bekommt. Das geschieht zweimal, einmal für die Maschine und einmal für jedes Programm darauf.

Könnte ein Angreifer einen falschen Agenten starten, wäre jede Identität falsch, die dieser ausgibt. Also muss der Agent erst seine eigene Maschine nachweisen, bevor der Server ihm irgendetwas glaubt.

Am Ende dieser Lektion

Notiz

Ich kann aus den Selektoren eines Workloads ableiten, welche Registrierungseinträge zu ihm passen.

Schlüsselwörter

BegriffWas er bedeutetBeispiel
Knotenattestierungder Agent weist dem Server seine Maschine nach
Workload-Attestierungder Agent findet heraus, was ein anfragender Prozess ist
Selektoreine Tatsache über einen Knoten oder Workloadunix:user:basket
x509popKnotenattestierung durch einen Schlüssel, den eine bekannte CA zertifiziert hat
Join-Tokenein Code zum einmaligen Gebrauch, mit dem ein Agent sich attestiert
Parent-IDder Agent, zu dem ein Eintrag gehört

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

Knotenattestierung: Der Agent weist seine Maschine nach

Jeder SPIRE-Agent weist zuerst die Maschine nach, auf der er läuft. In einer Cloud kann das ein signiertes Instanzdokument des Anbieters sein. In Kubernetes kann es ein projiziertes Token eines Dienstkontos sein.

Dieses Lab nutzt x509pop: Beim Setup hat eine kleine CA ein Zertifikat für den Knoten signiert. Der Agent beweist, dass er den Schlüssel dazu besitzt, und der Server traut der CA. Die ID des Agenten entsteht dann aus dem Common Name des Zertifikats.

Das Zertifikat des Knotens lesen

Befehl
openssl x509 -in /etc/spire/node.pem -noout -subject -issuer

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

Den Agenten sehen, wie der Server ihn sieht

Befehl
sudo spire-server agent show -spiffeID spiffe://lab.test/spire/agent/x509pop/spire-lab

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

Was der Server über den Knoten weiß

Das Zertifikat gibt subject=CN=spire-lab und issuer=CN=lab node CA aus. Wegen dieses Common Name endet die ID des Agenten auf /x509pop/spire-lab.

Der Datensatz des Agenten endet mit drei Knotenselektoren. x509pop:subject:cn:spire-lab ist überall gleich. Fingerabdruck der CA und Seriennummer sind in jeder Kopie anders, weil jedes Lab eigene Schlüssel erzeugt hat.

Ein Join-Token gilt einmal

Hat eine Maschine nichts, womit sie sich ausweisen kann, kann jemand vom Betrieb ein Join-Token erzeugen. Ein Agent darf es einmal zur Attestierung nutzen, dann ist es verbraucht.

Der nächste Run erzeugt eines für einen Ersatzknoten. Er gibt Token: und einen Zufallswert aus, jedes Mal einen anderen. Hier nutzt es niemand, also läuft es einfach ab. Anders als x509pop kann ein Token denselben Knoten nach einem Neustart nicht erneut attestieren.

Ein Join-Token zum einmaligen Gebrauch erzeugen

Befehl
sudo spire-server token generate -spiffeID spiffe://lab.test/node/spare

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

Workload-Attestierung: Der Agent fragt den Kernel

Ein Workload ruft den Agenten über einen Unix-Socket auf. Der Kernel nennt dem Agenten die Prozess-ID des Aufrufers, also kann der Aufrufer darüber nicht lügen. Plugins machen aus diesem Prozess dann Selektoren.

Das Plugin unix liefert Benutzer, uid, Gruppe, gid und den Pfad des Programms. Das Plugin k8s fragt das Kubelet, in welchem Pod der Prozess steckt. Ein Eintrag passt, wenn jeder seiner Selektoren unter denen des Workloads ist.

Beispiel: Passt der Eintrag?

Selektoren des EintragsDer Workload hatPasst?
unix:user:basketunix:user:basket, unix:uid:1006, ...Ja
unix:user:basket, unix:uid:0unix:user:basket, unix:uid:1006, ...Nein: uid 0 fehlt
unix:path:/usr/bin/python3.14jeder Benutzer, der dieses Programm ausführtJa, für alle
k8s:ns:demo, k8s:sa:printerein Pod in demo unter printerJa

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

Den Eintrag von basket noch einmal lesen

Befehl
sudo spire-server entry show -spiffeID spiffe://lab.test/basket

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

Ein häufiger Fehler

Warnung

Viele glauben, mehr Selektoren ließen einen Eintrag zu mehr Workloads passen. Es ist umgekehrt: Ein Workload muss jeden Selektor haben, also macht jeder weitere den Eintrag enger. Ein einziger breiter Selektor, etwa der Pfad eines Programms, kann jedem Benutzer eine ID geben.

Ü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.