shipcra

Générer une SBOM à partir d’un lockfile

Relu le 3 min de lecture

Un lockfile enregistre déjà chaque dépendance résolue avec sa version exacte : c’est la source la plus rapide pour une SBOM. Convertissez-le en CycloneDX avec un générateur adapté à votre écosystème, ajoutez le nom et la version de votre produit, complétez les composants que le lockfile ne voit pas, et régénérez la SBOM à chaque version.

L’essentiel

Meilleure source
Le lockfile versionné avec la version que vous livrez
Format de sortie courant
CycloneDX JSON
Quand la régénérer
À chaque version qui modifie les dépendances
Ce que le lockfile ne voit pas
Code copié, binaires natifs, moteurs et environnements d’exécution

Pourquoi partir du lockfile

Un manifeste comme package.json liste les plages de versions demandées. Le lockfile enregistre ce que le gestionnaire de paquets a réellement résolu : chaque dépendance directe et transitive, figée à une version exacte, souvent avec une empreinte d’intégrité. C’est exactement ce que doit décrire une SBOM, et c’est déjà dans votre dépôt.

Partir du lockfile rend aussi la SBOM reproductible : le même commit produit toujours la même liste de composants, ce qu’on attend d’une documentation technique.

Les lockfiles par écosystème

Écosystème Lockfile Remarque
npm package-lock.json Créé par défaut
Yarn yarn.lock Formats Classic et Berry différents
pnpm pnpm-lock.yaml Créé par défaut
CocoaPods Podfile.lock À versionner avec l’app
Swift Package Manager Package.resolved Dans le projet Xcode pour les apps
Gradle gradle.lockfile Seulement si le verrouillage des dépendances est activé
Flutter et Dart pubspec.lock À versionner pour les apps
Unity Packages/packages-lock.json Couvre les paquets Unity, pas le moteur
NuGet packages.lock.json Seulement avec RestorePackagesWithLockFile activé

Si votre projet n’a pas de lockfile, activez d’abord le verrouillage. Une SBOM générée à partir de plages de versions risque de ne pas correspondre à ce que vous avez livré.

Générer la SBOM, étape par étape

  1. Récupérez le commit de la version et vérifiez que le lockfile est à jour, par exemple avec npm ci ou un build propre.
  2. Choisissez un générateur pour votre écosystème. Le projet CycloneDX en maintient d’officiels : @cyclonedx/cyclonedx-npm pour npm, des plugins Gradle et Maven, CycloneDX pour .NET, et cdxgen, qui couvre de nombreux écosystèmes.
  3. Générez le JSON CycloneDX. Pour un projet npm : npx @cyclonedx/cyclonedx-npm --output-file sbom.json.
  4. Décrivez votre produit. Vérifiez que metadata.component porte le nom de votre produit et la version exacte publiée. Les générateurs reprennent souvent le nom du paquet, pas la version commerciale.
  5. Validez le fichier. Le CLI CycloneDX le vérifie par rapport au schéma : cyclonedx validate --input-file sbom.json.
  6. Repérez les manques (voir plus bas) et ajoutez à la main les composants absents.
  7. Archivez-la avec la version et dans votre documentation technique, puis branchez-la sur votre veille de vulnérabilités pour croiser chaque nouvel avis avec ce que vous avez livré.

Vérifier le résultat avant de le garder

  • Le nombre de composants est du même ordre que celui des paquets du lockfile.
  • Chaque dépendance de premier niveau apparaît : c’est le minimum du CRA.
  • Les composants ont une package URL (purl), pour que les bases comme OSV puissent les reconnaître.
  • Les licences sont renseignées quand le registre les connaît.
  • Le nom et la version du produit sont les vôtres, pas une valeur par défaut.

Ce que le lockfile ne voit pas

  • Le code copié : une bibliothèque collée dans vos sources n’a pas d’entrée dans le lockfile.
  • Les dépendances natives et binaires : SDK livrés sous forme de frameworks, fichiers .so ou .dll.
  • Les moteurs et environnements d’exécution : Unity, Unreal, Godot, Electron ou le runtime JavaScript embarqué.
  • Les services de la plateforme : les bibliothèques système de l’appareil sortent normalement de votre SBOM, mais tout ce que vous livrez dans votre paquet y entre.

Ajoutez-les à la main, avec une version et un fournisseur, pour que l’inventaire corresponde au produit. Si votre produit tourne dans des conteneurs, une analyse d’image ajoute les paquets système que le lockfile ignore.

La garder vivante

Une SBOM n’est utile que si elle correspond à ce que les utilisateurs exécutent. Régénérez-la dans la CI à chaque version, conservez chaque exemplaire à côté du build qu’il décrit et croisez-la chaque jour avec les données de vulnérabilités. Quand un composant d’une version livrée s’avère activement exploité, la SBOM vous dit quelles versions et quels utilisateurs sont touchés, dans les 24 heures prévues par l’article 14. Pour les bases du format, voir qu’est-ce qu’une SBOM.

Questions

Peut-on générer une SBOM sans envoyer son code ?

Oui. Les générateurs open source tournent en local ou dans votre CI, et shipcra analyse le lockfile dans votre navigateur : le fichier ne quitte jamais votre machine. Seule la SBOM obtenue est conservée, si vous choisissez de l’enregistrer.

À quelle fréquence régénérer la SBOM ?

À chaque version qui modifie vos dépendances. La SBOM de votre documentation technique doit décrire la version réellement livrée : rattachez sa génération à votre processus de publication.

Un générateur de SBOM rend-il mon produit conforme au CRA ?

Non. Il produit un élément de preuve : l’inventaire des composants demandé par l’annexe I. Il reste à respecter les autres exigences essentielles, à gérer les vulnérabilités et à réaliser l’évaluation de la conformité.

Faut-il analyser l’image de conteneur ou le lockfile ?

Les deux répondent à des questions différentes. Le lockfile décrit les dépendances de l’application ; l’analyse d’image trouve aussi les paquets du système d’exploitation du conteneur. Un produit côté serveur peut nécessiter les deux ; une app mobile ou un jeu part du lockfile et ajoute le moteur à la main.

Sources

  1. Règlement (UE) 2024/2847, annexe I partie II, EUR-Lex
  2. CycloneDX, catalogue d’outils
  3. OSV, base de vulnérabilités open source
  4. Boîte à outils OCCTET : ORT Server, Curator et VulnerableCode pour SBOM, VEX et rapports d’audit

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é