مجموعة اختبار أمان الأجهزة المحمولة مفتوحة المصدر لأنظمة iOS وAndroid. كانت تُعرف سابقًا باسم Passionfruit.
مجموعة أدوات لأدوات فحص تطبيقات الهاتف المحمول أثناء التشغيل، مدعومة بـ Frida. افحص تطبيقات الهاتف المحمول واعترض استدعاءاتها وعدّلها من خلال واجهة قائمة على الويب.
تدعم الآن كلاً من iOS وAndroid!
يتطلب تشغيل خادم Frida على جهازك. اتبع أدلة الإعداد الرسمية(Android) أولاً.
npm (موصى به، يتطلب Node.js 22.18+)
npm install -g igf
igf
أو التشغيل دون تثبيت (يتطلب Node.js 22.18+)
npx igf
ثنائيات مبنية مسبقًا لنظامي macOS وLinux وWindows متاحة على GitHub Releases. يستخدم كل من تطوير المصدر والملفات التنفيذية المبنية مسبقًا Node.js؛ راجع دليل التطوير للاطلاع على سير عمل npm.
igf [options] Start the server (default)
Options:
--frida <16 | 17> Frida version to use (default: 17)
--host <host> Host to bind (default: 127.0.0.1)
--port <port> Port to bind (default: 31337)
--project <path> Project directory for data/cache/logs (default: .igf in cwd)
--no-open Do not open browser on startup
--help, -h Show help message
| المتغير | الوصف | القيمة الافتراضية |
|---|---|---|
HOST | عنوان ربط الخادم | 127.0.0.1 |
PORT | منفذ الخادم | 31337 |
FRIDA_VERSION | الإصدار الرئيسي لـ Frida (16 أو 17) | 17 |
FRIDA_TIMEOUT | مهلة عملية Frida (بالميلي ثانية) | 1000 |
PROJECT_DIR | دليل المشروع للبيانات/التخزين المؤقت/السجلات | .igf في دليل العمل الحالي |
تأخذ معاملات سطر الأوامر الأولوية على متغيرات البيئة عند تعيين كليهما.
لا يتضمن هذا المشروع تجاوزات مدمجة لحمايات مكافحة العبث:
المبرّر: تتطور حلول RASP (الحماية الذاتية للتطبيقات وقت التشغيل) باستمرار لكشف أطر العمل الخاصة بالاعتراض. يتطلب الحفاظ على تجاوزات فعّالة جهدًا مستمرًا لمواكبة أساليب الكشف الجديدة، مما يفرض عبئًا كبيرًا في الصيانة واحتمالية حدوث مشكلات في الاستقرار. كما أن هذه التجاوزات مرتبطة ارتباطًا وثيقًا بالتطبيق المحدد، مما يجعل الحلول العامة هشّة.
بدلاً من توفير تجاوزات مدمجة هشّة، يركّز Grapefruit على قدرات الاعتراض والفحص التي تتكامل جيدًا مع أدوات التجاوز المخصصة.
الأساليب الموصى بها للتقييمات المصرّح بها حيث يكون تجاوز RASP مطلوبًا:
Frida Syscall Tracer — استخدم frida-strace (Frida 17.8.0+) لتتبع استدعاءات النظام في العملية الهدف. يساعد ذلك في تحديد آثار الكشف وتحديد التصحيحات المطلوبة قبل إرفاق Grapefruit:
frida-strace -U -f com.example.app
راجع ملاحظات إصدار Frida 17.8.0 للحصول على التفاصيل.
بنية متعددة الجلسات — يدعم Frida جلسات متعددة مرتبطة بالعملية نفسها. ابدأ جلسة منفصلة تحتوي على سكربتات تجاوز RASP أولاً، ثم شغّل Grapefruit. عندما يكتشف Grapefruit أن التطبيق الهدف قيد التشغيل بالفعل، فإنه يرتبط بالعملية الموجودة بدلاً من إعادة تشغيلها، مما يحافظ على أي تجاوزات سارية بالفعل.
يرتبط Grapefruit بـ 127.0.0.1 افتراضيًا ولا يمتلك مصادقة مدمجة. واجهة الويب وواجهة API متاحتان لأي عملية محلية. ورغم أن الطلبات عبر المصادر (cross-origin) محظورة افتراضيًا (لا توجد ترويسات CORS، ويرفض Socket.IO الاتصالات عبر المصادر)، فإن هذا وحده غير كافٍ لبيئة مشتركة أو بعيدة.
إذا كنت بحاجة إلى وصول عن بُعد أو أمان متعدد المستخدمين، فضع Grapefruit خلف وكيل عكسي موثّق مثل Caddy لتوفير TLS والتحكم في الوصول والتسجيل. لا تعرّض Grapefruit مباشرةً للشبكة دون مصادقة.