واجهة Frida UI

واجهة مستخدم ويب حديثة وخفيفة الوزن تعتمد على Frida، مصممة لـ اختبار الاختراق لتطبيقات Android. تتيح لك التفاعل مع الأجهزة والعمليات والنصوص البرمجية مباشرة من متصفحك.

بداية سريعة

# التثبيت باستخدام uv (موصى به) أو pipx/pip
uv tool install frida-ui
# أو: pipx install frida-ui
# أو: pip install frida-ui

# ابدأ الخادم
frida-ui

افتح متصفحك وانتقل إلى: http://localhost:8000

الميزات

📱 إدارة الأجهزة

• الاكتشاف التلقائي: يكتشف تلقائياً الأجهزة المتصلة عبر USB والأجهزة المحلية.
• الأجهزة البعيدة: أضف وأدر خوادم Frida عن بُعد بسهولة (مثل 192.168.1.x:27042).
• معلومات الجهاز: عرض معلمات النظام التفصيلية (نظام التشغيل، البنية، مستوى API) ومؤشرات نوع مرئية للجهاز المحدد.

🚀 التحكم في العمليات والتطبيقات

• قائمة التطبيقات: عرض التطبيقات المثبتة والعمليات الجارية.
• البحث: تصفية فورية للتطبيقات حسب الاسم أو المعرف.
• إدارة الجلسات:
  • إرفاق: الاتصال بالعمليات الجارية.
  • تشغيل: تشغيل التطبيقات المثبتة.
  • تشغيل وتنفيذ: تشغيل تطبيق وحقن النص من المحرر فوراً بالإضافة إلى أي نصوص CodeShare في قائمة الانتظار (القياس المبكر).
  • إنهاء/فصل: إنهاء العمليات أو قطع الاتصال بأمان.

💻 البرمجة النصية والقياس

• محرر النصوص: محرر مدمج لكتابة نصوص Frida. يتضمن محرر Monaco اختيارياً للتحرير الأكثر ثراءً (تظليل بناء الجملة وتخطيط تلقائي) مع العودة إلى textarea عادي إذا لم يتوفر.
• تحميل الملفات: تحميل النصوص من ملفات محلية أو سحب وإفلات ملفات .js في المحرر.
• تنزيل النص: تصدير محتوى المحرر الحالي كملف .js (frida-ui_<معرف التطبيق>_<الطابع الزمني>.js) مباشرة من رأس المحرر.
• التكامل مع CodeShare:
  • استيراد النصوص مباشرة من Frida CodeShare.
  • قائمة انتظار CodeShare: وضع نصوص CodeShare متعددة في قائمة الانتظار ليتم تحميلها وتنفيذها تلقائياً أثناء تشغيل وتنفيذ أو يدوياً عبر زر "تشغيل نصوص CodeShare".

📊 وحدة التحكم والتسجيل

• الإخراج في الوقت الفعلي: عرض رسائل console.log و send() والأخطاء من نصوصك.
• سجل المحفوظات: سجلات مستمرة لكل جلسة تطبيق.
• تصدير: تنزيل سجلات وحدة التحكم كملفات .txt للتحليل.

🎨 واجهة المستخدم/تجربة المستخدم

• السمة الداكنة: واجهة وضع داكن نظيفة ومتسقة.
• الثبات: يتذكر الجهاز المحدد والتطبيق وأحجام الألواح عبر الجلسات.
• متجاوب: ألواح قابلة للتعديل للشريط الجانبي والمحرر ووحدة التحكم.
• أوضاع التركيز: تبديل عروض المحرر فقط أو وحدة التحكم فقط لإخفاء الألواح الأخرى لسير عمل خالٍ من التشتيت.
• إمكانية الوصول: اختصارات لوحة المفاتيح (مثل Escape لإعادة تعيين العرض أو إغلاق التراكبات) ودعم ARIA.

البدء

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

• Python 3.7+
• uv (موصى به) / pipx / pip.

التثبيت

الخيار 1: التثبيت من PyPI (موصى به)

uv tool install frida-ui

يمكنك أيضاً تخصيص إصدار Frida:

uv tool install frida-ui --with frida==16.7.19

الخيار 2: التثبيت من المصدر (النسخة الأحدث)

uv tool install git+https://github.com/adityatelange/frida-ui

يمكنك تخصيص إصدار Frida:

uv tool install git+https://github.com/adityatelange/frida-ui --with frida==16.7.19

[!IMPORTANT] يجب أن يتطابق إصدار Frida الذي تقوم بتثبيته مع إصدار frida-server على جهاز Android الخاص بك لضمان التوافق.

التشغيل

ابدأ الخادم باستخدام التكوين الافتراضي:

frida-ui

أو مع خيارات مخصصة:

frida-ui --host 127.0.0.1 --port 8000 --reload

• --host: تحديد المضيف (الافتراضي: 127.0.0.1)
• --port: تحديد المنفذ (الافتراضي: 8000)
• --reload: تمكين إعادة التحميل التلقائي للتطوير

افتح http://localhost:8000 في متصفحك.

إعداد جهاز Android

قبل استخدام frida-ui، يجب أن يكون frida-server قيد التشغيل على جهاز Android الخاص بك. يجب أن يتطابق إصدار frida-server مع إصدار Frida الذي قمت بتثبيته في الخطوة السابقة.

الخيار 1: اتصال USB

إذا كان ADB مثبتاً لديك وتريد الاتصال عبر USB:

1. تنزيل frida-server: قم بزيارة إصدارات Frida وقم بتنزيل ملف frida-server الثنائي لنظام Android الذي يتوافق مع بنية/abi لجهازك (مثل frida-server-x.x.x-android-arm64.xz).

2. فك الضغط والدفع إلى الجهاز:

   root@kitploit:~

   unxz frida-server-x.x.x-android-arm64.xz
   mv frida-server-x.x.x-android-arm64 frida-server
   adb push frida-server /data/local/tmp/
   

3. تشغيل frida-server:

   root@kitploit:~

   adb shell "chmod 755 /data/local/tmp/frida-server"
   adb shell "/data/local/tmp/frida-server -D"
   

4. التحقق من الاتصال: تأكد من أن جهازك متصل عبر USB ومرئي عبر adb devices. سيكتشفه frida-ui تلقائياً عند التشغيل.

الخيار 2: اتصال عن بُعد (الشبكة)

بدلاً من ذلك، يمكنك تشغيل frida-server مع مستمع شبكة والاتصال عن بُعد:

1. تنزيل وتشغيل frida-server على جهاز Android الخاص بك (باستخدام أي طريقة - ADB، سكريبت مخصص، إلخ.):

   root@kitploit:~

   ./frida-server -l 0.0.0.0:27042 -D
   

2. إضافة جهاز بعيد في frida-ui: في واجهة frida-ui، أضف جهازاً بعيداً باستخدام عنوان IP والمنفذ الذي يستمع عليه frida-server (مثل 192.168.1.x:27042).

   لا يلزم تثبيت ADB لهذه الطريقة.

دليل الاستخدام

1. اختيار جهاز: اختر جهازاً من القائمة المنسدلة في الرأس العلوي.
2. اختيار تطبيق: انقر على تطبيق في الشريط الجانبي.
3. كتابة/تحميل النص:
   • اكتب JavaScript في المحرر.
   • أو اسحب وأفلت ملفاً.
   • أو أضف رابط نص من CodeShare.
4. الإجراء:
   • انقر على إرفاق لحقن العملية الجارية.
   • انقر على تشغيل لبدء التطبيق.
   • انقر على تشغيل وتنفيذ لبدء التطبيق مع حقن النص الخاص بك فوراً.
5. المراقبة: شاهد وحدة التحكم للإخراج.

💡 مثال على نص

جرب هذا النص البسيط لربط دالة (استبدلها بهدفك):

// مثال بسيط لربط دالة
Java.perform(() => {
  const MainActivity = Java.use("com.example.app.MainActivity");
  MainActivity.checkPassword.implementation = function (password) {
    console.log("[*] checkPassword تم استدعاؤها مع: " + password);
    return true; // تخطي التحقق
  };
});

ملاحظات

[!NOTE] هذه الأداة هي مشروع مستقل و ليست جزءاً من مجموعة أدوات Frida الرسمية و ليست مدعومة من مشروع Frida. إنها واجهة مستخدم تابعة لجهة خارجية تم إنشاؤها للتفاعل مع وظائف Frida الأساسية.

[!WARNING] تسمح هذه الأداة بتنفيذ JavaScript عشوائي في العمليات المستهدفة. قم بتعريض frida-ui فقط للشبكات والمستخدمين الموثوقين. يمكن أن يؤدي تنفيذ نصوص غير موثوقة إلى اختراق نظامك وبياناتك. يعمل خادم الويب محلياً بشكل افتراضي ولكنه يكشف عن إمكانيات قياس قوية.

الإسناد

• مشروع Frida - https://frida.re/.
• محرر Monaco - https://microsoft.github.io/monaco-editor/.
• شكر لـ Github Copilot على اقتراحات وتحسينات الكود.

عدد النجوم عبر الزمن