TP05 – Générer et exploiter un SBOM

← Analyse de vulnérabilités et SBOM avec Trivy

// travaux pratiques · Administration sécurité

TP05 - Générer et exploiter un SBOM

  • TP 5 / 6
  • 7 étapes
  • ≈ 45 min
  • Accès libre

Objectif : produire des SBOM aux formats CycloneDX et SPDX pour une image et pour un projet, les inspecter, les réanalyser sans disposer de l’artefact d’origine, contrôler les licences et organiser un archivage qui permet de répondre en quelques minutes à l’annonce d’une nouvelle vulnérabilité.

Contexte

Lorsqu’une vulnérabilité majeure touche une bibliothèque très répandue, la première question de la direction est toujours la même : « sommes-nous concernés, et où ? ». Sans inventaire, la réponse demande de se connecter à chaque serveur ou de réanalyser chaque image, parfois disparue du registre. Avec un SBOM archivé à chaque livraison, elle se résume à une recherche. Le SBOM répond aussi à une exigence croissante des clients et des régulateurs, notamment dans le cadre du Cyber Resilience Act. Pour une petite structure, il s’agit d’un fichier par application et par version ; pour un grand groupe, de milliers d’inventaires centralisés et interrogés automatiquement.

À la fin de ce TP, vous saurez générer, lire, réanalyser et archiver un SBOM, et retrouver toutes les versions déployées d’un composant donné.

Prérequis : TP01 à TP03 réalisés (le fichier py34.json du TP02 et le répertoire ~/lab-trivy/app du TP03) ; jq installé.

Durée estimée : 45 minutes.

Actions à réaliser

  1. Générer le SBOM CycloneDX d’une image.

    cd ~/lab-trivy
    trivy image --format cyclonedx --output py34.cdx.json python:3.4-alpine
    jq -r '.bomFormat, .specVersion, (.components | length)' py34.cdx.json

    Avec le format CycloneDX, Trivy ne lance par défaut aucune recherche de vulnérabilités : le fichier est un inventaire pur. Résultat attendu : jq affiche CycloneDX, le numéro de version de la spécification et le nombre de composants recensés (paquets Alpine et paquets Python).

  2. Lire les composants. Chaque composant porte un nom, une version et un identifiant de paquet universel (purl) qui indique son écosystème.

    jq -r '.components[] | .name + " " + (.version // "-") + " " + (.purl // "-")' py34.cdx.json | head -20

    Résultat attendu : une liste de lignes du type nom, version, puis un purl commençant par pkg:apk/alpine/ pour les paquets du système ou pkg:pypi/ pour les paquets Python. Le purl est la clé à utiliser pour croiser un inventaire avec un avis de sécurité.

  3. Générer le SBOM SPDX d’un projet. Certains clients ou acheteurs exigent SPDX, norme reconnue par l’ISO.

    trivy fs --format spdx-json --output app.spdx.json ~/lab-trivy/app
    jq -r '.spdxVersion, (.packages | length)' app.spdx.json

    Résultat attendu : la version SPDX (SPDX-2.x) et le nombre de paquets décrits, qui inclut les dépendances de requirements.txt.

  4. Réanalyser le SBOM sans l’image. C’est l’usage clé : l’image n’est plus nécessaire, seul l’inventaire est lu et comparé à la base de vulnérabilités du jour.

    trivy sbom --format json --output py34-sbom.json py34.cdx.json
    jq '[.Results[].Vulnerabilities[]?] | length' py34-sbom.json
    jq '[.Results[].Vulnerabilities[]?] | length' py34.json

    Résultat attendu : deux nombres très proches, voire identiques si la base n’a pas changé depuis le TP02. Un écart s’explique soit par une mise à jour de la base, soit par une information que le SBOM ne conserve pas ; la documentation de Trivy rappelle que l’analyse d’un SBOM produit par un autre outil peut être moins précise.

  5. Contrôler les licences. Le scanner de licences s’active explicitement.

    trivy sbom --scanners license py34.cdx.json

    Résultat attendu : un tableau listant les composants, leur licence et une catégorie associée à une gravité. Repérez les licences à forte réciprocité : elles ne posent pas de problème pour un usage interne, mais doivent être signalées au service juridique si le logiciel est distribué à des tiers.

  6. Archiver les inventaires. On range chaque SBOM par application et par version, avec une empreinte pour en garantir l’intégrité.

    mkdir -p ~/sbom/py34/2026-11 ~/sbom/app/1.0.0
    cp py34.cdx.json ~/sbom/py34/2026-11/
    trivy fs --format cyclonedx --output ~/sbom/app/1.0.0/app.cdx.json ~/lab-trivy/app
    cd ~/sbom && sha256sum */*/*.cdx.json > SHA256SUMS
    sha256sum -c SHA256SUMS

    Résultat attendu : la dernière commande affiche OK pour chaque fichier.

  7. Répondre à une alerte. Imaginons qu’un avis signale une faille dans la bibliothèque C musl. On cherche dans tous les inventaires archivés les versions présentes.

    jq -r '.components[]? | select(.name=="musl") | input_filename + " : " + .version' ~/sbom/*/*/*.cdx.json

    input_filename renvoie le fichier en cours de lecture, ce qui identifie l’application et la version concernées. Résultat attendu : une ligne pour l’image Alpine avec la version de musl, aucune pour le projet Python qui ne l’embarque pas. Il ne reste qu’à comparer ces versions avec celles citées dans l’avis.

Vérification

Le TP est réussi si ~/sbom contient au moins deux SBOM CycloneDX valides et un fichier SHA256SUMS vérifié, si trivy sbom renvoie des vulnérabilités pour l’image ancienne, et si la recherche de l’étape 7 identifie correctement le fichier qui contient musl.

Problèmes fréquents

  • Le SBOM CycloneDX ne contient aucune vulnérabilité. Cause : comportement normal, la génération CycloneDX n’active pas le scanner. Correction : ajouter --scanners vuln si l’on veut les joindre, ou analyser l’inventaire ensuite avec trivy sbom.
  • « jq: error … Cannot iterate over null ». Cause : un fichier sans tableau components (SBOM vide ou fichier SPDX passé à une requête CycloneDX). Correction : vérifier .bomFormat et utiliser la requête adaptée au format.
  • Très peu de composants dans le SBOM d’un projet. Cause : dépendances non épinglées ou fichier de verrouillage absent. Correction : générer le fichier de verrouillage de l’écosystème avant de produire le SBOM.
  • sha256sum -c signale « FAILED ». Cause : fichier modifié après archivage. Correction : ne jamais retoucher un SBOM archivé ; en produire un nouveau pour la nouvelle version.

Bonnes pratiques et sécurité

  • Produire le SBOM dans le pipeline, à partir de l’artefact réellement livré, et le conserver aussi longtemps que la version est en service.
  • Stocker les SBOM dans un emplacement en écriture contrôlée et protéger leur intégrité (empreintes, signature, ou attestation attachée à l’image dans le registre).
  • Exiger le SBOM des fournisseurs de logiciels dans les contrats et les appels d’offres, puis l’analyser comme les vôtres.
  • Restreindre l’accès aux inventaires : ils décrivent précisément la composition de vos systèmes.

Questions de contrôle

1. Pourquoi le SBOM CycloneDX généré à l’étape 1 ne contient-il pas de vulnérabilités ?

Voir la réponse

Parce qu’avec ce format Trivy désactive par défaut le scanner de vulnérabilités ; le fichier est un inventaire, analysable à tout moment avec trivy sbom.

2. Quel est l’intérêt du purl d’un composant ?

Voir la réponse

Il identifie sans ambiguïté le paquet et son écosystème (apk, pypi, npm…), ce qui permet de le rapprocher des avis de sécurité et des autres inventaires.

3. Pourquoi réanalyser un SBOM ancien peut-il révéler de nouvelles vulnérabilités ?

Voir la réponse

Parce que les composants n’ont pas changé mais la base de vulnérabilités, elle, s’est enrichie de nouveaux avis depuis la création du SBOM.

Pour aller plus loin

Les obligations de documentation des composants imposées aux fabricants sont détaillées dans l’article sur le Cyber Resilience Act. À l’échelle d’un grand parc, les SBOM sont généralement poussés vers une plateforme d’inventaire qui les réanalyse quotidiennement et alerte les équipes concernées. Trivy sait aussi produire l’inventaire d’un cluster entier (KBOM) avec la cible k8s.

Conservez ~/sbom : le TP06 y ajoutera le SBOM produit par le pipeline.

// formation sur mesure

Former votre équipe sur ce sujet ?

Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.

Demander un programme
Défiler vers le haut