Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

Reproduzierbare Builds und Herkunft der Software

Nach dieser Lektion: Ich kann prüfen, ob ein Build reproduzierbar ist.

Lektion, 60 Min.7 BefehleSQL-Injection-Lab: eine schwache Shop-Suche angreifen, die Abfrage reparieren und die Reparatur belegen

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

BegriffWas er bedeutetBeispiel
Reproduzierbarer Buildein Build, der aus demselben Quellcode jedes Mal dieselben Bytes liefert
Hashein kurzer Fingerabdruck von Bytes, der sich bei jedem geänderten Byte ändertsha256sum
SOURCE_DATE_EPOCHeine feste Zeit in Sekunden seit 1970, die ein Build statt der Uhr nimmtSOURCE_DATE_EPOCH=1709283600
Herkunftsnachweisein Protokoll, was aus welchem Quellcode mit welchem Build entstand; auf Englisch Provenance
Signaturein Nachweis mit einem Schlüssel, dass eine Datei von jemandem stammt und unverändert ist
SBOMeine 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

Befehl
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

Befehl
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

Befehl
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

UrsacheBeispielÜbliche Abhilfe
ZeitenJede Datei merkt sich ihre letzte ÄnderungAlle Zeiten auf SOURCE_DATE_EPOCH setzen
ReihenfolgeDer Ordner liefert die Dateien anders sortiertDie Namen vor dem Packen sortieren
Build-PfadDas Archiv speichert /home/anna/laden oder /tmp/ladenRelative Namen aus dem Ordner heraus packen
SpracheinstellungEine Einstellung sortiert Großbuchstaben zuerst, eine andere nichtMit LC_ALL=C sortieren
VersionenDie nächste Installation holt eine neuere BibliothekJede 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

Befehl
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

Befehl
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

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

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Jede Datei anfassen, dann neu bauen

Befehl
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

Code: python
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

StufeWas sie verlangtWogegen sie hilft
Build L1Ein Herkunftsnachweis existiert und beschreibt, wie die Datei gebaut wurdeFehler und nicht zu wissen, woher ein Release stammt
Build L2Eine gehostete Build-Plattform erstellt und signiert den NachweisÄnderungen an Datei oder Nachweis nach dem Build
Build L3Eine gehärtete Plattform trennt Builds und hält den Signaturschlüssel von den Build-Schritten fernManipulation 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.

Über dieses Lab und seinen Quellcode: SQL-Injection-Lab: eine schwache Shop-Suche angreifen, die Abfrage reparieren und die Reparatur belegen

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.