¿Qué es SLSA? La procedencia de los builds y sus niveles, explicados
Última actualización
SLSA explicado: los niveles del build track, qué registra una atestación de procedencia, cómo verificarla antes de desplegar y de qué no te protege SLSA.
En esta página
SLSA (Supply-chain Levels for Software Artifacts, que se pronuncia «salsa») es un marco de OpenSSF para la integridad de los builds. Define niveles de garantía de que un artefacto se construyó a partir del código fuente que esperas, con el proceso de build que esperas y sin manipulaciones por el camino. La evidencia en la que se apoya es la procedencia: una declaración, firmada por la plataforma de build en los niveles superiores, que indica qué artefacto se construyó, a partir de qué código fuente, con qué builder y con qué parámetros. Los consumidores verifican esa declaración antes de desplegar.
Esta página profundiza en la parte sobre SLSA de ¿Qué es la seguridad de la cadena de suministro de software?.
El problema que resuelve SLSA
La revisión de código protege el código fuente. No sirve de nada si el artefacto que despliegas no se construyó a partir del código revisado. Entre un commit revisado y un servicio en ejecución hay un build: un job de CI, sus scripts, su runner, sus credenciales, sus dependencias y el registro en el que publica. Un atacante que controle cualquiera de ellos puede entregar algo que nadie revisó.
No es hipotético. El compromiso de SolarWinds de 2020 insertó código malicioso durante el build, de modo que el producto entregado difería del código fuente. Los requisitos de build de SLSA buscan que ese tipo de ataque sea difícil de hacer y fácil de detectar.
Los niveles de build de SLSA
La versión 1.0 de SLSA organizó sus requisitos en tracks. El build track tiene cuatro niveles:
| Nivel | Requisito | Contra qué protege |
|---|---|---|
| Build L0 | Ninguno | Nada; es el punto de partida |
| Build L1 | Existe procedencia, que muestra cómo se construyó el artefacto | Errores de publicación, como construir a partir de un commit que no está en el repositorio oficial; hace que los builds se puedan inspeccionar |
| Build L2 | Los builds se ejecutan en una plataforma de build alojada que genera y firma la procedencia | La manipulación del artefacto o de la procedencia después del build |
| Build L3 | La plataforma de build está reforzada: los builds están aislados entre sí, y las claves de firma no están disponibles para los pasos de build que defines | La manipulación durante el build, también por un paso o un job de build comprometido |
Los niveles son acumulativos. El nivel 1 consiste sobre todo en tener procedencia. El nivel 2 hace que falsificarla exija comprometer la plataforma de build. El nivel 3 hace que comprometer un build no baste para falsificar la procedencia de otro.
La especificación sigue evolucionando: la versión 1.2, la actual, añade un Source track con requisitos para el control de código fuente. Consulta la versión actual en el sitio de SLSA para saber qué es definitivo.
Qué contiene la procedencia
La procedencia SLSA suele ser una atestación in-toto: una declaración firmada sobre uno o más artefactos. La declaración nombra los artefactos por su digest, y su predicado describe cómo se construyeron. Un ejemplo recortado:
{
"_type": "https://in-toto.io/Statement/v1",
"subject": [{ "name": "checkout-2.4.0.tar.gz", "digest": { "sha256": "…" } }],
"predicateType": "https://slsa.dev/provenance/v1",
"predicate": {
"buildDefinition": {
"buildType": "https://ci.example.com/workflow/v1",
"externalParameters": { "repository": "https://git.example.com/acme/checkout", "ref": "refs/tags/v2.4.0" },
"resolvedDependencies": [
{ "uri": "git+https://git.example.com/acme/checkout@refs/tags/v2.4.0", "digest": { "gitCommit": "…" } }
]
},
"runDetails": {
"builder": { "id": "https://ci.example.com/hosted-runner" },
"metadata": { "invocationId": "…" }
}
}
}
Las partes que más importan:
- subject: el artefacto, identificado por su hash. Una procedencia sobre otro hash no dice nada de tu archivo.
- buildDefinition: qué se construyó y cómo, incluidos el repositorio de código fuente, la ref y el commit exacto que se resolvió.
- runDetails.builder.id: qué plataforma de build lo produjo. La verificación lo compara con una lista de builders de confianza.
La declaración se firma, normalmente en un sobre DSSE y a menudo con Sigstore, que vincula la firma a la identidad del workflow de build en lugar de a una clave de larga duración.
Verificar la procedencia
La procedencia solo ayuda si alguien la comprueba antes de usar el artefacto. La verificación pregunta:
- ¿La firma es válida, y viene de un builder de confianza?
- ¿El digest del sujeto coincide con el artefacto que vas a desplegar o instalar?
- ¿El código fuente es el esperado: el repositorio correcto, y una etiqueta o una rama desde la que publicas?
- ¿Los parámetros del build son los esperados, sin entradas inesperadas?
Hay herramientas para esto, como el verificador del proyecto SLSA y las herramientas de Sigstore, y algunos ecosistemas lo traen integrado. npm, por ejemplo, puede publicar paquetes con procedencia desde proveedores de CI compatibles, y los registros pueden mostrarla. El lugar más valioso para verificar es el último paso antes del despliegue, como parte del control de despliegue.
Lo que SLSA no cubre
Los niveles de build de SLSA tratan de la integridad del build. No te dicen:
- si el código fuente está libre de vulnerabilidades o de errores;
- si alguien con acceso revisó y fusionó código malicioso;
- si tus dependencias se construyeron con un cuidado similar, salvo que publiquen su propia procedencia;
- qué componentes hay dentro del artefacto. Para eso está un SBOM.
SLSA, los SBOM y el SSDF
| Aspecto | Procedencia SLSA | SBOM | NIST SSDF (SP 800-218) |
|---|---|---|---|
| Responde a | ¿Cómo y dónde se construyó este artefacto? | ¿Qué hay dentro de este artefacto? | ¿Desarrolla esta organización software de forma segura? |
| Forma | Atestación firmada por artefacto | Documento de inventario por artefacto | Un conjunto de prácticas; las organizaciones certifican que las cumplen |
| Lo produce | La plataforma de build | Un generador de SBOM, idealmente en el build | Los procesos de la organización |
| Lo comprueban | Los verificadores antes de desplegar o instalar | Las herramientas de vulnerabilidades y de licencias | Clientes, auditores y departamentos de compras |
Se complementan. Una publicación madura puede llevar los tres: un SBOM, una procedencia firmada y una organización capaz de certificar que cumple las prácticas del SSDF.
Los pipelines de build y los agentes de IA
Las definiciones de build son código. Un archivo de workflow de CI que edita un agente de IA puede cambiar cómo se construyen los artefactos, qué secretos puede usar el build y dónde publica. Trata como sensibles los cambios en las definiciones de build y de pipelines: exige una revisión específica para ellos, y mantén a los agentes que escriben código lejos de las credenciales de build. La procedencia ayuda a posteriori, porque registra qué workflow construyó un artefacto, así que un workflow modificado aparece al verificar la procedencia.
Primeros pasos
- Haz inventario de tus caminos de publicación. Enumera todas las formas en que un artefacto llega a producción o a un registro, incluidas las publicaciones manuales desde un portátil. La procedencia solo ayuda en los caminos que la producen.
- Construye las versiones solo en la CI. Un artefacto construido en la máquina de un desarrollador no tiene una procedencia fiable. Pasar todos los builds de publicación a un servicio de CI alojado es el paso más importante.
- Activa la generación de procedencia. Muchos servicios de CI y registros de paquetes pueden generar y publicar la procedencia por ti. Eso te da el nivel 1, y a menudo el nivel 2.
- Verifica antes de desplegar. Añade al pipeline de despliegue un paso de verificación que compruebe la firma, el builder, el repositorio de código fuente y el digest del artefacto, y que falle en cerrado cuando alguno no coincida.
- Refuerza el build. Aísla los builds, mantén el material de firma lejos de los pasos de build y limita quién puede cambiar las definiciones de build. Ese es el camino hacia el nivel 3.
Qué relación tiene AI CodeOps con SLSA
AI CodeOps no construye tus artefactos ni genera procedencia SLSA; el build lo hace tu propia CI, y ahí es donde se produce la procedencia. AI CodeOps cubre los pasos anteriores al build: cómo se escribió, se revisó y se aprobó un cambio.
- Protege las definiciones de build con políticas. Una regla
diff.applycon la decisiónasken rutas como.github/**o.forgejo/**exige una revisión aprobada antes de que un cambio en esos archivos se convierta en un pull request. Una regladenylo bloquea. - Mantén las credenciales fuera del alcance de los agentes. Los secretos del espacio de trabajo llegan a los jobs de build como variables de entorno y se eliminan de los logs del build; los agentes de IA nunca los reciben.
- Registra cómo se hizo cada cambio. Cada cambio se puede descargar como un paquete de evidencias firmado: la tarea, los modelos, los pasos, los hallazgos, las pruebas, las aprobaciones y la entrega, firmados con Ed25519 y verificables sin conexión. Cumple un papel similar para la autoría de un cambio al que cumple la procedencia para el build.
Consulta Aprobaciones y políticas para las reglas de rutas y Revisión de seguridad y seguimiento de SBOM para la visión general.
Preguntas frecuentes
¿Cómo se pronuncia SLSA?
Como la palabra salsa. Las letras corresponden a Supply-chain Levels for Software Artifacts.
¿Qué diferencia hay entre SLSA y un SBOM?
Un SBOM enumera lo que hay dentro de un artefacto. La procedencia SLSA registra cómo se construyó el artefacto, a partir de qué código fuente y con qué plataforma de build. Responden a preguntas distintas y a menudo se usan juntos.
¿El nivel 3 de SLSA significa que mi software es seguro?
No. Significa que la plataforma de build hace difícil manipular el build o falsificar su procedencia. No dice nada de las vulnerabilidades, del código malicioso que se revisó y se fusionó, ni de la seguridad de tus dependencias.
¿Necesito llegar al nivel 3 de SLSA?
Empieza por el nivel 1, procedencia para cada versión, y pasa a una plataforma de build alojada que firme la procedencia para el nivel 2. Muchos servicios de CI alojados hacen viable el nivel 2 o el 3 sin construir tu propia plataforma.