AI CodeOps

Qu'est-ce que SLSA ? Provenance de build et niveaux expliqués

Mis à jour le

SLSA expliqué : niveaux de la Build track, contenu d'une attestation de provenance, vérification avant déploiement, et ce contre quoi SLSA ne protège pas.

SLSA (Supply-chain Levels for Software Artifacts, prononcé « salsa ») est un framework de l'OpenSSF consacré à l'intégrité des builds. Il définit des niveaux d'assurance qu'un artefact a été construit à partir de la source attendue, par le processus de build attendu, sans falsification en cours de route. La preuve sur laquelle il s'appuie est la provenance : une déclaration, signée par la plateforme de build aux niveaux supérieurs, qui indique quel artefact a été construit, à partir de quelle source, par quel builder et avec quels paramètres. Les consommateurs vérifient cette déclaration avant de déployer.

Cette page approfondit la partie consacrée à SLSA de Qu'est-ce que la sécurité de la supply chain logicielle ?.

Le problème que traite SLSA

La revue de code protège la source. Elle ne sert à rien si l'artefact que vous déployez n'a pas été construit à partir de la source relue. Entre un commit relu et un service en production, il y a un build : un job de CI, ses scripts, son runner, ses identifiants, ses dépendances et le registre sur lequel il publie. Un attaquant qui contrôle l'un de ces éléments peut livrer quelque chose que personne n'a relu.

Ce n'est pas théorique. La compromission de SolarWinds en 2020 a inséré du code malveillant pendant le build, si bien que le produit livré différait de la source. Les exigences de build de SLSA visent à rendre ce type d'attaque difficile à mener et facile à détecter.

Les niveaux de build SLSA

La version 1.0 de SLSA a organisé ses exigences en tracks. La Build track compte quatre niveaux :

NiveauExigenceCe contre quoi il protège
Build L0AucuneRien ; c'est le point de départ
Build L1Une provenance existe et montre comment l'artefact a été construitLes erreurs de release, comme un build à partir d'un commit absent du dépôt officiel ; rend les builds inspectables
Build L2Les builds s'exécutent sur une plateforme de build hébergée qui génère et signe la provenanceLa falsification de l'artefact ou de la provenance après le build
Build L3La plateforme de build est renforcée : les builds sont isolés les uns des autres, et les clés de signature ne sont pas accessibles aux étapes de build que vous définissezLa falsification pendant le build, y compris par une étape ou un job de build compromis

Les niveaux sont cumulatifs. Le niveau 1 consiste surtout à avoir une provenance tout court. Au niveau 2, il faut compromettre la plateforme de build pour la falsifier. Au niveau 3, compromettre un build ne suffit pas pour falsifier la provenance d'un autre.

La spécification continue d'évoluer : la version 1.2, la version actuelle, ajoute une Source track avec des exigences pour le contrôle de version des sources. Consultez la version actuelle sur le site de SLSA pour savoir ce qui est définitif.

Ce que contient la provenance

La provenance SLSA est généralement une attestation in-toto : une déclaration signée portant sur un ou plusieurs artefacts. La déclaration désigne les artefacts par leur digest, et son prédicat décrit comment ils ont été construits. Un exemple abrégé :

{
  "_type": "https://in-toto.io/Statement/v1",
  "subject": [{ "name": "checkout-2.4.0.tar.gz", "digest": { "sha256": "…" } }],
  "predicateType": "https://slsa.dev/provenance/v1",
  "predicate": {
    "buildDefinition": {
      "buildType": "https://ci.example.com/workflow/v1",
      "externalParameters": { "repository": "https://git.example.com/acme/checkout", "ref": "refs/tags/v2.4.0" },
      "resolvedDependencies": [
        { "uri": "git+https://git.example.com/acme/checkout@refs/tags/v2.4.0", "digest": { "gitCommit": "…" } }
      ]
    },
    "runDetails": {
      "builder": { "id": "https://ci.example.com/hosted-runner" },
      "metadata": { "invocationId": "…" }
    }
  }
}

Les éléments les plus importants :

  • subject : l'artefact, identifié par son empreinte. Une provenance portant sur une autre empreinte ne dit rien de votre fichier.
  • buildDefinition : ce qui a été construit et comment, y compris le dépôt source, la ref et le commit exact qui a été résolu.
  • runDetails.builder.id : la plateforme de build qui l'a produit. La vérification le compare à une liste de builders de confiance.

La déclaration est signée, généralement dans une enveloppe DSSE, et souvent avec Sigstore, qui lie la signature à l'identité du workflow de build plutôt qu'à une clé à longue durée de vie.

Vérifier la provenance

La provenance n'est utile que si quelqu'un la vérifie avant que l'artefact soit utilisé. La vérification pose ces questions :

  1. La signature est-elle valide, et provient-elle d'un builder de confiance ?
  2. Le digest du subject correspond-il à l'artefact que vous vous apprêtez à déployer ou à installer ?
  3. La source est-elle celle attendue : le bon dépôt, et un tag ou une branche à partir desquels vous publiez vos releases ?
  4. Les paramètres de build sont-ils ceux attendus, sans entrée inattendue ?

Des outils existent pour cela, comme le vérificateur du projet SLSA et les outils de Sigstore, et certains écosystèmes l'intègrent. npm, par exemple, peut publier des paquets avec une provenance depuis les fournisseurs de CI pris en charge, et les registres peuvent l'afficher. L'endroit le plus utile pour vérifier est la dernière étape avant le déploiement, dans le cadre de la barrière de déploiement.

Ce que SLSA ne couvre pas

Les niveaux de build SLSA portent sur l'intégrité du build. Ils ne vous disent pas :

  • si le code source est exempt de vulnérabilités ou de bugs ;
  • si du code malveillant a été relu et fusionné par quelqu'un qui disposait des accès ;
  • si vos dépendances ont été construites avec le même soin, sauf si elles publient leur propre provenance ;
  • quels composants se trouvent dans l'artefact. C'est le rôle d'un SBOM.

SLSA, les SBOM et le SSDF

AspectProvenance SLSASBOMNIST SSDF (SP 800-218)
Répond àComment et où cet artefact a-t-il été construit ?Que contient cet artefact ?Cette organisation développe-t-elle des logiciels de façon sécurisée ?
FormeAttestation signée par artefactDocument d'inventaire par artefactUn ensemble de pratiques ; les organisations attestent les suivre
Produit parLa plateforme de buildUn générateur de SBOM, idéalement dans le buildLes processus de l'organisation
Vérifié parDes vérificateurs avant le déploiement ou l'installationDes outils de vulnérabilités et de licencesLes clients, les auditeurs et les services achats

Ils se complètent. Une release mature peut réunir les trois : un SBOM, une provenance signée, et une organisation capable d'attester qu'elle suit les pratiques du SSDF.

Les pipelines de build et les agents IA

Les définitions de build sont du code. Un fichier de workflow de CI qu'un agent IA modifie peut changer la façon dont les artefacts sont construits, les secrets que le build peut utiliser et l'endroit où il publie. Traitez les changements des définitions de build et de pipeline comme sensibles : exigez pour eux une revue spécifique, et tenez les agents qui écrivent du code à l'écart des identifiants de build. La provenance aide après coup, car elle enregistre quel workflow a construit un artefact, si bien qu'un workflow modifié apparaît lors de la vérification de la provenance.

Pour commencer

  1. Recensez vos chemins de release. Listez chaque façon dont un artefact atteint la production ou un registre, y compris les releases manuelles depuis un ordinateur portable. La provenance n'aide que pour les chemins qui en produisent.
  2. Ne construisez vos releases qu'en CI. Un artefact construit sur la machine d'un développeur n'a pas de provenance digne de confiance. Faire passer tous les builds de release sur un service de CI hébergé est, à elle seule, l'étape la plus importante.
  3. Activez la génération de provenance. De nombreux services de CI et registres de paquets peuvent générer et publier la provenance pour vous. Cela vous donne le niveau 1, et souvent le niveau 2.
  4. Vérifiez avant de déployer. Ajoutez au pipeline de déploiement une étape de vérification qui contrôle la signature, le builder, le dépôt source et le digest de l'artefact, et qui refuse le déploiement (fail-closed) dès que l'un d'eux ne correspond pas.
  5. Renforcez le build. Isolez les builds, tenez le matériel de signature à l'écart des étapes de build, et limitez qui peut modifier les définitions de build. C'est le chemin vers le niveau 3.

Le lien entre AI CodeOps et SLSA

AI CodeOps ne construit pas vos artefacts et ne génère pas de provenance SLSA ; c'est votre propre CI qui fait le build, et c'est là que la provenance est produite. AI CodeOps couvre les étapes qui précèdent le build : la façon dont un changement a été écrit, relu et approuvé.

  • Protégez les définitions de build par une politique. Une règle diff.apply avec la décision ask sur des chemins comme .github/** ou .forgejo/** exige une revue approuvée avant qu'un changement de ces fichiers ne devienne une pull request. Une règle deny le bloque.
  • Tenez les identifiants hors de portée des agents. Les secrets de l'espace de travail parviennent aux jobs de build sous forme de variables d'environnement et sont retirés des logs de build ; les agents IA ne les reçoivent jamais.
  • Enregistrez comment chaque changement a été réalisé. Chaque changement peut être téléchargé sous forme de dossier de preuves signé : la tâche, les modèles, les étapes, les constats, les tests, les approbations et la livraison, signés avec Ed25519 et vérifiables hors ligne. Il joue pour la rédaction d'un changement un rôle semblable à celui de la provenance pour le build.

Consultez Approbations et politiques pour les règles de chemins et Revue de sécurité et suivi des SBOM pour la vue d'ensemble.

Questions fréquentes

Comment prononce-t-on SLSA ?

Comme le mot salsa. Les lettres signifient Supply-chain Levels for Software Artifacts.

Quelle est la différence entre SLSA et un SBOM ?

Un SBOM liste ce que contient un artefact. La provenance SLSA enregistre comment l'artefact a été construit, à partir de quelle source et par quelle plateforme de build. Ils répondent à des questions différentes et sont souvent utilisés ensemble.

Le niveau 3 de SLSA signifie-t-il que mon logiciel est sûr ?

Non. Il signifie que la plateforme de build rend difficile la falsification du build ou de sa provenance. Il ne dit rien des vulnérabilités, du code malveillant qui a été relu et fusionné, ni de la sécurité de vos dépendances.

Dois-je atteindre le niveau 3 de SLSA ?

Commencez par le niveau 1, une provenance pour chaque release, puis passez à une plateforme de build hébergée qui signe la provenance pour le niveau 2. De nombreux services de CI hébergés rendent le niveau 2 ou 3 accessible sans que vous ayez à construire votre propre plateforme.