shai-scan

Scanner CLI senza dipendenze per compromissioni della supply chain npm e PyPI.

Perché?

L'11 maggio 2026, un worm della supply chain auto-propagante soprannominato Mini Shai-Hulud (CVE-2026-45321, GHSA-g7cv-rxg3-hmpx) ha compromesso l'ecosistema npm. Attribuito a TeamPCP (alias DeadCatx3, PCPcat, ShellForce, CipherForce), il malware ha dirottato i token OIDC di GitHub Actions per pubblicare pacchetti dannosi con provenienza SLSA Build Level 3 valida. Ha rubato credenziali da pipeline CI/CD, provider cloud e portafogli di criptovalute e ha installato hook di persistenza in Claude Code e VS Code. Un dead-man switch integrato minacciava di cancellare la directory home dell'utente se i token npm venivano revocati.

I pacchetti colpiti includevano i pacchetti router e start di TanStack, gli SDK Mistral AI, il client OpenSearch, gli strumenti UiPath e decine di altri. Poiché gli attacchi alla supply chain si muovono velocemente, le organizzazioni hanno bisogno di uno scanner leggero e affidabile che possano eseguire ovunque senza aggiungere nuove dipendenze alla propria superficie d'attacco.

Funzionalità

• Scansione dei lockfile — Rileva pacchetti npm e PyPI compromessi in package-lock.json, pnpm-lock.yaml, yarn.lock, bun.lock, bun.lockb, poetry.lock, Pipfile.lock e requirements.txt
• Controlli IOC di sistema — Analizza processi in esecuzione, artefatti del filesystem, connessioni di rete e percorsi di persistenza noti per indicatori di compromissione
• Zero dipendenze runtime — Utilizza solo i moduli integrati di Node.js/Bun (fs, path, child_process, os). Lo scanner non aumenta il rischio della tua supply chain
• Molteplici formati di output — Testo leggibile dall'uomo, JSON leggibile dalle macchine e SARIF per GitHub Code Scanning
• Nativo per CI/CD — Codici di uscita progettati per l'automazione (0 = pulito, 1 = rilevamenti, 2 = errore)
• Indipendente dal percorso — Accetta qualsiasi directory; per impostazione predefinita usa la directory di lavoro corrente
• Database basato su campagne — Le nuove ondate di attacco vengono aggiunte come campagne distinte in src/db.ts; aggiorna il file ed esegui di nuovo

Installazione

Nessuna installazione richiesta. Esegui direttamente con il tuo package runner preferito:

# npx
npx @digi4care/shai-scan

# bunx
bunx @digi4care/shai-scan

# pnpm dlx
pnpm dlx @digi4care/shai-scan

Installazione globale (opzionale):

npm install -g @digi4care/shai-scan
# or
pnpm add -g @digi4care/shai-scan

Dal sorgente:

git clone https://github.com/digi4care/shai-scan.git
cd shai-scan
pnpm install
bun run src/cli.ts --help   # Bun (recommended for development)
# or build and run with Node.js:
pnpm run build && node dist/cli.js --help

Utilizzo

Analizza il progetto corrente

npx @digi4care/shai-scan

Analizza un percorso specifico

npx @digi4care/shai-scan ~/projects/my-app

Output JSON per l'automazione

npx @digi4care/shai-scan --json .

Output SARIF per GitHub Code Scanning

npx @digi4care/shai-scan --sarif --sarif-file results.sarif .

Codici di uscita CI/CD

#!/bin/bash
npx @digi4care/shai-scan --severity high . || {
  code=$?
  if [ "$code" -eq 1 ]; then
    echo "Supply chain findings detected"
    exit 1
  elif [ "$code" -eq 2 ]; then
    echo "Scanner error"
    exit 2
  fi
}

Integrazione CI/CD

GitHub Actions (output di testo)

name: Supply Chain Scan
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: pnpm install --frozen-lockfile
      - run: npx @digi4care/shai-scan --severity high .

GitHub Actions (caricamento SARIF)

name: Supply Chain Scan SARIF
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  schedule:
    - cron: '0 6 * * 1'

jobs:
  scan:
    runs-on: ubuntu-latest
    permissions:
      security-events: write
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: pnpm install --frozen-lockfile
      - run: npx @digi4care/shai-scan --sarif --sarif-file results.sarif .
      - uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: results.sarif

Formati di output

Formato	Flag	Descrizione
Testo	(predefinito)	Tabella leggibile dei rilevamenti con gravità, nome del pacchetto, versione e dettagli della campagna
JSON	--json	Array JSON strutturato dei rilevamenti, adatto all'ingestione in SIEM o dashboard personalizzate
SARIF	--sarif	Formato OASIS SARIF 2.1.0 per il caricamento su GitHub Code Scanning, GitLab Secure o altri consumatori SARIF

Esempio di estratto JSON:

[
  {
    "package": "@tanstack/react-router",
    "version": "1.169.5",
    "ecosystem": "npm",
    "severity": "critical",
    "campaign": "mini-shai-hulud-wave4",
    "cve": "CVE-2026-45321",
    "reference": "https://github.com/TanStack/router/security/advisories/GHSA-g7cv-rxg3-hmpx"
  }
]

Codici di uscita

Codice	Significato
0	Nessun pacchetto compromesso o IOC rilevato
1	Uno o più rilevamenti trovati
2	Errore runtime (percorso non valido, lockfile illeggibile, ecc.)

Aggiungere nuove campagne

Quando viene scoperto un nuovo attacco alla supply chain, aggiorna src/db.ts:

1. Aggiungi un nuovo array CompromisedVersion[] con i pacchetti e le versioni colpiti
2. Aggiungi un nuovo oggetto Campaign all'array CAMPAIGNS, includendo identificativi CVE/GHSA, gravità, descrizione, URL di riferimento e indicatori IOC
3. La funzione buildLookup() ricostruisce automaticamente la mappa di ricerca alla successiva esecuzione

Non è richiesta alcuna fase di ricompilazione quando si usa Bun. Le modifiche a src/db.ts hanno effetto immediato con bun run src/cli.ts. Per il pacchetto npm, esegui pnpm run build dopo la modifica.

Considerazioni sulla sicurezza

• Zero dipendenze runtime: Lo scanner utilizza solo moduli integrati di Node.js/Bun. Non scarica né esegue codice di terze parti in fase di runtime, eliminando il rischio che lo scanner stesso diventi un vettore di compromissione.

• pnpm come package manager: pnpm utilizza lockfile rigorosi, non esegue script di ciclo di vita per impostazione predefinita e supporta l'archiviazione content-addressable. Queste proprietà riducono la superficie d'attacco rispetto ad altri package manager.

• Impostazioni .npmrc consigliate: Per la massima protezione durante l'installazione dei pacchetti, aggiungi quanto segue al tuo .npmrc di progetto o globale:

  ignore-scripts=true
  engine-strict=true
  

• Nessuna chiamata di rete: shai-scan non contatta server esterni, non scarica firme e non richiede una chiave API. Tutti i dati delle campagne sono inclusi nel pacchetto.

Pacchetti colpiti (campagna corrente)

I seguenti pacchetti e versioni sono noti per essere compromessi in CVE-2026-45321 (Mini Shai-Hulud Wave 4). Questo è un sottoinsieme rappresentativo; l'elenco completo è mantenuto in src/db.ts.