Lista de materiales de software (SBOM)
Última actualización
Un SBOM enumera cada componente, versión y licencia dentro de un software. Qué incluye, por qué lo piden los compradores y cómo los registra AI CodeOps.
Una lista de materiales de software (SBOM) es un inventario legible por máquina de los componentes de un software: cada biblioteca y cada paquete, su versión, su proveedor, su licencia y su relación con los demás. Responde a la pregunta «¿qué hemos entregado exactamente?».
Qué es
Un SBOM se suele generar durante el build, a partir de lockfiles, manifiestos o el artefacto construido, y se escribe en un formato estándar. Los dos más habituales son CycloneDX y SPDX. Un SBOM útil identifica cada componente con precisión, a menudo con una URL de paquete (purl) como pkg:npm/[email protected], para que las herramientas puedan compararlo con los avisos de vulnerabilidades y las listas de licencias.
Un SBOM describe una versión del software. Si entregas un build nuevo con dependencias distintas, necesitas un SBOM nuevo.
Por qué importa
Cuando se anuncia una vulnerabilidad nueva, la primera pregunta es «¿nos afecta?». Con un SBOM por versión publicada, eso es una consulta, no una investigación. Los SBOM también hacen posible revisar licencias a gran escala, y los clientes los piden cada vez más. En Estados Unidos, la Executive Order 14028 (2021) llevó los SBOM a las compras de software federales, y la NTIA publicó ese mismo año sus elementos mínimos.
En AI CodeOps
AI CodeOps registra SBOM por proyecto; no los genera ni guarda el propio archivo. Creas el SBOM con tu herramienta habitual, guardas el archivo donde guardas los artefactos de build y registras una instantánea. En la beta abierta eso es una petición a /api/sbom con la sesión iniciada en la consola (todavía no hay formulario de subida ni ruta con clave de API):
{
"projectID": "checkout",
"commitSHA": "4f2a9c1e7b3d",
"format": "cyclonedx",
"formatVersion": "1.5",
"downloadURL": "https://artifacts.example.com/checkout/4f2a9c1e7b3d/bom.json",
"sha256": "9d1c5e0b7a2f4c6e8d0b1a3c5e7f9a2b4d6c8e0f1a3b5c7d9e2f4a6b8c0d1e3f",
"componentCount": 412,
"vulnerableCount": 3,
"licenseSummary": { "MIT": 301, "Apache-2.0": 74, "ISC": 29, "BSD-3-Clause": 8 },
"generationSource": "ci"
}
El SHA-256 permite a cualquiera comprobar que el registro corresponde al archivo. Los recuentos de componentes y de componentes vulnerables y el resumen de licencias son las cifras que envías; AI CodeOps no analiza el archivo para comprobarlas.
El registro más reciente es el SBOM actual del proyecto. Lo ves en la página del proyecto (Recent SBOMs, Vulnerable components (latest SBOM)) y en el panel Software Bill of Materials de Secure → Security, que agrega los resúmenes de licencias de todos los proyectos. La comprobación de publicación a la que llama tu CI puede entonces aplicar una política de licencias sobre él.
Para mirar dentro de un archivo JSON de CycloneDX sin iniciar sesión, abre el visor de SBOM.
Términos relacionados
- CycloneDX: uno de los dos formatos de SBOM que registra AI CodeOps.
- Análisis de composición de software (SCA): las herramientas que suelen producir los SBOM y los recuentos de vulnerabilidades.
- Política de licencias: reglas que se comprueban contra el resumen de licencias del SBOM.
Preguntas frecuentes
¿AI CodeOps genera SBOM?
No. Generas el SBOM con la herramienta que ya usas en tu build y lo registras en el proyecto. AI CodeOps lo sigue y lo usa para las comprobaciones de licencias.
¿Qué formatos de SBOM acepta AI CodeOps?
CycloneDX y SPDX. Cada registro guarda el formato y su versión, para que después puedas distinguirlos.
¿Puedo mirar dentro de un archivo SBOM sin iniciar sesión?
Sí, en el caso de CycloneDX JSON. El visor de SBOM gratuito lee el archivo en tu navegador y nunca lo sube.