⚡ Ch4120N CVE Pulse

مُجمِّع CVE PoC المباشر مع البحث الذكي واستخبارات التهديدات

CVE Pulse يكتشف ويقيّم ويفهرس تلقائيًا إثباتات المفهوم (Proof‑of‑Concepts) لثغرات CVE من GitHub.
يثريها بـ درجات EPSS وبيانات CISA KEV، ويبني لقطات وفروقات يومية، ويقدّم موقعًا ثابتًا سريعًا وقابلًا للبحث

📋 جدول المحتويات

• 👨‍💻 منشئ المشروع
• 🎯 ما الذي يفعله
• ✨ الميزات الرئيسية
• 🧱 البنية
• ⚙️ كيف يعمل
• 🚀 البدء السريع
• 📦 التثبيت
• 💻 الاستخدام
  • الأوامر الفرعية
  • خط الأنابيب الكامل
• 📊 المخرجات والموقع
• 🗂️ هيكل المشروع
• 🔧 الإعدادات
• 📡 مصادر البيانات
• 📅 الأتمتة (CI/CD)
• 📈 أكثر PoCs رواجًا
• ⚠️ إخلاء المسؤولية
• 📄 الترخيص

👨‍💻 منشئ المشروع

Ch4120N – مهتم بالأمن ومحب للأتمتة.
📧 [email protected]

🎯 ما الذي يفعله

1. يجلب أحدث درجات EPSS وكتالوج الثغرات المستغلة المعروفة (KEV) من CISA.
2. يفحص GitHub بحثًا عن المستودعات التي تحتوي على إثباتات مفهوم استغلال لثغرات CVE (باستخدام البحث + بيانات GraphQL الوصفية).
3. يقيّم كل مرشح باستخدام نموذج ثقة (النجوم، الحداثة، تطابق الكلمات المفتاحية، القائمة السوداء، إلخ).
4. يدمج بيانات PoC مع EPSS وKEV، ثم يبني واجهة JSON API كاملة.
5. يولّد موقعًا ثابتًا مع محرك بحث قوي من جانب العميل.
6. ينشئ لقطات يومية وفروقات لتتمكن من تتبع إثباتات المفهوم الجديدة عالية الثقة.

✨ الميزات الرئيسية

• 🔍 اكتشاف تلقائي لـ PoC – بحث متعدد النوافذ في أكواد ومستودعات GitHub
• 🧠 تقييم ذكي – مطابقات الكود مقابل التوثيق، عدد النجوم، الحداثة، القائمة السوداء، والاستدلالات
• 📈 تكامل EPSS وKEV – دمج قائمة KEV الخاصة بـ CISA ودرجات EPSS الخاصة بـ FIRST مع بيانات PoC
• 📊 لقطات وفروقات يومية – اطّلع على الجديد، وما تم ترقيته إلى "ثقة عالية"، وما تمت إزالته
• 🌐 موقع قابل للبحث – بحث ضبابي حسب معرّف CVE، المورّد، المنتج، الكلمة المفتاحية، مع مرشحات سلبية (-windows)
• 🚀 مؤتمت بالكامل – خطوط أنابيب GitHub Actions تحدّث كل شيء وفق جدول زمني
• 💾 بدون تكاليف خوادم – جميع البيانات ثابتة بصيغة JSON/HTML، مستضافة على GitHub Pages
• 🛡️ دعم القائمة السوداء – تجاهل المستودعات المزعجة أو غير ذات الصلة

🧱 البنية

⚙️ كيف يعمل

1. fetch-epss ينزّل أفضل 2000 ثغرة CVE حسب درجة EPSS.
2. fetch-kev ينزّل كتالوج CISA KEV.
3. sync-cves يقرأ data/github.txt ويجلب بيانات CVE الوصفية من MITRE API، ثم ينشئ/يحدّث ملفات markdown لكل ثغرة CVE.
4. pipeline (أو أوامر build-* الفردية):
   • يبني نطاقًا من ثغرات CVE للفحص (من github.txt أو الثغرات ذات الثقة المنخفضة سابقًا).
   • يستخدم GitHub search API للعثور على المستودعات التي تذكر معرّف CVE.
   • يثري المرشحين ببيانات المستودع الوصفية (النجوم، اللغة، المواضيع) عبر GraphQL.
   • يقيّم كل مستودع ويعيّن مستوى ثقة (عالية، متوسطة، منخفضة).
   • يكتب ملفات JSON لكل ثغرة CVE، وفهرسًا، وقائمة أفضل 100.
   • ينشئ لقطة للحالة الحالية وفرقًا مقابل اليوم السابق.
5. build-site يولّد CVE_list.json وtrending_poc.json وصفحة HTML الثابتة.

🚀 البدء السريع```bash

Clone the repository

git clone https://github.com/Ch4120N/Ch4120N-CVE-Pulse.git cd Ch4120N-CVE-Pulse

Install dependencies

pip install -r requirements.txt

Download base data

python chCVEPulse.py fetch-epss python chCVEPulse.py fetch-kev

Sync your initial CVE list (from data/github.txt)

python chCVEPulse.py sync-cves

Run the full discovery pipeline (needs GITHUB_TOKEN for higher rate limits)

export GITHUB_TOKEN=your_token_here python chCVEPulse.py pipeline --days 7

Generate the static website

python chCVEPulse.py build-site

Open docs/index.html in your browser

## 📦 التثبيت

**المتطلبات:**
- Python 3.9+
- `pip`

قم بتثبيت الحزم:```bash
pip install -r requirements.txt

(يتضمن requirements.txt الحزم requests وjinja2 وأي تبعيات أخرى.)

💻 الاستخدام

تمر جميع العمليات عبر السكربت الواحد chCVEPulse.py.

الأوامر الفرعية

أمثلة:```bash

Fetch new data

python chCVEPulse.py fetch-epss --limit 2000 python chCVEPulse.py fetch-kev

Update a specific CVE

python chCVEPulse.py sync-cves --cve CVE-2025-12345

Full pipeline (daily mode)

python chCVEPulse.py pipeline --days 7 --mode daily --limit 50

Regenerate website only

python chCVEPulse.py build-site --html-mode summary

### خط الأنابيب الكامل

يمكن ضبط الأمر الفرعي `pipeline` بدقة:

- `--days` : عدد الأيام للرجوع إليها في البحث على GitHub (الافتراضي: 7)
- `--mode` : `daily` (أحدث ثغرات CVE، أسرع) أو `weekly` (فحص أوسع)
- `--limit` : الحد الأقصى لعدد ثغرات CVE المراد فحصها (الافتراضي: 50)
- `--cve` : تحديد معرف CVE واحد أو أكثر لفحصه
- `--skip-discovery` : إعادة توليد المخرجات فقط من البيانات الموجودة
- `--check-links` : التحقق من أن روابط المستودعات لا تزال فعّالة

---

## 📊 المخرجات والموقع الإلكتروني

بعد تشغيل ناجح لخط الأنابيب، يحتوي `docs/` على:

- **`index.html`** – صفحة البحث الرئيسية (مدعومة بـ `logic.js` و `style.css`)
- **`CVE_list.json`** – جميع ثغرات CVE مع الأوصاف وروابط PoC
- **`trending_poc.json`** – إثباتات المفهوم (PoCs) المحدّثة حديثًا (من README المحدّث تلقائيًا)
- **`api/v1/`** – نقاط نهاية JSON كاملة بنمط REST:
  - `joined_top.json` – ثغرات CVE ذات الأولوية العالية مع PoCs وحالة EPSS و KEV
  - `kev.json` – قائمة KEV المُثراة
  - `epss_top.json` – أعلى ثغرات CVE وفق EPSS مع PoCs
  - `cve/{CVE-ID}.json` – معلومات PoC مفصّلة لكل ثغرة CVE
  - `snapshots/` – لقطات حالة يومية
  - `diffs/` – التغييرات يومًا بيوم

يدعم البحث **المطابقة الضبابية**، ومرشحات البائع/المنتج، والمصطلحات السلبية (مثل `-windows`).

---

## 🗂️ بنية المشروع```
Ch4120N-CVE-Pulse/
├── chCVEPulse.py
├── scripts/
│   ├── config.py
│   ├── helpers.py
│   ├── github_api.py
│   ├── scoring.py
│   ├── discovery.py
│   ├── outputs.py
│   ├── diff.py
│   ├── joined.py
│   ├── site.py
│   ├── sync.py
│   ├── fetch_epss.py
│   ├── fetch_kev.py
│   └── pipeline.py
├── templates/
│   └── index.html# Jinja2 template for the website
├── data/
│   ├── github.txt# CVE -> PoC URL list (edit this)
│   ├── blacklist.txt
│   ├── cache/
│   └── evidence/
├── docs/
│   ├── api/v1/
│   └── index.html, style.css, logic.js
├── requirements.txt
└── README.md

🔧 الإعدادات

توجد جميع الإعدادات تقريبًا في scripts/config.py:

• GITHUB_SOURCES – المسار إلى ملف data/github.txt
• EPSS_API_URL، KEV_URL، CVE_API_TEMPLATE – نقاط نهاية واجهات API الخارجية
• HIGH_EPSS_THRESHOLD – الحد الأدنى لقيمة EPSS لتنبيهات "الخطورة العالية"
• TOP_KEV_COUNT – عدد إدخالات KEV المراد الاحتفاظ بها
• SNAPSHOT_RETENTION_DAYS – المدة التي يتم الاحتفاظ فيها باللقطات القديمة

📡 مصادر البيانات

يُنصح باستخدام رمز GitHub لزيادة حدود معدل API (يُضبط كمتغير بيئة GITHUB_TOKEN).

📅 الأتمتة (CI/CD)

ثلاثة سير عمل GitHub Actions تُبقي كل شيء محدّثًا:

• sync_cve_pocs.yml – يعمل يوميًا، يقرأ data/github.txt، ويجلب بيانات CVE الجديدة ويحدّث ملفات markdown.
• hot_cves.yml – يعمل كل 6 ساعات، ويحدّث قسم Trending PoCs في هذا README.
• site.yml – يبني وينشر الموقع الثابت على GitHub Pages.

جميع سير العمل موجودة في .github/workflows/.

📈 Trending PoCs

جدول Trending PoCs أدناه يتم تحديثه تلقائيًا كل 6 ساعات بواسطة خط أنابيب CI.

2026 (أحدث 20 من 584 مستودعًا)

2025 (أحدث 20 من 594 مستودعًا)

2024 (أحدث 20 من 636 مستودعًا)

2023 (أحدث 20 من 531 مستودعًا)

2022 (أحدث 20 من 560 مستودعًا)

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

هذا المشروع مخصص لاستخبارات التهديدات وإدارة الثغرات وأبحاث الأمن الدفاعي.
لا تستخدم المستودعات المرتبطة به لأي أنشطة غير قانونية أو غير مصرح بها.
لا يستضيف المؤلفون كود PoC ولا يؤيدونه – بل يقومون فقط بفهرسة المعلومات المتاحة للعموم.

📄 الترخيص

ترخيص GPLv3 – راجع ملف LICENSE للحصول على النص الكامل.