tanstack-compromise-checker

Rileva indicatori dell'attacco alla supply-chain npm di TanStack su una macchina sviluppatore, 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 aggressori hanno pubblicato 84 versioni malevole su 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.

Avvio rapido

Scegli il punto di ingresso che corrisponde alla tua situazione.

macOS / Linux / WSL2 / Git Bash

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 — funziona su qualsiasi sistema operativo che esegue Docker (incl. Windows)

docker run --rm -v "$PWD":/scan \
  ghcr.io/fabriziosalmi/tanstack-compromise-checker:v1.0.0 \
  /scan true fail tanstack-findings.json '' GHSA-g7cv-rxg3-hmpx

L'immagine è multi-architettura (linux/amd64, linux/arm64) e include una provenienza di build firmata tramite GitHub OIDC. Verifica prima di eseguire:

gh attestation verify \
  oci://ghcr.io/fabriziosalmi/tanstack-compromise-checker:v1.0.0 \
  --repo fabriziosalmi/tanstack-compromise-checker

GitHub Action — blocca le dipendenze compromesse in CI

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 rinforzato si trova in .github/workflows/tanstack-check.yml ed è lo stesso flusso di lavoro che questo repository esegue su se stesso.

Cosa controlla lo script

Con --online, lo script recupera anche l'avviso GHSA in fase di esecuzione, in modo che la copertura di rilevamento segua lo stato live dell'avviso anziché un elenco di versioni hard-coded.

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.

Utilizzo

# 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

Tutte le opzioni

Codici di uscita

Postura di sicurezza

Questo repository si difende dalla stessa classe di attacchi che rileva. Nello specifico:

• Ogni uses: di GitHub Action è bloccato su un commit SHA di 40 caratteri, non su un tag fluttuante.
• L'immagine Docker di base è bloccata su un digest manifesto multi-architettura immutabile.
• Ogni flusso di lavoro dichiara permissions: {} al livello superiore; i job concedono solo ciò di cui hanno bisogno.
• actions/checkout viene invocato con persist-credentials: false in modo che nessun remote git autenticato rimanga in $GITHUB_WORKSPACE.
• step-security/harden-runner è il primo passo di ogni flusso di lavoro e monitora il traffico in uscita dal runner.
• OpenSSF Scorecard viene eseguito settimanalmente e ad ogni push su main; i risultati vengono caricati come SARIF.
• Ogni release pubblica un attestato di provenienza di build SLSA per l'immagine Docker. Chiunque può verificarlo offline con gh attestation.
• Ogni release fornisce un check.sh.sha256 che copre tutti gli artefatti installabili.

La policy completa è in SECURITY.md.

Non eseguire curl | bash per nessuno strumento di sicurezza, incluso questo. Scarica sempre, verifica il checksum, ispeziona, poi esegui.

Output di esempio

━━  1 / 8  DEAD-MAN'S SWITCH ARTEFACTS
  ✔  No dead-man's switch artefacts found

━━  2 / 8  PERSISTENCE VECTORS
  ✔  No persistence vectors detected

━━  3 / 8  TOKEN / CREDENTIAL EXPOSURE
  ✔  No credential exposure detected

━━  4 / 8  NETWORK INDICATORS
  ✔  No node TCP connections currently established (or none observable)

━━  5 / 8  REPO SCAN — package.json + lockfiles
  ℹ  Found 12 package.json + 8 lockfile(s)
  ✔  No compromised family declared in any package.json
  ✔  No compromised pins found in any lockfile

━━  6 / 8  INSTALLED node_modules — direct version check
  ✔  No compromised packages in installed node_modules

━━  7 / 8  GITHUB ACTIONS HARDENING HINTS
  ✔  No risky GitHub Actions patterns detected (in scanned scope)

━━  8 / 8  MINI SHAI-HULUD PAYLOAD + AUXILIARY IOCs
  ✔  No Mini Shai-Hulud payload / auxiliary IOCs detected

━━  SUMMARY
  Passed: 8    Warnings: 0    Failed: 0
  Scope : /Users/alice/dev
  ✔  No indicators of compromise within scope: /Users/alice/dev
  Note: a clean result for /Users/alice/dev does not certify the rest of the system.

Se sei compromesso

NON revocare il token GitHub prima di fermare il demone — il dead-man's switch eseguirà rm -rf ~/ nel momento in cui il token viene revocato.

1. Ferma prima il demone:
   • macOS 14+: launchctl bootout gui/$UID ~/Library/LaunchAgents/com.user.gh-token-monitor.plist
   • macOS legacy: launchctl unload ~/Library/LaunchAgents/com.user.gh-token-monitor.plist
   • Linux: systemctl --user stop gh-token-monitor && systemctl --user disable gh-token-monitor
2. Rimuovi lo script: rm -f ~/.local/bin/gh-token-monitor.sh
3. Poi revoca e ruota: token GitHub, token npm, credenziali AWS/GCP/Azure, chiavi SSH, agente SSH.
4. Esamina il log di controllo di GitHub: https://github.com/settings/security-log
5. Ispeziona ~/.aws/credentials, ~/.kube/config, ~/.config/gh/hosts.yml, ~/.npmrc.

Dipendenze

Lo script bash necessita di:

• bash 4+
• jq (consigliato) — analisi di package-lock.json
• python3 (fallback opzionale) — usato quando jq è assente
• curl — richiesto per --online
• lsof o ss (opzionale) — euristica IOC di rete

L'immagine Docker include tutto quanto sopra. Usala su sistemi dove non puoi o non vuoi installare questi strumenti.

Contribuire

Issue e pull request sono benvenuti. Nota che questo repository utilizza CODEOWNERS: tutte le PR richiedono una revisione da parte di un manutentore.

Riferimenti

• TanStack official postmortem
• GitHub Advisory GHSA-g7cv-rxg3-hmpx
• Snyk analysis
• Wiz Blog — Mini Shai-Hulud
• StepSecurity writeup
• Orca Security — 160+ packages

Licenza

MIT.