npm install unter der Lupe: Wie Angreifer die Lieferkette kapern

Auflösung, Lockfile, Installationsskripte: Wo beim Installieren fremder Code mitläuft und welche Einstellungen das begrenzen
Aktualisiert:
Abstract
- #Supply-Chain-Angriffe
- #npm
- #Sicherheit
- #Software-Lieferkette
- #Lifecycle-Skripte
- #Typosquatting
- #Dependency Confusion
- #qix
- #Shai-Hulud
- #Nx
Ein Befehl, Hunderte fremde Pakete: Warum jedes npm install eine Vertrauensentscheidung ist
Angenommen, eine neue Kollegin klont am ersten Arbeitstag das Repository des Firmen-Webshops und tippt npm install. In der package.json stehen vielleicht zwei Dutzend Abhängigkeiten. Nach einer halben Minute liegen im Ordner node_modules jedoch mehrere Hundert Pakete von Menschen, die niemand im Team kennt. Einige davon haben während der Installation bereits Programme gestartet, und zwar mit allen Rechten der Kollegin: Zugriff auf ihr Home-Verzeichnis, auf gespeicherte Zugangsdaten und auf das Netzwerk.
Das ist kein Konstruktionsfehler, sondern so gewollt. Genau deshalb ist npm install für Angreifer so attraktiv. Wer ein einziges beliebtes Paket manipuliert, erreicht auf einen Schlag Tausende Entwicklungsrechner und Build-Server. Die Angriffe der Jahre 2025 und 2026 haben gezeigt, dass das kein theoretisches Szenario ist. Wer versteht, was bei der Installation in welcher Reihenfolge passiert, erkennt auch, an welchen Stellen sich die Tür schließen lässt.
Was bei npm install der Reihe nach passiert
Hinter dem kurzen Befehl stecken vier Arbeitsschritte. Jeder davon ist eine eigene Angriffsfläche.
Schritt 1: Versionen auflösen
In der package.json stehen meist keine festen Versionen, sondern Bereiche. ^4.2.0 bedeutet etwa: jede Version ab 4.2.0, solange die Hauptversion 4 bleibt. npm fragt bei der Registry, dem zentralen Paketverzeichnis unter registry.npmjs.org, welche Versionen es gibt, und wählt die höchste passende. Das wiederholt sich für jede Abhängigkeit der Abhängigkeit. So entsteht ein Baum, dessen weitaus größter Teil aus sogenannten transitiven Abhängigkeiten besteht: Paketen, die Sie nie selbst ausgewählt haben.
Der Knackpunkt: Erscheint heute Nachmittag eine neue Version 4.2.1, bekommt sie jeder, der danach ohne Lockfile installiert. Für einen Angreifer, der diese Version veröffentlicht hat, ist das der Verteilmechanismus.
Schritt 2: Das Lockfile festschreiben
Die Datei package-lock.json hält das Ergebnis der Auflösung fest: für jedes Paket die exakte Version, die Download-Adresse und einen Prüfwert (integrity, meist ein SHA-512-Hash). Liegt ein Lockfile vor und passt es zur package.json, installiert npm genau diese Versionen. Passen die Versionsbereiche der package.json nicht mehr zu den festgehaltenen Versionen oder fehlt das Lockfile, löst npm neu auf und schreibt die Datei um. Ein Lockfile ist damit so etwas wie die Stückliste einer Maschine: Solange sie gilt, wird nichts Unbekanntes eingebaut.
Schritt 3: Herunterladen und prüfen
npm lädt die Pakete als komprimierte Archive herunter und vergleicht sie mit dem Prüfwert aus dem Lockfile. Das schützt vor Manipulation auf dem Transportweg oder in einem Zwischenspeicher. Es schützt nicht vor einer bösartigen Version, die regulär veröffentlicht wurde. Deren Prüfwert stimmt, denn er wurde aus genau diesem Archiv berechnet.
Schritt 4: Lifecycle-Skripte ausführen
Nach dem Entpacken führt npm die Lifecycle-Skripte der Pakete aus. Gemeint sind Befehle, die ein Paketautor in seiner package.json unter den Namen preinstall, install und postinstall hinterlegt. Gedacht sind sie etwa dafür, eine Bibliothek in C oder C++ für das eigene Betriebssystem zu übersetzen oder eine passende Binärdatei nachzuladen. Liegt eine Datei binding.gyp im Paket, startet npm sogar ohne eigenen Eintrag automatisch node-gyp rebuild.
Diese Skripte sind gewöhnliche Programme. Sie laufen mit den Rechten des Benutzers, der installiert, und sehen dessen Umgebungsvariablen. Auf einem Build-Server stehen dort oft Tokens für die Registry, für GitHub oder für die Cloud. Ein manipuliertes postinstall braucht also keine Sicherheitslücke, um an diese Daten zu kommen. Es fragt einfach danach.
Vier Angriffsmuster, die Sie kennen sollten
Die meisten Vorfälle der vergangenen Jahre lassen sich auf wenige Grundmuster zurückführen. Sie unterscheiden sich darin, wie der Schadcode in Ihren Abhängigkeitsbaum gelangt.
Typosquatting: der Tippfehler als Einfallstor
Beim Typosquatting veröffentlichen Angreifer Pakete, deren Namen bekannten Paketen zum Verwechseln ähneln: ein vertauschter Buchstabe, ein zusätzlicher Bindestrich, ein Zusatz wie -js. Wer sich vertippt, installiert das Imitat. Eine neuere Spielart setzt auf KI-Assistenten, die gelegentlich Paketnamen erfinden. Registriert jemand einen solchen erfundenen Namen, landet der Schadcode bei allen, die dem Vorschlag ungeprüft folgen. Wie Sie ein Paket vor dem ersten Einsatz bewerten, beschreibt der Beitrag npm-Pakete sicher prüfen.
Übernommene Maintainer-Konten
Wirkungsvoller ist es, ein Paket zu kapern, dem bereits alle vertrauen. Dafür brauchen Angreifer die Zugangsdaten eines Maintainers, also einer Person, die ein Paket pflegt und veröffentlichen darf. Phishing, gestohlene Tokens oder ein übernommenes E-Mail-Konto reichen aus. Die manipulierte Version stammt dann aus dem echten Konto und unterscheidet sich äußerlich durch nichts von einem regulären Update.
Schadcode im Installationsskript
Unabhängig vom Einfallstor nutzen viele Angriffe die Lifecycle-Skripte als Zünder. Der Vorteil für den Angreifer: Der Code läuft, sobald die Installation durch ist, und nicht erst, wenn die Anwendung das Paket irgendwann lädt. Ein Testlauf in der Pipeline genügt, um Zugangsdaten abzugreifen.
Dependency Confusion: der Name aus dem Firmennetz
Viele Unternehmen betreiben eine interne Registry für eigene Pakete, etwa webshop-utils. Ist npm so eingerichtet, dass es zusätzlich die öffentliche Registry fragt, kann ein Angreifer dort ein Paket mit genau diesem Namen und einer sehr hohen Versionsnummer veröffentlichen. Je nach Konfiguration gewinnt die höhere Version, und der Build-Server holt das fremde Paket. Der Sicherheitsforscher Alex Birsan machte das Muster 2021 bekannt, als er auf diesem Weg Code in die Build-Systeme mehrerer großer Konzerne einschleusen konnte, mit deren Erlaubnis über Bug-Bounty-Programme oder eigene Vereinbarungen.
Zwei Fälle aus dem Jahr 2025
chalk und debug: Phishing gegen einen Maintainer
Am 8. September 2025 erhielt der Maintainer mit dem Kürzel Qix eine E-Mail, die angeblich vom npm-Support kam und ihn aufforderte, seine Zwei-Faktor-Authentifizierung zu erneuern. Die Absenderdomain lautete npmjs.help, nicht npmjs.com. Über die gefälschte Seite gelangten die Angreifer an sein Konto und veröffentlichten manipulierte Versionen weit verbreiteter Pakete, darunter chalk@5.6.1 und debug@4.4.2. Der Schadcode zielte auf Webanwendungen, die diese Pakete in ihren Browsercode übernahmen: Er manipulierte Kryptowährungs-Transaktionen und leitete Zahlungen auf Adressen der Angreifer um.
Lehrreich ist der Fall aus zwei Gründen. Erstens stammten die Versionen aus dem echten Konto, keine Signaturprüfung hätte angeschlagen. Zweitens arbeitete der Schadcode ohne Installationsskript. Wer Skripte abgeschaltet hatte, war nicht geschützt. Geschützt war, wer ein Lockfile mit den älteren Versionen hatte und in diesem Zeitraum nicht neu auflöste.
Shai-Hulud: ein Wurm, der sich selbst veröffentlicht
Wenige Tage später, Mitte September 2025, tauchte Shai-Hulud auf. Der Schadcode lief über ein Installationsskript, durchsuchte den Rechner nach npm- und GitHub-Tokens sowie Cloud-Zugangsdaten und veröffentlichte mit erbeuteten npm-Tokens infizierte Versionen weiterer Pakete der Opfer. Damit verbreitete er sich ohne weiteres Zutun der Angreifer. Im November 2025 folgte eine zweite Welle, die schon im preinstall-Schritt ansetzte. Den Ablauf im Detail erklärt der Beitrag Shai-Hulud 2.0 einfach erklärt.
Wenn die Pipeline zum Ziel wird: Nx und TanStack
Neben den Rechnern der Entwickler rücken die CI/CD-Pipelines in den Fokus, also die automatisierten Abläufe, die Software bauen, testen und veröffentlichen. Wer dort eindringt, kann im Namen eines Projekts veröffentlichen.
Im August 2025 traf es das Build-Werkzeug Nx. Ein GitHub-Actions-Workflow, der mit dem Auslöser pull_request_target lief, übernahm ungeprüft Text aus Pull-Requests in einen Shell-Befehl. Darüber gelangten Angreifer an ein Token zum Veröffentlichen und brachten manipulierte Nx-Versionen in Umlauf. Deren postinstall-Skript suchte nach Zugangsdaten und spannte dafür sogar auf dem Rechner installierte KI-Kommandozeilenwerkzeuge ein.
Im Mai 2026 wurden Pakete des TanStack-Projekts kompromittiert, obwohl es bereits auf Trusted Publishing setzte. Bei diesem Verfahren erhält die Pipeline für jede Veröffentlichung ein kurzlebiges Token über OpenID Connect (OIDC), ein dauerhaft gespeichertes Token gibt es nicht mehr. Die Angreifer lasen das kurzlebige Token nach den veröffentlichten Analysen während des Build-Laufs aus dem Speicher und veröffentlichten innerhalb von sechs Minuten 84 manipulierte Versionen in 42 Paketen. Die Lehre daraus: Trusted Publishing beseitigt gestohlene Langzeit-Tokens als Risiko, aber nicht eine kompromittierte Pipeline.
Das Installieren absichern
Die folgenden Maßnahmen setzen dort an, wo npm install arbeitet. Keine davon ist für sich allein ausreichend, zusammen machen sie die meisten der beschriebenen Angriffe deutlich schwerer.
Lockfile verbindlich machen
Das Lockfile gehört ins Repository, und Änderungen daran verdienen im Code-Review denselben Blick wie Quellcode. In Pipelines und Docker-Builds ersetzt npm ci den Befehl npm install: Es installiert ausschließlich, was im Lockfile steht, und bricht ab, wenn Lockfile und package.json nicht zusammenpassen. Eine frisch veröffentlichte, manipulierte Version rutscht so nicht unbemerkt in den Build. Wie Sie Abhängigkeiten danach geordnet aktualisieren, ohne neue Risiken einzukaufen, ist Thema des Beitrags JavaScript-Pakete sicher aktualisieren.
Zusätzlich kennt npm seit Version 11.10 die Einstellung min-release-age. Sie sorgt dafür, dass bei der Auflösung nur Versionen infrage kommen, die schon eine bestimmte Zahl von Tagen veröffentlicht sind. Viele der bekannten Schadversionen wurden innerhalb von Stunden entdeckt und entfernt, eine Wartezeit von wenigen Tagen fängt sie also ab.
Installationsskripte nur nach Freigabe
Mit npm ci --ignore-scripts oder dauerhaft über die Projektdatei .npmrc unterbinden Sie, dass Pakete beim Installieren Programme starten:
# .npmrc im Projektverzeichnis
ignore-scripts=true
min-release-age=3
npm 12, erschienen im Juli 2026, geht einen Schritt weiter. Skripte von Abhängigkeiten sind dort standardmäßig blockiert, es sei denn, das Projekt gibt sie im Feld allowScripts der package.json frei, zum Beispiel über npm install-scripts approve <paket>. Beachten Sie aber, dass die LTS-Versionen Node.js 24 und 26 noch npm 11 mitbringen, das bei fehlender Freigabe nur warnt. Node.js 22, noch bis zum 30. April 2027 im LTS-Support, liefert npm 10.9.9 aus, das weder min-release-age noch allowScripts kennt. Wer den strengen Standard will, aktualisiert npm gezielt oder setzt die Einstellung selbst. pnpm verhält sich seit Version 10 ähnlich und führt Skripte von Abhängigkeiten nur nach Freigabe aus.
Pakete, die ihre Skripte wirklich brauchen, etwa für native Erweiterungen, geben Sie einzeln frei und bauen sie nach. Bei global gesetztem ignore-scripts gelingt das mit npm rebuild <paket> --ignore-scripts=false. So bleibt die Liste der Pakete, die beim Installieren Code ausführen dürfen, kurz und sichtbar.
Die Registry eindeutig festlegen
Gegen Dependency Confusion hilft eine klare Zuordnung: Interne Pakete bekommen einen eigenen Scope, also ein Namenspräfix wie @firma/, und dieser Scope wird fest an die interne Registry gebunden:
# .npmrc: interne Pakete nur aus der Firmen-Registry
@firma:registry=https://npm.intern.example.com/
registry=https://registry.npmjs.org/
Sichern Sie den Scope zusätzlich auf npmjs.com als Organisation, damit niemand dort Pakete unter Ihrem Präfix veröffentlichen kann. Wer eine Proxy-Registry wie Verdaccio oder Artifactory einsetzt, sollte dort festlegen, dass interne Namen nie aus der öffentlichen Quelle nachgeladen werden.
Herkunft prüfen
Pakete, die über Trusted Publishing aus einem öffentlichen Repository oder mit der Option --provenance veröffentlicht wurden, tragen einen Herkunftsnachweis: eine signierte Angabe, aus welchem Repository und welchem Workflow das Archiv stammt. Mit npm audit signatures prüfen Sie nach der Installation, ob die Registry-Signaturen und vorhandenen Herkunftsnachweise Ihrer Abhängigkeiten gültig sind. Der Nachweis sagt allerdings nur, wo ein Paket gebaut wurde, nicht ob sein Inhalt harmlos ist. Der TanStack-Fall zeigt, dass auch eine echte Pipeline Schadcode ausliefern kann.
Installation von Geheimnissen trennen
Ein Installationsskript kann nur stehlen, was es vorfindet. Installieren Sie in Pipelines in kurzlebigen Umgebungen, etwa frischen Containern, und stellen Sie Tokens erst in dem Schritt bereit, der sie wirklich braucht, nicht schon beim Installieren. Wo es möglich ist, begrenzen Sie ausgehende Verbindungen während der Installation auf die Registry. Auf Entwicklungsrechnern gehören langlebige Cloud-Schlüssel nicht unverschlüsselt ins Home-Verzeichnis.
Was das für Ihr Team bedeutet
Die wichtigste Einsicht ist unspektakulär: npm install ist kein passives Herunterladen, sondern das Ausführen fremden Codes mit den eigenen Rechten. Die Gegenmittel sind bekannt und kosten wenig. npm ci in jeder Pipeline, ein gepflegtes Lockfile und abgeschaltete Installationsskripte mit kurzer Freigabeliste schließen die meisten Lücken, die 2025 ausgenutzt wurden. Ein fest zugeordneter Scope erledigt Dependency Confusion fast vollständig.
Überschätzt wird dagegen, was einzelne Werkzeuge leisten. Weder Signaturen noch Herkunftsnachweise noch Sicherheitsscanner erkennen zuverlässig eine Version, die aus dem echten Konto eines Maintainers stammt. Die npm-Plattform hat nach den Vorfällen nachgeschärft: Klassische Tokens wurden Ende 2025 abgeschafft, schreibende Tokens sind zeitlich begrenzt, und npm 12 blockiert Installationsskripte standardmäßig. Das verschiebt die Kosten für Angreifer, ersetzt aber keine eigene Konfiguration.
Unsere Empfehlung: Beginnen Sie mit der Pipeline, denn dort liegen die wertvollsten Zugangsdaten und dort lassen sich die Regeln zentral durchsetzen. Einen breiteren Überblick, der auch das Veröffentlichen eigener Pakete einschließt, gibt der Beitrag npm-Sicherheit: Abhängigkeiten und Pakete absichern. Wer Sicherheitsfragen schon beim Entwurf von Build- und Lieferprozessen mitdenken möchte, findet Beratung und Seminare auf unserer Themenseite Security by Design.
Häufige Fragen zu npm install und Lieferkettenangriffen
Schützt --ignore-scripts vor allen Angriffen über npm?
Nein. Es verhindert nur, dass Code während der Installation startet. Schadcode, der im Paket selbst steckt, läuft spätestens, wenn Ihre Anwendung oder Ihr Test das Paket lädt. Der Fall chalk und debug kam ganz ohne Installationsskript aus. --ignore-scripts ist deshalb eine wichtige Schicht, aber nur zusammen mit Lockfile und Wartezeit wirksam.
Funktioniert ein Projekt noch, wenn Skripte blockiert sind?
In den meisten Fällen ja. Viele Pakete mit nativen Bestandteilen liefern ihre Binärdateien heute als optionale Abhängigkeiten für jede Plattform aus und brauchen kein Skript. Scheitert ein Build, zeigt die Fehlermeldung meist, welches Paket betroffen ist. Dieses geben Sie gezielt frei und bauen es mit npm rebuild nach.
Reicht es, nur in der Pipeline npm ci zu verwenden?
Die Pipeline ist der wichtigste Ort, aber nicht der einzige. Auch auf Entwicklungsrechnern liegen Tokens und Schlüssel, und ein npm install nach einem Wechsel des Branches löst unter Umständen neu auf. Setzen Sie ignore-scripts und min-release-age deshalb in der .npmrc des Projekts, dann gelten sie für alle, die das Repository klonen.
Was ist zu tun, wenn eine verdächtige Version installiert wurde?
Behandeln Sie alle Zugangsdaten, die auf dem Rechner oder in der Pipeline erreichbar waren, als kompromittiert und tauschen Sie sie aus, beginnend mit npm-, GitHub- und Cloud-Tokens. Prüfen Sie im Lockfile, seit wann die Version im Projekt war, und gleichen Sie sie mit den Sicherheitsmeldungen ab. Ein betroffener Build-Runner wird neu aufgesetzt statt bereinigt.
Kategorien