Frida Workbench لـ VSCode

المستودع | المشكلات | التثبيت

هذا مشروع مساهم به من المجتمع، وليس تابعًا لفريق Frida الرسمي. تم تطويره وصيانته بواسطة @CodeColorist كإضافة مفتوحة المصدر لـ Visual Studio Code لتحسين تجربة كتابة سكريبتات Frida.

中文说明

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

• Python >= 3.7
• حزمة Python ‏frida-tools

التبعيات الاختيارية

• libimobiledevice (لأمر inetcat لبدء صدفة SSH)
• iTunes على Windows (لاتصال iOS عبر USB)

إذا كنت تستخدم Windows، فأنت بحاجة إلى إبقاء iTunes مفتوحًا للتفاعل مع أجهزة iOS عبر USB.

تثبيت frida-tools

بسبب PEP0668، قد تواجه خطأً عند تشغيل pip3 install frida-tools بشكل عام.

الطريقة الموصى بها هي فتح مجلد (مساحة عمل) في VSCode، ثم إنشاء بيئة افتراضية وتفعيلها باستخدام إضافة Python. في هذه الحالة، ستستخدم الإضافة بيئة Python الافتراضية النشطة حاليًا لديك لتحميل أوامر frida.

بدلاً من ذلك، يمكنك استخدام مدير حزم مثل pipx أو UV لتثبيته في $PATH، مع إبقائه معزولًا.

الميزات

قائمة التطبيقات والعمليات

اعرض قائمة التطبيقات والعمليات على الأجهزة المتصلة في لوحة جانبية. انقر بزر الفأرة الأيمن للربط، أو الربط بصلاحيات مرتفعة للأهداف المحلية، أو التشغيل، أو التشغيل في وضع التعليق، أو إنهاء العمليات، أو نسخ معلومات الجهاز/العملية إلى الحافظة. يدعم الأجهزة المحلية ومحاكي Apple وأجهزة USB والأجهزة البعيدة. تتضمن إدخالات العمليات المحلية بيانات وصفية بأفضل جهد ممكن مثل مسار الملف التنفيذي والمالك ومعرّف العملية الأب والوسائط عند توفرها.

لوحات وقت التشغيل التفاعلية

متصفح الوحدات والتصديرات

تصفح الوحدات الأصلية المحمّلة ودوالها المصدّرة لأي عملية مرتبطة. صفِّ الوحدات حسب الاسم، وافحص العنوان الأساسي والحجم والمسار، ثم اختر التصديرات لتوليد الـ hook.

متصفح الأصناف والطرق

استكشف أصناف وطرق وقت التشغيل لكل من Java وObjective-C. صفِّ الأصناف، وبدّل بين الطرق الخاصة والموروثة، واختر الطرق دفعة واحدة لتوليد الـ hook. يتضمن أيضًا فحص بروتوكولات Objective-C لتصفح وتحليل البروتوكولات.

توليد الترويسة

استخرج ترويسات الأصناف للهندسة العكسية:

• Objective-C — توليد ملفات الترويسة من بيانات وصفية لأصناف وقت التشغيل
• Java — توليد ركائز أصناف مفكوكة الترجمة مع عبارات الحزمة والاستيراد

توليد الـ Hook

ولّد كود Frida hook من لوحتي الوحدات والأصناف:

• Hooks أصلية — Interceptor.attach() مع استدعاءات onEnter / onLeave للدوال المصدّرة
• Hooks لـ Objective-C — hooks مبنية على الصنف والمحدِّد مع الاستخدام الصحيح لجسر ObjC
• Hooks لـ Java — hooks بـ Java.perform() / Java.use() مع دعم تحميل الطرق المتعدد
• Hooks مدعومة بالذكاء الاصطناعي — استخدم GitHub Copilot لاستنتاج توقيعات الدوال الأصلية (أنواع المعاملات، أنواع الإرجاع) وتوليد تسجيل وسائط واعٍ بالأنواع

الإكمال التلقائي الذكي (LSP)

إكمالات واعية بالسياق لسكريبتات Frida في JavaScript / TypeScript:

• ObjC.classes.<ClassName> — يكمل أسماء أصناف Objective-C
• ObjC.classes.Foo['<method>'] — يكمل محدِّدات الطرق
• ObjC.classes.Foo.method — يكمل محدِّدات طرق الصنف
• Java.use('<ClassName>') — يكمل أسماء أصناف Java
• Process.getModuleByName('<name>') — يكمل أسماء الوحدات المحمّلة

يعتمد خادم اللغة على سياق عملية هدف. تحتاج إلى إنشاء ملف إعدادات .vscode/frida.json في مساحة عملك. أسهل طريقة هي النقر بزر الفأرة الأيمن على عملية أو تطبيق في الشريط الجانبي واختيار Set LSP Target، الذي يولّد الملف تلقائيًا.

إعدادات .vscode/frida.json

يحدد الملف الجهاز والهدف الذي يجب أن يرتبط به LSP. يتطلب حقل device وواحدًا فقط من app أو pid أو process.

الربط بمعرّف التطبيق (موصى به — يشغّل التطبيق أو يرتبط به):

{
    "device": "local",
    "app": "com.example.myapp"
}

الربط باسم العملية:

{
    "device": "local",
    "process": "myprocess"
}

الربط بمعرّف العملية (مفيد عندما تتشارك عمليات متعددة الاسم نفسه):

{
    "device": "local",
    "pid": 1234
}

تتوافق قيمة device مع معرّف جهاز Frida — local للجهاز المضيف، أو معرّف محاكي أو جهاز USB، أو سلسلة host:port للأجهزة البعيدة.

يراقب LSP هذا الملف بحثًا عن التغييرات. يؤدي تعديله أو إعادة إنشائه إلى إعادة تشغيل خادم اللغة تلقائيًا مع الهدف الجديد.

Syslog

بث سجلات التطبيق في الوقت الفعلي من العمليات المرتبطة.

هيكلة المشروع

• New Agent — إنشاء مشروع Frida Agent جديد مع دعم TypeScript
• New C Module — إنشاء مشروع Frida C Module جديد
• Download Typings — تنزيل تعريفات أنواع TypeScript الخاصة بـ Frida للإكمال التلقائي

إعدادات التصحيح

ولّد launch.json وtasks.json الخاصين بـ VSCode لتصحيح سكريبتات Frida مع نقاط التوقف.

أدوات Android

• تنزيل وتشغيل frida-server على جهاز Android (كشف تلقائي للمعمارية)
• سحب APK من الجهاز (انقر بزر الفأرة الأيمن على تطبيق Android للسحب)

تكامل الأدوات الخارجية

• Objection — استكشاف تطبيقات الجوال في وقت التشغيل

الصدفة

بالنسبة لأجهزة Android، Open Shell هو غلاف لـ adb shell.

بالنسبة لـ iOS، يوفر صدفة SSH على الأجهزة المكسورة الحماية. قد تحتاج إلى إعداد بيانات الاعتماد.

دعم الأجهزة البعيدة

اتصل بأجهزة Frida البعيدة عبر host:port مباشرة من الشريط الجانبي.

CHANGELOG

المساهمون