Torna agli aggiornamenti
New releaseSep 9, 2026

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.

Condividi

FAT — Firmware Analysis Toolkit

FAT release 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 $firmware oppure fat 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

Triage binario e flusso di dati

Categorie