مولد تقارير Nuclei إلى PDF

أداة تشغيل آلي احترافية مصممة لسد الفجوة بين المسح الفني للثغرات وإعداد التقارير التنفيذية. تم تطويرها بواسطة Adi Mahluf (Tenroot Cyber Security).

🚀 نظرة عامة

يوفر هذا المشروع سير عمل "أمر واحد" سلسًا لتدقيق أصول الويب. يستخدم محرك Nuclei عالي الأداء لتحديد الثغرات والتكوينات الخاطئة، ثم يقوم تلقائيًا بتجميع النتائج الأولية في تقرير PDF منسق وجاهز للعميل. تم تصميمه خصيصًا لمهندسي الأمن وفرق الاستجابة للحوادث الذين يحتاجون إلى تقديم بيانات واضحة وقابلة للتنفيذ لأصحاب المصلحة.

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

لضمان عمل الأداة بشكل صحيح عبر بيئات مختلفة، يجب تثبيت المكونات التالية على محطة العمل الخاصة بك.

1. محرك Nuclei (الإصدار v3.x+)

محرك المسح الأساسي. تأكد من استخدام الإصدار 3.0 أو أعلى لدعم القوالب والأعلام الحديثة.

go install -v [github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest](https://github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest)

2. Python 3 والبيئة الافتراضية

يتطلب سكريبت إعداد التقارير Python 3.10+ ومكتبة fpdf2 للحصول على ميزات PDF الحديثة ودعم Unicode. تعليمات الإعداد:

# تثبيت أدوات venv إذا كانت مفقودة (Ubuntu/WSL)
sudo apt update && sudo apt install python3-venv python3-full -y
# إنشاء البيئة وتكوينها
python3 -m venv venv
./venv/bin/pip install fpdf2

3. أدوات مساعدة

مطلوبة للتعامل مع أذونات السكريبتات والتشفير عبر المنصات.

sudo apt install dos2unix -y

📥 التثبيت

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

git clone [https://github.com/YourUsername/Nuclei-PDF-Generator.git](https://github.com/YourUsername/Nuclei-PDF-Generator.git)
cd Nuclei-PDF-Generator

2. إصلاح التشفير والأذونات: تأكد من أن السكريبتات لديها حقوق التنفيذ واستخدام نهايات الأسطر بنظام Unix.

chmod +x scan.sh
dos2unix scan.sh generate_report.py

3. إضافة علامتك التجارية: ضع شعار شركتك في المجلد الرئيسي للمشروع وقم بتسميته logo.png بالضبط.

##📑 الاستخدام قم بتشغيل سكريبت التدقيق عن طريق توفير النطاق المستهدف. يتم تعيين السكريبت افتراضيًا إلى الوضع الخفي (Stealth Mode) (محدد المعدل) لتجنب الحظر من قبل جدران الحماية لتطبيقات الويب (WAF).

./scan.sh <domain_name> [--aggressive]

• مثال (خفي): ./scan.sh tenroot.io
• مثال (عدواني): ./scan.sh internal-site.local --aggressive

ستقوم الأداة بإنشاء ملف باسم: Report_domain.com_YYYYMMDD-HHMM.pdf.

📋 ميزات التقرير

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

📷 الصور

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

إخلاء المسؤولية: هذه الأداة مخصصة لاختبارات الأمن المصرح بها فقط. لا يتحمل المطور أي مسؤولية عن سوء الاستخدام أو الضرر الناجم عن هذا التطبيق.