BEWERTIQ

Supply-Chain-Angriffe: So schützt du dein Projekt vor manipulierten Paketen

TL;DR: Ein Angreifer muss deine Software nicht direkt knacken. Es reicht, eine Abhängigkeit zu manipulieren, die du ohnehin installierst. Mit festen Versionen, Hash-Prüfung über das Lockfile, überprüften Updates und minimalen Rechten in der CI lässt sich das Risiko deutlich senken.

Das Problem

Moderne Projekte stützen sich auf Hunderte kleiner Pakete. Jedes davon ist ein Vertrauensvorschuss an seine Maintainer, ihre Zugangsdaten und ihre Build-Umgebung. Wird ein Paket manipuliert, landet der Schadcode bei allen, die die neue Version installieren.

Bekannte Fälle zeigen das Muster. Beim Fall CVE-2024-3094 wurde eine Hintertür in das weit verbreitete Compression-Paket xz eingeschleust. Der Angreifer baute dafür über rund zwei Jahre Vertrauen im Projekt auf und wurde selbst Maintainer.

Maßnahme 1: Lockfile verwenden und ernst nehmen

Das Lockfile legt für jede Abhängigkeit Version und Hash fest. Installiere mit npm ci statt npm install: Der Befehl hält sich strikt an das Lockfile und bricht ab, wenn es nicht passt.

  • Lockfile immer committen
  • Diffs im Lockfile in Code-Reviews prüfen, nicht nur den Quellcode
  • Keine Versionsbereiche wie ^ für kritische Pakete ohne Grund

Maßnahme 2: Install-Skripte kontrollieren

Viele Pakete führen beim Installieren eigene Skripte aus. Mit npm ci --ignore-scripts läuft nichts davon automatisch. Wo Skripte nötig sind, erlaubst du sie gezielt.

Maßnahme 3: Updates langsam und geprüft einführen

Automatische Update-Bots sind praktisch, aber sie übernehmen Änderungen sofort. Setze eine Wartezeit für neue Versionen, bündle Updates und lass sie wie jeden anderen Code durch Review und Tests laufen.

Maßnahme 4: CI mit minimalen Rechten betreiben

Ein Build braucht selten Schreibrechte auf das Repository. Setze in GitHub Actions den Standard für das GITHUB_TOKEN auf Lesezugriff und erhöhe ihn nur für Jobs, die es brauchen. Pinne Actions auf einen vollständigen Commit-Hash statt auf eine bewegliche Versionsnummer.

Die GitHub-Dokumentation beschreibt dazu die Grundsätze im Detail: Security-Hardening für GitHub Actions.

Maßnahme 5: Herkunft nachweisen

Mit Build-Provenance lässt sich belegen, aus welchem Quellcode und mit welchem Build-Prozess ein Artefakt entstanden ist. Das Framework SLSA ordnet diese Schutzmaßnahmen in aufsteigende Stufen ein. Wer selbst veröffentlicht, sollte mindestens Provenance aktivieren.

Fazit

Die wirksamsten Schritte sind einfach: Lockfile committen, mit npm ci installieren, Install-Skripte prüfen, Updates bewusst einspielen und CI-Rechte knapp halten. Keine Maßnahme schützt vollständig, zusammen aber machen sie einen Angriff deutlich teurer.

Ressourcen