Shell-Skript zum Erkennen von Indikatoren für den TanStack npm Supply-Chain-Angriff (CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)
Erkennt Indikatoren für den TanStack-npm-Lieferkettenangriff auf einem Entwickler- Rechner, einem Repository oder einem CI-Runner. Bash-Skript, Docker-Image und GitHub Action — dieselbe Engine, drei Einstiegspunkte.
CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx
Am 11. Mai 2026 veröffentlichten Angreifer 84 bösartige Versionen über 42
@tanstack/*-Pakete mittels GitHub-Actions-Cache-Poisoning. Die Payload stiehlt
GitHub-Tokens, npm-Tokens, AWS/GCP/Azure-Anmeldedaten und installiert einen
Dead-Man's-Switch-Daemon, der ~/ löscht, sobald das gestohlene Token
widerrufen wird.
Wähle den Einstiegspunkt, der zu deiner Umgebung passt.
TAG=v1.0.0
curl -fsSLO https://github.com/fabriziosalmi/tanstack-compromise-checker/releases/download/$TAG/check.sh
curl -fsSLO https://github.com/fabriziosalmi/tanstack-compromise-checker/releases/download/$TAG/check.sh.sha256
sha256sum -c check.sh.sha256
bash check.sh --online
docker run --rm --user "$(id -u):$(id -g)" -v "$PWD":/scan \
ghcr.io/fabriziosalmi/tanstack-compromise-checker:1 \
/scan true fail tanstack-findings.json '' GHSA-g7cv-rxg3-hmpx
Exit-Code 0 bedeutet sauber, 2 bedeutet, dass Indikatoren für eine Kompromittierung gefunden wurden. Die
Findings-JSON wird in tanstack-findings.json im aktuellen Verzeichnis geschrieben.
--user ermöglicht es dem Container, diese Datei in ein Verzeichnis zu schreiben, das Ihrem
Benutzer gehört; unter Linux ohne diese Option läuft der Scan weiterhin, aber die JSON kann nicht geschrieben werden.
In PowerShell, wo id nicht existiert, lassen Sie das --user-Flag weg.
Image-Tags tragen kein v-Präfix: 1.2.1 für eine exakte Version, 1 für die
neueste 1.x-Version (sie bewegt sich mit dem v1-Action-Tag) und latest.
Das Image ist Multi-Arch (linux/amd64, linux/arm64) und wird mit Build-
Provenienz ausgeliefert, die über GitHub OIDC signiert ist. Vor der Ausführung verifizieren:
gh attestation verify \
oci://ghcr.io/fabriziosalmi/tanstack-compromise-checker:1 \
--repo fabriziosalmi/tanstack-compromise-checker
permissions: {}
jobs:
check:
runs-on: ubuntu-latest
permissions:
contents: read
steps:
- uses: actions/checkout@v6
with:
persist-credentials: false
- uses: fabriziosalmi/tanstack-compromise-checker@v1
with:
scan-dir: .
online: 'true'
fail-on: fail
Ein vollständiger gehärteter Workflow befindet sich unter
.github/workflows/tanstack-check.yml
und ist derselbe Workflow, den dieses Repository gegen sich selbst ausführt.
| # | Prüfung | Beschreibung |
|---|---|---|
| 1 | Dead-Man's-Switch | ~/.local/bin/gh-token-monitor.sh, LaunchAgents + LaunchDaemons (macOS), systemd-User- + System-Units (Linux), laufende Prozesse |
| 2 | Persistenz | Shell-rc-Dateien, Benutzer-/System-Crontab, /etc/cron.*, XDG-Autostart, globales Git core.hooksPath |
| 3 | Anmeldedaten | sensible Umgebungsvariablen, ~/.npmrc, ~/.yarnrc.yml, ~/.aws/credentials, ~/.config/gh/hosts.yml, ~/.netrc, ~/.docker/config.json, ~/.kube/config, Auflistung von .env*-Dateien |
| 4 | Netzwerk-IOC | laufende node-Prozesse mit aufgebauten ausgehenden TCP-Verbindungen (heuristisch, manuelle Prüfung) |
| 5 | Repo-Scan | in package.json deklarierte Abhängigkeiten + im Lockfile festgeschriebene Versionen (package-lock.json, yarn.lock, pnpm-lock.yaml) |
| 6 | Installiert | node_modules/@tanstack/*/package.json wird gegen die Liste bekannter bösartiger Versionen geprüft, dann gegen die npm-Registry time[<version>], wenn --online |
| 7 | Actions-Hinweise | .github/workflows/* wird auf pull_request_target, fehlendes --ignore-scripts, Verwendung von actions/cache geprüft |
| 8 | Mini-Shai-Hulud-IOCs | Payload-Dateien in node_modules (router_init.js, tanstack_runner.js), optionale Abhängigkeit @tanstack/setup, Manipulation von KI-Tool-Konfigurationen, C2-Domains im Quellcode, Commit-Autor- und Branch-Muster des Angreifers, mit Lösegeld markierte npm-Tokens, sekundär durch den Wurm verbreitete Pakete, plus Heuristiken auf Info-Ebene für unbekannte Payload-Formen |
Mit --online ruft das Skript außerdem zur Laufzeit den GHSA-Advisory ab, sodass
die Erkennungsabdeckung dem Live-Zustand des Advisories folgt statt einer fest
codierten Versionsliste.
Betroffene Familie: @tanstack/router, @tanstack/react-router,
@tanstack/history, @tanstack/start, @tanstack/eslint-plugin-router und
verwandte Pakete.
Saubere Familien (nicht betroffen): @tanstack/react-query,
@tanstack/react-table, @tanstack/react-virtual, @tanstack/form,
@tanstack/store.
# Quick check (current user's home)
bash check.sh
# Online mode: query the GHSA advisory and npm registry publish-time
bash check.sh --online
# Scan a specific directory
bash check.sh --scan-dir /path/to/your/repos
# JSON output for CI/SIEM integration
bash check.sh --json > findings.json
# Suggest pin commands for affected repos (dry-run)
bash check.sh --scan-dir /path/to/repos --fix
# Provide an extended known-bad list
bash check.sh --bad-versions-file ./extra-bad-versions.txt
| Flag | Beschreibung |
|---|---|
--scan-dir DIR | Stammverzeichnis zum Scannen (Standard: $HOME). Verweigert das Scannen von Systemverzeichnissen wie /, /etc, /usr. |
--online | Fragt die GHSA-Advisory und das time[<version>]-Feld der npm-Registry ab, um eine Kompromittierung zu bestätigen. Standardmäßig deaktiviert — Opt-in. |
--ghsa GHSA-ID | Überschreibt die in --online verwendete Advisory-ID (Standard GHSA-g7cv-rxg3-hmpx). |
--attack-window-start ISO, --attack-window-end ISO | Überschreibt das in --online verwendete Veröffentlichkeitszeitfenster. |
--fix | Gibt empfohlene Pin-Befehle für betroffene Repos aus (standardmäßig Dry-Run). |
--apply | Zusammen mit --fix: Opt-in zur Ausführung. Verweigert derzeit weiterhin ein blindes update; manuelles Pinning ist erforderlich. |
--yes, -y | Überspringt die Bestätigungsaufforderung für --apply. |
--json | Gibt Befunde als JSON auf stdout aus (impliziert --quiet). |
--bad-versions-file F | Hängt Einträge (pkg@version, eine pro Zeile) an die Liste der bekannten schlechten Versionen an. |
--no-color | Deaktiviert ANSI-Farben. |
--quiet, -q | Unterdrückt die Ausgabe pro Prüfung, gibt nur die Zusammenfassung aus. |
-h, --help | Zeigt die Hilfe an. |
| Code | Bedeutung |
|---|---|
| 0 | Sauber — keine Indikatoren im gescannten Bereich |
| 1 | Nur Warnungen — Überprüfung empfohlen |
| 2 | Fehler — Kompromittierungsindikatoren vorhanden |
| 3 | Werkzeug-/Nutzungsfehler |
Dieses Repository verteidigt sich gegen dieselbe Angriffsklasse, die es erkennt. Konkret: