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"] }
]
}
-
serialNumberetversionidentifient 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.componentest le produit décrit par la SBOM, et la racine de l'arbre de dépendances. -
dependenciesfait demsune dépendance transitive : l'application ne l'a jamais demandée, c'estdebugqui l'a fait. UndependsOnvide 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. -
compositionsdéclare que l'arbre de dépendances sousacme-apiest complet. Un outil qui n'a pas pu tout voir devrait plutôt indiquerincompleteouunknown, 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