RSC Infra Scanner

rsc_infra_scan.py هو أداة Python سريعة وغير متزامنة تقوم ببصمة النطاقات للكشف عن البنية التحتية المحتملة لـ Next.js App Router / React Server Components (RSC).

لا تستغل أي ثغرات أمنية.
تقوم فقط بـبصمة سلبية عبر HTTP/HTML/الترويسات (headers) لمساعدتك في تحديد الأهداف التي قد تكون ضمن عائلة التقنيات المتأثرة (مثل CVEs ذات الصلة بـ RSC).

الثغرات المستهدفة

صُمم هذا الماسح للمساعدة في تحديد البنية التحتية التي قد تكون عرضة لما يلي:

• CVE-2025-55182 — ثغرة حرجة لتنفيذ التعليمات البرمجية عن بُعد (RCE) في React Server Components بسبب إلغاء التسلسل غير الآمن. تسمح هذه الثغرة بتنفيذ تعليمات برمجية عن بُعد قبل المصادقة.
• CVE-2025-66478 — مُخصصة في البداية لـ Next.js ولكن تم وضع علامة عليها كمكررة لـ CVE-2025-55182.

الإصدارات المتأثرة

• React: 19.0.0, 19.1.0, 19.1.1, 19.2.0
• Next.js: 15.x و16.x باستخدام App Router

مهم: هذه الأداة تحدد فقط البنية التحتية التي يبدو أنها تستخدم تقنية Next.js App Router / RSC. وهي لا تتحقق مما إذا كان CVE معين قابلًا للاستغلال أو ما إذا كان الهدف يعمل بإصدار معرض للخطر. تحقق دائمًا من حالة الثغرة من خلال الاختبارات الأمنية السليمة وإرشادات البائع.

---

الميزات

• يفحص قائمة النطاقات بشكل متزامن باستخدام aiohttp.
• يكتشف مؤشرات استدلالية لـ:
  • window.__next_f (بيئة تشغيل Next.js App Router / RSC)
  • react-server-dom-webpack
  • حاوية id="__next"
  • ترويسات الاستجابة x-nextjs-*
  • Content-Type: text/x-component
• يخصص درجة من 0–100 لكل نطاق.
• يطبع ملخصًا بصيغة CSV‑like يتضمن:
  • علامة [+] خضراء لـ “بنية RSC / Next.js محتملة” (درجة ≥ 50).
  • علامة [-] حمراء لـ “غير محتمل / لم يتم اكتشافه” أو الأخطاء.
• يستخدم HTTPS افتراضيًا، مع الرجوع إلى HTTP في حال وجود مشكلة في SSL.

هذه الأداة مخصصة لـالبحث والاختبارات الأمنية الدفاعية. لا تستخدمها على أنظمة غير مصرح لك باختبارها.

---

التثبيت

1. استنسخ (Clone) أو حمّل هذا المستودع.

2. ثبّت تبعيات Python:

   pip install aiohttp
   

3. تأكد من أن لديك Python 3.8+.

---

الإعداد

أنشئ ملف List.txt في نفس المجلد الذي يحتوي على rsc_infra_scan.py.

• نطاق واحد أو URL واحد في كل سطر.
• # في بداية السطر يُعتبر تعليقًا.
• يمكنك خلط النطاقات المجردة وعناوين URL الكاملة.

مثال List.txt:

# Example targets
example.com
https://subdomain.example.org
nextjs-demo.vercel.app

---

الاستخدام

شغّل الماسح من المجلد الذي يحتوي على rsc_infra_scan.py وList.txt:

python rsc_infra_scan.py

سيقوم السكربت بـ:

• قراءة List.txt.
• إزالة النطاقات المكررة.
• فحص كل هدف بشكل متزامن.
• طباعة جدول بصيغة CSV‑like إلى stdout.

---

تنسيق المخرجات

الترويسة:

domain,status,is_rsc_like,score,signals_or_error

أمثلة على الصفوف:

example.com,[+],yes,75,HTML:(window|self)\.__next_f\s*=; HDR:x-nextjs-cache=HIT
legacy-site.org,[-],no,0,
bad-ssl.test,[-],ERROR,0,SSL: CERTIFICATE_VERIFY_FAILED

حيث:

• status:
  • [+] (أخضر في طرفية تدعم ANSI) → يبدو أنه يستخدم بنية Next.js App Router / RSC‑style.
  • [-] (أحمر) → لا توجد إشارات قوية أو حدث خطأ.
• is_rsc_like:
  • yes عندما تكون score >= 50.
  • no فيما عدا ذلك.
• score:
  • درجة استدلالية من 0–100، بناءً على أنماط HTML والترويسات.
• signals_or_error:
  • قائمة مفصولة بفواصل منقوطة من الإشارات المطابقة (مثل HTML:..., HDR:...) أو رسالة خطأ.

---

كيف يعمل الكشف (مستوى عالٍ)

يرسل الماسح طلب GET واحدًا لكل هدف (مع الرجوع إلى HTTP إذا فشل HTTPS) ويفحص:

1. نص HTML

   • window.__next_f → مؤشر قوي على Next.js App Router / RSC.
   • react-server-dom-webpack → مرجع مكتبة RSC.
   • id="__next" → حاوية الجذر العامة لـ Next.js.

2. ترويسات الاستجابة

   • x-nextjs-cache
   • x-nextjs-matched-path
   • x-nextjs-page
   • x-nextjs-router-state-tree
   • Content-Type: text/x-component

تساهم كل إشارة في الدرجة الإجمالية. الدرجة ≥ 50 تعني أن النطاق “شبيه ببنية RSC‑infra”.

ملاحظة: هذا ليس ماسح ثغرات. لا يمكنه إخبارك ما إذا كان CVE معين (مثل CVE-2025-55182 أو CVE-2025-66478) قابلاً للاستغلال، فقط ما إذا كانت الحزمة تبدو كبنية Next.js/RSC التي قد تكون متأثرة. تحقق دائمًا من حالة الثغرة الفعلية من خلال الاختبارات الأمنية السليمة واستشر إرشادات البائعين الرسمية.

---

الاستخدام القانوني والأخلاقي

• افحص فقط الأنظمة التي:
  • تملكها بنفسك، أو
  • لديك إذن كتابي صريح لاختبارها.
• لا تتعامل مع الكشف الاستدلالي كدليل على وجود ثغرة؛ اتبع دائمًا إرشادات الإفصاح المنسق والتصحيح الصادرة عن البائعين.

---

المراجع

لمزيد من المعلومات حول الثغرات التي تساعد هذه الأداة في تحديدها:

• CVE-2025-55182: NIST NVD
• CVE-2025-66478: NIST NVD (مكررة لـ CVE-2025-55182)
• استشارة React الأمنية: تحقق من مستودع React الرسمي للاستشارات الأمنية
• استشارة Next.js الأمنية: تحقق من مستودع Next.js الرسمي ومجتمع Vercel للتحديثات

---

إخلاء مسؤولية

هذا المشروع مقدم لأغراض تعليمية وبحثية فقط.

المؤلفون غير مسؤولين عن أي إساءة استخدام أو ضرر ناتج عن هذا البرنامج.
أنت وحدك المسؤول عن الامتثال لجميع القوانين واللوائح المعمول بها عند استخدام هذه الأداة.