
تحليل الفرز عالي الأوكتان
[][docs]
[
][tests]
[
][codecov]
[
][pypi]
__ __ High Octane Triage Analysis __
|| _||______ __ __________ _____ ||
|| \||___ \__| ____/ ______/___ / ____\ ||
==||=====|| | __/ |/ \ /==| / __ \ __\===]|
'======|| | \ | | \_ _| \ ___/| | ||
||____ /__|___|__/ / | \____]| | ||
=========''====\/=========/ /==|__|=====|__|======'
\ /
\/
Binary Refinery™ عبارة عن مجموعة من سكربتات Python التي تنفّذ تحويلات على البيانات الثنائية مثل الضغط والتشفير.
سنشير إليها غالبًا باختصار باسم refinery، وهو أيضًا اسم الحزمة المقابلة.
صُممت السكربتات لتقرأ المدخلات حصريًا من stdin وتكتب المخرجات إلى stdout.
الفلسفة الأساسية هي أن كل سكربت يجب أن يكون وحدة بمعنى أنه ينفّذ مهمة واحدة،
ويمكن دمج الوحدات الفردية في خطوط أنابيب باستخدام معامل الأنابيب | على سطر الأوامر لتنفيذ مهام أكثر تعقيدًا.
التركيز الرئيسي للمشروع هو فرز البرمجيات الخبيثة،
وهو محاولة لتنفيذ شيء مثل CyberChef على سطر الأوامر.
أنشئ بيئة Python افتراضية. تحتاج إلى Python 3.11 أو أحدث. ثبّت refinery هكذا:
python -m pip install -U pip
python -m pip install -U --no-cache-dir binary-refinery[extended]
شغّل الوحدات باستخدام -h لتتعلم كيف تعمل، أو ابحث فيها عبر [docs][] أو استخدم الأمر binref للعثور عليها.
شاهد [فيديو حديثًا][VOD3] إذا أردت رؤيتها أثناء العمل.
ولكن أيضًا، اقرأ بقية هذا الملف التعريفي.
لا يوجد جدول إصدارات، لكن الإصدارات تصدر بشكل متكرر جدًا ويُوصى بالتحديث دوريًا. لا تُوثَّق إصلاحات الأخطاء خارج GIT، لكن جميع التغييرات الأخرى (أي الميزات الجديدة) موثقة في سجل التغييرات. تابعني على [Mastodon][] للحصول على تحديثات حول الإصدارات ذات التأثير الكبير.
نص المساعدة الذي يُعرض عند تنفيذ وحدة باستخدام المفتاح -h أو --help هو توثيقها الرئيسي.
تحتوي [التوثيق المُولَّد تلقائيًا][docs] على تجميع لهذا المخرَج لكل وحدة على المستوى الأعلى،
لكنه يحتوي أيضًا على مواصفات المفاهيم الأساسية الثلاثة لمجموعة الأدوات:
[التأطير][frame]، و[وسائط multibin][argformats]، و[المتغيرات الفوقية][meta].
البحث النصي الكامل في الوصف ونص المساعدة لكل وحدة متاح أيضًا على سطر الأوامر،
عبر الأمر binref المرفق. وإدراكًا لحقيقة أن التوثيق المرجعي قد يكون جافًا إلى حد ما،
هناك جهد مستمر لإنتاج سلسلة من الدروس التعليمية؛ أوصي بشدة بالاطلاع عليها.
علاوة على ذلك، أجمع موارد إضافية (بما في ذلك بعض الموارد التي ينتجها آخرون) أدناه.
[!NOTE]
لا يزال Refinery في مرحلة ألفا وقد تتغير الواجهة أحيانًا، أي قد تُحذف الوحدات والمعاملات أو يُعاد تسميتها. لذلك، قد يحدث أن سطور أوامر محددة من فيديوهات ومنشورات مدونات قديمة لم تعد تعمل.
2021/08] تكرم [OALabs][OA] بالسماح لي [بعرض مجموعة الأدوات في فيديو مميز][VOD1].
في الفيديو، أعمل أساسًا عبر محتويات
الدرس التعليمي الأول.2021/11] كتب [Johannes Bader][JB] [منشور مدونة][BLOG] رائعًا حول تحليل البريد العشوائي الخبيث باستخدام binary refinery.2024/03] أنتج [Malware Analysis For Hedgehogs][MH] [فيديو حول فك حزمة عينة XWorm][VOD2] باستخدام refinery.2024/11] استضافني [the CyberYeti][CY] [على البث لتقديم refinery][VOD3].2025/06] كنت [على البث مجددًا][VOD4] مع [the CyberYeti][CY]، وهذا الأخير أكثر عفوًا قليلًا.
جميع الأخطاء التي يمكنك رؤيتها هنا تم إصلاحها. 😉تشمل العروض التوضيحية مجددًا عينات من قسم الأمثلة أدناه ومن الدروس التعليمية.
Binary Refinery هي (c) 2019 Jesko Hüttenhain، ومنشورة بموجب [ترخيص BSD ثلاثي البنود][license]. يحتوي هذا المستودع أيضًا على نسخة من نص الترخيص الكامل. إذا أردت القيام بشيء لا يغطيه هذا الترخيص، فلا تتردد في التواصل مع المؤلف.
يتطلب refinery Python 3.11 على الأقل. يُوصى بتثبيته في [بيئة افتراضية][venv] خاصة به: فالحزمة قد تجلب العديد من التبعيات، وتثبيتها في Python العام لديك عرضة إلى حد ما لتعارضات الإصدارات. أيضًا، نظرًا لأن مجموعة الأدوات تُدخل عددًا كبيرًا من الأوامر الجديدة، فهناك احتمال جيد أن تتعارض بعضها على بعض الأنظمة، وإبقاؤها في بيئة افتراضية منفصلة خاصة بها هو إحدى طرق منع ذلك.
إذا أردت أن تكون جميع أوامر refinery متاحة في shell لديك في جميع الأوقات (أي دون الحاجة إلى التبديل إلى بيئة افتراضية مخصصة)،
فلديك أيضًا خيار اختيار بادئة للتثبيت،
تُوضع أمام كل shim أمر يتم تثبيته.
على سبيل المثال، إذا اخترت r. كبادئتك، فسيتم تثبيت وحدة [emit][] كأمر r.emit.
من الفوائد الإضافية أنك تستطيع كتابة r. والضغط على Tab مرتين للحصول على قائمة بجميع أوامر refinery المتاحة.
لاحظ مع ذلك أنه لا تُفترض أي بادئة في التوثيق، وأن أحد أهداف تطوير refinery هو عدم التعارض على معظم الأنظمة.
لا يستخدم المؤلف بادئة ويوفر هذا الخيار كشبكة أمان.
أسهل طريقة لتثبيت refinery وتحديثه هي عبر pip. تأكد من تشغيل أحدث إصدار أولاً:
python -m pip install -U pip
ثم قم بتثبيت حزمة refinery فقط:
pip install -U --no-cache-dir binary-refinery
إذا كنت تريد اختيار بادئة لجميع الوحدات، يمكنك تحديدها عبر متغير البيئة REFINERY_PREFIX.
على سبيل المثال، سيقوم الأمر التالي بتثبيت refinery في بيئة Python الحالية بالبادئة r. على Linux:
REFINERY_PREFIX=r. pip install -U --no-cache-dir binary-refinery
على Windows، ستحتاج إلى تشغيل الأوامر التالية:
set REFINERY_PREFIX=r.
pip install -U --no-cache-dir binary-refinery
تحديد البادئة الخاصة ! سيكون له تأثير عدم إنشاء أي أوامر shell على الإطلاق،
وسيتم تثبيت binary refinery كمكتبة فقط.
اضبط REFINERY_NO_EXTENSIONS=1 للتثبيت بدون إضافات Cython؛
حينها يستخدم refinery تطبيقات Python خالصة (أبطأ بكثير) لعدة خوارزميات.
إذا كنت ترغب في تثبيت HEAD الحالي لـ refinery، يمكنك تكرار جميع الخطوات المذكورة أعلاه، مع تحديد هذا المستودع بدلاً من حزمة pip.
على سبيل المثال، سيقوم ما يلي بتثبيت أحدث commit لـ refinery:
pip install -U --no-cache-dir git+git://github.com/binref/refinery.git
أخيرًا، إذا كنت تستخدم [REMnux][remnux-main]، يمكنك استخدام [حاوية refinery docker][remnux] الخاصة بهم.
إذا كنت ترغب في تعليم تحليل البرمجيات الخبيثة المحلي الخاص بك [claude][] استخدام binary refinery، فاطّلع على [Binary Refinery Skill][agent].
فيما يلي ملخص لمدى جودة دعم بيئات الصدفة (shell) المختلفة حاليًا:
| Shell | Platform | State | Comment |
|---|---|---|---|
| Bash | Posix | 🔵 جيد | يستخدمه المؤلف أحيانًا. |
| CMD | Windows | 🔵 جيد | يستخدمه المؤلف على نطاق واسع. |
| PowerShell | Windows | 🟡 مقبول | [يعمل ببساطة إذا كان إصدار PowerShell على الأقل 7.4.][psh1] |
| Zsh | Posix | 🟠 مشكلات طفيفة | بعد [نقاش][zsh1]، يوجد [إصلاح][zsh2]. |
| Fish | Posix | 🟠 مشكلات طفيفة | راجع المشكلة [#55][fsh1] والنقاش [#22][fsh2]. |
إذا كنت تستخدم صدفة (shell) مختلفة ولديك بعض الملاحظات لمشاركتها، فيرجى إخباري!