138% de CVE signalées en plus par jour en 2026 par rapport à l'an dernier.Nouveau : les Fixboxes toujours actives. Dépendances vulnérables, corrigées et vérifiées.

SBOM

Qu'est-ce que CycloneDX ?

CycloneDX est un standard ouvert de nomenclatures (bills of materials), porté par l'OWASP Foundation et publié par Ecma International sous la référence ECMA-424. Il est surtout connu comme format de SBOM : une liste lisible par machine des composants d'un logiciel, de leurs dépendances mutuelles et de ce que l'on sait de leurs vulnérabilités. La version actuelle est CycloneDX 1.7, et le même format décrit aussi des services, du matériel, de la cryptographie et des modèles de machine learning.

Mis à jour le

CycloneDX en un coup d'œil

Maintenu par Le projet CycloneDX de l'OWASP Foundation, avec le Technical Committee 54 (TC54) d'Ecma International
Standard ECMA-424. La 1re édition (juin 2024) correspond à CycloneDX 1.6 ; la 2e édition (décembre 2025) à CycloneDX 1.7
Version actuelle CycloneDX 1.7, publiée en octobre 2025
Encodages JSON, XML et Protocol Buffers
Type de média application/vnd.cyclonedx+json, avec un paramètre de version comme version=1.7
Noms de fichiers bom.json, bom.xml, *.cdx.json, *.cdx.xml

La première version, CycloneDX 1.0, est sortie en 2018 comme nomenclature orientée sécurité. Ecma a créé le TC54 pour les standards de la chaîne d'approvisionnement en décembre 2023, et CycloneDX 1.6 est devenu ECMA-424 en juin 2024. La présentation de la spécification et la page ECMA-424 sont les références principales.

Ce que contient une SBOM CycloneDX

Un document CycloneDX est un objet unique, généralement appelé BOM. Seuls deux champs sont obligatoires, bomFormat (toujours "CycloneDX") et specVersion. Tout le reste est facultatif, ce qui explique pourquoi deux fichiers CycloneDX valides peuvent tant différer dans ce qu'ils vous apprennent réellement.

Élément Ce qu'il contient
metadata Quand et comment la BOM a été produite : horodatage, outils, auteurs, phase du cycle de vie et composant décrit par la BOM
components Chaque bibliothèque, framework, conteneur, fichier, firmware, appareil ou modèle, avec sa version, ses identifiants, ses empreintes et ses licences
services Les services externes appelés par le logiciel, comme des API, avec leurs endpoints et leurs flux de données
dependencies Quel composant ou service dépend de quel autre, pour pouvoir reconstruire l'arbre, niveaux transitifs compris
compositions Le degré de complétude de chaque partie de la BOM : complete, incomplete, unknown ou non spécifié
vulnerabilities Les vulnérabilités connues, leurs scores et, pour VEX, si et comment elles affectent le produit
formulation Comment le produit a été construit : les workflows, les tâches et l'environnement qui l'ont produit
annotations Des commentaires et des notes rattachés à d'autres parties de la BOM, avec leur auteur et leur date
declarations, definitions, citations Les attestations de conformité à des standards, les standards eux-mêmes, et l'origine des données de la BOM

Le champ metadata.lifecycles indique à quel moment la BOM a été produite : design, pre-build, build, post-build, operations, discovery ou decommission. Une SBOM de la phase de build et un scan post-build du même produit peuvent lister des composants différents : la phase compte donc quand vous comparez deux fichiers.

Les types de BOM CycloneDX

Le même modèle objet couvre bien plus que le logiciel. Le projet CycloneDX liste ces capacités :

Type Décrit
SBOM Les composants logiciels et leurs dépendances
SaaSBOM Les services, endpoints et flux de données d'une application hébergée
HBOM Les composants matériels
CBOM Les actifs cryptographiques : algorithmes, clés, certificats et protocoles
ML-BOM Les modèles de machine learning et les jeux de données sur lesquels ils reposent
OBOM et MBOM Les environnements d'exploitation, et la fabrication d'un produit
VEX, VDR et BOV Si une vulnérabilité affecte un produit (VEX), le rapport d'un fournisseur sur les vulnérabilités connues (VDR) et une nomenclature de vulnérabilités
CDXA Des attestations qu'un produit satisfait à un standard ou à une exigence

Il s'agit d'usages d'un seul format, pas de formats distincts. Un document VEX, par exemple, est une BOM CycloneDX dont les entrées vulnerabilities portent un état d'analyse et pointent vers des composants d'une SBOM.

Identifiants : purl, CPE et empreintes

Le nom d'un composant ne suffit pas pour le rapprocher d'une vulnérabilité, car un même nom peut désigner des paquets différents dans des écosystèmes différents. Les composants CycloneDX portent des identifiants pour cela : une package URL (purl) comme pkg:npm/[email protected], un CPE, un tag SWID, des identifiants OmniBOR et SWHID, et des empreintes cryptographiques. La purl est celle sur laquelle la plupart des outils s'appuient pour les paquets open source, et elle est devenue un standard Ecma à part entière, ECMA-427, en décembre 2025. Dans le document, chaque élément peut aussi avoir un bom-ref, un identifiant local que les sections dependencies, compositions et vulnerabilities utilisent pour pointer vers lui.

Un exemple CycloneDX en JSON

Une SBOM réduite mais complète pour une application, acme-api, qui utilise un paquet npm, debug, lequel dépend à son tour de ms. Elle est valide selon le schéma 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 et version identifient cette BOM. Chaque BOM nouvellement générée reçoit un nouveau numéro de série ; quand une BOM existante est modifiée, elle garde son numéro de série et sa version augmente de un.
  • metadata.component est le produit décrit par la SBOM, et la racine de l'arbre de dépendances.
  • dependencies fait de ms une dépendance transitive : l'application ne l'a jamais demandée, c'est debug qui l'a fait. Un dependsOn vide indique que le composant n'a aucune dépendance. Laisser un composant hors du graphe signifie que ses dépendances sont inconnues, pas qu'il n'en a aucune.
  • compositions déclare que l'arbre de dépendances sous acme-api est complet. Un outil qui n'a pas pu tout voir devrait plutôt indiquer incomplete ou unknown, pour qu'un lecteur sache qu'il ne doit pas considérer un paquet manquant comme absent.

Pour un fichier plus grand, avec empreintes, fournisseurs et une version SPDX correspondante de la même application, voir les exemples de SBOM.

Comment générer une SBOM CycloneDX

Il existe trois façons d'en produire une, et elles décrivent des choses différentes.

Méthode Fonctionnement Ce qui lui échappe
Scan des manifestes et des lockfiles Lit package-lock.json, requirements.txt, pom.xml et les fichiers similaires Tout ce qui est récupéré hors du gestionnaire de paquets, comme les scripts d'installation, les scripts de build et les images de base
Analyse d'image, de système de fichiers ou de binaire Inspecte une image de conteneur, un répertoire ou un binaire finis pour y trouver des métadonnées de paquets et des signatures Les composants qui n'ont laissé aucune métadonnée, et le code compilé qu'il doit deviner
Enregistrement pendant le build Enregistre ce que le build a réellement récupéré pendant son exécution Uniquement ce que l'enregistreur ne peut pas voir, qu'un bon enregistreur signale comme incomplet

Outils gratuits qui écrivent du CycloneDX :

  • cdxgen, un projet OWASP, pour de nombreux langages et les images de conteneurs : cdxgen -o bom.json. Il écrit du CycloneDX 1.7 par défaut.
  • Les plugins de l'écosystème CycloneDX, comme @cyclonedx/cyclonedx-npm, cyclonedx-python, le plugin Maven CycloneDX et cyclonedx-gomod, chacun pour un gestionnaire de paquets : npx @cyclonedx/cyclonedx-npm --output-file bom.json.
  • Syft, d'Anchore, pour les images de conteneurs et les systèmes de fichiers : syft <image> -o cyclonedx-json.

Le Tool Center de CycloneDX en liste beaucoup d'autres. Pour comparer ces approches en pratique, voir les générateurs de SBOM open source et les SBOM d'images Docker.

Comment valider un fichier CycloneDX

La CLI CycloneDX officielle vérifie un fichier par rapport au schéma de sa version :

cyclonedx validate --input-file bom.json --input-version v1_7 --fail-on-errors

Le même outil convertit entre JSON, XML et Protocol Buffers, entre versions de la spécification, et vers SPDX JSON, avec cyclonedx convert. La validation de schéma prouve seulement que le fichier est bien formé. Elle ne peut pas vous dire si un composant manque. Pour cela, vérifiez le contenu à l'aide d'une liste comme la checklist de qualité des SBOM.

CycloneDX vs SPDX

SPDX est l'autre format de SBOM largement utilisé, hébergé par la Linux Foundation et publié sous la référence ISO/IEC 5962:2021. Il est né de la conformité des licences, alors que CycloneDX est parti de la sécurité, ce qui explique pourquoi CycloneDX porte les vulnérabilités et VEX dans le même format. Tous deux décrivent des composants, des identifiants, des licences et des relations, des outils convertissent de l'un à l'autre, et le Cyber Resilience Act de l'UE n'impose ni l'un ni l'autre. Le choix dépend généralement de ce que lisent vos clients et vos outils. La comparaison complète se trouve dans CycloneDX vs SPDX.

Comment CRACI produit des SBOM CycloneDX

CRACI est un runner GitHub Actions qui enregistre chaque paquet récupéré par chaque job pendant son exécution, à tous les niveaux de l'arbre de dépendances, y compris les paquets restaurés depuis les caches CI. Chaque composant de la SBOM était donc réellement présent dans le build. Chaque paquet apporte sa purl et sa licence déclarée, et la SBOM de chaque job a un état de complétude qui indique ce que le job n'a pas pu voir. La SBOM s'exporte en CycloneDX ou SPDX, avec les dépendances transitives et les vulnérabilités trouvées dans ses composants, et l'API la renvoie en JSON CycloneDX 1.7. Voir la génération de SBOM au build ou les bonnes pratiques SBOM.

Quand CRACI n'est pas la réponse

  • Nomenclatures de matériel, de cryptographie ou de services. CRACI enregistre les paquets logiciels qu'un build récupère. Une HBOM, une CBOM ou une SaaSBOM nécessite d'autres sources.
  • Builds hors de GitHub Actions. GitHub Actions est aujourd'hui la seule CI prise en charge ; les autres systèmes CI figurent sur la roadmap. Utilisez en attendant un générateur comme cdxgen.
  • Logiciels reçus sous forme binaire. Si vous ne l'avez pas construit, vous ne pouvez pas enregistrer son build. Demandez une SBOM au fournisseur, ou utilisez l'analyse de binaires.

CycloneDX : questions fréquentes

À quoi sert CycloneDX ?

Surtout aux SBOM : lister les composants d'un logiciel pour suivre les vulnérabilités et les licences et partager cette liste avec les clients. Le même format couvre aussi VEX, les services, le matériel, la cryptographie et les modèles de machine learning.

Qui maintient CycloneDX ?

L'OWASP Foundation porte le projet CycloneDX, et le Technical Committee 54 d'Ecma International le publie sous la forme du standard ECMA-424.

Quelle est la dernière version de CycloneDX ?

CycloneDX 1.7, publiée en octobre 2025. C'est aussi la 2e édition d'ECMA-424, publiée en décembre 2025. La 1re édition correspond à CycloneDX 1.6.

CycloneDX, c'est du JSON ou du XML ?

Les deux, ainsi que Protocol Buffers. JSON est le plus courant, avec le type de média application/vnd.cyclonedx+json et des noms de fichiers comme bom.json ou nom.cdx.json.

CycloneDX est-il meilleur que SPDX ?

Aucun des deux n'est meilleur en général. CycloneDX est parti de la sécurité et porte nativement les vulnérabilités et VEX, SPDX est parti de la conformité des licences et est un standard ISO. Produisez ce que lisent vos clients et vos outils ; des convertisseurs existent dans les deux sens.

Comment vérifier qu'un fichier CycloneDX est valide ?

Exécutez la CLI CycloneDX officielle : cyclonedx validate --input-file bom.json --fail-on-errors. Elle vérifie la structure par rapport au schéma, pas l'absence d'un composant.

Du CycloneDX issu du build lui-même

Enregistrez chaque paquet que vos jobs GitHub Actions récupèrent, avec un état de complétude, et exportez-le en CycloneDX ou SPDX.

Réserver une démo