Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

Identifiants SPIFFE, domaines de confiance et SVID

Après cette leçon: Je peux lire un identifiant SPIFFE et le retrouver dans un SVID X.509 ou JWT.

Leçon de 70 min7 commandesLab d’identité des workloads : SPIFFE et SPIRE sur k3s, avec du mTLS entre services, sur une VM Ubuntu privée

Un nom que chaque service peut vérifier

Un identifiant SPIFFE est le nom d’un workload, écrit comme une URI, par exemple spiffe://lab.test/basket. Chaque service d’une entreprise peut le lire et le vérifier de la même façon.

Sans format commun, chaque équipe invente le sien : un nom d’hôte ici, un nom de compte là. Personne ne peut alors écrire une seule règle sur qui peut appeler quoi.

À la fin de cette leçon

Remarque

Je peux lire un identifiant SPIFFE et le retrouver dans un SVID X.509 ou JWT.

Mots clés

MotCe que ça veut direExemple
Identifiant SPIFFEle nom d’un workload sous forme d’URIspiffe://lab.test/basket
Domaine de confiancela partie après spiffe://, une seule autorité de signaturelab.test
X.509-SVIDun certificat qui porte l’identifiant dans son SAN URI
JWT-SVIDun jeton signé qui porte l’identifiant dans sa revendication sub
Bundle de confianceles certificats d’AC qui vérifient les SVID d’un domaine de confiance
Entrée d’enregistrementune règle qui donne un identifiant aux workloads qui correspondent

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Un identifiant SPIFFE a deux parties

Après spiffe:// vient le domaine de confiance, par exemple lab.test. Tout ce qui est dans un domaine de confiance est signé par une seule autorité. Vient ensuite le chemin, par exemple /ns/demo/sa/printer, qui nomme le workload à l’intérieur.

Les règles sont strictes. Le domaine de confiance n’admet que minuscules, chiffres, points, tirets et soulignés. Pas de port, pas d’utilisateur, pas de requête, aucun segment vide, ni . ni .., et pas de barre oblique finale.

Exemple guidé : valide ou non

TexteValide ?Pourquoi
spiffe://lab.test/basketOuiDomaine de confiance lab.test, chemin /basket
spiffe://lab.testOuiUn domaine de confiance sans chemin
spiffe://Lab.test/basketNonUne majuscule dans le domaine de confiance
spiffe://lab.test/basket/NonUne barre oblique à la fin
spiffe://lab.test:8443/basketNonUn port est interdit
https://lab.test/basketNonLe schéma doit être spiffe

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Une entrée d’enregistrement distribue un identifiant

Un identifiant est donné par une entrée d’enregistrement. Elle nomme l’identifiant SPIFFE, l’agent autorisé à le distribuer (l’identifiant parent) et les sélecteurs auxquels un workload doit correspondre. La leçon 4 regarde les entrées de près.

Les deux Runs suivants enregistrent les workloads des leçons. L’utilisateur catalogue reçoit spiffe://lab.test/catalogue, et basket reçoit spiffe://lab.test/basket. Chacun affiche la nouvelle entrée ; son Entry ID change dans chaque copie.

Enregistrer le workload catalogue

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Enregistrer le workload basket

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Un X.509-SVID est un certificat court

Un X.509-SVID est un certificat ordinaire, à une différence près : son nom est un SAN URI qui contient l’identifiant SPIFFE. Les bibliothèques TLS savent déjà s’en servir.

Attendez quelques secondes après l’enregistrement, puis demandez-le en tant que basket. Le Run affiche SPIFFE ID: spiffe://lab.test/basket, puis SVID Valid After et SVID Valid Until, à environ une heure et dix secondes d’écart. SPIRE fait commencer le certificat dix secondes plus tôt, pour les horloges décalées.

Obtenir le X.509-SVID en tant que basket

Commande
sudo -u basket spire-agent api fetch x509

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Créer un dossier à basket

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Écrire le SVID dans des fichiers

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Lire l’identifiant SPIFFE qu’il contient

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Trois fichiers, dont un reste privé

Le Run d’écriture crée svid.0.pem (le certificat), svid.0.key (sa clé privée, lisible par basket seul) et bundle.0.pem (le bundle de confiance). OpenSSL affiche URI:spiffe://lab.test/basket sous X509v3 Subject Alternative Name.

La clé privée a été créée sur cette machine et ne l’a jamais quittée.

Un JWT-SVID est un jeton signé

Certains appels ne peuvent pas utiliser le TLS mutuel, par exemple à travers un proxy qui termine le TLS. Un JWT-SVID est alors un jeton signé. Sa revendication sub est l’identifiant SPIFFE et sa revendication aud nomme qui peut l’accepter.

Le Run affiche token(spiffe://lab.test/basket):, un long jeton en trois parties séparées par des points, puis les clés JWT du domaine de confiance. Le jeton dure cinq minutes ici.

Obtenir un JWT-SVID pour catalogue

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Une erreur fréquente

Attention

Beaucoup pensent qu’un JWT-SVID est plus sûr parce qu’il est plus récent. Un JWT peut être rejoué par quiconque le copie, jusqu’à son expiration. Utilisez des X.509-SVID avec le TLS mutuel quand c’est possible, et sinon des JWT courts à l’audience étroite.

À propos de ce labo et de sa source: Lab d’identité des workloads : SPIFFE et SPIRE sur k3s, avec du mTLS entre services, sur une VM Ubuntu privée

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.