AI CodeOps

Nomenclature logicielle (SBOM)

Mis à jour le

Un SBOM liste chaque composant, version et licence d'un logiciel. Ce qu'il contient, pourquoi les acheteurs le demandent, et comment AI CodeOps les enregistre.

Une nomenclature logicielle (software bill of materials, SBOM) est un inventaire lisible par machine des composants d'un logiciel : chaque bibliothèque et chaque paquet, sa version, son fournisseur, sa licence et ses relations avec les autres. Elle répond à la question « qu'avons-nous livré exactement ? ».

Définition

Un SBOM est généralement généré pendant le build, à partir des lockfiles, des manifestes ou de l'artefact construit, et écrit dans un format standard. Les deux formats courants sont CycloneDX et SPDX. Un SBOM utile identifie chaque composant avec précision, souvent par une URL de paquet (purl) comme pkg:npm/[email protected], afin que les outils puissent le rapprocher des avis de sécurité et des listes de licences.

Un SBOM décrit une version du logiciel. Si vous livrez un nouveau build avec des dépendances différentes, il vous faut un nouveau SBOM.

Pourquoi c'est important

Lorsqu'une nouvelle vulnérabilité est annoncée, la première question est « sommes-nous concernés ? ». Avec un SBOM par release, c'est une simple recherche, pas une enquête. Les SBOM rendent aussi possible le contrôle des licences à grande échelle, et les clients les demandent de plus en plus. Aux États-Unis, l'Executive Order 14028 (2021) a introduit les SBOM dans les achats de logiciels fédéraux, et la NTIA en a publié les éléments minimaux la même année.

Dans AI CodeOps

AI CodeOps enregistre les SBOM par projet ; il ne les génère pas et ne conserve pas le fichier lui-même. Vous créez le SBOM avec votre outil habituel, gardez le fichier là où vous gardez vos artefacts de build, et enregistrez un instantané. Pendant la bêta ouverte, il s'agit d'une requête vers /api/sbom depuis une session connectée (il n'existe pas encore de formulaire d'envoi ni de route par clé API) :

{
  "projectID": "checkout",
  "commitSHA": "4f2a9c1e7b3d",
  "format": "cyclonedx",
  "formatVersion": "1.5",
  "downloadURL": "https://artifacts.example.com/checkout/4f2a9c1e7b3d/bom.json",
  "sha256": "9d1c5e0b7a2f4c6e8d0b1a3c5e7f9a2b4d6c8e0f1a3b5c7d9e2f4a6b8c0d1e3f",
  "componentCount": 412,
  "vulnerableCount": 3,
  "licenseSummary": { "MIT": 301, "Apache-2.0": 74, "ISC": 29, "BSD-3-Clause": 8 },
  "generationSource": "ci"
}

L'empreinte SHA-256 permet à quiconque de rapprocher l'enregistrement du fichier. Le nombre de composants, le nombre de composants vulnérables et le résumé des licences sont les chiffres que vous envoyez ; AI CodeOps n'analyse pas le fichier pour les vérifier.

L'enregistrement le plus récent est le SBOM actuel du projet. Vous le voyez sur la page du projet (Recent SBOMs, Vulnerable components (latest SBOM)) et dans le panneau Software Bill of Materials sous Secure → Security, qui agrège les résumés de licences de tous les projets. La vérification de livraison qu'appelle votre CI peut ensuite lui appliquer une politique de licences.

Pour examiner le contenu d'un fichier JSON CycloneDX sans vous connecter, ouvrez le visualiseur de SBOM.

Questions fréquentes

AI CodeOps génère-t-il des SBOM ?

Non. Vous générez le SBOM avec l'outil que vous utilisez déjà dans votre build et vous l'enregistrez sur le projet. AI CodeOps le suit et s'en sert pour le contrôle des licences.

Quels formats de SBOM AI CodeOps accepte-t-il ?

CycloneDX et SPDX. Un enregistrement conserve le format et sa version, pour que vous puissiez distinguer les deux ensuite.

Puis-je examiner le contenu d'un fichier SBOM sans me connecter ?

Oui, pour le JSON CycloneDX. Le visualiseur de SBOM gratuit lit le fichier dans votre navigateur et ne l'envoie jamais.