shipcra

SBOM : qu’est-ce qu’une nomenclature logicielle, avec un exemple

Relu le 3 min de lecture

Une SBOM, ou nomenclature logicielle (software bill of materials), est une liste lisible par machine des composants d’un logiciel : noms, versions, fournisseurs, licences et dépendances entre eux. Le Cyber Resilience Act oblige les fabricants à en établir une couvrant au minimum les dépendances de premier niveau. Elle n’a pas à être publiée.

L’essentiel

Signification
Software bill of materials, nomenclature logicielle
Formats principaux
CycloneDX (ECMA-424) et SPDX (ISO/IEC 5962:2021)
Base dans le CRA
Annexe I, partie II, point 1
Profondeur minimale exigée
Les dépendances de premier niveau
Publication
Non obligatoire ; mise à disposition des autorités de surveillance du marché sur demande

Ce que contient une SBOM

C’est la liste des ingrédients de votre logiciel. Pour chaque composant, une SBOM indique en général :

  • Le nom et la version, par exemple react 19.2.0.
  • Un identifiant, le plus souvent une package URL (pkg:npm/react@19.2.0), pour que d’autres outils puissent le croiser avec les bases de vulnérabilités.
  • Le fournisseur ou l’auteur, quand il est connu.
  • La licence, comme MIT ou Apache-2.0.
  • Les relations : quel composant dépend de quel autre, pour distinguer les dépendances directes des dépendances transitives.
  • Les empreintes (hashes), quand le générateur peut les calculer, pour prouver quel fichier exact a été livré.

Le document décrit aussi le produit lui-même (nom, version, fabricant) et la date de génération.

Un exemple de SBOM

Voici un document CycloneDX 1.6 réduit, pour une petite app avec une seule dépendance :

{
  "bomFormat": "CycloneDX",
  "specVersion": "1.6",
  "serialNumber": "urn:uuid:3e671687-395b-41f5-a30f-a58921a69b79",
  "version": 1,
  "metadata": {
    "timestamp": "2026-11-19T10:00:00Z",
    "component": {
      "type": "application",
      "bom-ref": "lumen-notes@2.4.1",
      "name": "lumen-notes",
      "version": "2.4.1"
    }
  },
  "components": [
    {
      "type": "library",
      "bom-ref": "pkg:npm/react@19.2.0",
      "name": "react",
      "version": "19.2.0",
      "purl": "pkg:npm/react@19.2.0",
      "licenses": [{ "license": { "id": "MIT" } }]
    }
  ],
  "dependencies": [
    { "ref": "lumen-notes@2.4.1", "dependsOn": ["pkg:npm/react@19.2.0"] },
    { "ref": "pkg:npm/react@19.2.0", "dependsOn": [] }
  ]
}

Une vraie application liste des centaines de composants. La structure reste la même.

CycloneDX ou SPDX

CycloneDX SPDX
Maintenu par OWASP, normalisé sous ECMA-424 La Linux Foundation, normalisé sous ISO/IEC 5962:2021
Origine Sécurité applicative Conformité des licences
Formats courants JSON, XML JSON, tag-value, RDF, YAML
Point fort Dépendances, vulnérabilités, services Licences, fichiers, provenance

Les deux satisfont le CRA. Des convertisseurs existent dans les deux sens : le choix n’est pas définitif.

Ce qu’exige le Cyber Resilience Act

L’annexe I, partie II, point 1, demande aux fabricants de recenser et de documenter les vulnérabilités et les composants de leurs produits, notamment en établissant une nomenclature logicielle dans un format couramment utilisé et lisible par machine, qui couvre au minimum les dépendances de premier niveau. La formulation exacte figure dans la version française du règlement sur EUR-Lex.

En pratique :

  • Les dépendances de premier niveau sont un minimum. La plupart des générateurs listent aussi les dépendances transitives, ce qui rend le croisement avec les vulnérabilités bien plus utile.
  • Une SBOM par version. Elle doit correspondre à ce que vous avez livré : régénérez-la dès que les dépendances changent.
  • La conserver, pas forcément la publier. Elle fait partie de la documentation technique et va aux autorités sur demande.

La Commission peut préciser le format et le contenu de la SBOM par des actes d’exécution. D’ici là, le texte ci-dessus fait foi.

Ce qu’une SBOM ne fait pas

Une SBOM est un inventaire. Elle ne prouve pas qu’un produit est sûr, ni qu’il respecte le CRA. C’est le point de départ du travail qui compte : croiser les composants avec les vulnérabilités connues, décider quoi corriger, signaler quand une faille est activement exploitée.

Elle ne liste que ce que le générateur voit. Le code copié dans le dépôt, les bibliothèques natives et les moteurs doivent souvent être ajoutés à la main. Le guide pratique pour générer une SBOM depuis un lockfile explique comment repérer ces manques.

Questions

La SBOM est-elle obligatoire avec le Cyber Resilience Act ?

Oui, pour les produits concernés, à partir du 11 décembre 2027. L’annexe I, partie II, point 1, impose de recenser et documenter les composants, notamment en établissant une nomenclature des logiciels dans un format couramment utilisé et lisible par machine, couvrant au minimum les dépendances de premier niveau.

Dois-je publier ma SBOM ?

Non. Le CRA n’impose pas de la rendre publique. Vous la conservez avec votre documentation technique et la fournissez aux autorités de surveillance du marché sur demande motivée. Si vous choisissez de la partager avec les utilisateurs, l’annexe II demande d’indiquer où la trouver.

Faut-il choisir CycloneDX ou SPDX ?

Les deux répondent au critère « couramment utilisé et lisible par machine ». CycloneDX est orienté sécurité et bien outillé pour les données de vulnérabilités ; SPDX vient de la conformité des licences et est une norme ISO. Prenez celui que vos outils produisent et que vos clients demandent.

Quelle différence entre une SBOM et un lockfile ?

Un lockfile est écrit pour votre gestionnaire de paquets. Une SBOM est un document normalisé destiné aux personnes et aux autres outils : elle ajoute des identifiants comme les package URL, les licences, les fournisseurs et le produit décrit.

Sources

  1. Règlement (UE) 2024/2847, annexe I partie II et annexe II, EUR-Lex
  2. Spécification CycloneDX
  3. Spécifications SPDX

Ce guide explique le règlement de façon générale. Il ne constitue pas un conseil juridique pour votre produit.

Transformez votre lockfile en SBOM.

shipcra lit votre lockfile dans le navigateur et produit une SBOM CycloneDX pour votre documentation technique. Le fichier ne quitte jamais votre machine.

Rejoindre l’accès anticipé