
firmware-analysis-toolkit v2.0.0-alpha.1
फर्मवेयर सुरक्षा अनुसंधान प्लेटफ़ॉर्म जो IoT, एज AI, मोबाइल डिवाइस और रोबोटिक्स में बाइनरी विश्लेषण, टेंट ट्रेसिंग और इम्यूलेशन को जोड़ता है।
FAT — फर्मवेयर विश्लेषण टूलकिट
नवीनतम रिलीज़ डाउनलोड करें · चेंजलॉग · इंस्टॉलेशन
फर्मवेयर विश्लेषण टूलकिट IoT, फिजिकल AI, मोबाइल डिवाइस और रोबोटिक्स के लिए फर्मवेयर सुरक्षा की जाँच करने हेतु एक सुरक्षा अनुसंधान टूलकिट है। यह मुख्य रूप से Attify द्वारा संचालित "Offensive IoT Exploitation" प्रशिक्षण के लिए बनाया गया है।
यह वास्तविक फर्मवेयर सुरक्षा जाँचों में वास्तव में क्या मायने रखता है, इसके वास्तविक व्यावहारिक अनुभव के आधार पर बनाया गया है।
FAT का लक्ष्य केवल फर्मवेयर सुरक्षा अनुसंधान के लिए एक विश्व-स्तरीय अत्याधुनिक टूलकिट बनाना नहीं है, बल्कि ऐसे पेशेवरों और प्रैक्टिशनर्स को तैयार करना भी है जो अपने चरम पर काम करते हैं, जहाँ यदि टूल का उपयोग कुछ विशिष्ट तरीकों से किया जाए तो यह एक संज्ञानात्मक सुपरपावर बन जाता है, साथ ही यह उन लोगों के लिए भी पर्याप्त आसान है जो इस क्षेत्र में नए हैं।
कुछ विशेषताओं में अज्ञात फर्मवेयर का वर्गीकरण, फाइलसिस्टम निकालना, ट्रस्ट-प्रासंगिक कोड का मानचित्रण, टेन्ट ट्रेसिंग, और QEMU एमुलेशन का समन्वय शामिल है।
FAT क्या विश्लेषित कर सकता है
- अज्ञात ब्लॉब्स और डायरेक्टरीज़: कंटेनर, संपीड़ित सदस्य, उच्च-एन्ट्रॉपी क्षेत्र, MCU सिग्नल, और संभावित फर्मवेयर फ़ाइलें
- फर्मवेयर इमेजेज़: हेडर, अपडेट एनवेलप, पार्टीशन, बूटलोडर, और इमेज-से-इमेज अंतर
- BMC फ्लैश इमेजेज़: FIT हैश/हस्ताक्षर मेटाडेटा, OpenBMC/MegaRAC मार्कर, CRC-वैध U-Boot एनवायरनमेंट, नेटिव JFFS2 रिकवरी, और स्पष्ट फुल-फ्लैश/वेंडर-कर्नेल एमुलेशन प्रोफ़ाइल
- निकाले गए Linux फाइलसिस्टम: इन्वेंटरी, स्टार्टअप इरादा, ट्रस्ट-वहन करने वाली बाइनरीज़, क्रिप्टो सामग्री, और स्ट्रिंग साक्ष्य
- ELF बाइनरीज़: इम्पोर्ट, एक्सपोर्ट, हैंडलर टेबल, स्ट्रिप्ड-कोड सिंक, डीकंपाइलेशन, और सोर्स-टू-सिंक टेन्ट
- बेयर-मेटल और MCU इमेजेज़: वेक्टर टेबल, मेमोरी मैप, पेरिफेरल संकेत, फ्लैश-राइट प्राधिकार, और बूट हैंडऑफ़ साक्ष्य
- एज AI आर्टिफैक्ट्स: MAGIK/JZDL, TFLite, ONNX, और Qualcomm DLC फ़ाइलें तथा दृश्यमान इन्फरेंस रनटाइम
- Android एप्लिकेशन: APK इन्वेंटरी, डिस्कवरी लीड्स, लोकैलिटी, क्षमता श्रृंखलाएँ, और हैंडऑफ़ सीमाएँ
- सोर्स रिपॉज़िटरीज़: इनवेरिएंट क्वेरीज़, पैच मार्गदर्शन, और निकटवर्ती वेरिएंट खोजें
त्वरित शुरुआत
Releases से एक बाइनरी बंडल डाउनलोड करें, जिसमें पहले से ही मेल खाता share/fat रनटाइम डेटा शामिल है, या Cargo के साथ crates.io से एक्ज़ीक्यूटेबल इंस्टॉल करें:
# 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 executable इंस्टॉल करता है। इंस्टॉल किए गए संस्करण के लिए runtime-data bundle एक बार इंस्टॉल करें; --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 installation steps से शुरू करें।
समर्थित होस्ट्स के लिए One-Shot Installer:
./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 निरीक्षण CI के लिए --sarif --fail-on-warning का भी समर्थन करता है। FIT हस्ताक्षर संग्रहीत मेटाडेटा के रूप में रिपोर्ट किए जाते हैं; क्रिप्टोग्राफ़िक वैधता और हार्डवेयर बूट प्रवर्तन का परीक्षण नहीं किया जाता है।
समर्थित BMC सेवाओं को fat emulate --project <project> --pack bmc-romulus या स्पष्ट ASUS वेंडर-कर्नेल प्रोफ़ाइल के साथ चलाएँ। प्रोफ़ाइल की सूची fat rehost profiles list से देखें; इनपुट हैश, अनुकूलन, Redfish जाँच और डिबगिंग के लिए BMC emulation देखें।
डिस्पोज़ेबल लैब खातों के लिए, fat debug redfish-session एक व्यवस्थापक सकारात्मक नियंत्रण के साथ ReadOnly भूमिका प्रवर्तन और सत्र निरसन की जाँच करता है। fat debug process SSH के माध्यम से एक गेस्ट डेमन से जुड़ता है और उसकी पहचान और सफ़ाई दर्ज करता है। सेटअप और Romulus/ASUS परिणामों के लिए BMC session and process debugging देखें।
नेटिव एक्सट्रैक्शन नेस्टेड संपीड़ित सामग्री का निरीक्षण करने से पहले JFFS2 फ़ाइलों का पुनर्निर्माण करता है। एक्सट्रैक्शन वर्कफ़्लो, केस-संवेदी स्टोरेज आवश्यकताओं, SARIF आउटपुट और पर्यावरण ओवरराइड के लिए Inspecting BMC firmware देखें।
Image to Runtime
Quick start से पाइपलाइन, शुरू से अंत तक:
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
शेल स्क्रिप्ट डेटा प्रवाह
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