BinAIVulHunter

مكوّن إضافي لبرنامج IDA Pro للمساعدة في اكتشاف الثغرات الأمنية في الملفات الثنائية.

استخدم مفكك أكواد IDA Pro HexRays مع OpenAI (ChatGPT) للعثور على الثغرات الأمنية المحتملة في الملفات الثنائية

إخلاء مسؤولية: قد تؤدي الردود المحتملة أثناء محاولة العثور على ثغرات أمنية في الملفات الثنائية باستخدام الذكاء الاصطناعي إلى نتائج إيجابية كاذبة، ومع ذلك فقد نجح الأمر في العديد من مسابقات CTF التي عملت عليها (سهلة/متوسطة ... وبعضها صعبة)

مستوحى من Gepetto : https://github.com/JusticeRage/Gepetto

التثبيت:

ضع ملف البايثون النصي في مجلد إضافات (Plugins) الخاص بـ IDA Pro.

طريقة الاستخدام:

انقر بزر الماوس الأيمن على الكود المُفكَّك، ثم اختر "Find possible vulnerability in function"

تم تحديثه بميزة إنشاء نموذج استغلال (Exploit) بلغة بايثون (أحياناً جيد، وأحياناً سيئ)

تم تحديثه بميزتي Gepetto لإعادة التسمية والشرح

BinAIVulHunter - مكوّن إضافي لتحليل الثغرات الأمنية بالذكاء الاصطناعي لبرنامج IDA Pro

BinAIVulHunter هو مكوّن إضافي متقدم لبرنامج IDA Pro يستفيد من عدة مزودي ذكاء اصطناعي (OpenAI GPT وGoogle Gemini وOllama) لإجراء تحليل ذكي للثغرات الأمنية، وشرح الكود، وتقييم أمان الدوال المُفكَّكة.

🚀 الميزات

• دعم متعدد لمزودي الذكاء الاصطناعي: اختر بين OpenAI GPT أو Google Gemini أو Ollama
• اكتشاف الثغرات الأمنية: فحص تلقائي استناداً إلى تصنيف CWE (تعداد نقاط الضعف الشائعة)
• شرح الكود: تحليل وشرح الدوال المُفكَّكة باستخدام الذكاء الاصطناعي
• إعادة تسمية المتغيرات: اقتراحات ذكية لأسماء أفضل للمتغيرات والدوال
• المعالجة بالدفعات: فحص جميع الدوال في ملف ثنائي مع إدارة الذاكرة
• تكامل مرجع CWE: بحث مدمج في CWE وتصنيف تفصيلي للثغرات الأمنية
• الوضع بدون واجهة (Headless): دعم سطر الأوامر للتحليل الآلي
• دعم الذكاء الاصطناعي المحلي: تحليل يركز على الخصوصية مع Ollama (بدون اعتماد على السحابة)

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

• التثبيت
• إعداد مزود الذكاء الاصطناعي
  • OpenAI
  • Google Gemini
  • Ollama (ذكاء اصطناعي محلي)
• الإعدادات
• الاستخدام
  • الوضع التفاعلي
  • قائمة السياق
  • لوحة التحكم
  • الوضع بدون واجهة (Headless)
• فئات الثغرات الأمنية
• أمثلة
• استكشاف الأخطاء وإصلاحها
• المساهمة
• الترخيص

🛠 التثبيت

1. قم بتنزيل المكوّن الإضافي:

   # Save BinAIVulHunter.py to your IDA Pro plugins directory
   # Typically: C:\Program Files\IDA Pro X.X\plugins\
   

2. ثبّت التبعيات الأساسية:

   pip install psutil
   

3. ثبّت مكتبات مزودي الذكاء الاصطناعي (اختر واحدة أو أكثر):

   # For OpenAI
   pip install openai
   
   # For Google Gemini
   pip install google-generativeai
   
   # For Ollama (local AI)
   pip install requests
   

4. أعد تشغيل IDA Pro لتحميل المكوّن الإضافي

🤖 إعداد مزود الذكاء الاصطناعي

OpenAI

1. احصل على مفتاح API:

   • قم بزيارة مفاتيح OpenAI API
   • أنشئ مفتاح API جديداً

2. عيّن متغير البيئة:

   # Windows Command Prompt
   set OPENAI_API_KEY=sk-your-openai-key-here
   
   # PowerShell
   $env:OPENAI_API_KEY="sk-your-openai-key-here"
   
   # Linux/Mac
   export OPENAI_API_KEY="sk-your-openai-key-here"
   

3. أعد تشغيل IDA Pro

Google Gemini

1. احصل على مفتاح API:

   • قم بزيارة Google AI Studio
   • أنشئ مفتاح API جديداً

2. عيّن متغير البيئة:

   # Windows Command Prompt
   set GEMINI_API_KEY=your-gemini-key-here
   
   # PowerShell
   $env:GEMINI_API_KEY="your-gemini-key-here"
   
   # Linux/Mac
   export GEMINI_API_KEY="your-gemini-key-here"
   

3. أعد تشغيل IDA Pro

Ollama (ذكاء اصطناعي محلي)

1. ثبّت Ollama:

   • قم بزيارة Ollama.ai ونزّل المثبّت
   • أو استخدم مديري الحزم:

     # Linux
     curl -fsSL https://ollama.ai/install.sh | sh
     
     # macOS
     brew install ollama
     

2. شغّل خدمة Ollama:

   ollama serve
   

3. اسحب نماذج الذكاء الاصطناعي:

   # For general code analysis
   ollama pull llama2
   
   # For coding tasks (recommended)
   ollama pull codellama
   
   # Other specialized models
   ollama pull mistral
   ollama pull deepseek-coder
   

4. متغيرات بيئة اختيارية:

   # Custom Ollama server (if not localhost:11434)
   set OLLAMA_BASE_URL=http://your-server:11434
   
   # Set default model
   set OLLAMA_MODEL=codellama
   

⚙️ الإعدادات

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

المتغير	الوصف	الافتراضي	مطلوب
OPENAI_API_KEY	مفتاح API الخاص بـ OpenAI	لا يوجد	لـ OpenAI
GEMINI_API_KEY	مفتاح API الخاص بـ Google Gemini	لا يوجد	لـ Gemini
OLLAMA_BASE_URL	عنوان URL لخادم Ollama	http://localhost:11434	لا
OLLAMA_MODEL	نموذج Ollama الافتراضي	llama2	لا
VULCHAT_PROVIDER	مزود الذكاء الاصطناعي المستخدم	openai	لا
VULCHAT_MODEL	اسم نموذج محدد	الافتراضي للمزود	لا
OPENAI_BASE_URL	نقطة نهاية مخصصة لـ OpenAI	واجهة API الرسمية	لا

اختيار المزود

عيّن مزود الذكاء الاصطناعي المفضل لديك:

# Use OpenAI (default)
set VULCHAT_PROVIDER=openai

# Use Google Gemini
set VULCHAT_PROVIDER=gemini

# Use Ollama (local)
set VULCHAT_PROVIDER=ollama

🎯 الاستخدام

الوضع التفاعلي

1. افتح IDA Pro مع ملفك الثنائي
2. انتقل إلى عرض المفكك (F5)
3. الوصول إلى VulChat عبر:
   • القائمة: Edit → VulChat
   • قائمة السياق: انقر بزر الماوس الأيمن في عرض المفكك
   • اختصارات لوحة المفاتيح (انظر أدناه)

قائمة السياق

انقر بزر الماوس الأيمن في عرض المفكك للوصول إلى:

• Find Possible Vulnerability - تحليل الدالة الحالية بحثاً عن مشاكل أمنية
• Explain - الحصول على شرح بالذكاء الاصطناعي لسلوك الدالة
• Rename Variables - الحصول على اقتراحات ذكية لتسمية المتغيرات
• Generate Safe Test Inputs - إنشاء حالات اختبار للدالة
• Scan All - فحص دفعاتي للثغرات الأمنية في الملف الثنائي بأكمله
• CWE Info - البحث عن تفاصيل ثغرات CWE
• Control Panel - التبديل بين مزودي الذكاء الاصطناعي وضبط الإعدادات

لوحة التحكم

الوصول عبر Edit → VulChat → Control Panel أو Ctrl+Alt+P:

• التبديل بين مزودي الذكاء الاصطناعي: التنقل بين OpenAI وGemini وOllama
• اختيار النموذج: اختيار نماذج محددة لكل مزود
• معلومات الحالة: عرض الإعدادات الحالية وتوفر المزود
• دليل الإعداد: الحصول على تعليمات إعداد مفصلة

اختصارات لوحة المفاتيح

الاختصار	الإجراء
Ctrl+Alt+V	العثور على الثغرات
Ctrl+Alt+G	شرح الدالة
Ctrl+Alt+R	إعادة تسمية المتغيرات
Ctrl+Alt+X	إنشاء مدخلات اختبار
Ctrl+Alt+S	فحص جميع الدوال
Ctrl+Alt+W	البحث في مرجع CWE
Ctrl+Alt+P	لوحة التحكم
Ctrl+F5	تفكيك جميع الدوال

الوضع بدون واجهة (Headless)

للتحليل الآلي والتكامل مع CI/CD:

# Scan all functions for vulnerabilities
ida64.exe -A -S"BinAIVulHunter.py --scan-all --output results.json" binary.exe