Script shell per rilevare gli indicatori di attacco alla supply chain di TanStack npm (CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)
Rileva indicatori dell'attacco alla supply chain npm di TanStack su una macchina di sviluppo, un repository o un runner CI. Script Bash, immagine Docker e GitHub Action — stesso motore, tre punti di ingresso.
CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx
L'11 maggio 2026, gli attaccanti hanno pubblicato 84 versioni malevole in 42
pacchetti @tanstack/* tramite avvelenamento della cache di GitHub Actions. Il
payload ruba token GitHub, token npm, credenziali AWS/GCP/Azure e installa un
demone dead-man's switch che cancella ~/ nel momento in cui il token
rubato viene revocato.
Scegli il punto di ingresso che corrisponde alla tua situazione.
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
Il codice di uscita 0 indica nessun problema, 2 indica che sono stati trovati indicatori di compromissione. Il JSON dei risultati viene scritto in tanstack-findings.json nella directory corrente. --user consente al container di scrivere quel file in una directory di proprietà del tuo utente; su Linux senza di esso la scansione viene comunque eseguita, ma il JSON non può essere scritto. In PowerShell, dove id non esiste, ometti il flag --user.
I tag delle immagini non hanno il prefisso v: 1.2.1 per una release esatta, 1 per l'ultima release 1.x (si sposta con il tag v1 dell'Action) e latest.
L'immagine è multi-arch (linux/amd64, linux/arm64) e viene distribuita con la provenienza della build firmata tramite GitHub OIDC. Verifica prima di eseguire:
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
Un flusso di lavoro completo e rafforzato si trova in
.github/workflows/tanstack-check.yml
ed è lo stesso flusso di lavoro che questo repository esegue su se stesso.
| # | Controllo | Descrizione |
|---|---|---|
| 1 | Dead-man's switch | ~/.local/bin/gh-token-monitor.sh, LaunchAgents + LaunchDaemons (macOS), unità utente + di sistema systemd (Linux), processi in esecuzione |
| 2 | Persistenza | file rc della shell, crontab utente/sistema, /etc/cron.*, autostart XDG, core.hooksPath globale di git |
| 3 | Credenziali | variabili d'ambiente sensibili, ~/.npmrc, ~/.yarnrc.yml, ~/.aws/credentials, ~/.config/gh/hosts.yml, ~/.netrc, ~/.docker/config.json, ~/.kube/config, enumerazione dei file .env* |
| 4 | IOC di rete | processi node in esecuzione con connessioni TCP in uscita stabilite (euristica, revisione manuale) |
| 5 | Scansione del repo | dipendenze dichiarate in package.json + versioni bloccate nel lockfile (package-lock.json, yarn.lock, pnpm-lock.yaml) |
| 6 | Installati | node_modules/@tanstack/*/package.json confrontati con l'elenco delle versioni note come dannose, poi con il registro npm time[<version>] quando si usa --online |
| 7 | Indicazioni sulle Actions | .github/workflows/* analizzati per pull_request_target, --ignore-scripts mancante, uso di actions/cache |
| 8 | IOC di Mini Shai-Hulud | file di payload in node_modules (router_init.js, tanstack_runner.js), optionalDependency @tanstack/setup, manomissione della configurazione degli strumenti AI, domini C2 nel codice sorgente, pattern di autore dei commit e di branch dell'attaccante, token npm contrassegnati per il riscatto, pacchetti secondari propagati dal worm, più euristiche a livello informativo per forme di payload sconosciute |
Con --online, lo script recupera anche l'avviso GHSA in fase di esecuzione, in modo che
la copertura del rilevamento segua lo stato live dell'avviso invece di un elenco
di versioni codificato in modo fisso.
Famiglia interessata: @tanstack/router, @tanstack/react-router,
@tanstack/history, @tanstack/start, @tanstack/eslint-plugin-router e
pacchetti correlati.
Famiglie pulite (non interessate): @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 | Descrizione |
|---|---|
--scan-dir DIR | Directory radice da scansionare (predefinita: $HOME). Rifiuta di scansionare directory di sistema come /, /etc, /usr. |
--online | Interroga l'advisory GHSA e il campo time[<version>] del registry npm per confermare la compromissione. Disattivato per impostazione predefinita — opt-in. |
--ghsa GHSA-ID | Sovrascrive l'ID dell'advisory usato in --online (predefinito GHSA-g7cv-rxg3-hmpx). |
--attack-window-start ISO, --attack-window-end ISO | Sovrascrive la finestra temporale di pubblicazione usata in --online. |
--fix | Stampa i comandi di pin consigliati per i repository interessati (dry-run per impostazione predefinita). |
--apply | Con --fix: opt-in all'esecuzione. Attualmente rifiuta comunque l'update alla cieca; è richiesto il pinning manuale. |
--yes, -y | Salta la richiesta di conferma per --apply. |
--json | Emette i risultati come JSON su stdout (implica --quiet). |
--bad-versions-file F | Aggiunge voci (pkg@version, una per riga) alla lista delle versioni note come dannose. |
--no-color | Disabilita i colori ANSI. |
--quiet, -q | Sopprime l'output per singolo controllo, stampa solo il riepilogo. |
-h, --help | Mostra l'aiuto. |
| Codice | Significato |
|---|---|
| 0 | Pulito — nessun indicatore nell'ambito scansionato |
| 1 | Solo avvisi — revisione consigliata |
| 2 | Errori — presenti indicatori di compromissione |
| 3 | Errore dello strumento/di utilizzo |
Questo repository si difende dalla stessa classe di attacco che rileva. Concretamente: