MORF

إطار الاستطلاع المحمول

أداة أمن هجومية قوية لتحليل تطبيقات الجوال

اكتشف الأسرار. احمِ التطبيقات. ابقَ آمنًا.

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

• 💡 نظرة عامة
• 🚀 بداية سريعة
• 🔍 الميزات الرئيسية
• 🏗️ البنية المعمارية
• 📋 حالات الاستخدام الشائعة
• 📦 التثبيت
  • المتطلبات الأساسية
  • الطريقة 1: Docker (موصى به)
  • الطريقة 2: البرنامج النصي للتشغيل
  • إعداد البيئة
• 🖥️ الاستخدام
  • الواجهة الإلكترونية
  • واجهة الأوامر
• 🏆 الاعتراف بالمؤتمرات
• 🛣️ خريطة التطوير
• 👨‍💻 المؤلفون
• 📄 الرخصة
• 🙏 شكر وتقدير

💡 نظرة عامة

MORF هي أداة متقدمة لتحليل أمن تطبيقات الجوال تكتشف تلقائيًا المعلومات الحساسة داخل تطبيقات Android وiOS. صممت خصيصًا لمتخصصي الأمن، ومختبري الاختراق، والمطورين، وتوفر MORF رؤى شاملة حول الوضع الأمني لتطبيقات الجوال.

🚀 بداية سريعة

يمكن تشغيل MORF في ثوانٍ باستخدام Docker أو البرنامج النصي المرفق:

# استنساخ المستودع والدخول إلى المجلد
git clone https://github.com/amrudesh1/morf && cd morf

# الخيار 1: استخدام البرنامج النصي للتشغيل (موصى به)
chmod +x run.sh && ./run.sh

# الخيار 2: استخدام Docker Compose
docker-compose up --build

ثم ببساطة زر http://localhost في متصفحك وارفع ملف APK أو IPA لبدء التحليل!

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

يقدم MORF قدرات تحليل أمني شاملة لتطبيقات الجوال:

🏗️ البنية المعمارية

يجمع MORF بين واجهة خلفية بلغة Go وواجهة أمامية بـ Angular لتحليل قوي مع واجهة بديهية:

📋 حالات الاستخدام الشائعة

📦 التثبيت

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

• Docker (موصى به لأسهل تثبيت)
• بديلاً عن ذلك: Go و Node.js لإعداد بيئة التطوير

الطريقة 1: Docker (موصى به)

لمستخدمي macOS، راجع README-LOCAL.md للحصول على دليل التطوير المحلي المفصل.

# استنساخ المستودع
git clone https://github.com/amrudesh1/morf
cd MORF

# تشغيل جميع الخدمات (MySQL, Redis, Backend, Frontend)
./run-local.sh start

# أو باستخدام docker-compose مباشرة
docker-compose up -d

الخدمات ستكون متاحة على:

• الواجهة الأمامية: http://localhost
• API الواجهة الخلفية: http://localhost:9092/api
• فحص الصحة: http://localhost:9092/api/health

الأوامر الشائعة:

./run-local.sh start    # تشغيل جميع الخدمات
./run-local.sh stop     # إيقاف جميع الخدمات
./run-local.sh status   # التحقق من حالة الخدمات
./run-local.sh logs     # عرض السجلات

الطريقة 2: البرنامج النصي للتشغيل

git clone https://github.com/amrudesh1/morf
cd morf
chmod +x run.sh
./run.sh

إعداد البيئة

يتطلب MORF متغير البيئة DATABASE_URL للاتصال بقاعدة البيانات الخاصة بك:

# macOS/Linux
export DATABASE_URL="root@tcp(localhost:3306)/Secrets?charset=utf8mb4&parseTime=True&loc=Local"

# Windows (CMD)
set DATABASE_URL=root@tcp(localhost:3306)/Secrets?charset=utf8mb4&parseTime=True&loc=Local

# Windows (PowerShell)
$env:DATABASE_URL = "root@tcp(localhost:3306)/Secrets?charset=utf8mb4&parseTime=True&loc=Local"

ملاحظة: Docker Compose سيستخدم تلقائيًا متغيرات البيئة المضبوطة على جهازك المضيف.

🖥️ الاستخدام

الواجهة الإلكترونية

بعد تشغيل MORF، قم بالوصول إلى الواجهة الإلكترونية البديهية على http://localhost واتبع الخطوات التالية:

1. ارفع ملف APK أو IPA باستخدام واجهة السحب والإفلات
2. انتظر حتى يقوم MORF بمعالجة وتحليل التطبيق
3. استكشف النتائج المفصلة، بما في ذلك:
   • الأسرار ومفاتيح API المكتشفة
   • تحليل أمان المكونات
   • تقييم الصلاحيات
   • رسم خرائط الروابط العميقة
   • بيانات وصفية شاملة

واجهة الأوامر

يوفر MORF أيضًا واجهة CLI قوية للأتمتة والتكامل:

# فحص أساسي مع إخراج وحدة التحكم
./morf cli --apk-path=/path/to/app.apk

🏆 الاعتراف بالمؤتمرات

المشاركات في المؤتمرات

🛣️ خريطة التطوير

👨‍💻 المؤلفون

@amrudesh1

📄 الرخصة

تم إصدار MORF بموجب رخصة MIT. راجع ملف LICENSE لمزيد من التفاصيل.

🙏 شكر وتقدير

• قاعدة بيانات أنماط الأسرار - قاعدة الأنماط المستخدمة بواسطة MORF لكشف الأسرار
• مجتمع الأمن مفتوح المصدر - للإلهام والملاحظات والدعم
• جميع المساهمين - كل من ساهم بشيفرة وملاحظات وأفكار في مشروع MORF