138% más CVE notificadas al día en 2026 que el año pasado.Novedad: Fixboxes siempre activas. Dependencias vulnerables, corregidas y verificadas.

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"] }
  ]
}
  • serialNumber y version identifican 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.component es el producto que describe la SBOM y la raíz del árbol de dependencias.
  • dependencies convierte ms en una dependencia transitiva: la aplicación nunca la pidió, la pidió debug. Un dependsOn vací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.
  • compositions declara que el árbol de dependencias bajo acme-api está completo. Una herramienta que no pudo verlo todo debería indicar incomplete o unknown, 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