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
| Mot | Ce que ça veut dire | Exemple |
|---|---|---|
| Identifiant SPIFFE | le nom d’un workload sous forme d’URI | spiffe://lab.test/basket |
| Domaine de confiance | la partie après spiffe://, une seule autorité de signature | lab.test |
| X.509-SVID | un certificat qui porte l’identifiant dans son SAN URI | |
| JWT-SVID | un jeton signé qui porte l’identifiant dans sa revendication sub | |
| Bundle de confiance | les certificats d’AC qui vérifient les SVID d’un domaine de confiance | |
| Entrée d’enregistrement | une 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
| Texte | Valide ? | Pourquoi |
|---|---|---|
| spiffe://lab.test/basket | Oui | Domaine de confiance lab.test, chemin /basket |
| spiffe://lab.test | Oui | Un domaine de confiance sans chemin |
| spiffe://Lab.test/basket | Non | Une majuscule dans le domaine de confiance |
| spiffe://lab.test/basket/ | Non | Une barre oblique à la fin |
| spiffe://lab.test:8443/basket | Non | Un port est interdit |
| https://lab.test/basket | Non | Le 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
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/catalogue -selector unix:user:catalogueAffiché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
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/basket -selector unix:user:basketAffiché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
sudo -u basket spire-agent api fetch x509Affiché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
sudo -u basket mkdir -p /tmp/basketAffiché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
sudo -u basket spire-agent api fetch x509 -write /tmp/basketAffiché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
openssl x509 -in /tmp/basket/svid.0.pem -noout -ext subjectAltNameAffiché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
sudo -u basket spire-agent api fetch jwt -audience catalogueAffiché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.