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
- Récupérez le commit de la version et vérifiez que le lockfile est à jour, par exemple avec
npm ciou un build propre. - Choisissez un générateur pour votre écosystème. Le projet CycloneDX en maintient d’officiels :
@cyclonedx/cyclonedx-npmpour npm, des plugins Gradle et Maven,CycloneDXpour .NET, etcdxgen, qui couvre de nombreux écosystèmes. - Générez le JSON CycloneDX. Pour un projet npm :
npx @cyclonedx/cyclonedx-npm --output-file sbom.json. - Décrivez votre produit. Vérifiez que
metadata.componentporte 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. - Validez le fichier. Le CLI CycloneDX le vérifie par rapport au schéma :
cyclonedx validate --input-file sbom.json. - Repérez les manques (voir plus bas) et ajoutez à la main les composants absents.
- 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
.soou.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
- Règlement (UE) 2024/2847, annexe I partie II, EUR-Lex
- CycloneDX, catalogue d’outils
- OSV, base de vulnérabilités open source
- 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.