Gleicher Quellcode, gleiche Bytes
Ein reproduzierbarer Build liefert aus demselben Quellcode mit denselben Werkzeugen genau dieselbe Datei, Bit für Bit. Das ist wichtig, weil dann jede und jeder eine Veröffentlichung nachbauen und prüfen kann, dass unterwegs niemand etwas geändert hat.
Im März 2024 wurde in den Versionen 5.6.0 und 5.6.1 von xz-utils eine Hintertür gefunden, einer Kompressionsbibliothek in vielen Linux-Systemen. Ein Teil davon steckte in den veröffentlichten Archiven und nicht im Code, den die meisten lasen.
Am Ende dieser Lektion
Notiz
Ich kann prüfen, ob ein Build reproduzierbar ist.
Schlüsselwörter
| Begriff | Was er bedeutet | Beispiel |
|---|---|---|
| Reproduzierbarer Build | ein Build, der aus demselben Quellcode jedes Mal dieselben Bytes liefert | |
| Hash | ein kurzer Fingerabdruck von Bytes, der sich bei jedem geänderten Byte ändert | sha256sum |
| SOURCE_DATE_EPOCH | eine feste Zeit in Sekunden seit 1970, die ein Build statt der Uhr nimmt | SOURCE_DATE_EPOCH=1709283600 |
| Herkunftsnachweis | ein Protokoll, was aus welchem Quellcode mit welchem Build entstand; auf Englisch Provenance | |
| Signatur | ein Nachweis mit einem Schlüssel, dass eine Datei von jemandem stammt und unverändert ist | |
| SBOM | eine Stückliste der Software: alle Bestandteile eines Produkts |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Die eine Regel
Warnung
Dieses Lab ist ein Shop, der absichtlich unsicher ist. Arbeiten Sie nur in Ihrer eigenen, privaten Kopie und nirgends sonst. Sie hat keine Verbindung ins Internet.
Ein wiederholbarer Build ist sicherer
Ein Build macht aus Quellcode die Datei, die ausgeliefert wird: ein Archiv, ein Programm oder ein Container-Image. Nutzerinnen und Nutzer laden diese Datei herunter, nicht den Quellcode.
Bauen zwei Personen denselben Quellcode und bekommen denselben Hash, hat niemand etwas dazwischen geschoben. Weichen die Hashes ab, hat sich etwas geändert, und Sie können danach suchen. Ein Build, der jedes Mal anders ausfällt, verdeckt dieses Signal.
Dieselben zwei Dateien zweimal bauen
Ihr Lab kann mit tar ein kleines Release bauen, das Dateien in ein Archiv packt, und mit sha256sum seinen Hash berechnen. Der nächste Befehl schreibt zwei kleine Quelldateien in den Container des Shops.
Der Befehl danach packt sie zweimal. Dazwischen ändert er nur die Zeit der Dateien, um eine Stunde, als wäre der Quellcode später geholt worden.
Zwei Quelldateien schreiben
docker exec app sh -c "mkdir -p /tmp/build/src && printf 'print(42)\n' > /tmp/build/src/main.py && printf 'Laden 1.0\n' > /tmp/build/src/VERSION && cat /tmp/build/src/VERSION"Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Zweimal packen, eine Stunde auseinander
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"Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Die Zeiten im Archiv lesen
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 -"Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Eine Stunde änderte den ganzen Hash
Der erste Befehl gibt Laden 1.0 aus. Der zweite gibt zwei Hashes aus: Einer beginnt mit db986909, der andere mit 02b72b85. Der Inhalt der beiden Dateien blieb gleich.
Der dritte listet das Archiv. Jede Zeile zeigt die Rechte der Datei, ihren Besitzer, ihre Größe und ihre Zeit, 2024-03-01 10:00:00. Das Archiv speichert diese Zeit, also ergibt eine neue Zeit ein neues Archiv.
Ein häufiger Fehler
Warnung
Viele glauben, derselbe Quellcode ergebe immer dieselbe Datei. Das stimmt erst, wenn jede Eingabe festliegt: Zeiten, Reihenfolge, Pfade und Werkzeuge. Nennen Sie einen Build erst reproduzierbar, wenn zwei getrennte Builds denselben Hash liefern.
Beispiel: warum zwei Builds sich unterscheiden
| Ursache | Beispiel | Übliche Abhilfe |
|---|---|---|
| Zeiten | Jede Datei merkt sich ihre letzte Änderung | Alle Zeiten auf SOURCE_DATE_EPOCH setzen |
| Reihenfolge | Der Ordner liefert die Dateien anders sortiert | Die Namen vor dem Packen sortieren |
| Build-Pfad | Das Archiv speichert /home/anna/laden oder /tmp/laden | Relative Namen aus dem Ordner heraus packen |
| Spracheinstellung | Eine Einstellung sortiert Großbuchstaben zuerst, eine andere nicht | Mit LC_ALL=C sortieren |
| Versionen | Die nächste Installation holt eine neuere Bibliothek | Jede Version in einer Lock-Datei festlegen |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Zeit und Reihenfolge festlegen
SOURCE_DATE_EPOCH ist eine verbreitete Vereinbarung: Ein Build-Werkzeug, das die Variable sieht, nimmt diese Zeit statt der Uhr. Viele Compiler und Packprogramme lesen sie schon. Hier setzt das Skript jede Datei mit touch auf diese Zeit.
Auch die Reihenfolge zählt. Der nächste Befehl packt dieselben Dateien mit derselben Zeit, einmal in jeder Reihenfolge. Danach schreiben Sie ein kleines Skript, das die Namen zuerst sortiert.
Dieselben Dateien, andere Reihenfolge
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"Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ein Build-Skript, das beides behebt
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"Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Mit SOURCE_DATE_EPOCH bauen
docker exec -e SOURCE_DATE_EPOCH=1709283600 app sh /tmp/build/build.shHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Jede Datei anfassen, dann neu bauen
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"Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Zwei Builds, ein Hash
Der Befehl zur Reihenfolge gibt 02b72b85 und dann e7043877 aus: gleiche Bytes, gleiche Zeiten, andere Reihenfolge. Der Befehl zum Skript zeigt dessen drei Zeilen.
Beide Builds geben danach einen Hash aus, der mit 6d2160b9 beginnt, obwohl der zweite jede Datei vorher auf die aktuelle Zeit gesetzt hat. LC_ALL=C sort stellt VERSION vor main.py, weil diese Einstellung Großbuchstaben zuerst sortiert. Deshalb wird auch die Sprache festgelegt.
Ein Byte genügt, um den Hash zu ändern
import hashlib
# Ändern Sie die 2 in zweites zu einer 3 und führen Sie den Block aus.
erstes = b"print(42)\n"
zweites = b"print(42)\n"
print(hashlib.sha256(erstes).hexdigest()[:16])
print(hashlib.sha256(zweites).hexdigest()[:16])
print("gleicher Build:", hashlib.sha256(erstes).digest() == hashlib.sha256(zweites).digest())
Der Herkunftsnachweis sagt, wie gebaut wurde
Einen Build nachzubauen ist eine Prüfung. Der Herkunftsnachweis ist eine andere: ein Protokoll, welcher Quellcode, welcher Commit und welcher Build eine Datei erzeugt hat. Ein von der Build-Plattform signiertes Protokoll heißt Attestierung.
SLSA, Supply-chain Levels for Software Artifacts, ist ein offenes Rahmenwerk, das abstuft, wie weit Sie diesem Protokoll trauen können. Sein Teil zum Build hat drei Stufen.
Beispiel: die Build-Stufen von SLSA
| Stufe | Was sie verlangt | Wogegen sie hilft |
|---|---|---|
| Build L1 | Ein Herkunftsnachweis existiert und beschreibt, wie die Datei gebaut wurde | Fehler und nicht zu wissen, woher ein Release stammt |
| Build L2 | Eine gehostete Build-Plattform erstellt und signiert den Nachweis | Änderungen an Datei oder Nachweis nach dem Build |
| Build L3 | Eine gehärtete Plattform trennt Builds und hält den Signaturschlüssel von den Build-Schritten fern | Manipulation während des Builds, auch durch einen Build-Schritt |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Signatur und SBOM runden das Bild ab
Eine Signatur zeigt, wer eine Datei veröffentlicht hat. Sigstore ist dafür ein freier, öffentlicher Dienst. Sein Werkzeug cosign signiert ein Container-Image oder eine Datei. Es nutzt ein kurzlebiges Zertifikat, das an ein Konto gebunden ist, und trägt die Signatur in ein öffentliches Protokoll ein. Dieses Lab hat kein cosign, Sie lesen hier also nur davon.
Eine SBOM listet jeden Bestandteil und jede Version eines Produkts. Erscheint eine Warnung, durchsuchen Sie die SBOMs, statt zu raten.