~/blog/2025/09/shai-hulud-ein-wurm-im-npm-oekosys.md

Shai-Hulud: Ein Wurm im npm-Ökosystem

6 min
Beitragsbild: Shai-Hulud: Ein Wurm im npm-Ökosystem

Keine Zeit? Hier die Kurzversion in 30 Sekunden.

  • Am 8. September 2025 wurde ein bekannter npm-Maintainer per Phishing übernommen; kurzzeitig gab es manipulierte Versionen von Paketen wie chalk und debug, die Krypto-Transaktionen im Browser umleiten sollten.
  • Mitte September folgte der selbstverbreitende Wurm „Shai-Hulud“: Er stahl mit TruffleHog Zugangsdaten und infizierte mit gestohlenen npm-Tokens weitere Pakete der Opfer.
  • Betroffen waren hunderte Pakete; die gestohlenen Daten landeten in öffentlichen GitHub-Repositories.
  • GitHub kündigte strengere Regeln an: 2FA-Pflicht, kurzlebige granulare Tokens, Trusted Publishing, Abschaffung klassischer Tokens.
  • Gegenmittel: Lockfiles, Install-Skripte abschalten, Secrets in CI minimieren, Provenance prüfen, neue Versionen verzögert übernehmen.

Das Wort „Wurm“ hatte ich lange in der Schublade für Geschichten von früher. Die Sorte, die sich über E-Mail-Anhänge und offene Netzwerkdienste verbreitet hat und die man nur noch in Rückblicken liest. Im September 2025 ist das Wort im Entwickleralltag zurückgekehrt, mit einem Namen aus einem Wüstenroman: Shai-Hulud, so heißen dort die riesigen Sandwürmer. Ein passender Name für etwas, das sich unter der Oberfläche durch ein Ökosystem frisst.

Ich schreibe das ein paar Wochen nach dem ersten Vorfall, mit etwas Abstand. Die Details sind nicht in jedem Punkt geklärt, und genaue Zahlen betroffener Pakete möchte ich nicht nennen, weil ich sie nicht sicher weiß. Gesichert ist der Ablauf, und der ist lehrreich genug.

Erst die Phishing-Mail

Der Anfang war unspektakulär. Am 8. September 2025 bekam ein bekannter Maintainer eine E-Mail, die aussah, als käme sie vom npm-Support, mit einer gefälschten, aber täuschend ähnlichen Domain. Er gab dort seine Zugangsdaten ein, und damit hatten die Angreifer sein Konto. Wer jemals auf einen Link in einer Mail geklickt hat, weil sie in einem müden Moment kam, kann nachvollziehen, wie das passiert.

Danach erschienen kurzzeitig manipulierte Versionen sehr verbreiteter Pakete, darunter chalk und debug. Das sind Bibliotheken, die in unzähligen Projekten stecken, oft nicht direkt, sondern tief in den Abhängigkeiten. Der eingeschleuste Code zielte auf den Browser und sollte Krypto-Transaktionen umleiten. Die Versionen wurden innerhalb weniger Stunden entfernt. Dass es dabei „nur“ um Kryptowährung ging, ist ein Glücksfall der Zielwahl, nicht der Reichweite: Die Pakete hätten mit demselben Zugang etwas ganz anderes tun können.

Dann der Wurm

Mitte September folgte etwas Neues. Unter dem Namen Shai-Hulud tauchte Schadcode auf, der sich selbst weiterverbreitete. Der Ablauf, soweit bekannt: Läuft der Code auf einem Rechner, sucht er mit dem Werkzeug TruffleHog nach Geheimnissen. Das ist ein legitimes Tool, mit dem man normalerweise Repositories auf versehentlich eingecheckte Zugangsdaten prüft. Hier wurde es umgedreht. Gefunden wurden npm-Tokens, GitHub-Tokens und Cloud-Schlüssel aus Entwicklerumgebungen und CI-Systemen.

Zwei Dinge geschahen dann mit der Beute. Erstens wurde sie in GitHub-Repositories veröffentlicht, die nach dem Wurm benannt waren, öffentlich einsehbar für jeden. Zweitens nutzte der Schadcode die gestohlenen npm-Tokens, um weitere Pakete der Opfer zu infizieren. Wer ein Paket pflegt und sich ansteckt, verbreitet den Wurm damit an alle, die dieses Paket einsetzen. So wächst eine solche Sache exponentiell, und deshalb sprach man bald von hunderten betroffenen Paketen, ohne dass ich eine belastbare Zahl wiedergeben könnte.

Dass die Geheimnisse öffentlich landeten, hat einen bitteren Nebeneffekt: Wer betroffen war, konnte nicht hoffen, dass die Daten nur bei einem unbekannten Angreifer liegen. Sie waren für alle erreichbar. Die Konsequenz lautet, jede Zugangsdaten-Art, die auf einem betroffenen System lag, als kompromittiert zu behandeln und zu erneuern.

Was mich an der Geschichte besonders beschäftigt, ist die Asymmetrie. Für den Angreifer reicht es, ein einziges Konto zu übernehmen, das zufällig ein beliebtes Paket betreut. Für die Verteidigung müsste jeder, der dieses Paket einsetzt, sofort reagieren, und die meisten bekommen es gar nicht mit. Wer seine Abhängigkeiten nicht kennt, weiß auch nicht, ob er betroffen ist. In einem normalen Projekt zählt der Abhängigkeitsbaum leicht in die Hunderte Einträge, und kaum jemand hat jeden davon je angesehen. Das ist keine Schande, es ist die Realität, auf die sich die ganze Branche eingelassen hat.

Was GitHub angekündigt hat

Die Reaktion kam schnell. GitHub, zu dem npm gehört, kündigte strengere Regeln an. Die Eckpunkte: Zwei-Faktor-Authentifizierung wird beim lokalen Veröffentlichen verpflichtend, Tokens bekommen eine kürzere Gültigkeit und werden granular, ältere klassische Tokens sollen verschwinden, und „Trusted Publishing“ soll gefördert werden. Beim Trusted Publishing veröffentlicht nicht ein langlebiger Token, sondern die CI-Umgebung selbst, die sich über ein kurzlebiges Identitätsverfahren ausweist. Ein Token, das nicht existiert, kann nicht gestohlen werden.

Ich halte das für die richtige Richtung. Gleichzeitig ist es der übliche Zielkonflikt: Jede dieser Maßnahmen macht es für einzelne Maintainer, oft Freiwillige, umständlicher. Ein Ökosystem, das auf unbezahlter Arbeit einzelner Personen beruht, hat eine Sicherheitsgrenze, die so stark ist wie das müdeste Konto darin. Das wussten wir spätestens seit dem Vorfall mit left-pad im Jahr 2016, bei dem ein einziges kleines Paket Builds weltweit lahmgelegt hat. Damals ging es um Ärger und Verfügbarkeit, heute geht es um Vertrauen.

Dazu passt eine Beobachtung, die mir unangenehm ist: Gerade die besonders bequemen Wege sind die gefährlichen. Ein Token, das monatelang auf dem Laptop liegt, damit man nicht jedes Mal eine Anmeldung durchlaufen muss. Ein CI-Job, der mit einem Schlüssel läuft, der alles darf, weil man sich das Feintuning der Rechte gespart hat. Beides habe ich selbst schon so gemacht, und beides ist der Stoff, aus dem so ein Wurm sein Futter bezieht.

Es betrifft nicht nur JavaScript

Man kann das als Problem der JavaScript-Welt abtun, mit ihren tiefen Abhängigkeitsbäumen und winzigen Paketen. Ich halte das für zu bequem. Dieselbe Mechanik gibt es überall, wo Pakete aus Registries nachgeladen werden, in Maven genauso wie bei NuGet oder PyPI. Die Zahl der Abhängigkeiten ist in JavaScript besonders hoch, aber das Prinzip ist universell. Und wer ein Frontend in einem Java- oder .NET-Projekt baut, hat npm sowieso im Build.

Auch die Muster sind bekannt. Beim Codecov-Vorfall 2021 wurde ein Skript manipuliert, das Build-Server ausführten, und es nahm Umgebungsvariablen mit. 2024 kam xz hinzu, wo ein Angreifer über lange Zeit Vertrauen als Maintainer aufgebaut hat. Shai-Hulud ergänzt eine weitere Variante: Der Angriff nutzt die Entwickler selbst als Verbreitungsweg. Alle drei laufen auf dasselbe hinaus. Wir führen fremden Code aus, den wir nicht gelesen haben, in Umgebungen, in denen Geheimnisse liegen.

Was ich mir vornehme

Hilft jetzt nur Misstrauen? Nein, aber ein paar Gewohnheiten, die den Schaden begrenzen:

  • Lockfiles verwenden und prüfen. Im CI mit npm ci bauen, nicht mit npm install, und Änderungen an der Lockdatei im Review ansehen.
  • Install-Skripte abschalten. Viele Angriffe laufen über postinstall. Mit npm ci --ignore-scripts oder ignore-scripts=true in der .npmrc entfällt dieser Weg, auch wenn dafür einzelne Pakete mit nativen Teilen eine Ausnahme brauchen.
  • Secrets in CI minimieren. Ein Build-Job braucht nicht alles. Kurzlebige Zugangsdaten statt dauerhafter Schlüssel, und kein Token mit Schreibrechten, wo ein lesendes genügt.
  • Provenance und Signaturen beachten. Mit npm audit signatures lassen sich Signaturen und Herkunftsnachweise prüfen. Das ist kein Schutz vor allem, aber ein Indiz.
  • Neue Versionen nicht sofort übernehmen. Manipulierte Versionen wurden meist innerhalb von Stunden entfernt. Eine Verzögerung von ein paar Tagen vor dem Update fängt viel davon ab.

Nichts davon ist neu, und trotzdem habe ich es bei mir selbst nur teilweise umgesetzt. Die Verzögerung bei Updates, zum Beispiel, steht im Konflikt mit dem Wunsch, Sicherheitsupdates schnell einzuspielen. Dafür gibt es keine saubere Regel, nur eine Abwägung.

Wie haltet ihr es mit Install-Skripten und CI-Secrets? Mich würde interessieren, ob jemand die Verzögerung bei Updates schon systematisch eingeführt hat.

Beitragsbild: Foto Sanddünen, Sahara von Vyacheslav Argenberg, CC BY 4.0 (via Wikimedia Commons; zugeschnitten auf 16:9).

$ whoami
Christian Ackermann

Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.