AI CodeOps

Qu'est-ce qu'un SBOM ? Contenu, types et utilisation

Mis à jour le

La nomenclature logicielle en détail : contenu, identifiants de composants, types de SBOM de la conception à l'exécution, génération, et place de VEX.

Une nomenclature logicielle (software bill of materials, SBOM) est un inventaire lisible par machine des composants qui constituent un logiciel : chaque bibliothèque, paquet ou module, avec sa version, son fournisseur, ses identifiants, sa licence et ses relations avec les autres. Comme la nomenclature qu'un fabricant établit pour un produit physique, elle vous permet de savoir ce qu'il contient sans le démonter. Sa valeur tient à ce que vous en faites : retrouver en quelques minutes les logiciels concernés lorsqu'une vulnérabilité est annoncée, contrôler les licences à chaque changement, et montrer aux clients et aux auditeurs ce que vous livrez.

Cette page approfondit la partie consacrée aux SBOM de Qu'est-ce que la sécurité de la supply chain logicielle ?.

Ce que contient un SBOM

En 2021, la National Telecommunications and Information Administration (NTIA) des États-Unis a publié les éléments minimaux d'un SBOM. Ils se répartissent en trois groupes.

Champs de données pour chaque composant : nom du fournisseur, nom du composant, version, autres identifiants uniques, relation de dépendance, auteur des données du SBOM, et horodatage.

Prise en charge de l'automatisation : le SBOM est dans un format lisible par machine que les outils peuvent générer et exploiter. La NTIA a cité SPDX, CycloneDX et les balises SWID.

Pratiques et processus : quand produire un SBOM (à chaque nouveau build ou nouvelle release), jusqu'où il descend (au moins les composants de premier niveau, avec assez de détails pour retrouver les composants transitifs), comment consigner les « inconnues connues » là où l'arbre des dépendances est incomplet, comment il est distribué et qui peut y accéder, et comment les erreurs sont corrigées.

La plupart des générateurs vont au-delà du minimum : données de licence, empreintes de fichiers, outil qui a produit le SBOM, et parfois références de vulnérabilités.

Identifiants de composants

Un SBOM ne vaut que par ses identifiants. « openssl, version 3 » est difficile à rapprocher de quoi que ce soit ; un identifiant précis peut être rapproché automatiquement des bases de vulnérabilités et des listes de licences.

  • Package URL (purl). Une chaîne qui nomme un paquet dans son écosystème, comme pkg:npm/[email protected] ou pkg:pypi/[email protected]. Très utilisée par les outils open source.
  • CPE (Common Platform Enumeration). Un schéma de nommage qu'utilise la National Vulnerability Database des États-Unis pour indiquer quels produits une vulnérabilité affecte.
  • Empreintes. Des empreintes cryptographiques de fichiers ou de paquets, qui identifient un artefact exact quel que soit son nom.

Un composant doté d'un purl et d'une empreinte peut être rapproché de façon fiable. Un composant qui n'a qu'un nom et une version, souvent pas.

À quoi ressemble un SBOM

Un SBOM CycloneDX minimal en JSON, réduit à une application et une dépendance :

{
  "bomFormat": "CycloneDX",
  "specVersion": "1.5",
  "version": 1,
  "metadata": {
    "timestamp": "2026-10-21T09:30:00Z",
    "component": { "type": "application", "name": "checkout", "version": "2.4.0", "bom-ref": "checkout" }
  },
  "components": [
    {
      "type": "library",
      "bom-ref": "pkg:npm/[email protected]",
      "name": "lodash",
      "version": "4.17.21",
      "purl": "pkg:npm/[email protected]",
      "licenses": [{ "license": { "id": "MIT" } }]
    }
  ],
  "dependencies": [{ "ref": "checkout", "dependsOn": ["pkg:npm/[email protected]"] }]
}

Le bloc metadata décrit l'objet du SBOM et sa date de création. Chaque entrée de components est un composant avec ses identifiants et sa licence. Le bloc dependencies enregistre quel composant dépend de quel autre, afin de pouvoir reconstruire l'arbre. SPDX enregistre les mêmes informations avec une structure et des noms différents. Pour une comparaison des deux formats, consultez CycloneDX ou SPDX.

Types de SBOM : à quel moment du cycle de vie il a été produit

Un SBOM produit à partir d'un document de conception ne dit pas la même chose qu'un SBOM produit à partir d'un conteneur en cours d'exécution. Un document de la CISA de 2023, Types of Software Bill of Material (SBOM) Documents, en distingue six types :

TypeProduit à partir deCe qu'il vous apprend
Design (conception)Les plans ou les exigences, avant que le logiciel existeCe qu'il est prévu d'inclure
SourceLe dépôt source et ses manifestesCe dont le code déclare dépendre
BuildLe processus de build, à partir des dépendances résoluesCe qui est entré dans un build précis
Analyzed (analysé)L'inspection d'un artefact construit, comme une imageCe qu'un scanner trouve dans l'artefact
Deployed (déployé)Le logiciel tel qu'installé dans un environnementCe qui est présent là où il s'exécute, configuration comprise
Runtime (exécution)L'observation du système en cours d'exécutionCe qui est réellement chargé et exécuté

Pour la réponse aux vulnérabilités et le contrôle des licences, un SBOM de type Build est en général le meilleur point de départ : il reflète les versions résolues, dépendances transitives comprises, d'un artefact que vous avez réellement livré.

Comment les SBOM sont générés

Les SBOM sont produits par des outils, pas écrits à la main. Les générateurs lisent les lockfiles et les manifestes, inspectent les artefacts construits ou les images de conteneur, ou se branchent sur le build lui-même. Parmi les exemples open source figurent Syft, Trivy et cdxgen, et de nombreux écosystèmes de build ont leurs propres plugins.

Pour obtenir un SBOM sur lequel vous pouvez compter :

  • Générez-le en CI, à partir du build. Cela le rattache à un artefact et à un commit, et supprime l'étape que l'on oublie.
  • Utilisez les versions résolues. Un manifeste avec des plages de versions indique ce qui est autorisé ; un lockfile ou un artefact construit indique ce qui a été utilisé.
  • Incluez les dépendances transitives, et notez où l'arbre est incomplet.
  • Conservez-le avec la release, avec une empreinte, afin de pouvoir retrouver le SBOM de ce qui tournait à un moment donné.
  • Vérifiez-le. Ouvrez quelques SBOM et assurez-vous que les composants, les versions et les licences sont plausibles. Un générateur configuré sur le mauvais répertoire produit un SBOM valide et presque vide.

Utiliser un SBOM

  • Réponse aux vulnérabilités. Rapprochez les identifiants de composants des avis de sécurité. Lorsqu'une nouvelle vulnérabilité est annoncée, cherchez dans vos SBOM stockés au lieu de fouiller chaque dépôt.
  • Conformité des licences. Faites la somme des licences de tous les composants et comparez-la à votre politique, à chaque changement plutôt qu'au seul moment de la release.
  • Inventaire et suivi de fin de vie. Repérez les composants qui ne sont plus maintenus ou qui ont dépassé leur date de fin de support.
  • Demandes des clients et des régulateurs. Aux États-Unis, l'Executive Order 14028 a introduit les SBOM dans les achats de logiciels fédéraux. Dans l'UE, le Cyber Resilience Act impose aux fabricants de produits comportant des éléments numériques d'établir un SBOM, couvrant au moins les dépendances de premier niveau, dans le cadre de leur documentation technique.

Les SBOM et VEX

Un SBOM dit ce qui est présent. Un scanner de vulnérabilités qui le rapproche des avis de sécurité signalera chaque composant ayant une vulnérabilité connue, y compris ceux dont le code vulnérable n'est jamais appelé. VEX (Vulnerability Exploitability eXchange) enregistre l'évaluation du fournisseur pour chaque cas, avec des statuts comme not affected (non concerné), affected (concerné), fixed (corrigé) et under investigation (en cours d'analyse), et une justification pour « not affected », par exemple que le code vulnérable n'est pas présent ou ne peut pas être atteint.

VEX peut être publié en CycloneDX, au format CSAF ou sous forme de documents OpenVEX. Ensemble, un SBOM et des déclarations VEX permettent à un client de savoir quels résultats de scanner demandent une action.

Comment AI CodeOps s'y prend

AI CodeOps suit les SBOM par projet, au format CycloneDX ou SPDX. Il ne les génère pas : vous créez le SBOM avec votre outil habituel, conservez le fichier avec vos artefacts de build, et enregistrez un instantané avec son format, son commit, son empreinte, son lien de téléchargement, son nombre de composants et son résumé des licences. Pendant la bêta ouverte, un instantané s'enregistre par une requête vers /api/sbom depuis une session connectée ; l'enregistrement depuis la CI avec une clé API n'est pas encore disponible.

La vérification de livraison qu'appelle votre CI peut refuser un changement lorsque le dernier SBOM du projet contient une licence que vous avez interdite, et le refuse lorsqu'une règle de licence est définie et que le projet n'a pas de SBOM. Les SBOM apparaissent sous Secure → Security et sur la page de chaque projet.

Consultez Sécurité et SBOM pour les détails, l'entrée SBOM du glossaire, et le visualiseur de SBOM gratuit, qui ouvre un fichier JSON CycloneDX dans votre navigateur sans l'envoyer.

Questions fréquentes

Quelle est la différence entre un SBOM et un lockfile ?

Un lockfile fige les versions des dépendances pour un gestionnaire de paquets donné, afin que les builds soient reproductibles. Un SBOM décrit tous les composants du logiciel livré dans un format standard, avec des identifiants, des licences et des relations, afin que d'autres outils et d'autres organisations puissent le lire.

Un SBOM inclut-il les dépendances transitives ?

Un bon SBOM, oui. Les dépendances de vos dépendances sont à l'origine de la plupart des composants, et c'est là que l'on trouve beaucoup de vulnérabilités. Vérifiez les paramètres de votre générateur, et notez lorsque la profondeur est incomplète.

À quelle fréquence faut-il générer un SBOM ?

Au minimum pour chaque release, et idéalement pour chaque build susceptible d'être déployé. Un SBOM décrit une version du logiciel, si bien qu'un nouveau build avec des dépendances différentes en demande un nouveau.

Dois-je partager mes SBOM avec mes clients ?

De nombreux clients et régulateurs les demandent désormais. Décidez qui peut les recevoir et comment, car un SBOM montre exactement quels composants et quelles versions vous utilisez.

Qu'est-ce que VEX ?

Vulnerability Exploitability eXchange est une déclaration indiquant si une vulnérabilité connue affecte réellement un produit, avec un statut comme not affected (non concerné), affected (concerné), fixed (corrigé) ou under investigation (en cours d'analyse). Elle accompagne un SBOM pour réduire le bruit des scanners.