ماسح ثغرات TanStack Router CVE

أداة فحص أمني للكشف عن ثغرة TanStack Router CVE | TanStack Router GHSA في مشاريعك.

نظرة عامة

تقوم هذه الأداة بفحص قاعدة الأكواد الخاصة بك بحثًا عن مؤشرات ثغرة TanStack Router (CVE-2026-45321 / GHSA-g7cv-rxg3-hmpx)، والتي تؤثر على إصدارات محددة من حزم TanStack Router. تكتشف:

• ملفات router_init.js التي قد تحتوي على كود ضار
• تبعيات اختيارية مشبوهة في package.json
• إصدارات الحزم المعرضة للخطر المعروفة
• إصدارات معرضة للخطر في ملفات القفل (package-lock.json، pnpm-lock.yaml، yarn.lock)
• إدخالات ذات صلة في سجلات npm

الإصدارات المعرضة للخطر المعروفة

يتم وضع علامة على إصدارات الحزم التالية على أنها معرضة للخطر:

مستويات المخاطر

• HIGH: تم العثور على router_init.js، أو تبعيات اختيارية مشبوهة، أو إصدارات معرضة للخطر في package.json/ملفات القفل
• MEDIUM: تم العثور على إدخالات ذات صلة في سجلات npm فقط
• LOW: لم يتم العثور على مؤشرات

التثبيت

macOS

1. افتح الطرفية (Terminal)
2. انتقل إلى دليل مشروعك:
   root@kitploit:~

   cd /path/to/your/project
   

3. قم بتشغيل الماسح (انظر الاستخدام أدناه)

Windows

1. افتح موجه الأوامر (Command Prompt) أو PowerShell
2. انتقل إلى دليل مشروعك:
   root@kitploit:~

   cd C:\path\to\your\project
   

3. قم بتشغيل الماسح (انظر الاستخدام أدناه)

Linux

1. افتح الطرفية (Terminal)
2. انتقل إلى دليل مشروعك:
   root@kitploit:~

   cd /path/to/your/project
   

3. قم بتشغيل الماسح (انظر الاستخدام أدناه)

الاستخدام

الاستخدام الأساسي

فحص الدليل الحالي:

node scan.js

فحص مجلد محدد:

node scan.js /path/to/your/project

فحص دليل المستخدم الرئيسي:

node scan.js ~

حفظ الناتج في ملف JSON

macOS / Linux:

node scan.js ~/your-project > scan-result.json

Windows (موجه الأوامر):

node scan.js C:\Users\YourName\your-project > scan-result.json

Windows (PowerShell):

node scan.js C:\Users\YourName\your-project | Out-File -FilePath scan-result.json

أمثلة لسير العمل

فحص مشروع واحد:

cd /Users/username/my-react-app
node scan.js . > result.json
cat result.json

فحص النظام بأكمله (macOS/Linux):

node scan.js ~ > full-scan.json

فحص باستخدام jq (macOS/Linux) - تصفية مستوى المخاطر فقط:

node scan.js . | jq -r '.risk'

تنسيق الناتج

يقوم الماسح بإخراج JSON بالهيكل التالي:

{
  "scannedRoot": "/path/to/scanned/directory",
  "risk": "HIGH|MEDIUM|LOW",
  "summary": {
    "routerInit": 0,
    "optionalDeps": 0,
    "badPackageVersions": 0,
    "badLockVersions": 0,
    "npmLogs": 0,
    "errors": 0
  },
  "findings": {
    "routerInit": [],
    "optionalDeps": [],
    "badPackageVersions": [],
    "badLockVersions": [],
    "npmLogs": [],
    "errors": []
  }
}

الأدلة التي يتم تخطيها

يتخطى الماسح تلقائيًا الأدلة التالية لتحسين الأداء:

• .git
• .next
• .nuxt
• .turbo
• .cache
• .DS_Store
• dist
• build
• coverage
• .yarn

يتم أيضًا تخطي الملفات الأكبر من 5 ميجابايت.

ما يجب فعله في حالة وجود ثغرة

إذا أبلغ الماسح عن خطر HIGH:

1. افحص فورًا ملفات package.json المتأثرة
2. قم بتحديث الحزم المعرضة للخطر إلى أحدث الإصدارات الآمنة
3. احذف أي ملفات router_init.js مشبوهة
4. أعد تثبيت التبعيات بشكل نظيف:
   root@kitploit:~

   rm -rf node_modules package-lock.json
   npm install
   

5. راجع ملفات القفل الخاصة بك بحثًا عن أي تكوينات خبيثة
6. أبلغ عن الثغرة إذا وجدت دليلاً على استغلالها

موارد إضافية

• TanStack Router على GitHub
• NVD CVE-2026-45321
• الإشعار الأمني