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

Dieses Lab gibt jeder Person eine eigene SPIFFE-Vertrauensdomäne. SPIFFE ist ein Standard, um einem laufenden Programm, einem Workload, eine Identität statt eines gemeinsamen Passworts zu geben. SPIRE ist die Software, die diese Identitäten ausgibt. Auf der Ubuntu-VM laufen ein SPIRE-Server, ein SPIRE-Agent und ein Kubernetes-Cluster mit einem Knoten, k3s, und gearbeitet wird mit den echten Befehlen spire-server, spire-agent und kubectl.

Die Lernenden registrieren Workloads, holen kurzlebige Zertifikate, die SVIDs heißen, und sehen, wie ein Dienst einen Aufrufer ohne Identität schon beim TLS-Handshake abweist. Sie geben einem Kubernetes-Pod eine Identität über seinen Namespace und sein Dienstkonto. Auf dem eigenen Computer wird nichts installiert, und nichts wird mit anderen geteilt.

Was die Lernenden lernen

Warum eine Identität, die ein Workload zur Laufzeit nachweist, sicherer ist als ein Geheimnis, das in eine Datei kopiert wurde. Was eine SPIFFE-ID und eine Vertrauensdomäne sind und wie ein X.509-SVID und ein JWT-SVID sie tragen. Wie der Agent dem Server seine Maschine nachweist (Knotenattestierung, hier mit x509pop) und herausfindet, was ein anfragender Prozess ist (Workload-Attestierung, nach Unix-Benutzer und Kubernetes-Pod). Wie man einen Workload mit den richtigen Selektoren registriert, wie zwei Dienste ihre SVIDs für Mutual TLS mit einer Erlaubnisliste von SPIFFE-IDs nutzen und wie SVIDs rotieren und Vertrauensdomänen föderieren. Das Hochschulmodul Workload-Identität mit SPIFFE und SPIRE wird darin bearbeitet.

Was in der Maschine steckt

SPIRE in Version 1.15.5 und k3s in Version 1.35, vom Setup des Labs aus den öffentlichen Releases der Projekte auf GitHub installiert und über die dort veröffentlichten Prüfsummen festgelegt; jede andere Datei wird abgelehnt. SPIRE-Server und -Agent laufen auf der VM als Systemdienste, mit der Vertrauensdomäne lab.test, und Pods erreichen den Agenten über seinen Socket, der in jeden Pod eingehängt ist. Zwei kleine Dienste, für das Lab in Python geschrieben, billing und catalogue, holen alle 15 Sekunden ihr eigenes SVID und sprechen Mutual TLS. Unix-Benutzer stehen für Workloads.

Die VM erreicht das Paketarchiv von Ubuntu, PyPI, npm und GitHub, aber keine Image-Registry. Darum läuft jeder Pod mit busybox, dem Image, das k3s mitbringt.

Im Browser ausführen

VM-Labs werden in einem Modul als Lab-Aufgabe eingerichtet, und das Beispiel steht auf der Seite des Labs. Die Maschine verlangt 2 CPUs, 2 GB Arbeitsspeicher und 10 GB Festplatte.

  1. Lab hinzufügen. Fügen Sie in einem Modul, das Sie unterrichten, eine Aufgabe hinzu und wählen Sie die Karte für das Ubuntu-VM-Lab. Die Seite zeigt statt einer Compose-Datei eine kurze Beschreibung der Maschine.
  2. Mit dem Beispiel beginnen. Die Seite bietet fertige Labs als Ausgangspunkt an. Wählen Sie Workload-Identität (SPIFFE und SPIRE). Ein Beispiel ersetzt den Text, und Rückgängig bringt Ihren eigenen zurück.
  3. Veröffentlichen und die eigene Kopie starten. Veröffentlichen Sie, dann Starten. Beim ersten Start der VM installiert das Setup-Skript des Labs SPIRE und k3s aus deren öffentlichen GitHub-Releases, etwa 300 MB. Es schreibt außerdem den Befehl spirelab, zwei kleine Dienste, ein Deployment zum Bearbeiten und die README. Nach einigen Minuten ist alles bereit.
  4. Das Terminal öffnen. Öffnen Sie das Terminal, führen Sie spirelab status aus, bis Server und Agent gesund sind, und lesen Sie README.md im Home-Ordner. Sie sagt in vier Teilen, was zu tun ist, und gibt keine der Antworten.

Wer es ausführen kann

k3s braucht 2 GB, und die Maschine eines Hochschulkontos hat sie. Die Maschine eines freien Kontos hat 1 GB, also installiert das Setup SPIRE ohne k3s und sagt das: Alles außer dem Teil mit Pods funktioniert. Ein Besucher ohne Konto erreicht nur das Archiv von Ubuntu, kann SPIRE also gar nicht herunterladen. Richten Sie das Lab für eine Klasse in einer Hochschule ein.

Eine Basislektion zu diesem Lab

Workload Identity Basics ist eine kleine Lektion, die in diesem Lab, einer Ubuntu-VM, bearbeitet wird. Sie hat einen Einstieg, ein Ziel in der Form „Ich kann“, Schlüsselwörter, eine Startfrage, eine Kontrolle nach jeder Idee, einen häufigen Fehler und eine Abschlusskontrolle. Jeder Schritt hat eine Schaltfläche Ausführen, die seinen Befehl in das Terminal der Maschine tippt. Die Lernenden fragen, wie es um SPIRE steht, sehen, dass ein nicht registrierter Workload nichts bekommt, registrieren ihn, holen sein SVID und lesen darin die SPIFFE-ID mit OpenSSL.

Sie nutzt einen eigenen Benutzer und überlässt die eigentliche Aufgabe des Labs den Lernenden, verrät also keine Antworten.

Wie bewertet wird

Das Lab hat eine Prüfung. Sie läuft nach einem frischen Start auf einer Kopie der gespeicherten Maschine, wartet auf SPIRE und k3s und fragt diese, nicht die Dateien. Der Benutzer billing muss genau die ID spiffe://lab.test/billing bekommen und der Benutzer orders genau spiffe://lab.test/orders. Der Benutzer visitor und ein Benutzer mit einem Namen, den die Prüfung neu anlegt, dürfen nichts bekommen. orders muss billing über Mutual TLS aufrufen dürfen, und visitor muss am Handshake abgewiesen werden. Das Deployment reports im Namespace payments muss seine ID bekommen, ein Pod, den die Prüfung mit neuem Namen unter demselben Dienstkonto startet, dieselbe ID. Ein Pod unter dem Standardkonto des Namespace darf nichts bekommen. Die erste Zeile der Ausgabe der Prüfung sagt, warum sie nicht bestanden wurde.

  1. Verteilen. Weisen Sie das Lab wie jede Aufgabe zu, auf Wunsch mit Abgabefrist. Jede Person bekommt eine eigene VM, die zwischen den Sitzungen erhalten bleibt, und die Registrierungen von SPIRE liegen auf ihrer Platte.
  2. Die Prüfung ausführen. Drücken Sie in der Zeile einer Person in der Klassenliste auf Prüfung ausführen. Sie startet eine Kopie der gespeicherten Maschine, die nicht zurückgespeichert wird, wartet auf SPIRE und den Cluster, fragt beide und zeigt, ob bestanden wurde, was ausgegeben wurde und wann. Die Person erfährt das Ergebnis nicht.
  3. Bewerten. Lesen Sie die erste Zeile dessen, was die Prüfung ausgegeben hat: Sie sagt, was nicht stimmt. Etwa ein Benutzer mit zwei Identitäten, ein Aufrufer, den billing nicht erlaubt, oder ein Eintrag, der auch einen Pod unter einem anderen Konto erreicht. Geben Sie die Arbeit mit einer Begründung zurück, wenn mehr nötig ist.

Die Definition auf GitHub

Die Datei ist die ganze Lab-Definition, derselbe Text, den die Plattform ausführt: Größe, Setup-Skript, der Befehl spirelab, die Konfiguration von SPIRE, die beiden Dienste, das Deployment zum Bearbeiten, die README und die Prüfung. Kopieren Sie sie und ändern Sie die Workloads oder die Erlaubnislisten, um ein längeres Lab zu machen.

Dieses Lab ausprobieren, und was es kostet

Mit einem kostenlosen persönlichen Konto können Sie die Grundlagenlektionen in diesem Lab durcharbeiten, mit genug kostenlosem Guthaben pro Monat für die meisten Lektionen und ohne Karte. Für eine Klasse sind die ersten 365 Tage für eine Schule kostenlos, für bis zu 50 Lernende; danach zahlt sie je lernender Person und Jahr, alle Labs inklusive und Lehrkräfte kostenlos.

Häufige Fragen

Braucht das Lab zur Workload-Identität eine Lizenz?
Nein. SPIRE und k3s sind Open Source unter der Lizenz Apache 2.0. Sie werden beim Start der VM aus den eigenen Releases der Projekte heruntergeladen; wir verteilen nichts davon.
Warum läuft SPIRE auf der VM und nicht im Cluster?
Die VM erreicht keine Image-Registry, also lassen sich die Container-Images von SPIRE nicht holen. Server und Agent als Dienste auf dem Knoten zu betreiben, ist außerdem ein echter Weg, sie einzusetzen. Der Agent attestiert Pods weiterhin, indem er das Kubelet fragt, genau wie in einem eigenen Pod.
Gehört die Föderation zum Lab?
Sie wird im Modul erklärt, und das Trust-Bundle wird in dem Format gezeigt, das ein föderierter Server abholt. Das Lab hat aber nur eine Vertrauensdomäne, also wird keine Föderation eingerichtet.
Können die Lernenden etwas kaputt machen?
Nur ihre eigene Kopie. Jede Identität darin gehört zur eigenen Vertrauensdomäne des Labs, die beim ersten Start entsteht und der nichts außerhalb traut. Die VM erreicht das Archiv von Ubuntu, PyPI, npm und GitHub und sonst nichts.
Wurde das Lab in einer echten Schüler-VM getestet?
Das Setup mit seinen echten Downloads, die Befehle der Lektionen und die Prüfung, mit mehreren Arten, sie falsch zu lösen, liefen in einem echten Ubuntu 26.04 mit laufendem SPIRE und k3s, in einem Container, der die VM vertritt. Eine gestartete Schüler-VM, die die Dienste über systemd startet, mit dem eigenen Netz-Proxy der Plattform, sollten Sie vor einer Stunde einmal ausprobieren.