سكربت شل للكشف عن مؤشرات هجوم سلسلة التوريد في TanStack npm (CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)
اكتشف مؤشرات هجوم سلسلة التوريد على npm الخاص بـ TanStack على جهاز مطوّر، أو مستودع، أو مشغّل CI. سكربت Bash، وصورة Docker، وإجراء GitHub Action — نفس المحرك، ثلاث نقاط دخول.
CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx
في 11 مايو 2026، نشر المهاجمون 84 إصدارًا خبيثًا عبر 42
حزمة @tanstack/* عبر تسميم ذاكرة التخزين المؤقت في GitHub Actions. تسرق
الحمولة رموز 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.
في PowerShell، حيث لا يوجد id، احذف علامة --user.
لا تحمل وسوم الصور بادئة v: 1.2.1 لإصدار محدد، و1 لأحدث إصدار 1.x (يتحرك مع وسم الإجراء v1)، و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 | مفتاح الرجل الميت | ~/.local/bin/gh-token-monitor.sh، وLaunchAgents + LaunchDaemons (macOS)، ووحدات systemd للمستخدم + النظام (Linux)، والعمليات قيد التشغيل |
| 2 | الاستمرارية | ملفات rc للصدفة، وcrontab للمستخدم/النظام، و/etc/cron.*، وXDG autostart، وcore.hooksPath العام في git |
| 3 | بيانات الاعتماد | متغيرات البيئة الحساسة، و~/.npmrc، و~/.yarnrc.yml، و~/.aws/credentials، و~/.config/gh/hosts.yml، و~/.netrc، و~/.docker/config.json، و~/.kube/config، وتعداد ملفات .env* |
| 4 | مؤشرات الشبكة (IOC) | عمليات node قيد التشغيل مع اتصالات TCP صادرة قائمة (استدلالي، يتطلب مراجعة يدوية) |
| 5 | فحص المستودع | التبعيات المعلنة في package.json + الإصدارات المثبّتة في ملف القفل (package-lock.json، yarn.lock، pnpm-lock.yaml) |
| 6 | المثبّت | فحص node_modules/@tanstack/*/package.json مقابل قائمة الإصدارات الخبيثة المعروفة، ثم مقابل time[<version>] في سجل npm عند استخدام --online |
| 7 | إشارات Actions | فحص .github/workflows/* بحثًا عن pull_request_target، وغياب --ignore-scripts، واستخدام actions/cache |
| 8 | مؤشرات Mini Shai-Hulud | ملفات الحمولة في node_modules (router_init.js، tanstack_runner.js)، و@tanstack/setup كـ optionalDependency، والتلاعب بإعدادات أدوات الذكاء الاصطناعي، ونطاقات 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 (الافتراضي 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: في GitHub Action مثبّت على SHA التزام من 40 حرفًا، وليس على
وسم عائم.permissions: {} على المستوى الأعلى؛ وتمنح المهام فقط
ما تحتاجه.actions/checkout مع persist-credentials: false حتى لا يبقى
أي remote git موثّق في $GITHUB_WORKSPACE.step-security/harden-runner
هو الخطوة الأولى في كل سير عمل ويراقب حركة الخروج من runner.main؛ وتُرفع النتائج بصيغة SARIF.gh attestation.check.sh.sha256 يغطي جميع الملفات القابلة للتثبيت.السياسة الكاملة موجودة في SECURITY.md.
لا تقم بتوجيه curl | bash لأي أداة أمنية، بما في ذلك هذه الأداة. دائمًا
قم بالتنزيل، والتحقق من checksum، والفحص، ثم التشغيل.
━━ 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)