TanStack npm サプライチェーン攻撃の兆候(CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)を検出するシェルスクリプト
開発者マシン、リポジトリ、または CI ランナー上で TanStack npm サプライチェーン攻撃の痕跡を検出します。Bash スクリプト、Docker イメージ、GitHub Action — 同じエンジンで、3 つのエントリーポイント。
CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx
2026年5月11日、攻撃者は GitHub Actions のキャッシュポイズニングを通じて、42 個の @tanstack/* パッケージにわたる 84 個の悪意あるバージョンを公開しました。ペイロードは GitHub トークン、npm トークン、AWS/GCP/Azure の認証情報を窃取し、盗まれたトークンが失効した瞬間に ~/ を消去するデッドマンスイッチデーモンをインストールします。
現在の環境に合ったエントリーポイントを選択してください。
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
終了コード 0 はクリーン、2 は侵害の指標が見つかったことを意味します。検出結果の JSON はカレントディレクトリの tanstack-findings.json に書き込まれます。--user を指定すると、コンテナはそのファイルをあなたのユーザーが所有するディレクトリに書き込めるようになります。Linux でこれを指定しない場合でもスキャンは実行されますが、JSON は書き込めません。id が存在しない PowerShell では、--user フラグを外してください。
イメージタグには v プレフィックスが付きません。正確なリリースには 1.2.1、最新の 1.x リリースには 1(v1 Action タグに追従して移動します)、そして latest です。
イメージはマルチアーキテクチャ(linux/amd64、linux/arm64)であり、GitHub OIDC 経由で署名されたビルド来歴が付属しています。実行前に検証してください:
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
完全に堅牢化されたワークフローは
.github/workflows/tanstack-check.yml
にあり、このリポジトリが自身に対して実行しているものと同じワークフローです。
| # | チェック | 説明 |
|---|---|---|
| 1 | Dead-man's switch | ~/.local/bin/gh-token-monitor.sh、LaunchAgents + LaunchDaemons (macOS)、systemd user + system units (Linux)、実行中のプロセス |
| 2 | 永続化 | シェル rc ファイル、ユーザー/システム crontab、/etc/cron.*、XDG autostart、グローバル git core.hooksPath |
| 3 | 認証情報 | 機密環境変数、~/.npmrc、~/.yarnrc.yml、~/.aws/credentials、~/.config/gh/hosts.yml、~/.netrc、~/.docker/config.json、~/.kube/config、.env* ファイルの列挙 |
| 4 | ネットワーク IOC | 確立された外向き TCP 接続を持つ実行中の node プロセス (ヒューリスティック、手動レビュー) |
| 5 | リポジトリスキャン | package.json で宣言された依存関係 + ロックファイルで固定されたバージョン (package-lock.json、yarn.lock、pnpm-lock.yaml) |
| 6 | インストール済み | node_modules/@tanstack/*/package.json を既知の悪意あるバージョンリストと照合し、--online の場合は npm レジストリの time[<version>] と照合 |
| 7 | Actions のヒント | .github/workflows/* をスキャンして pull_request_target、--ignore-scripts の欠落、actions/cache の使用を検出 |
| 8 | Mini Shai-Hulud IOC | node_modules 内のペイロードファイル (router_init.js、tanstack_runner.js)、@tanstack/setup の optionalDependency、AI ツール設定の改ざん、ソース内の C2 ドメイン、攻撃者のコミット作成者 + ブランチパターン、身代金マーク付き npm トークン、二次的にワーム伝播したパッケージ、さらに未知のペイロード形状に対する情報レベルのヒューリスティック |
--online を指定すると、スクリプトは実行時に GHSA アドバイザリも取得するため、
検出範囲はハードコードされたバージョンリストではなくアドバイザリのライブ状態に追従します。
影響を受けるファミリー: @tanstack/router、@tanstack/react-router、
@tanstack/history、@tanstack/start、@tanstack/eslint-plugin-router、および
関連パッケージ。
クリーンなファミリー (影響なし): @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
| フラグ | 説明 |
|---|---|
--scan-dir DIR | スキャンするルートディレクトリ(デフォルト: $HOME)。/、/etc、/usr などのシステムディレクトリのスキャンは拒否します。 |
--online | GHSA アドバイザリと npm レジストリの time[<version>] を照会して侵害を確認します。デフォルトでは無効 — オプトインです。 |
--ghsa GHSA-ID | --online で使用するアドバイザリ ID を上書きします(デフォルト GHSA-g7cv-rxg3-hmpx)。 |
--attack-window-start ISO, --attack-window-end ISO | --online で使用する公開時刻のウィンドウを上書きします。 |
--fix | 影響を受けたリポジトリに対して推奨されるピン留めコマンドを出力します(デフォルトはドライラン)。 |
--apply | --fix と併用: 実行へのオプトイン。現在も盲目的な update は拒否され、手動でのピン留めが必要です。 |
--yes, -y | --apply の確認プロンプトをスキップします。 |
--json | 検出結果を JSON として stdout に出力します(--quiet を暗黙的に有効化)。 |
--bad-versions-file F | 既知の悪いバージョンリストにエントリ(pkg@version、1 行に 1 件)を追記します。 |
--no-color | ANSI カラーを無効化します。 |
--quiet, -q | チェックごとの出力を抑制し、サマリーのみを表示します。 |
-h, --help | ヘルプを表示します。 |
| コード | 意味 |
|---|---|
| 0 | クリーン — スキャン範囲内に指標なし |
| 1 | 警告のみ — レビューを推奨 |
| 2 | 失敗 — 侵害の指標あり |
| 3 | ツール/使用方法のエラー |
このリポジトリは、自身が検出するのと同じ攻撃クラスに対して自己防御しています。 具体的には:
uses: は、浮動タグではなく 40 文字のコミット SHA に
ピン留めされています。permissions: {} を宣言し、ジョブは必要な権限のみを
付与します。actions/checkout は persist-credentials: false 付きで呼び出されるため、認証済みの
git リモートが $GITHUB_WORKSPACE に残りません。step-security/harden-runner
がすべてのワークフローの最初のステップであり、ランナーの外向き通信を監視します。main への
すべてのプッシュ時に実行され、結果は SARIF としてアップロードされます。gh attestation を使ってオフラインで検証できます。check.sh.sha256 が同梱されています。完全なポリシーは SECURITY.md にあります。
このツールを含め、いかなるセキュリティツールでも curl | bash をパイプで実行しないでください。常に
ダウンロードし、チェックサムを検証し、内容を確認してから実行してください。
━━ 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.
デーモンを停止する前に GitHub トークンを失効させないでください — デッドマンスイッチは、トークンが失効した瞬間に
rm -rf ~/を実行します。