SBOM
¿Qué es CycloneDX?
CycloneDX es un estándar abierto para listas de materiales (BOM), gestionado por la OWASP Foundation y publicado por Ecma International como ECMA-424. Es conocido sobre todo como formato de SBOM: una lista legible por máquina de los componentes de un software, de cómo dependen unos de otros y de lo que se sabe de sus vulnerabilidades. La versión actual es CycloneDX 1.7, y el mismo formato describe también servicios, hardware, criptografía y modelos de machine learning.
Actualizado el
CycloneDX de un vistazo
| Mantenido por | El proyecto CycloneDX de la OWASP Foundation, con el Comité Técnico 54 (TC54) de Ecma International |
|---|---|
| Estándar | ECMA-424. La 1.ª edición (junio de 2024) es CycloneDX 1.6; la 2.ª edición (diciembre de 2025) es CycloneDX 1.7 |
| Versión actual | CycloneDX 1.7, publicada en octubre de 2025 |
| Codificaciones | JSON, XML y Protocol Buffers |
| Tipo de medio | application/vnd.cyclonedx+json, con un parámetro de versión como version=1.7 |
| Nombres de archivo | bom.json, bom.xml, *.cdx.json, *.cdx.xml |
La primera versión, CycloneDX 1.0, apareció en 2018 como una lista de materiales centrada en la seguridad. Ecma constituyó el TC54 para estándares de cadena de suministro en diciembre de 2023, y CycloneDX 1.6 se convirtió en ECMA-424 en junio de 2024. La visión general de la especificación y la página de ECMA-424 son las referencias principales.
Qué contiene una SBOM CycloneDX
Un documento CycloneDX es un único objeto, que suele llamarse BOM. Solo hay dos campos obligatorios,
bomFormat (siempre "CycloneDX") y specVersion. Todo lo demás es opcional, y por
eso dos archivos CycloneDX válidos pueden diferir tanto en lo que realmente le dicen.
| Elemento | Qué contiene |
|---|---|
metadata |
Cuándo y cómo se creó la BOM: marca de tiempo, herramientas, autores, la fase del ciclo de vida y el componente que describe la BOM |
components |
Cada biblioteca, framework, contenedor, archivo, firmware, dispositivo o modelo, con su versión, identificadores, hashes y licencias |
services |
Servicios externos a los que llama el software, como API, con sus endpoints y flujos de datos |
dependencies |
Qué componente o servicio depende de cuál, para poder reconstruir el árbol, niveles transitivos incluidos |
compositions |
Lo completa que está cada parte de la BOM: completa, incompleta, desconocida o no especificada |
vulnerabilities |
Vulnerabilidades conocidas, sus puntuaciones y, en el caso de VEX, si afectan al producto y cómo |
formulation |
Cómo se generó el producto: los workflows, las tareas y el entorno que hay detrás |
annotations |
Comentarios y notas asociados a otras partes de la BOM, con quién los hizo y cuándo |
declarations, definitions, citations |
Atestaciones de conformidad con estándares, los propios estándares y de dónde proceden los datos de la BOM |
El campo metadata.lifecycles indica cuándo se creó la BOM: design, pre-build, build, post-build,
operations, discovery o decommission. Una SBOM de la fase de build y un escaneo posterior al build del mismo producto
pueden enumerar componentes distintos, así que la fase importa cuando compara dos archivos.
Tipos de BOM de CycloneDX
El mismo modelo de objetos cubre más que el software. El proyecto CycloneDX enumera estas capacidades:
| Tipo | Describe |
|---|---|
| SBOM | Componentes de software y sus dependencias |
| SaaSBOM | Servicios, endpoints y flujos de datos de una aplicación alojada |
| HBOM | Componentes de hardware |
| CBOM | Activos criptográficos: algoritmos, claves, certificados y protocolos |
| ML-BOM | Modelos de machine learning y los conjuntos de datos en los que se basan |
| OBOM y MBOM | Entornos operativos y la fabricación de un producto |
| VEX, VDR y BOV | Si una vulnerabilidad afecta a un producto (VEX), el informe de un fabricante sobre vulnerabilidades conocidas (VDR) y una lista de vulnerabilidades (BOV) |
| CDXA | Atestaciones de que un producto cumple un estándar o un requisito |
Son usos de un mismo formato, no formatos distintos. Un documento VEX, por ejemplo, es una BOM CycloneDX cuyas
entradas vulnerabilities llevan un estado de análisis y apuntan a componentes de una SBOM.
Identificadores: purl, CPE y hashes
El nombre de un componente no basta para cotejarlo con una vulnerabilidad, porque el mismo nombre puede designar
paquetes distintos en ecosistemas distintos. Para eso, los componentes de CycloneDX llevan identificadores: una
package URL (purl) como pkg:npm/[email protected], un CPE, una etiqueta
SWID, identificadores OmniBOR y SWHID, y hashes criptográficos. Purl es el que usan la mayoría de las herramientas para
cotejar paquetes de código abierto, y en diciembre de 2025 se convirtió en un estándar de Ecma propio, ECMA-427. Dentro
del documento, cada elemento puede tener además un bom-ref, un ID local que las secciones de
dependencias, composiciones y vulnerabilidades usan para referirse a él.
Un ejemplo de CycloneDX en JSON
Una SBOM pequeña pero completa de una aplicación, acme-api, que usa un paquete npm, debug,
que a su vez depende de ms. Es válida según el esquema JSON de CycloneDX 1.7.
{
"bomFormat": "CycloneDX",
"specVersion": "1.7",
"serialNumber": "urn:uuid:3e671687-395b-41f5-a30f-a58921a69b79",
"version": 1,
"metadata": {
"timestamp": "2026-11-16T09:30:00Z",
"lifecycles": [{ "phase": "build" }],
"component": {
"type": "application",
"bom-ref": "acme-api",
"name": "acme-api",
"version": "1.4.0"
}
},
"components": [
{
"type": "library",
"bom-ref": "pkg:npm/[email protected]",
"name": "debug",
"version": "4.4.0",
"purl": "pkg:npm/[email protected]",
"licenses": [{ "license": { "id": "MIT" } }]
},
{
"type": "library",
"bom-ref": "pkg:npm/[email protected]",
"name": "ms",
"version": "2.1.3",
"purl": "pkg:npm/[email protected]",
"licenses": [{ "license": { "id": "MIT" } }]
}
],
"dependencies": [
{ "ref": "acme-api", "dependsOn": ["pkg:npm/[email protected]"] },
{ "ref": "pkg:npm/[email protected]", "dependsOn": ["pkg:npm/[email protected]"] },
{ "ref": "pkg:npm/[email protected]", "dependsOn": [] }
],
"compositions": [
{ "aggregate": "complete", "dependencies": ["acme-api"] }
]
}
-
serialNumberyversionidentifican esta BOM. Cada BOM generada de nuevo recibe un número de serie nuevo; cuando se modifica una BOM existente, conserva el número de serie y su versión sube en uno. -
metadata.componentes el producto que describe la SBOM y la raíz del árbol de dependencias. -
dependenciesconviertemsen una dependencia transitiva: la aplicación nunca la pidió, la pidiódebug. UndependsOnvacío indica que el componente no tiene dependencias. Dejar un componente fuera del grafo significa que sus dependencias son desconocidas, no que no tenga ninguna. -
compositionsdeclara que el árbol de dependencias bajoacme-apiestá completo. Una herramienta que no pudo verlo todo debería indicarincompleteounknown, para que quien lo lea sepa que no debe tratar un paquete que falta como ausente.
Para un archivo más grande con hashes, proveedores y una versión SPDX equivalente de la misma aplicación, consulte ejemplos de SBOM.
Cómo generar una SBOM CycloneDX
Hay tres formas de producirla, y describen cosas distintas.
| Método | Cómo funciona | Qué se le escapa |
|---|---|---|
| Escaneo de manifiestos y lockfiles | Lee package-lock.json, requirements.txt, pom.xml y archivos similares |
Todo lo que se descarga fuera del gestor de paquetes, como scripts de instalación, scripts de build e imágenes base |
| Análisis de imágenes, sistemas de archivos o binarios | Inspecciona una imagen de contenedor, un directorio o un binario terminados en busca de metadatos y firmas de paquetes | Los componentes que no dejan metadatos y el código compilado que tiene que adivinar |
| Registro durante el build | Registra lo que el build descarga realmente mientras se ejecuta | Solo lo que el registrador no puede ver, que uno bueno declara como incompleto |
Herramientas gratuitas que generan CycloneDX:
-
cdxgen, un proyecto de OWASP, para muchos lenguajes e imágenes de contenedor:
cdxgen -o bom.json. Genera CycloneDX 1.7 por defecto. -
Los plugins del ecosistema CycloneDX, como
@cyclonedx/cyclonedx-npm, cyclonedx-python, el plugin de Maven de CycloneDX y cyclonedx-gomod, cada uno para un gestor de paquetes:npx @cyclonedx/cyclonedx-npm --output-file bom.json. -
Syft, de Anchore, para imágenes de contenedor y sistemas de archivos:
syft <image> -o cyclonedx-json.
El Tool Center de CycloneDX enumera muchas más. Para ver cómo se comparan estos enfoques en la práctica, consulte generadores de SBOM de código abierto y SBOM de imágenes Docker.
Cómo validar un archivo CycloneDX
La CLI oficial de CycloneDX comprueba un archivo con el esquema de su versión:
cyclonedx validate --input-file bom.json --input-version v1_7 --fail-on-errors
La misma herramienta convierte entre JSON, XML y Protocol Buffers, entre versiones de la especificación y a SPDX JSON,
con cyclonedx convert. La validación del esquema solo demuestra que el archivo está bien formado. No puede
decirle si falta un componente. Para eso, revise el contenido con una lista como la
checklist de calidad de SBOM.
CycloneDX frente a SPDX
SPDX es el otro formato de SBOM más utilizado, alojado por la Linux Foundation y publicado como ISO/IEC 5962:2021. Nació del cumplimiento de licencias, mientras que CycloneDX partió de la seguridad, y por eso CycloneDX incluye vulnerabilidades y VEX en el mismo formato. Ambos describen componentes, identificadores, licencias y relaciones, hay herramientas que convierten entre ellos y el Cyber Resilience Act de la UE no menciona ninguno. Cuál produzca suele depender de lo que lean sus clientes y sus herramientas. La comparación completa está en CycloneDX frente a SPDX.
Cómo produce CRACI SBOM CycloneDX
CRACI es un runner de GitHub Actions que registra cada paquete que descarga cada job mientras se ejecuta, a cualquier profundidad del árbol de dependencias e incluidos los paquetes restaurados desde cachés de CI. Así, cada componente de la SBOM estuvo realmente en el build. Cada paquete lleva su purl y su licencia declarada, y la SBOM de cada job tiene un estado de completitud que indica lo que el job no pudo ver. La SBOM se exporta en CycloneDX o SPDX, con las dependencias transitivas y las vulnerabilidades encontradas en sus componentes, y la API la devuelve como JSON de CycloneDX 1.7. Consulte la generación de SBOM durante el build o las buenas prácticas de SBOM.
Cuándo CRACI no es la respuesta
- BOM de hardware, criptografía o servicios. CRACI registra los paquetes de software que descarga un build. Una HBOM, una CBOM o una SaaSBOM necesitan otras fuentes.
- Builds fuera de GitHub Actions. GitHub Actions es hoy el único CI compatible; otros sistemas de CI están en la hoja de ruta. Mientras tanto, use un generador como cdxgen.
- Software que recibe como binario. Si no lo generó usted, no puede registrar su build. Pida una SBOM al proveedor o use análisis de binarios.
CycloneDX: preguntas frecuentes
¿Para qué se usa CycloneDX?
Sobre todo para SBOM: enumerar los componentes de un software para hacer el seguimiento de vulnerabilidades y licencias y compartir la lista con los clientes. El mismo formato cubre también VEX, servicios, hardware, criptografía y modelos de machine learning.
¿Quién mantiene CycloneDX?
La OWASP Foundation gestiona el proyecto CycloneDX, y el Comité Técnico 54 de Ecma International lo publica como el estándar ECMA-424.
¿Cuál es la última versión de CycloneDX?
CycloneDX 1.7, publicada en octubre de 2025. Es también la 2.ª edición de ECMA-424, publicada en diciembre de 2025. La 1.ª edición corresponde a CycloneDX 1.6.
¿CycloneDX es JSON o XML?
Ambos, y también Protocol Buffers. JSON es el más habitual, con el tipo de medio application/vnd.cyclonedx+json y nombres de archivo como bom.json o name.cdx.json.
¿Es CycloneDX mejor que SPDX?
Ninguno es mejor en general. CycloneDX partió de la seguridad e incluye de forma nativa vulnerabilidades y VEX; SPDX partió del cumplimiento de licencias y es un estándar ISO. Produzca lo que lean sus clientes y sus herramientas; existen conversores en ambos sentidos.
¿Cómo compruebo que un archivo CycloneDX es válido?
Ejecute la CLI oficial de CycloneDX: cyclonedx validate --input-file bom.json --fail-on-errors. Comprueba la estructura con el esquema, no si falta algún componente.
CycloneDX desde el propio build
Registre cada paquete que descargan sus jobs de GitHub Actions, con un estado de completitud, y expórtelo en CycloneDX o SPDX.
Reservar una demo