Lab d’identité des workloads : SPIFFE et SPIRE sur k3s, avec du mTLS entre services, sur une VM Ubuntu privée

Ce lab donne à chaque élève son propre domaine de confiance SPIFFE. SPIFFE est une façon standard de donner à un programme en marche, un workload, une identité au lieu d’un mot de passe partagé, et SPIRE est le logiciel qui distribue ces identités. La VM Ubuntu de l’élève fait tourner un serveur SPIRE, un agent SPIRE et un cluster Kubernetes à un nœud, k3s, et l’élève travaille avec les vraies commandes spire-server, spire-agent et kubectl.

Il enregistre des workloads, obtient des certificats de courte durée appelés SVID, voit un service refuser un appelant sans identité dès la poignée de main TLS, et donne une identité à un pod Kubernetes par son espace de noms et son compte de service. Rien n’est installé sur l’ordinateur de l’élève et rien n’est partagé avec les autres élèves.

Ce que les élèves apprennent

Pourquoi une identité qu’un workload prouve pendant qu’il tourne est plus sûre qu’un secret copié dans un fichier. Ce que sont un identifiant SPIFFE et un domaine de confiance, et comment un X.509-SVID et un JWT-SVID en portent un. Comment l’agent prouve sa machine au serveur (l’attestation du nœud, ici par x509pop) et découvre ce qu’est un processus appelant (l’attestation du workload, par utilisateur Unix et par pod Kubernetes). Comment enregistrer un workload avec les bons sélecteurs, comment deux services utilisent leurs SVID pour du TLS mutuel avec une liste d’autorisation d’identifiants SPIFFE, et comment les SVID se renouvellent et les domaines de confiance se fédèrent. Le module Identité des workloads avec SPIFFE et SPIRE se travaille dedans.

Ce que contient la machine

SPIRE version 1.15.5 et k3s version 1.35, installés par le script du lab depuis les versions publiques des projets sur GitHub. Les fichiers sont fixés par les sommes de contrôle que publient les versions, et tout autre fichier est refusé. Le serveur et l’agent SPIRE tournent sur la VM comme services système, avec le domaine de confiance lab.test, et les pods joignent l’agent par son socket, monté dans chaque pod. Deux petits services écrits en Python pour le lab, billing et catalogue, obtiennent chacun leur propre SVID toutes les 15 secondes et servent du TLS mutuel. Des utilisateurs Unix représentent les workloads.

La VM d’un élève atteint l’archive de paquets d’Ubuntu, PyPI, npm et GitHub, et aucun registre d’images : tous les pods font donc tourner busybox, l’image fournie avec k3s.

Le lancer dans votre navigateur

Les labs VM se donnent comme tâche de lab dans un module, et l’exemple se trouve sur la page du lab. La machine demande 2 processeurs, 2 Go de mémoire et 10 Go de disque.

  1. Ajouter le lab. Dans un module que vous enseignez, ajoutez une tâche et choisissez la carte Lab VM Ubuntu. La page montre une courte description de la machine au lieu d’un fichier compose.
  2. Partir de l’exemple. La page propose des labs tout prêts. Choisissez Identité des workloads (SPIFFE et SPIRE). Utiliser un exemple remplace le texte, et Annuler rend le vôtre.
  3. Publier et démarrer votre propre copie. Publiez, puis Démarrez. Le script d’installation du lab installe SPIRE et k3s depuis leurs versions publiques sur GitHub au premier démarrage de la VM, environ 300 Mo, et écrit la commande spirelab, deux petits services, un Deployment à travailler et le README. Tout est prêt quelques minutes plus tard.
  4. Ouvrir le terminal. Ouvrez son terminal, lancez spirelab status jusqu’à ce que le serveur et l’agent soient en bonne santé, puis lisez README.md dans le dossier personnel : il dit quoi faire en quatre parties et ne donne aucune réponse.

Qui peut le lancer

k3s a besoin de 2 Go, que la machine d’un compte d’établissement possède. La machine d’un compte gratuit a 1 Go : l’installation met alors SPIRE sans k3s et le dit, et tout marche sauf la partie avec des pods. Un visiteur sans compte n’atteint que l’archive d’Ubuntu, donc SPIRE ne peut pas du tout être téléchargé. Donnez le lab à une classe dans un établissement.

Une leçon de base sur ce lab

Workload Identity Basics est une petite leçon donnée dans ce lab, une VM Ubuntu. Elle a une accroche, un objectif « je peux », des mots-clés, une mise en route, une vérification après chaque idée, une erreur fréquente et une vérification finale, et chaque étape a un bouton Exécuter qui tape sa commande dans le terminal de la machine. L’élève demande où en est SPIRE, voit un workload que personne n’a enregistré ne rien recevoir, l’enregistre, obtient son SVID et lit avec OpenSSL l’identifiant SPIFFE qu’il contient.

Elle utilise un utilisateur à elle et laisse à l’élève la tâche du lab : elle ne donne donc aucune réponse.

Comment il est noté

Le lab a une vérification. Elle s’exécute sur une copie de la machine enregistrée après un démarrage neuf, attend SPIRE et k3s, et les interroge, pas les fichiers. L’utilisateur billing doit recevoir exactement l’identifiant spiffe://lab.test/billing et l’utilisateur orders exactement spiffe://lab.test/orders ; l’utilisateur visitor, et un utilisateur que la vérification crée avec un nom que personne n’a vu, ne doivent rien recevoir. orders doit pouvoir appeler billing en TLS mutuel, et visitor doit être refusé à la poignée de main. Le Deployment reports de l’espace de noms payments doit recevoir son identifiant, un pod que la vérification lance sous un nouveau nom avec le même compte de service doit recevoir le même, et un pod sous le compte par défaut de l’espace de noms ne doit rien recevoir. La première ligne de ce que la vérification a affiché dit pourquoi elle n’a pas réussi.

  1. La distribuer. Attribuez le lab comme n’importe quelle tâche, avec une date limite si vous voulez. Chaque élève a sa propre VM, conservée entre les séances, et les enregistrements de SPIRE sont sur son disque.
  2. Lancer la vérification. Sur la ligne d’un élève dans la liste de classe, appuyez sur Lancer la vérification. Elle démarre une copie de sa machine enregistrée, sans rien réenregistrer, attend SPIRE et le cluster, les interroge et montre si elle a réussi, ce qu’elle a affiché et quand. L’élève n’est pas informé du résultat.
  3. La noter. Lisez la première ligne de ce que la vérification a affiché : elle dit ce qui ne va pas, par exemple un utilisateur qui reçoit deux identités, un appelant que billing n’autorise pas, ou une entrée qui atteint aussi un pod sous un autre compte. Renvoyez le travail avec un motif s’il faut aller plus loin.

La définition sur GitHub

Le fichier est toute la définition du lab, le texte même que la plateforme exécute : taille, script d’installation, commande spirelab, configuration de SPIRE, les deux services, le Deployment à travailler, README et vérification. Copiez-le et changez les workloads ou les listes d’autorisation pour faire un lab plus long.

Essayer ce lab, et ce qu’il coûte

Un compte personnel gratuit permet de suivre les leçons de base de ce lab, avec chaque mois assez de crédit gratuit pour suivre la plupart des leçons, sans carte. Pour une classe, un établissement a ses 365 premiers jours gratuits pour 50 élèves au plus, puis paie par élève et par an, tous les labs compris et les enseignants gratuits.

Questions fréquentes

Le lab d’identité des workloads demande-t-il une licence ?
Non. SPIRE et k3s sont des logiciels libres sous licence Apache 2.0, téléchargés depuis les versions des projets au démarrage de la VM de l’élève ; nous n’en distribuons rien.
Pourquoi SPIRE tourne-t-il sur la VM et pas dans le cluster ?
La VM d’un élève n’atteint aucun registre d’images : les images de conteneur de SPIRE ne peuvent donc pas être récupérées. Faire tourner le serveur et l’agent comme services sur le nœud est aussi une vraie façon de les déployer : l’agent atteste toujours les pods en interrogeant le kubelet, exactement comme il le ferait dans un pod à lui.
La fédération fait-elle partie du lab ?
Elle est expliquée dans le module, et le bundle de confiance est montré au format qu’un serveur fédéré va chercher, mais le lab n’a qu’un domaine de confiance : aucune fédération n’est mise en place.
Les élèves peuvent-ils casser quelque chose ?
Seulement leur propre copie. Chaque identité y appartient au domaine de confiance propre du lab, créé au premier démarrage et reconnu par rien à l’extérieur, et la VM atteint l’archive d’Ubuntu, PyPI, npm et GitHub et rien d’autre.
Le lab a-t-il été testé dans une vraie VM d’élève ?
L’installation avec ses vrais téléchargements, les commandes des leçons et la vérification, avec plusieurs façons de se tromper, ont été exécutées dans un vrai Ubuntu 26.04 avec SPIRE et k3s en marche, dans un conteneur à la place de la VM. Une VM d’élève réellement démarrée, qui lance les services depuis systemd, avec le proxy réseau de la plateforme, mérite un essai avant un cours.