TanStack npm 공급망 공격 지표(CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)를 탐지하는 셸 스크립트
개발자 머신, 저장소 또는 CI 러너에서 TanStack npm 공급망 공격의 지표를 탐지합니다. Bash 스크립트, Docker 이미지, GitHub Action — 동일한 엔진, 세 가지 진입점.
CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx
2026년 5월 11일, 공격자들은 GitHub Actions 캐시 포이즈닝을 통해 42개의 @tanstack/* 패키지에 걸쳐 84개의 악성 버전을 게시했습니다. 페이로드는 GitHub 토큰, npm 토큰, AWS/GCP/Azure 자격 증명을 탈취하고, 탈취된 토큰이 폐기되는 순간 ~/를 삭제하는 데드맨 스위치(dead-man's switch) 데몬을 설치합니다.
현재 위치에 맞는 진입점을 선택하세요.
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를 통해 서명된 빌드 출처(provenance)와 함께 제공됩니다. 실행 전에 검증하십시오:
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 | 데드맨 스위치 | ~/.local/bin/gh-token-monitor.sh, LaunchAgents + LaunchDaemons (macOS), systemd 사용자 + 시스템 유닛 (Linux), 실행 중인 프로세스 |
| 2 | 지속성 | 셸 rc 파일, 사용자/시스템 crontab, /etc/cron.*, XDG 자동 시작, 전역 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, 한 줄에 하나)을 추가합니다. |
--no-color | ANSI 색상을 비활성화합니다. |
--quiet, -q | 검사별 출력을 억제하고 요약만 출력합니다. |
-h, --help | 도움말을 표시합니다. |
| 코드 | 의미 |
|---|---|
| 0 | 정상 — 스캔 범위 내 지표 없음 |
| 1 | 경고만 존재 — 검토 권장 |
| 2 | 실패 — 침해 지표 존재 |
| 3 | 도구/사용 오류 |
이 저장소는 자신이 탐지하는 것과 동일한 공격 유형에 대해 스스로를 방어합니다. 구체적으로:
uses:는 부동 태그가 아닌 40자 커밋 SHA로
고정됩니다.permissions: {}를 선언하며, 각 작업은 필요한 권한만
부여합니다.actions/checkout은 persist-credentials: false로 호출되어
$GITHUB_WORKSPACE에 인증된 git 원격이 남지 않습니다.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 ~/를 실행합니다.