مستكشف الثغرات (Exploit Mapper)

منصة شاملة لإدارة الثغرات الأمنية تقوم بتحليل تقارير المسح الأمني، وإثراء بيانات الثغرات بمعلومات الاستغلالات، وتقديم تقييم للمخاطر قابل للتنفيذ من أجل تحديد أولويات المعالجة.

الميزات

استيراد متعدد التنسيقات: دعم تقارير الثغرات بصيغ CSV وExcel من ماسحات ضوئية مختلفة (Nessus وQualys وArctic Wolf وOpenVAS والمزيد)
كشف تلقائي للأعمدة: تعيين ذكي لأسماء الأعمدة الخاصة بالماسح إلى الحقول القياسية
إثراء بالاستغلالات: بحث تلقائي في قائمة CISA KEV (الثغرات المستغلة المعروفة) وقاعدة Exploit-DB
محرك تقييم المخاطر: درجات مخاطر سياقية بناءً على CVSS وتوفر الاستغلال وأهمية الأصول
إضافة ثغرات يدوية (غير نظامية): القدرة على إضافة ثغرات يدويًا لقبول أن الماسح لا يستطيع اكتشافها؛ مثل استخدام TLS v1 للتطبيق XYZ.
لوحة تحكم تفاعلية: مقياس مخاطر فوري، وتفصيل حسب الشدة، وتحليل الاتجاهات
إدارة الأجهزة: تتبع الثغرات حسب المضيف/الجهاز مع معلومات نظام التشغيل والأهمية
تتبع المعالجة: سير عمل الحالة، والتعيين، وتتبع الحل
مصادقة المستخدم: التحكم في الوصول القائم على الأدوار (مسؤول، مستخدم، مشاهد)
آمنة بالتصميم: التحقق من صحة الملفات المتوافق مع OWASP، وتجزئة كلمة المرور باستخدام PBKDF2، وإدارة الجلسات

*** استخدام عملية إثراء CVE في التحميل الأول قد يبطئ عملية التحميل، حيث سيحاول فقط إثراء الثغرات المرفوعة التي تم وضع علامة عليها كقابلة للاستغلال من مسحك، ولكن يمكن أن يختلف التوقيت بشكل كبير حسب حجم الملف المرفوع.*** Uploads

لوحة التحكم

توفر لوحة التحكم نظرة عامة سريعة على وضعك الأمني من خلال:

مقياس درجة المخاطر الإجمالي
رسوم بيانية لتوزيع الشدة
أهم الثغرات القابلة للاستغلال
تتبع تقدم المعالجة

قائمة الثغرات

تصفح الثغرات وتصفيتها وفرزها حسب:

الشدة، درجة المخاطر، CVSS
توفر الاستغلال
حالة CISA KEV
المضيف/الجهاز
الحالة (مفتوحة، قيد التقدم، تم حلها)

Vuln-list

تفاصيل الثغرة

عرض تفصيلي يتضمن:

توصيات الماسح
الإجراءات المطلوبة من CISA KEV
سيناريوهات الهجوم
النتائج ذات الصلة عبر الأجهزة
سير عمل المعالجة

Vuln-details

المتطلبات الأساسية

Node.js >= 18.0.0
npm >= 9.0.0
Git (لاستنساخ المستودع)
متصفح ويب حديث (Chrome وFirefox وEdge وSafari)

تثبيت المتطلبات الأساسية

Windows

الخيار أ: استخدام المثبّت

قم بتنزيل Node.js LTS من https://nodejs.org
قم بتشغيل المثبّت واتبع التعليمات
تأكد من تحديد "Add to PATH" أثناء التثبيت
افتح موجه أوامر جديد أو PowerShell وتحقق من:
```
node --version
npm --version
```

الخيار ب: استخدام إصدار Node ثابت (موصى به)

قم بتنزيل nvm-windows من https://github.com/coreybutler/nvm-windows
قم بتشغيل المثبّت واتبع التعليمات

nvm install 22.12.0
nvm use 22.12.0

الخيار ج: استخدام winget (مدير حزم Windows)

winget install OpenJS.NodeJS.LTS
winget install Git.Git

الخيار د: استخدام Chocolatey

choco install nodejs-lts
choco install git

macOS

باستخدام Homebrew:

brew install node
brew install git

أو قم بتنزيل المثبّت من https://nodejs.org

تحقق من التثبيت:

node --version
npm --version

Linux (Ubuntu/Debian)

# استخدام مستودع NodeSource لأحدث إصدار LTS
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs git

# تحقق
node --version
npm --version

التثبيت

1. استنساخ المستودع

macOS / Linux:

git clone https://github.com/jrokz2315/exploit-mapper.git
cd exploit-mapper

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

git clone https://github.com/jrokz2315/exploit-mapper.git
cd exploit-mapper

Windows (PowerShell):

git clone https://github.com/jrokz2315/exploit-mapper.git
cd exploit-mapper

2. تثبيت التبعيات

جميع المنصات:

npm run install:all

أو التثبيت يدويًا:

macOS / Linux:

npm install
cd server && npm install
cd ../client && npm install
cd ..

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

npm install
cd server && npm install
cd ..\client && npm install
cd ..

Windows (PowerShell):

npm install
cd server; npm install
cd ..\client; npm install
cd ..

ملاحظة (Windows): إذا واجهت أخطاء مع better-sqlite3، قد تحتاج إلى تثبيت أدوات بناء Windows:
npm install --global windows-build-tools
أو قم بتثبيت أدوات بناء Visual Studio مع عبء عمل "Desktop development with C++" من https://visualstudio.microsoft.com/visual-cpp-build-tools/

3. بدء التطبيق

وضع التطوير (مع إعادة التحميل الفوري) — جميع المنصات:

npm run dev

يؤدي هذا إلى بدء خادم الخلفية (المنفذ 3000) وخادم الواجهة الأمامية للتطوير (المنفذ 5173).

وضع الإنتاج — جميع المنصات:

# بناء العميل
npm run build

# بدء الخادم
npm start

4. الوصول إلى التطبيق

افتح متصفحك وانتقل إلى:

التطوير: http://localhost:5173
الإنتاج: http://localhost:3000

5. تسجيل الدخول الافتراضي

عند التشغيل الأول، يتم إنشاء حساب مسؤول افتراضي:

اسم المستخدم: admin
كلمة المرور: Admin123!

سيُطلب منك تغيير كلمة المرور هذه عند أول تسجيل دخول.

هيكل المشروع

exploit-mapper/
├── client/                 # الواجهة الأمامية React
│   ├── src/
│   │   ├── components/     # مكونات واجهة المستخدم القابلة لإعادة الاستخدام
│   │   ├── pages/          # مكونات الصفحات
│   │   └── App.jsx         # المكون الرئيسي للتطبيق
│   ├── package.json
│   └── vite.config.js
├── server/                 # الخلفية Express
│   ├── src/
│   │   ├── db/             # مخطط قاعدة البيانات والاتصال
│   │   ├── middleware/     # الوسائط الوسيطة للمصادقة
│   │   ├── routes/         # مسارات API
│   │   └── services/       # منطق الأعمال
│   ├── data/               # قاعدة بيانات SQLite (ملف .gitignore)
│   ├── uploads/            # تخزين مؤقت للتحميل (ملف .gitignore)
│   └── package.json
├── package.json            # جذر الحزمة مع البرامج النصية
├── .gitignore
├── LICENSE
├── CONTRIBUTING.md
└── README.md

نقاط نهاية API

المصادقة

لوحة التحكم

الثغرات

الأجهزة

الطريقة

التحميل

التقارير

الطريقة	نقطة النهاية	الوصف
`GET`	`/api/reports`	قائمة التقارير المرفوعة
`GET`	`/api/reports/:id/export`	تصدير التقرير

تنسيقات الماسحات الضوئية المدعومة

يكتشف Exploit Mapper تلقائيًا الأعمدة من الماسحات الضوئية المختلفة ويقوم بتعيينها:

تعيين الأعمدة

يقوم المحلل بتعيين أسماء الأعمدة الشائعة تلقائيًا:

تقييم المخاطر

درجة مخاطر الثغرة الفردية

درجة المخاطرة = درجة CVSS + التعديلات

التعديلات:
  +0.5 إذا كانت ضمن CISA KEV (مستغلة بنشاط)
  +0.3 إذا كان استغلال عام متاح

درجة المخاطر الإجمالية للمؤسسة

الإجمالي = (أقصى مخاطرة × 30%) + (متوسط المخاطرة × 40%) + (متوسط القابل للاستغلال × 20%) + (الكثافة × 10%)

في حالة وجود CISA KEV: اضرب في 1.05

التكوين

متغيرات البيئة

قم بإنشاء ملف .env في دليل server/ (اختياري — راجع server/.env.example):

PORT=3000
NODE_ENV=production
SESSION_SECRET=your-secret-key

قاعدة البيانات

يستخدم Exploit Mapper SQLite للتخزين بدون تكوين. يتم إنشاء قاعدة البيانات تلقائيًا في server/data/exploit-mapper.db عند التشغيل الأول.

اعتبارات الأمان

يتم تجزئة كلمات المرور باستخدام PBKDF2 مع 100,000 تكرار وSHA-512
رموز الجلسة هي قيم عشوائية آمنة تشفيريًا 256 بت
يتم التحقق من صحة تحميلات الملفات من حيث النوع والحجم (500 ميجابايت كحد أقصى) ووحدات البايت السحرية
تستخدم استعلامات SQL عبارات ذات معلمات في جميع الأنحاء
يتم تكوين CORS لمنشأ الواجهة الأمامية فقط
حساب المسؤول الافتراضي يتطلب تغيير كلمة المرور عند أول تسجيل دخول

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة

المنفذ قيد الاستخدام بالفعل

Windows:

netstat -ano | findstr :3000
taskkill /PID <pid> /F

macOS / Linux:

lsof -i :3000
kill -9 <pid>

أخطاء بناء better-sqlite3 على Windows

تتطلب هذه الوحدة الأصلية أدوات بناء C++:

:: الخيار 1: التثبيت عبر npm
npm install --global windows-build-tools

:: الخيار 2: تثبيت أدوات بناء Visual Studio
:: قم بالتنزيل من https://visualstudio.microsoft.com/visual-cpp-build-tools/
:: حدد عبء عمل "Desktop development with C++"

بعد التثبيت، احذف node_modules وأعد التثبيت:

cd server
rmdir /s /q node_modules
npm install

قاعدة البيانات مقفلة

تأكد من تشغيل مثيل واحد فقط من الخادم. على Windows:

tasklist | findstr node
taskkill /IM node.exe /F

على macOS / Linux:

pkill -f "node.*index.js"

فشل التحميل

تحقق من حجم الملف (500 ميجابايت كحد أقصى)
تأكد من أن الملف بصيغة .csv أو .xlsx أو .xls
تحقق من أن الملف يحتوي على عمود عنوان/اسم واحد على الأقل
تحقق من وحدة تحكم الخادم للحصول على رسائل خطأ مفصلة

npm run dev يفشل على Windows

إذا فشل concurrently، حاول تشغيل الخادم والعميل بشكل منفصل في نافذتين طرفيتين:

الطرفية 1 (الخادم):

cd server
npm run dev

الطرفية 2 (العميل):

cd client
npm run dev

المساهمة

راجع CONTRIBUTING.md للحصول على إرشادات مفصلة.

قم بعمل Fork للمستودع
أنشئ فرع ميزة (git checkout -b feature/amazing-feature)
قم بعمل Commit للتغييرات (git commit -m 'Add amazing feature')
ادفع إلى الفرع (git push origin feature/amazing-feature)
افتح طلب سحب

الترخيص

هذا المشروع مرخص بموجب رخصة MIT — راجع ملف LICENSE للحصول على التفاصيل.

شكر وتقدير

CISA KEV Catalog لبيانات الاستغلال
NVD لبيانات CVE
Exploit-DB لمعلومات الاستغلال
Lucide Icons لمجموعة الأيقونات
Tailwind CSS للتصميم
Recharts لتصور البيانات

`POST`	`/api/auth/login`	تسجيل دخول المستخدم
`POST`	`/api/auth/logout`	تسجيل خروج المستخدم
`GET`	`/api/auth/me`	الحصول على المستخدم الحالي
`POST`	`/api/auth/change-password`	تغيير كلمة المرور

`GET`	`/api/dashboard/summary`	مقاييس لوحة التحكم
`GET`	`/api/dashboard/risk`	تفصيل المخاطر
`GET`	`/api/dashboard/trends`	الاتجاهات التاريخية
`GET`	`/api/dashboard/executive-summary`	ملخص تنفيذي

`GET`	`/api/vulnerabilities`	القائمة (مع التصفية/الترقيم)
`GET`	`/api/vulnerabilities/:id`	تفاصيل الثغرة
`GET`	`/api/vulnerabilities/exploitable`	القابلة للاستغلال فقط
`GET`	`/api/vulnerabilities/stats/summary`	الإحصائيات
`PATCH`	`/api/vulnerabilities/:id`	تحديث الحالة
`PATCH`	`/api/vulnerabilities`	تحديث جماعي
`POST`	`/api/vulnerabilities/manual`	إضافة إدخال يدوي
`DELETE`	`/api/vulnerabilities/:id`	حذف إدخال يدوي

`GET`	`/api/devices`	قائمة الأجهزة
`GET`	`/api/devices/:id`	تفاصيل الجهاز
`PATCH`	`/api/devices/:id`	تحديث معلومات الجهاز

`POST`	`/api/upload`	تحميل تقرير الثغرات
`GET`	`/api/upload/info`	إحصائيات التحميل
`DELETE`	`/api/upload/clear`	مسح جميع البيانات

Exploit-Mapper

الأكثر شعبية

Arctic Wolf	أعمدة `risk_id`، `asset_category`
Nessus/Tenable	عمود `plugin_id`
Qualys	عمود `qid`
OpenVAS	عمود `nvt`
Nexpose/Rapid7	معرف `nexpose`
CSV/Excel عام	مطابقة ذكية لأسماء الأعمدة

CVE	`cve`, `cves`, `cve_id`, `vulnerability_id`
العنوان	`name`, `title`, `vulnerability`, `plugin_name`
الوصف	`description`, `synopsis`, `summary`
الحل	`solution`, `remediation`, `fix`, `recommendation`
الشدة	`severity`, `risk_severity`, `risk_level`
درجة CVSS	`cvss`, `cvss_score`, `cvssv3_score`
المضيف	`hostname`, `asset_name`, `host_name`, `fqdn`
عنوان IP	`ip_address`, `host_ip`, `asset_ip`

أقصى درجة مخاطرة	30%	أعلى درجة مخاطرة لثغرة واحدة
متوسط درجة المخاطرة	40%	المتوسط عبر جميع الثغرات
متوسط المخاطرة للقابلة للاستغلال	20%	متوسط الثغرات القابلة للاستغلال فقط
عامل الكثافة	10%	`log10(total_vulns + 1) x 3` (الحد الأقصى 10)