binnavi

بن نافي

حقوق الطبع والنشر 2011-2020 لشركة Google LLC

مقدمة

BinNavi عبارة عن بيئة تطوير متكاملة (IDE) للتحليل الثنائي - وهي بيئة تسمح للمستخدمين بفحص الرسوم البيانية لتدفق التحكم للتعليمات البرمجية المفككة والتنقل فيها وتحريرها والتعليق عليها، والقيام بالشيء نفسه بالنسبة لرسم بياني للملف القابل للتنفيذ، وجمع ودمج آثار التنفيذ، وتتبع المسار بشكل عام نتائج التحليل بين مجموعة من المحللين.

ملحوظة: مشروع BinNavi لم يعد قيد التطوير النشط.

التبعية التجارية لطرف ثالث

يستخدم BinNavi مكتبة تصور رسوم بيانية تجارية تابعة لجهة خارجية (yFiles) لعرض الرسوم البيانية وتخطيطها. هذه المكتبة قوية للغاية، ولا يمكن استبدالها بسهولة.

من أجل تنفيذ التطوير المباشر باستخدام yFiles، تحتاج إلى ترخيص مطور لذلك. وفي الوقت نفسه، نريد أن يكون المجتمع قادرًا على المساهمة في BinNavi دون الحاجة إلى ترخيص yFiles تجاري. من أجل القيام بذلك والتوافق مع ترخيص yFiles، يجب أن تكون جميع واجهات yFiles مشوشة بشكل صحيح.

ومن أجل تحقيق ذلك قمنا بما يلي:

1. تم تقسيم BinNavi وجميع المكتبات إلى قسمين: تم تقسيم أجزاء المشروع التي تعتمد بشكل مباشر على yFiles إلى حزم فرعية تسمى "yfileswrap":

• com.google.security.zynamics.binnavi
• com.google.security.zynamics.binnavi.yfileswrap
• com.google.security.zynamics.zylib
• com.google.security.zynamics.zylib.yfileswrap
• com.google.security.zynamics.reil
• com.google.security.zynamics.reil.yfileswrap

نحن نقوم بتوزيع ملف JAR مُعد مسبقًا بجميع التعليمات البرمجية الموجودة في حزم yfileswrap الفرعية - المرتبطة مسبقًا والمبهمة مقابل yFiles. إذا كنت ترغب في تغيير أو إضافة تعليمات برمجية في BinNavi وليس لديك ترخيص yFiles، فيمكنك القيام بكل ما تريده بحرية في الحزم غير yfileswrap - يمكنك ببساطة وضع lib/yfileswrap-obfuscated.jar في مسار الفصل الخاص بك اختبار ومعرفة النتائج.

إذا كنت ترغب في إجراء تغييرات على الدلائل الفرعية yfileswrap ، يرجى العلم أنك ستحتاج إلى ترخيص yFiles صالح - وأي مساهمة تقدمها لمشروع BinNavi يجب أن تحترم اتفاقية الترخيص الخاصة بهم. هذا يعني أنه لا يمكنك ببساطة الكشف عن واجهات برمجة التطبيقات الداخلية الخاصة بهم تحت أسماء مختلفة وما إلى ذلك.

سوف نقوم بتنفيذ هذا - نحن سعداء جدًا لأننا وجدنا طريقة لفتح BinNavi مفتوح المصدر باستخدام تبعية yFiles، وسوف نتأكد من أن أي كود نسحبه يحترم ترخيص yFiles.

ملاحظة للمشرفين/حاملي تراخيص yFiles

لإعادة بناء مكتبة غلاف yFiles، قم أولاً بنسخ y.jar و ysvg.jar إلى third_party/java/yfiles . ثم أعد البناء باستخدام:

 mvn dependency:copy-dependencies
ant build-yfiles-wrapper-jar
mvn install:install-file 
    -Dfile=target/yfileswrap-obfuscated.jar 
    -DgroupId=com.google.security.zynamics.binnavi 
    -DartifactId=yfileswrap-obfuscated 
    -Dversion=6.1 
    -Dpackaging=jar 
    -DlocalRepositoryPath=lib

بناء BinNavi من الصفر

يستخدم BinNavi Maven لإدارة التبعية، ولكن ليس للبناء الفعلي. Java 11 هو الإصدار الأدنى المدعوم.

للبناء من الصفر استخدم هذه الأوامر:

 mvn dependency:copy-dependencies
ant build-binnavi-fat-jar

تشغيل BinNavi لأول مرة

يرجى العلم أن BinNavi يستخدم قاعدة بيانات PostgreSQL مركزية لتخزين عمليات التفكيك/التعليقات/الآثار - لذلك تحتاج إلى تشغيل مثل هذا المثيل في مكان ما يمكنك الوصول إليه. يمكنك تشغيل BinNavi على النحو التالي:

 java -jar target/binnavi-all.jar

استيراد المشروع إلى Eclipse

يتطلب تحميل الكود في Eclipse لمزيد من التطوير القليل من التكوين.

1. قم بتثبيت التبعيات (كما هو موضح أعلاه) وتأكد من أن لديك Java SDK مع تثبيت توافق اللغة 1.8.
2. قم بإنشاء "Java Project From Existing Ant Buildfile" واستخدم الملف build.xml
3. حدد مهمة "javac" الموجودة في الهدف "build-binnavi-jar"
4. افتح مربع الحوار "خصائص المشروع" واختر "مسار إنشاء Java" الذي يظهر علامة التبويب "المصدر".
5. قم بإزالة كافة المجلدات المصدر باستثناء مجلد واحد وقم بتحريره ليحتوي على الخصائص التالية:
   • موقع المجلد المرتبط: PROJECT_LOC/src/main/java
   • اسم المجلد: java
   • انقر على "التالي"
6. أضف **/yfileswrap/** إلى قائمة الدلائل المراد استبعادها.
7. انتقل إلى "تشغيل->تشغيل باسم"، وحدد "تطبيق Java" ثم ابحث عن CMain .

يجب أن تكون على استعداد للذهاب من هنا.

تصدير عمليات التفكيك من المؤسسة الدولية للتنمية

كجزء من هذا المشروع، نقوم بتوزيع مكون IDA Pro الإضافي الذي يصدر عمليات التفكيك من IDA إلى تنسيق قاعدة بيانات PostgreSQL الذي يتطلبه BinNavi. عند تشغيل BinNavi، ما عليك سوى تكوين المسار الصحيح لـ IDA، والنقر فوق الزر "تثبيت البرنامج المساعد" إذا لزم الأمر - يجب أن تكون الآن قادرًا على استيراد عمليات التفكيك.

استخدام مفككات أخرى غير المؤسسة الدولية للتنمية

في الوقت الحالي، ليس لدينا سوى البرنامج الإضافي للتصدير من IDA - ولكننا نأمل كثيرًا أن يساعدنا شخص ما في بناء وظائف التصدير لوحدات التفكيك الأخرى في المستقبل القريب.

بناء BinNavi مع Gradle

يرجى ملاحظة أن إصدار Maven حاليًا هو نظام البناء الرسمي لـ BinNavi. Gradle تجريبي بحت ومن المرجح أن يتغير.

يمكنك إنشاء BinNavi باستخدام gradle عن طريق تشغيل ما يلي:

على نظام التشغيل Linux/OS X:

 $ ./gradlew clean jar 

على نظام التشغيل Windows:

 /gradlew.bat clean jar

سيؤدي هذا إلى إنتاج الجرة في مسار المشروع ضمن build/libs/ .

تحميل المشروع إلى Eclipse باستخدام Gradle

على نظام التشغيل Linux/OS X:

 $ ./gradlew eclipse 

على نظام التشغيل Windows:

 ./gradlew.bat eclipse

كجزء من عملية إنشاء المشروع، سيتم تنزيل التبعيات. بمجرد الانتهاء، قم بما يلي للتحميل في Eclipse:

1. افتح الكسوف.
2. ملف > استيراد... من شريط القوائم.
3. من النافذة التي تظهر، حدد عام > المشاريع الموجودة في مساحة العمل.
4. تأكد من تحديد زر الاختيار "تحديد الدليل الجذر".
5. انقر فوق "استعراض"... وانتقل إلى دليل المشروع.
6. يجب أن تحتوي منطقة المشاريع الآن على "binnavi" ووضع علامة بجوارها.
7. اضغط على إنهاء.

تم الآن إعداد مساحة عمل Eclipse وإكمالها لـ BinNavi.

تحميل المشروع إلى IntelliJ باستخدام Gradle

على نظام التشغيل Linux/OS X:

 $ ./gradlew idea

على نظام التشغيل Windows:

 ./gradlew.bat idea

كجزء من عملية إنشاء المشروع، سيتم تنزيل التبعيات. بمجرد الانتهاء، قم بما يلي للتحميل في IntelliJ:

1. افتح IntelliJ.
2. حدد "فتح" من النافذة الرئيسية.
3. انتقل إلى مجلد المشروع وسترى أيقونة IntelliJ. وهذا يدل على أنه مشروع.
4. اضغط على "موافق" وانتظر حتى يتم الاستيراد والتحميل.
5. قد لا يتعرف عليه IntelliJ كمشروع أولي. حدد تمكين من النافذة المنبثقة واستخدم Gradle المحلي.

تم الآن إعداد بيئة IntelliJ الخاصة بك واستكمالها لـ IntelliJ.