¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

SPIFFE ID, dominios de confianza y SVID

Después de esta lección: Puedo leer un SPIFFE ID y encontrarlo dentro de un SVID X.509 o JWT.

Lección de 70 min7 comandosLaboratorio de identidad de cargas de trabajo: SPIFFE y SPIRE en k3s, con mTLS entre servicios, en una VM Ubuntu privada

Un nombre que cualquier servicio puede comprobar

Un SPIFFE ID es el nombre de una carga de trabajo, escrito como una URI, por ejemplo spiffe://lab.test/basket. Todos los servicios de una empresa pueden leerlo y comprobarlo de la misma manera.

Sin un formato común, cada equipo se inventa el suyo: aquí un nombre de máquina, allí un nombre de cuenta. Así nadie puede escribir una sola regla sobre quién puede llamar a qué.

Al final de esta lección

Nota

Puedo leer un SPIFFE ID y encontrarlo dentro de un SVID X.509 o JWT.

Palabras clave

PalabraQué significaEjemplo
SPIFFE IDel nombre de una carga de trabajo como URIspiffe://lab.test/basket
Dominio de confianzala parte que sigue a spiffe://, una sola autoridad que firmalab.test
X.509-SVIDun certificado que lleva el ID en su URI SAN
JWT-SVIDun token firmado que lleva el ID en su claim sub
Paquete de confianzalos certificados de CA que comprueban los SVID de un dominio
Entrada de registrouna regla que da un ID a las cargas que coinciden

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Un SPIFFE ID tiene dos partes

Después de spiffe:// viene el dominio de confianza, por ejemplo lab.test. Todo lo que hay en un dominio de confianza lo firma una sola autoridad. Luego viene la ruta, por ejemplo /ns/demo/sa/printer, que nombra la carga dentro del dominio.

Las reglas son estrictas. En el dominio solo van minúsculas, cifras, puntos, guiones y guiones bajos. No se admite puerto, usuario ni consulta. Tampoco un segmento vacío, . o .., ni una barra al final.

Ejemplo resuelto: válido o no

Texto¿Válido?Por qué
spiffe://lab.test/basketSíDominio lab.test, ruta /basket
spiffe://lab.testSíUn dominio de confianza sin ruta
spiffe://Lab.test/basketNoUna mayúscula en el dominio
spiffe://lab.test/basket/NoUna barra al final
spiffe://lab.test:8443/basketNoNo se admite un puerto
https://lab.test/basketNoEl esquema tiene que ser spiffe

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Una entrada de registro reparte un ID

Un ID se da mediante una entrada de registro. Nombra el SPIFFE ID, el agente que puede entregarlo (el ID padre) y los selectores que debe cumplir una carga. La lección 4 estudia las entradas con calma.

Las dos ejecuciones siguientes registran las cargas de las lecciones. El usuario catalogue recibe spiffe://lab.test/catalogue, y basket recibe spiffe://lab.test/basket. Cada una imprime la entrada nueva; su Entry ID cambia en cada copia.

Registra la carga catalogue

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Registra la carga basket

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Un X.509-SVID es un certificado corto

Un X.509-SVID es un certificado normal con una diferencia: su nombre es un URI SAN que guarda el SPIFFE ID. Las bibliotecas de TLS ya saben usarlo.

Espera unos segundos después de registrar y pide el SVID como basket. La ejecución imprime SPIFFE ID: spiffe://lab.test/basket y luego SVID Valid After y SVID Valid Until, separados por una hora y diez segundos. SPIRE empieza el certificado diez segundos antes por si los relojes no coinciden.

Pide el X.509-SVID como basket

Comando
sudo -u basket spire-agent api fetch x509

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Crea una carpeta de basket

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Escribe el SVID en archivos

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Lee el SPIFFE ID que lleva dentro

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Tres archivos, y uno sigue siendo privado

La ejecución con -write crea svid.0.pem (el certificado), svid.0.key (su clave privada, que solo puede leer basket) y bundle.0.pem (el paquete de confianza). OpenSSL imprime URI:spiffe://lab.test/basket bajo X509v3 Subject Alternative Name.

La clave privada se creó en esta máquina y nunca ha salido de ella.

Un JWT-SVID es un token firmado

Algunas llamadas no pueden usar TLS mutuo, por ejemplo si pasan por un proxy que termina el TLS. Un JWT-SVID es entonces un token firmado. Su claim sub es el SPIFFE ID y su claim aud nombra quién puede aceptarlo.

La ejecución imprime token(spiffe://lab.test/basket):, un token largo en tres partes unidas por puntos, y después las claves JWT del dominio. Aquí el token dura cinco minutos.

Pide un JWT-SVID para catalogue

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Un error frecuente

Advertencia

Mucha gente cree que un JWT-SVID es más seguro porque es más moderno. Quien copie un JWT puede reutilizarlo hasta que caduque. Usa X.509-SVID con TLS mutuo siempre que puedas, y JWT cortos con una audiencia estrecha cuando no puedas.

Sobre este laboratorio y su código: Laboratorio de identidad de cargas de trabajo: SPIFFE y SPIRE en k3s, con mTLS entre servicios, en una VM Ubuntu privada

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.