Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

Builds reproductibles et provenance du logiciel

Après cette leçon: Je peux vérifier si un build est reproductible.

Leçon de 60 min7 commandesLab d’injection SQL : attaquer une recherche faible, corriger la requête et prouver la correction

Le même source doit donner les mêmes octets

Un build reproductible donne exactement le même fichier, octet pour octet, à partir du même code source et des mêmes outils. C’est important : n’importe qui peut alors reconstruire une version publiée et vérifier que personne ne l’a modifiée.

En mars 2024, une porte dérobée a été trouvée dans xz-utils 5.6.0 et 5.6.1. Cette bibliothèque de compression est présente dans de nombreux systèmes Linux. Une partie se cachait dans les archives publiées, pas dans le code que lisaient la plupart des gens.

À la fin de cette leçon

Remarque

Je peux vérifier si un build est reproductible.

Mots-clés

MotCe que ça veut direExemple
Build reproductibleune construction qui donne les mêmes octets à chaque fois, à partir du même source
Empreinteun résumé court d’un fichier, qui change si un seul octet changesha256sum
SOURCE_DATE_EPOCHune date fixe, en secondes depuis 1970, que le build utilise à la place de l’horlogeSOURCE_DATE_EPOCH=1709283600
Provenancela trace de ce qui a été construit, à partir de quel source, par quel build
Signatureune preuve, faite avec une clé, qu’un fichier vient de quelqu’un et n’a pas changé
SBOMla nomenclature logicielle : la liste de tous les composants d’un produit

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

La règle unique

Attention

Ce laboratoire est une boutique volontairement fragile. Travaillez dans votre copie privée, et rien d’autre : elle n’a aucune sortie vers Internet. Tester un système qui n’est pas le vôtre, ou sans permission, est un délit dans presque tous les pays.

Un build qui se répète est plus sûr

Un build transforme le code source en fichier livré : une archive, un programme ou une image de conteneur. Les utilisateurs téléchargent ce fichier, pas le source.

Si deux personnes construisent le même source et obtiennent la même empreinte, rien ne s’est glissé entre le source et le fichier. Si les empreintes diffèrent, quelque chose a changé, et on peut le chercher. Un build qui change à chaque fois cache ce signal.

Construire deux fois les deux mêmes fichiers

Votre laboratoire peut fabriquer une petite version avec tar, qui range des fichiers dans une archive, et sha256sum, qui en calcule l’empreinte. La commande suivante écrit deux petits fichiers source dans le conteneur de la boutique.

La commande d’après les emballe deux fois. Entre les deux, elle ne change que la date des fichiers, d’une heure, comme si le source avait été récupéré plus tard.

Écrire deux fichiers source

Commande
docker exec app sh -c "mkdir -p /tmp/build/src && printf 'print(42)\n' > /tmp/build/src/main.py && printf 'boutique 1.0\n' > /tmp/build/src/VERSION && cat /tmp/build/src/VERSION"

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Les emballer deux fois, à une heure d’écart

Commande
docker exec app sh -c "cd /tmp/build/src && touch -d '2024-03-01 09:00:00' main.py VERSION && tar -cf - main.py VERSION | sha256sum && touch -d '2024-03-01 10:00:00' main.py VERSION && tar -cf - main.py VERSION | sha256sum"

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Lire les dates rangées dans l’archive

Commande
docker exec app sh -c "cd /tmp/build/src && touch -d '2024-03-01 10:00:00' main.py VERSION && tar -cf - main.py VERSION | tar -tvf -"

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Une heure a changé toute l’empreinte

La première commande affiche boutique 1.0. La deuxième affiche deux empreintes : l’une commence par 207bd122, l’autre par ccf15965. Le contenu des deux fichiers n’a pourtant pas bougé.

La troisième liste l’archive. Chaque ligne donne les droits du fichier, son propriétaire, sa taille puis sa date, 2024-03-01 10:00:00. L’archive garde cette date : une nouvelle date donne une nouvelle archive.

Une erreur fréquente

Attention

Beaucoup pensent qu’un même source donne toujours le même fichier. C’est faux tant que chaque entrée n’est pas fixée : les dates, l’ordre, les chemins et les outils. Ne dites qu’un build est reproductible qu’après deux builds séparés de même empreinte.

Exemple travaillé : ce qui fait différer deux builds

CauseExempleCorrection habituelle
Les datesChaque fichier garde sa date de dernière modificationMettre toutes les dates à SOURCE_DATE_EPOCH
L’ordre des fichiersLe dossier liste les fichiers dans un autre ordreTrier les noms avant d’emballer
Le chemin de buildL’archive garde /home/lea/boutique ou /tmp/boutiqueEmballer des noms relatifs, depuis le dossier
Les réglages de langueLe tri met les majuscules d’abord dans un réglage, pas dans un autreTrier avec LC_ALL=C
Les versionsL’installation suivante prend une bibliothèque plus récenteFiger chaque version dans un fichier de verrouillage

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Fixer la date et l’ordre

SOURCE_DATE_EPOCH est une convention partagée : un outil de build qui la voit prend cette date au lieu de l’horloge. Beaucoup de compilateurs et d’outils d’archive la lisent déjà. Ici, le script met chaque fichier à cette date avec touch.

L’ordre compte aussi. La commande suivante emballe les mêmes fichiers à la même date, une fois dans chaque ordre. Vous écrivez ensuite un petit script de build qui trie d’abord les noms.

Mêmes fichiers, autre ordre

Commande
docker exec app sh -c "cd /tmp/build/src && touch -d '2024-03-01 10:00:00' main.py VERSION && tar -cf - main.py VERSION | sha256sum && tar -cf - VERSION main.py | sha256sum"

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Un script de build qui corrige les deux

Commande
docker exec app sh -c "printf '%s\n' 'cd /tmp/build/src' 'touch -d @\$SOURCE_DATE_EPOCH *' 'tar -cf - \$(ls | LC_ALL=C sort) | sha256sum' > /tmp/build/build.sh && cat /tmp/build/build.sh"

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Construire avec SOURCE_DATE_EPOCH

Commande
docker exec -e SOURCE_DATE_EPOCH=1709283600 app sh /tmp/build/build.sh

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Toucher chaque fichier, puis reconstruire

Commande
docker exec -e SOURCE_DATE_EPOCH=1709283600 app sh -c "touch /tmp/build/src/main.py /tmp/build/src/VERSION && sh /tmp/build/build.sh"

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Deux builds, une seule empreinte

La commande sur l’ordre affiche ccf15965 puis 644bcdfd : mêmes octets, mêmes dates, autre ordre. La commande du script affiche ses trois lignes.

Les deux builds affichent ensuite une empreinte qui commence par da1efa67, alors que le second a d’abord mis chaque fichier à l’heure du moment. LC_ALL=C sort place VERSION avant main.py, car ce réglage trie les majuscules en premier. C’est pourquoi on fixe aussi la langue.

Un octet suffit à changer une empreinte

Code: python
import hashlib

# Remplacez le 2 de second par un 3, puis lancez.
premier = b"print(42)\n"
second = b"print(42)\n"
print(hashlib.sha256(premier).hexdigest()[:16])
print(hashlib.sha256(second).hexdigest()[:16])
print("même build :", hashlib.sha256(premier).digest() == hashlib.sha256(second).digest())

La provenance dit d’où vient un fichier

Reproduire un build est un contrôle. La provenance en est un autre : une trace qui dit quel source, quel commit et quel build ont produit un fichier. Une trace signée par la plateforme de build s’appelle une attestation.

SLSA, pour Supply-chain Levels for Software Artifacts, est un cadre public qui gradue la confiance qu’on peut accorder à cette trace. Sa partie sur le build compte trois niveaux.

Exemple travaillé : les niveaux de build SLSA

NiveauCe qu’il demandeCe qu’il aide à empêcher
Build L1La provenance existe et dit comment le fichier a été construitLes erreurs, et l’ignorance de l’origine d’une version
Build L2Une plateforme de build hébergée produit et signe la provenanceUne modification du fichier ou de sa trace après le build
Build L3Une plateforme renforcée isole les builds et garde la clé de signature hors de portée des étapesUne falsification pendant le build, même par une étape du build

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Signature et SBOM complètent le tableau

Une signature prouve qui a publié un fichier. Sigstore est un service public et gratuit pour cela. Son outil cosign signe une image de conteneur ou un fichier. Il utilise un certificat de courte durée lié à un compte et note la signature dans un registre public. Ce laboratoire n’a pas cosign : vous ne faites ici que le découvrir.

Une SBOM liste chaque composant et chaque version d’un produit. Quand une faille est annoncée, on cherche dans les SBOM au lieu de deviner.

À propos de ce labo et de sa source: Lab d’injection SQL : attaquer une recherche faible, corriger la requête et prouver la correction

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.