
firmware-analysis-toolkit v2.0.0-alpha.1
Piattaforma di ricerca sulla sicurezza del firmware che combina analisi binaria, tracciamento del taint ed emulazione su IoT, edge AI, dispositivi mobili e robotica.
FAT — Firmware Analysis Toolkit
Scarica l'ultima release · Changelog · Installazione
Firmware Analysis Toolkit è un toolkit per la ricerca sulla sicurezza, pensato per indagare la sicurezza del firmware di IoT, Physical AI, dispositivi mobili e robotica. È stato realizzato principalmente per il corso "Offensive IoT Exploitation" tenuto da Attify.
È stato costruito sulla base dell'esperienza pratica sul campo di ciò che conta davvero quando si tratta di indagini reali sulla sicurezza del firmware.
L'obiettivo di FAT non è solo quello di costruire un toolkit eccezionale e all'avanguardia per la ricerca sulla sicurezza del firmware, ma anche di formare professionisti e operatori che lavorano al massimo delle loro capacità, dove lo strumento diventa un superpotere cognitivo se usato in un certo modo, pur restando abbastanza semplice da essere utilizzato da chi è nuovo al settore.
Alcune delle funzionalità includono la classificazione di firmware sconosciuti, l'estrazione di filesystem, la mappatura del codice rilevante per la fiducia, il tracciamento della taint e il coordinamento dell'emulazione QEMU.
Cosa può analizzare FAT
- Blob e directory sconosciuti: container, membri compressi, regioni ad alta entropia, segnali MCU e file firmware candidati
- Immagini firmware: header, envelope di aggiornamento, partizioni, bootloader e differenze tra immagini
- Immagini flash BMC: metadati di hash/firma FIT, marcatori OpenBMC/MegaRAC, ambienti U-Boot con CRC valido, recupero nativo JFFS2 e profili espliciti di emulazione full-flash/kernel del fornitore
- Filesystem Linux estratti: inventario, intenti di avvio, binari rilevanti per la fiducia, materiale crittografico ed evidenze testuali
- Binari ELF: import, export, tabelle di handler, sink di codice stripped, decompilazione e taint da sorgente a sink
- Immagini bare-metal e MCU: tabelle dei vettori, mappe di memoria, indizi sui periferici, autorità di scrittura sulla flash ed evidenze di handoff del boot
- Artefatti Edge AI: file MAGIK/JZDL, TFLite, ONNX e Qualcomm DLC, oltre ai runtime di inferenza visibili
- Applicazioni Android: inventario APK, piste di scoperta, località, catene di capacità e confini di handoff
- Repository di codice sorgente: query sugli invarianti, indicazioni sulle patch e ricerche di varianti vicine
Avvio rapido
Scarica un bundle binario dalle Releases, che contiene già i dati runtime corrispondenti in share/fat, oppure installa l'eseguibile da crates.io con 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 installa solo l'eseguibile fat. Installa una volta il bundle di dati runtime per la versione installata; --release scarica il corrispondente fat-data-<version>.zip, ne verifica lo SHA-256 e lo attiva:
fat data install --release
fat doctor
Compilare questo checkout (per lo sviluppo, o per le funzionalità elencate in 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
Su Arch Linux o Omarchy, inizia con i passaggi di installazione per Arch per i pacchetti prerequisiti e gli strumenti opzionali.
Installer One-Shot per gli host supportati:
./scripts/install.sh --install-system-deps
Consulta INSTALL.md per le opzioni di installazione e gli strumenti opzionali.
Per le funzionalità elencate in Unreleased, usa --branch master nel comando di clone sopra riportato. L'ispezione BMC e il recupero nativo di JFFS2 sono stati aggiunti dopo v2.0.1.
Riferimento rapido ai comandi
- Aiuto :
fat -h - Identificare un firmware:
fat $firmwareoppurefat identify --file $firmware - Ispezionare la flash BMC:
fat inspect bmc --file $firmware - Nuovo progetto :
fat new $firmware - Estrarre il file system :
fat extract $firmware - Analizzare :
fat analyze $firmware - Emulazione :
fat emulate --project $firmware
Primo contatto con un file sconosciuto
fat ./firmware.bin
fat inspect update --file ./firmware.bin --rootfs ./rootfs --reference ./older.bin
fat ./firmware.bin è una scorciatoia per fat identify --file ./firmware.bin.
Fornisce una panoramica compatta dell'identità e della struttura del file.
Aggiungi --details per le tabelle di supporto.
Per le immagini MCU grezze, ispeziona la mappatura, l'avvio, gli interrupt e l'hardware:
fat inspect mcu --file ./firmware.bin
fat inspect mcu --file ./firmware.bin --details
Per le immagini flash BMC, ispezionare il layout, i metadati di autenticazione FIT e gli ambienti memorizzati:
fat inspect bmc --file ./flash.mtd
fat inspect bmc --file ./flash.mtd --details
Entrambi i flussi di lavoro di ispezione supportano --json per il report completo dell'analisi strutturata.
L'ispezione BMC supporta anche --sarif --fail-on-warning per la CI. Le firme FIT sono riportate come metadati memorizzati; la validità crittografica e l'applicazione dell'avvio hardware non vengono testate.
Esegui i servizi BMC supportati con fat emulate --project <project> --pack bmc-romulus o con il profilo esplicito del kernel del vendor ASUS. Elenca i profili con fat rehost profiles list; consulta BMC emulation per gli hash di input, gli adattamenti, i controlli Redfish e il debug.
Per gli account di laboratorio usa e getta, fat debug redfish-session verifica l'applicazione del ruolo ReadOnly e la revoca della sessione con un controllo positivo da amministratore. fat debug process si collega a un daemon guest tramite SSH e ne registra l'identità e la pulizia. Consulta BMC session and process debugging per la configurazione e i risultati Romulus/ASUS.
L'estrazione nativa ricostruisce i file JFFS2 prima di ispezionare il contenuto compresso annidato. Consulta Inspecting BMC firmware per il flusso di lavoro di estrazione, i requisiti di archiviazione con distinzione tra maiuscole e minuscole, l'output SARIF e le sostituzioni delle variabili d'ambiente.
Image to Runtime
La pipeline dalla Guida rapida, dall'inizio alla fine:
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