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
| Mot | Ce que ça veut dire | Exemple |
|---|---|---|
| Build reproductible | une construction qui donne les mêmes octets à chaque fois, à partir du même source | |
| Empreinte | un résumé court d’un fichier, qui change si un seul octet change | sha256sum |
| SOURCE_DATE_EPOCH | une date fixe, en secondes depuis 1970, que le build utilise à la place de l’horloge | SOURCE_DATE_EPOCH=1709283600 |
| Provenance | la trace de ce qui a été construit, à partir de quel source, par quel build | |
| Signature | une preuve, faite avec une clé, qu’un fichier vient de quelqu’un et n’a pas changé | |
| SBOM | la 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
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
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
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
| Cause | Exemple | Correction habituelle |
|---|---|---|
| Les dates | Chaque fichier garde sa date de dernière modification | Mettre toutes les dates à SOURCE_DATE_EPOCH |
| L’ordre des fichiers | Le dossier liste les fichiers dans un autre ordre | Trier les noms avant d’emballer |
| Le chemin de build | L’archive garde /home/lea/boutique ou /tmp/boutique | Emballer des noms relatifs, depuis le dossier |
| Les réglages de langue | Le tri met les majuscules d’abord dans un réglage, pas dans un autre | Trier avec LC_ALL=C |
| Les versions | L’installation suivante prend une bibliothèque plus récente | Figer 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
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
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
docker exec -e SOURCE_DATE_EPOCH=1709283600 app sh /tmp/build/build.shAffiché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
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
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
| Niveau | Ce qu’il demande | Ce qu’il aide à empêcher |
|---|---|---|
| Build L1 | La provenance existe et dit comment le fichier a été construit | Les erreurs, et l’ignorance de l’origine d’une version |
| Build L2 | Une plateforme de build hébergée produit et signe la provenance | Une modification du fichier ou de sa trace après le build |
| Build L3 | Une plateforme renforcée isole les builds et garde la clé de signature hors de portée des étapes | Une 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.