
firmware-analysis-toolkit v2.0.0-alpha.1
منصة أبحاث أمن البرامج الثابتة تجمع بين تحليل الثنائيات، وتتبع التلوث، والمحاكاة عبر إنترنت الأشياء، والذكاء الاصطناعي الطرفي، والأجهزة المحمولة، والروبوتات.
FAT — مجموعة أدوات تحليل البرامج الثابتة
نزّل أحدث إصدار · سجل التغييرات · التثبيت
Firmware Analysis Toolkit هي مجموعة أدوات للبحث الأمني مخصصة للتحقيق في أمان البرامج الثابتة الخاصة بإنترنت الأشياء (IoT) والذكاء الاصطناعي المادي والأجهزة المحمولة والروبوتات. وقد بُنيت بشكل أساسي من أجل دورة تدريبية بعنوان "Offensive IoT Exploitation" تُقدّمها Attify.
وقد بُنيت استنادًا إلى خبرة عملية ميدانية فعلية حول ما يهم حقًا عندما يتعلق الأمر بتحقيقات أمان البرامج الثابتة التي لها أثر حقيقي.
هدف FAT ليس فقط بناء مجموعة أدوات استثنائية عالمية المستوى ومتطورة لأبحاث أمان البرامج الثابتة، بل أيضًا صقل محترفين وممارسين يعملون في ذروة أدائهم، حيث تصبح الأداة قوة إدراكية خارقة إذا استُخدمت بطرق معينة، مع بقائها سهلة بما يكفي ليستخدمها من هم جدد في هذا المجال.
تشمل بعض الميزات تصنيف البرامج الثابتة غير المعروفة، واستخراج أنظمة الملفات، ورسم خرائط للشيفرة ذات الصلة بالثقة، وتتبع التلوث (taint)، وتنسيق محاكاة QEMU.
ما يمكن لـ FAT تحليله
- الكتل غير المعروفة والمجلدات: الحاويات، والأعضاء المضغوطة، والمناطق عالية الإنتروبيا، وإشارات MCU، وملفات البرامج الثابتة المرشحة
- صور البرامج الثابتة: الرؤوس، وأغلفة التحديث، والأقسام، ومحمّلات الإقلاع، والفروقات بين الصور
- صور فلاش BMC: بيانات FIT الوصفية للتجزئة/التوقيع، وعلامات OpenBMC/MegaRAC، وبيئات U-Boot الصالحة وفق CRC، واسترداد JFFS2 الأصلي، وملفات تعريف محاكاة صريحة للفلاش الكامل/نواة المورّد
- أنظمة ملفات Linux المستخرجة: الجرد، ونوايا بدء التشغيل، والثنائيات الحاملة للثقة، والمواد التشفيرية، والأدلة النصية
- ثنائيات ELF: الواردات، والصادرات، وجداول المعالجات، ومصارف الشيفرة المجرّدة، وفك الترجمة، وتلوث الشيفرة المصدرية إلى المصرف
- صور Bare-metal وMCU: جداول المتجهات، وخرائط الذاكرة، وإشارات الأجهزة الطرفية، وصلاحية الكتابة إلى الفلاش، وأدلة تسليم الإقلاع
- مخرجات الذكاء الاصطناعي الطرفي: ملفات MAGIK/JZDL وTFLite وONNX وQualcomm DLC بالإضافة إلى بيئات الاستدلال المرئية
- تطبيقات Android: جرد APK، وخيوط الاستكشاف، والموقع، وسلاسل القدرات، وحدود التسليم
- مستودعات المصدر: استعلامات الثوابت، وإرشادات الترقيع، والبحث عن المتغيرات القريبة
البدء السريع
نزّل حزمة ثنائية من Releases، والتي تحتوي بالفعل على بيانات التشغيل المطابقة share/fat، أو ثبّت الملف التنفيذي من crates.io باستخدام Cargo:
# Fast path: fetch the prebuilt archive for this platform (requires cargo-binstall).
cargo binstall firmware-analysis-toolkit
# From source: compiles the full dependency tree (Rust 1.91 or newer plus a C compiler).
cargo install --locked firmware-analysis-toolkit
يثبّت Cargo الملف التنفيذي fat فقط. ثبّت حزمة بيانات وقت التشغيل الخاصة بالإصدار المثبّت مرة واحدة؛ إذ يقوم --release بتنزيل fat-data-<version>.zip المطابق، والتحقق من SHA-256 الخاص به، وتفعيله:
fat data install --release
fat doctor
بناء نسخة العمل هذه (للتطوير، أو للميزات المدرجة تحت Unreleased):
git clone --branch v2.1.0 --depth 1 https://github.com/attify/firmware-analysis-toolkit.git
cd firmware-analysis-toolkit
cargo build --release --locked
cargo install --path crates/fat_cli --locked
python3 scripts/build-runtime-data-bundle.py --output ./dist/fat-data.zip
fat data install --archive ./dist/fat-data.zip
fat doctor
على Arch Linux أو Omarchy، ابدأ بـ خطوات التثبيت على Arch لحزم المتطلبات الأساسية والأدوات الاختيارية.
مثبّت بنقرة واحدة للمضيفين المدعومين:
./scripts/install.sh --install-system-deps
راجع INSTALL.md للاطلاع على خيارات المثبّت والأدوات الاختيارية.
للميزات المدرجة تحت Unreleased، استخدم --branch master في أمر الاستنساخ أعلاه. أُضيف فحص BMC والاسترداد الأصلي لـ JFFS2 بعد v2.0.1.
مرجع الأوامر السريع
- المساعدة :
fat -h - التعرّف على برنامج ثابت:
fat $firmwareأوfat identify --file $firmware - فحص فلاش BMC:
fat inspect bmc --file $firmware - مشروع جديد :
fat new $firmware - استخراج نظام الملفات :
fat extract $firmware - التحليل :
fat analyze $firmware - المحاكاة :
fat emulate --project $firmware
أول تواصل مع ملف غير معروف
fat ./firmware.bin
fat inspect update --file ./firmware.bin --rootfs ./rootfs --reference ./older.bin
fat ./firmware.bin هو اختصار لـ fat identify --file ./firmware.bin.
يمنحك نظرة عامة موجزة عن هوية الملف وبنيته.
أضف --details لعرض الجداول الداعمة.
بالنسبة لصور MCU الخام، افحص التعيين والبدء والمقاطعات والعتاد:
fat inspect mcu --file ./firmware.bin
fat inspect mcu --file ./firmware.bin --details
لفحص صور فلاش BMC، افحص التخطيط وبيانات تعريف مصادقة FIT والبيئات المخزنة:
fat inspect bmc --file ./flash.mtd
fat inspect bmc --file ./flash.mtd --details
يدعم سيرا عمل الفحص كليهما الخيار --json للحصول على تقرير التحليل المنظم الكامل.
كما يدعم فحص BMC الخيارين --sarif --fail-on-warning لأجل CI. تُبلَّغ توقيعات FIT كبيانات وصفية مخزَّنة؛ ولا تُختبر الصلاحية التشفيرية ولا فرض الإقلاع على مستوى العتاد.
شغِّل خدمات BMC المدعومة باستخدام fat emulate --project <project> --pack bmc-romulus أو ملف تعريف نواة مورّد ASUS الصريح. اعرض ملفات التعريف باستخدام fat rehost profiles list؛ راجع محاكاة BMC للاطلاع على تجزئات الإدخال والتعديلات وفحوص Redfish وتصحيح الأخطاء.
بالنسبة لحسابات المختبر المؤقتة، يتحقق fat debug redfish-session من فرض دور ReadOnly وإبطال الجلسة باستخدام ضابط إيجابي بصلاحيات مسؤول. يربط fat debug process بعملية خفية (daemon) في الضيف عبر SSH ويسجّل هويتها وتنظيفها. راجع تصحيح أخطاء جلسة BMC والعمليات للاطلاع على الإعداد ونتائج Romulus/ASUS.
يعيد الاستخراج الأصلي بناء ملفات JFFS2 قبل فحص المحتوى المضغوط المتداخل. راجع فحص البرنامج الثابت لـ BMC للاطلاع على سير عمل الاستخراج ومتطلبات التخزين الحساسة لحالة الأحرف ومخرجات SARIF وتجاوزات متغيرات البيئة.
من الصورة إلى وقت التشغيل
خط الأنابيب من البدء السريع، من البداية إلى النهاية:
fat new ./firmware.bin
fat extract .fat-projects/firmware
fat analyze .fat-projects/firmware
fat preflight .fat-projects/firmware
fat emulate --project .fat-projects/firmware
الفرز الثنائي وتدفق البيانات
fat r2-triage --file ./usr/sbin/httpd --json
fat taint --file ./www/cgi-bin/diag.cgi --summary
fat taint-query --file ./www/cgi-bin/diag.cgi
fat taint-cross --rootfs ./rootfs
fat taint-cross --rootfs ./rootfs --source-profile ./my-target-models.yaml --state-profile ./my-target-state.yaml
تدفق بيانات سكربت Shell
fat taint --lang shell --file ./app/init/wifi.sh --summary
fat taint --lang shell --rootfs ./extracted-rootfs --json
fat taint --lang shell --rootfs ./extracted-rootfs --source-profile ./my-target-shell.yaml --severity high
الملفات التنفيذية المجرّدة
ابحث عن الـ sinks بشكل ساكن، ثم جهّز خطافات وقت التشغيل لنفس العناوين: