ioncodes/idacodeتكامل بين IDA وVS Code يربط بينهما لتسهيل تنفيذ وتصحيح نصوص IDAPython.
يجعل IDACode من السهل تنفيذ وتصحيح أخطاء نصوص بايثون في بيئة IDA الخاصة بك دون مغادرة Visual Studio Code. يمكن العثور على إضافة VS Code على المتجر.
لا يزال IDACode في مرحلة مبكرة جدًا ومن المتوقع وجود أخطاء. يرجى فتح مشكلة جديدة إذا واجهت أي مشاكل.
debugpy للاتصال، فإنه يقوم بمزامنة نافذة الإخراج بشكل طبيعي مع لوحة الإخراج في VS Code.تم اختبار IDACode على Windows و macOS مع IDA 8.4/9.0 و Python 3.12 (إصدارات بايثون الأقدم بها مشاكل في تصحيح الأخطاء).
لإعداد التبعيات لإضافة IDA، قم بتشغيل:
# تأكد من استخدام إصدار بايثون الصحيح
# يدعم IDACode أحدث إصدار من debugpy اعتبارًا من الإصدار 3.0.0، تأكد من الترقية!
python -m pip install --user debugpy tornado
إما استنساخ هذا المستودع أو تنزيل حزمة إصدار من هنا. يعكس ida.zip محتويات مجلد ida في هذا المستودع. انسخ جميع الملفات إلى دليل الإضافات في IDA.
الخطوة التالية هي تكوين الإعدادات لتتناسب مع بيئتك (اختياري). قم بتحرير idacode_utils/settings.py وفقًا لذلك:
HOST: هذا هو عنوان المضيف. دائمًا ما يكون 127.0.0.1 إلا إذا أردت أن يكون قابلاً للوصول من موقع بعيد. ضع في اعتبارك أن هذه الإضافة لا تستخدم المصادقة.PORT: هذا هو المنفذ الذي تريد أن يستمع عليه IDA. يستخدم للاتصال عبر WebSocket بين IDA و VS Code.DEBUG_PORT: هذا هو المنفذ الذي تريد الاستماع عليه لجلسات تصحيح الأخطاء الواردة.LOGGING: يحدد ما إذا كان يجب على المصحح تسجيل الدخول إلى الملفات. هذا مفيد بشكل خاص عندما تواجه مشاكل مع IDACode. يرجى تقديم مشكلة جديدة إذا وجدت أي شيء. توجد الملفات دائمًا في دليل temp الخاص بك (مثال: Windows: %TEMP%). تسمى الملفات debugpy.*.log.يمكنك الآن بدء تشغيل الإضافة بالنقر على IDACode في قائمة الإضافات.
إضافة VS Code متاحة على المتجر. لتكوين الإضافة، يرجى الرجوع إلى ملف README الخاص بالإضافة.
اضغط على IDACode في قائمة الإضافات. يجب أن ترى النص التالي:
IDACode listening on 127.0.0.1:7065
اعتبارًا من الإصدار 0.2.0، يدعم IDACode "التنفيذ عند الحفظ" وهو ممكّن افتراضيًا. سيقوم VS Code تلقائيًا بتنفيذ النص الخاص بك في IDA بمجرد حفظ المستند الحالي (على سبيل المثال باستخدام CTRL+S). يمكن تعطيل هذا السلوك في الإعدادات. افتح وحدة تحكم تطوير إضافات VS Code باستخدام Ctrl-Shift-P وأدخل "idacode" لرؤية قائمة الأوامر أدناه. لا تستخدم وظيفة "تشغيل" أو "تصحيح" في VS Code، لأنك ستتلقى رسالة "HTTP misformed" في IDA بدلاً من ذلك.
هناك 4 أوامر تحت تصرفك:
بمجرد فتح مجلد تريد وضع نصوصك فيه (يجب تحديد المجلد عندما يطلب منك VS Code ذلك!) تكون مستعدًا للاتصال بـ IDA. يمكنك القيام بذلك إما بتنفيذ Connect to IDA أو Connect and attach a debugger to IDA. يرجى ملاحظة أن جلسة تصحيح الأخطاء دائمة حتى تقوم بإعادة تشغيل IDA. لا يمكنك تغيير مجلد العمل بمجرد بدء المصحح.
تأكد من أن مجلد العمل هو المجلد الذي توجد به نصوصك الرئيسية.
بمجرد الاتصال، يمكنك تحديد Execute script in IDA.
يستخدم IDACode مصحح الأخطاء عن بُعد الخاص بـ VS Code للاتصال بـ IDA. جميع ميزات VS Code مدعومة. ومع ذلك، يجب عليك تحديد نقطة دخول النص باستخدام وظيفة بايثون المضمنة: breakpoint. يخبر هذا الأمر المصحح بإيقاف التنفيذ، وإذا لم يكن هناك مصحح موجود فإنه سيتجاهل الوظيفة. يستورد IDACode حزمة مساعدة تسمى dbg والتي تنفذ تجاوزًا لـ breakpoint يُسمى bp. تدعم هذه الوظيفة التسجيل والشرطيات:
name = idc.get_segm_name(segment)
dbg.bp(name==".text", f"found {name} at {segment}")
يرجى أيضًا ملاحظة أن استدعاء breakpoint() يجب ألا يحدث أبدًا في نهاية الملف، يجب أن يكون دائمًا قبل أي سطر آخر من التعليمات البرمجية حيث أنه يتوقف عند التعليمة التالية في الكود الخاص بك. لاحظ أيضًا أنه إذا قررت استخدام حزمة dbg فيجب عليك إما إزالة جميع الإشارات إليها أو استخدام المتغير __idacode__ كشرط قبل تنفيذها كنص IDA عادي.
من المهم أيضًا أن إرفاق مصحح الأخطاء سيؤدي إلى إنشاء مثيل مصحح جديد. في معظم الحالات، هذا ليس ما تريده. إذا قمت بفصل المصحح، استخدم مصحح الأخطاء عن بُعد الخاص بـ VS Code للاتصال مرة أخرى.
