WPPConnect-Kompromittierung: Veröffentlichte Pakete stahlen Secrets und WhatsApp-Sessions

Nahaufnahme von Netzwerk-Switches und Patchkabeln in einem schwach beleuchteten Serverraum
Deine Reaktion:

Der Angriff auf WPPConnect zeigt eine unbequeme Wahrheit über moderne Lieferketten: Ein Paket kann aus der offiziellen Pipeline stammen, gültige Signaturen besitzen und trotzdem beim ersten Laden schädlichen Code ausführen. Im November 2026 veröffentlichte das Projekt über seine eigenen GitHub-Actions-Workflows vier Versionen, die Secrets, Konfigurationsdateien und WhatsApp-Sessions an einen Telegram-Bot übertrugen. Drei Details sind besonders relevant: Der Schadcode startete bereits beim Import, die npm-Option --ignore-scripts bot daher keinen Schutz, und selbst eine gültige SLSA-Provenienz bestätigte nur die Herkunft des Builds, nicht die Prüfung des Quellcodes.

Für Betreiber von WPPConnect ergibt sich daraus eine klare Folge: Betroffene Versionen dürfen nicht einfach neu installiert werden. Sie müssen gesucht, Images anhand ihrer Digests identifiziert, erreichbare Secrets rotiert und aktive WhatsApp-Sessions abgemeldet werden. Der Schadcode unterdrückte seine eigenen Fehler und begrenzte die Übertragung auf eine Ausführung pro Host und Tag. Das Fehlen einer Marker-Datei ist deshalb kein Entlastungsnachweis.

Was die kompromittierten WPPConnect-Versionen veröffentlichten

Am 15. November 2026 um 23:31 UTC begann npm, die Bibliothek @wppconnect-team/wppconnect in Version 2.4.1 bereitzustellen. Am 16. November um 03:09 UTC folgte @wppconnect/server in Version 2.10.82. Beide Pakete enthielten ein vermeintliches Diagnosemodul, das ausführte, sobald die Bibliothek geladen oder der Server gestartet wurde. Es sammelte sensible Daten aus der Laufzeitumgebung und versuchte, sie an einen fest kodierten Telegram-Bot zu senden.

Das npm-Paket 2.4.1 wurde ungefähr viereinhalb Stunden als latest ausgeliefert. Die registrierten 155 Downloads sind nur ein Mindestwert, weil das Downloadfenster lediglich etwa 28 Minuten des betroffenen Zeitraums abdeckt. Betroffen war außerdem nicht nur die direkte Installation der Bibliothek. Der Server depended transitiv auf die Bibliothek und konnte deren kompromittierte Version automatisch erhalten.

Die Recherchen von StepSecurity umfassten die npm-Registry, die GitHub-API, Actions-Protokolle, das Sigstore-Transparenzlog und Docker Hub. Der Schadcode wurde ausschließlich als Text gelesen und nicht ausgeführt. Wichtig für die Bewertung ist außerdem, dass neben den offiziell gelisteten Versionen weitere Pipeline-Artefakte existieren: Für 2.4.3 und 2.10.83 gibt es erfolgreiche Veröffentlichungsprotokolle beziehungsweise Images, obwohl npm diese Versionen nicht auflistet. Auch 2.4.2 sollte deshalb vorsichtshalber geprüft werden.

Wie der Angriff durch die reguläre Release-Pipeline gelangte

Im Bibliotheks-Repository landeten am 15. November um 22:34 UTC zwei unsignierte Commits ohne Pull Request auf dem Branch master. Einer fügte src/utils/diagnostics.ts hinzu, der andere importierte dieses Modul aus src/controllers/browser.ts. Im Server-Repository wurde am 16. November um 02:43 UTC ein ähnlicher Commit auf main eingespielt. Damit war der bösartige Code Teil des Default-Branches und konnte von den normalen Release-Mechanismen erfasst werden.

Der Angriff nutzte kein separates, offensichtlich fremdes System. Laut dem Bericht handelte das Konto joaosouz4dev. GitHub zeigt damit nur, welches Konto eine Aktion auslöste, nicht wer sie tatsächlich steuerte. Wie der Zugriff erlangt wurde, ist nicht geklärt. Das zentrale Risiko liegt ohnehin in der Rechtekette: Das Konto konnte die bereits vorhandenen Release- und Veröffentlichungsfunktionen des Projekts nutzen.

Bei der Bibliothek wurde der Release-Workflow innerhalb einer Minute manuell gestartet. Er erzeugte einen Release-Commit und ein Version-Tag; der anschließende Publish-Workflow hatte id-token: write und veröffentlicht über die GitHub-Trusted-Publisher-Identität. Im Server-Repository lief release.yml dagegen bei jedem Push auf main. Der Payload-Push löste die Version 2.10.82 daher automatisch aus. Auch 2.10.83 wurde manuell angestoßen. In der entscheidenden Fassung des Bibliotheks-Workflows fehlte ein environment:-Schlüssel, sodass keine Reviewer-Freigabe zwischen Tag und Registry lag.

Warum Signaturen und Provenienz den Angriff nicht verhindert haben

Die kompromittierte Bibliotheksversion wurde über den vertrauten GitHub-Actions-Publisher veröffentlicht und besaß eine gültige SLSA-Provenienz. Die attestierten Angaben stimmten: Der Workflow, Branch, Commit und konkrete Run waren korrekt. Das Problem liegt in einer häufig missverstandenen Sicherheitsgrenze. Provenienz beantwortet die Frage, wo ein Paket gebaut wurde. Sie beantwortet nicht die Frage, ob ein Mensch den Quellcode geprüft und die Freigabe erteilt hat. Der attestierte Commit war gerade der bösartige Commit.

Auch der Trusted-Publisher-Check bestand für beide Veröffentlichungen, während eine Prüfung der Provenienz nur die Server-Version als auffällig markierte, weil für sie keine Attestierung abrufbar war. Beide Prüfungen ließen sich damit durch einen Angriff passieren, der die reguläre Build- und Signaturinfrastruktur verwendete. Wer nur auf Signaturen, OIDC-Identität oder attestierte Workflows setzt, kontrolliert die Herkunft eines Builds, aber nicht die Integrität des committeten Codes.

Zusätzlich wurde die Historie nach der Entdeckung gezielt verändert. Etwa 30 Sekunden nachdem ein externer Forscher zwei öffentliche Issues eröffnet hatte, wurden beide Default-Branches force-pushed. Danach zeigte der Tag v2.4.1 auf einen ähnlich aussehenden Commit ohne Payload. Der auf GitHub sichtbare Quellcode entsprach damit nicht mehr dem, was npm ausgeliefert hatte. Reviewer, die nach der Meldung nur den Tag auf GitHub geprüft hätten, hätten die schädliche Version nicht gefunden.

Was der Schadcode sammelte und exfiltrierte

Das Payload bestand im Wesentlichen aus einer Funktion mit portugiesischen Kommentaren, die sie als Support-Werkzeug tarnten. Die Sammlung umfasste Hostname, Benutzername, Betriebssystem, Node-Version, Arbeitsverzeichnis, Speicherdaten und die öffentliche IP-Adresse. Entscheidend waren anschließend Umgebungsvariablen mit Werteketten von drei bis 499 Zeichen. API-Schlüssel, Datenbank-URLs und Cloud-Zugangsdaten fielen in diese Kategorie. Aus typischen Dateien wie .env, .env.local, .env.production, config.js, config.json und ormconfig.json wurden jeweils die ersten 12.000 Zeichen gelesen.

Außerdem las der Schadcode bis zu fünf JSON-Dateien aus den Verzeichnissen ./tokens/ beziehungsweise ./wppconnect_tokens/. Diese enthielten laut Typdefinition die Session-Struktur der WhatsApp-Web-Schnittstelle: eine Browser-ID, Geheimnisse mit Verschlüsselungs- und MAC-Schlüsseln sowie weitere Tokens. Das sind funktionale Zugangsdaten. Ein Angreifer konnte damit nicht nur einzelne Konfigurationswerte auslesen, sondern die an WhatsApp gebundenen Sessions missbrauchen.

Die Daten wurden als Textdatei mit dem Muster <hostname>_<datum-zeit>.txt über die Telegram-Methode sendDocument an einen fest kodierten Bot und Chat übertragen. Der Bot-Token war im Code in mehrere Fragmente aufgeteilt. Fehler wurden ignoriert, sodass der normale Betrieb weiterlief. Eine Marker-Datei im temporären Systemverzeichnis begrenzte die Übertragung auf einen Versuch pro Host und Tag. Das ist keine Sicherheitsmaßnahme, sondern eine unbeabsichtigte Rauschminderung: Der Marker belegt nur einen Startversuch, und sein Fehlen kann einen Host nicht entlasten.

Die Server-Variante enthielt zusätzliche Verschleierungslogik. Sie kodierte den Telegram-Endpunkt mit Base64, wartete zwischen 30 und 240 Sekunden und versuchte, CI- und Analyseumgebungen anhand von Variablen, Proxy-Adressen und Hostnamen zu erkennen. Die Bibliotheksvariante besaß diese Prüfungen nicht. Eine CI-Pipeline, die nur die Bibliothek importierte, konnte deshalb Secrets aus dem Job übertragen, ohne dass eine erkennbare Verzögerung oder Umgebungserkennung eingegriffen hätte.

Prüfung von npm-Paketen, Lockfiles und Docker-Images

Die Suche muss dort beginnen, wo die Pakete tatsächlich eingesetzt wurden: in Lockfiles, lokalen Installationen, CI-Konfigurationen und Container-Images. Für npm sind @wppconnect-team/wppconnect in den Versionen 2.4.1 und 2.4.3 sowie @wppconnect/server in den Versionen 2.10.82 und 2.10.83 relevant. Da npm 2.4.3 und 2.10.83 nicht auflistet, reicht eine reine Registry-Suche nicht aus. Lockfiles, package.json-Dateien und installierte node_modules-Verzeichnisse müssen zusätzlich berücksichtigt werden.

Bei Docker ist ein Vergleich von Tags unzureichend. Ein Tag wie latest, 2 oder 2.10 kann später auf ein anderes Image zeigen, während auf einem Host weiterhin das kompromittierte Image läuft. Betroffen waren laut Bericht sämtliche wppconnect/wppconnect-server-Images, die zwischen 02:48 und 03:54 UTC am 16. November gezogen wurden, sowie der main-Tag vor 07:31 UTC. Entscheidend ist deshalb der unveränderliche Digest, nicht der bewegliche Tag. Betreiber sollten lokale und registrierte Digests inventarisieren und gegen bekannte Images aus dem relevanten Zeitfenster abgleichen.

Die Versions-Tags 2.10.82 und 2.10.83 wurden später von Docker Hub entfernt. Floating Tags zeigten bis 03:54 UTC auf das kompromittierte 2.10.83-Image. Anschließend wurden die Tags neu gesetzt, ohne dass daraus automatisch die Bereinigung jedes bereits ausgelieferten Systems folgte. Die späteren Versionen 2.10.85 und 2.10.86 sind ebenfalls nicht automatisch ein Nachweis für eine saubere Umgebung, weil eine bereits ausgeführte Instanz ohne Neustart weiterhin mit dem alten Image arbeitet.

Wer eine betroffene Bibliothek oder einen betroffenen Server tatsächlich geladen hat, muss sämtliche Secrets als kompromittiert behandeln. Das betrifft nicht nur API-Schlüssel des Projekts, sondern auch Credentials, die im Prozess erreichbar waren. Dazu gehören Datenbankzugänge, Cloud-Token, CI-Geheimnisse, Signatur-Keys und Konfigurationswerte. Der Vorfall zeigt die Reichweite des Problems: Ein scheinbar harmloser Support-Code hatte Zugriff auf die Umgebung des Prozesses, in dem WPPConnect lief.

Warum eine erneute Installation das Risiko nicht behebt

Die verbreitete Annahme lautet, ein neuer Release sei sicher, wenn er aus der offiziellen Pipeline stammt. Hier zeigt der Fall das Gegenteil. Die schädlichen Versionen durchliefen genau die Mechanismen, die normalerweise Vertrauen schaffen sollten. Sie wurden von einem authentifizierten Publisher veröffentlicht, erschienen in der offiziellen Registry und bauten Docker-Images über reguläre Workflows.

Ebenso verbreitet ist die Annahme, npm install --ignore-scripts schütze vor kompromittierten Paketen. Hier greift dieser Schutz jedoch zu kurz. Die Bibliothek besaß keinen Install-Hook, der die Payload beim Installation ausführte. Der Import in browser.ts löste sie beim Laden des Moduls aus. Der Server führte sie beim Start seines kompilierten Codes aus. Das Installationsverhalten war somit nicht der relevante Auslöser. Entscheidend war, ob die Bibliothek importiert oder der Server gestartet wurde.

Die unmittelbare Reaktion kann deshalb nur lauten: betroffene Versionen aus Lockfiles und Deployments entfernen, Container durch einen geprüften Image-Digest ersetzen, Prozesse neu starten und die alte Registry-Auflösung nicht ungeprüft übernehmen. Danach folgt die Credential-Rotation. Diese Reihenfolge ist wichtig. Ein Secrets-Austausch vor der Entfernung des Schadcodes kann die alten Zugangsdaten erneut exfiltrieren, wenn der kompromittierte Prozess weiterläuft.

Auch WhatsApp-Sessions benötigen eine gezielte Reaktion. Sie sind nicht nur ein Cache lokaler Anmeldungen, sondern Authentifizierungsdaten. Deshalb sollten betroffene Sessions serverseitig abgemeldet und die Anmeldungen neu aufgebaut werden. Eine bloße Aktualisierung der WPPConnect-Version genügt nicht, wenn dieselben Tokens weiterhin in Verzeichnissen liegen oder in aktiven Prozessen verwendet werden.

Welche Kontrollen den Vorfall künftig begrenzen können

StepSecurity leitet aus dem Vorfall eine Reihe von Kontrollen ab, die in eine bestehende Lieferkettensicherung passen. Der Dev Machine Guard kann installierte OSS-Pakete auf Entwicklerrechnern und in Projektverzeichnissen inventarisieren. Eine organisationsweite Suche nach den betroffenen Paketnamen liefert damit einen besseren Ausgangspunkt als einzelne Anfragen an ein einzelnes Hosting-System.

Ein weiterer Baustein ist der Secure Registry Cooldown. Er kann Versionen, die erst innerhalb eines konfigurierten Zeitraums veröffentlicht wurden, in Registry-Sichtweisen ausblenden oder zurückhalten. Das schafft ein Zeitfenster für zusätzliche Prüfungen. Es ersetzt kein Code-Review, begrenzt aber die Geschwindigkeit, mit der eine automatische Release-Pipeline neue Versionen verbreitet. Gerade bei npm ist das relevant, weil ein neuer latest-Stand während weniger als einer Stunde zahlreiche Installationen erreichen kann.

Harden-Runner ergänzt diese Maßnahmen um Netzwerkkontrolle in CI. Unerwartete ausgehende Verbindungen lassen sich markieren oder blockieren. In diesem Vorfall wäre eine Verbindung zu einem Telegram-Endpunkt aus einem unerwarteten Build-Kontext ein relevantes Signal gewesen. Das ist kein vollständiger Ersatz für eine sichere Anwendung, aber es reduziert die Wahrscheinlichkeit, dass ein stiller Exfiltrationskanal unbemerkt bleibt.

Provenienz, Signaturen, Trusted Publisher und Review sollten als getrennte Kontrollschichten behandelt werden. Keine dieser Schichten ist wertlos. Zusammen können sie einen Angriff erkennen oder begrenzen. Sie ersetzen jedoch nicht die Prüfung, ob ein Commit auf dem Default-Branch ohne ungewöhnliche oder ungeprüfte Änderungen in einen Release gelangen ist. Automatisierung erhöht die Geschwindigkeit und Reichweite einer Veröffentlichung. Sie erhöht deshalb auch die Geschwindigkeit, mit der ein kompromittiertes Konto schädliche Versionen verteilen kann.

Einordnung des Vorfalls für Betreiber und Projekte

Die WPPConnect-Kompromittierung war kein Bruch der kryptografischen Signaturen und kein Versagen eines einzelnen Registrierungs-Passworts. Sie war ein Angriff auf der Prozessebene: auf Commit-Rechte, Review-Kontrolle, Release-Automatisierung und die Geschwindigkeit der Verteilung. Die offizielle Herkunft einer Version bleibt wertvoll, beantwortet aber nicht die entscheidende Frage, ob ihr Code sicher und beabsichtigt war.

Für Betreiber ist die praktische Konsequenz klar. Projekte und Container müssen nach den genannten Versionen durchsucht, Images anhand von Digests bewertet und laufende Instanzen ersetzt werden. Erreichbare Secrets müssen rotiert und WhatsApp-Sessions abgemeldet werden. Erst danach lässt sich eine bereinigte Umgebung herstellen. Die Prüfung der npm-Registry allein genügt nicht, weil bewegliche Docker-Tags, transitive Abhängigkeiten und nicht mehr gelistete Pipeline-Versionen die Sichtbarkeit verzerren.

Für Projekte zeigt der Vorfall, wie stark Release-Pipelines inzwischen als Verteilungskanal wirken. Wer Tag, Build und Registry zusammen mit einem einzigen Zugangsschutzmodell kontrolliert, kann mehrere Artefakttypen gleichzeitig erreichen. Das ist bequem, aber ein großer Angriffshebel. Reviews für Default-Branches, getrennte Freigaben für npm und Docker sowie Überwachung unerwarteter Netzwerkverbindungen gehören deshalb zur Grundlage einer sicheren Lieferkette. Ein Import genügt, um Daten zu stehlen.

Quelle: stepsecurity.io

Deine Reaktion:
Artikel teilen:
Krötzsch-Check0 — 100
Fakten 91
Relevanz 89
Hype 18
Einschätzung 91
Redaktion 50 Stand 50 · noch keine Stimmen
Ist das Hype?
Sebastian Krötzsch
Autor

Sebastian Krötzsch

Sebastian Krötzsch schreibt auf sebask.de über Künstliche Intelligenz, Automatisierung, digitale Systeme und die Frage, was davon im Alltag wirklich nützlich ist. Ohne Buzzword-Nebel, dafür mit klarem Blick auf Praxis, Tools und echte Wirkung.