
firmware-analysis-toolkit v2.0.0-alpha.1
Plateforme de recherche en sécurité des firmwares combinant analyse binaire, traçage de flux de données (taint tracing) et émulation pour l’IoT, l’IA en périphérie (edge AI), les appareils mobiles et la robotique.
FAT — Firmware Analysis Toolkit
Télécharger la dernière version · Journal des modifications · Installation
Firmware Analysis Toolkit est une boîte à outils de recherche en sécurité pour l'analyse de la sécurité des firmwares des objets IoT, de l'IA physique, des appareils mobiles et de la robotique. Elle est principalement conçue pour la formation "Offensive IoT Exploitation" dispensée par Attify.
Elle a été construite sur la base d'une expérience pratique réelle de terrain concernant ce qui compte vraiment lorsqu'il s'agit d'enquêtes de sécurité de firmware qui ont un impact réel.
L'objectif de FAT n'est pas seulement de construire une boîte à outils exceptionnelle et de pointe de classe mondiale pour la recherche en sécurité des firmwares, mais aussi de former des professionnels et des praticiens qui opèrent à leur plein potentiel, où l'outil devient un superpouvoir cognitif s'il est utilisé de certaines manières, tout en restant suffisamment simple pour être utilisé par ceux qui découvrent le domaine.
Parmi les fonctionnalités figurent la classification de firmwares inconnus, l'extraction de systèmes de fichiers, la cartographie du code lié à la confiance, le suivi de la contamination (taint), et la coordination de l'émulation QEMU.
Ce que FAT peut analyser
- Blobs et répertoires inconnus : conteneurs, membres compressés, régions à forte entropie, signaux MCU et fichiers de firmware candidats
- Images de firmware : en-têtes, enveloppes de mise à jour, partitions, bootloaders et différences entre images
- Images flash BMC : métadonnées de hachage/signature FIT, marqueurs OpenBMC/MegaRAC, environnements U-Boot à CRC valide, récupération JFFS2 native et profils d'émulation explicites full-flash/kernel constructeur
- Systèmes de fichiers Linux extraits : inventaire, intention de démarrage, binaires porteurs de confiance, matériel cryptographique et preuves sous forme de chaînes
- Binaires ELF : imports, exports, tables de gestionnaires, puits de code strippé, décompilation et contamination source-vers-puits
- Images bare-metal et MCU : tables de vecteurs, cartes mémoire, indices de périphériques, autorité d'écriture flash et preuves de passation de démarrage
- Artefacts d'IA en périphérie : fichiers MAGIK/JZDL, TFLite, ONNX et Qualcomm DLC, ainsi que les runtimes d'inférence visibles
- Applications Android : inventaire APK, pistes de découverte, localité, chaînes de capacités et frontières de passation
- Dépôts de code source : requêtes d'invariants, conseils de correctifs et recherches de variantes à proximité
Démarrage rapide
Téléchargez un bundle binaire depuis Releases, qui contient déjà les données d'exécution share/fat correspondantes, ou installez l'exécutable depuis crates.io avec 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 n'installe que l'exécutable fat. Installez une seule fois le bundle de données d'exécution correspondant à la version installée ; --release télécharge le fichier fat-data-<version>.zip correspondant, vérifie son SHA-256 et l'active :
fat data install --release
fat doctor
Compiler cette copie de travail (développement, ou pour les fonctionnalités listées sous 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
Sur Arch Linux ou Omarchy, commencez par les étapes d'installation Arch pour les paquets prérequis et les outils optionnels.
Installateur en une seule commande pour les hôtes pris en charge :
./scripts/install.sh --install-system-deps
Voir INSTALL.md pour les options d'installation et les outils facultatifs.
Pour les fonctionnalités listées sous Unreleased, utilisez --branch master dans la commande de clonage ci-dessus. L'inspection BMC et la récupération native JFFS2 ont été ajoutées après v2.0.1.
Réf. rapide des commandes
- Aide :
fat -h - Identifier un firmware :
fat $firmwareoufat identify --file $firmware - Inspecter la flash BMC :
fat inspect bmc --file $firmware - Nouveau projet :
fat new $firmware - Extraire le système de fichiers :
fat extract $firmware - Analyser :
fat analyze $firmware - Émulation :
fat emulate --project $firmware
Premier contact avec un fichier inconnu
fat ./firmware.bin
fat inspect update --file ./firmware.bin --rootfs ./rootfs --reference ./older.bin
fat ./firmware.bin est un raccourci pour fat identify --file ./firmware.bin.
Il donne un aperçu compact de l'identité et de la structure du fichier.
Ajoutez --details pour obtenir les tableaux complémentaires.
Pour les images MCU brutes, inspectez le mapping, le démarrage, les interruptions et le matériel :
fat inspect mcu --file ./firmware.bin
fat inspect mcu --file ./firmware.bin --details
Pour les images flash BMC, inspectez la disposition, les métadonnées d'authentification FIT et les environnements stockés :
fat inspect bmc --file ./flash.mtd
fat inspect bmc --file ./flash.mtd --details
Les deux workflows d'inspection prennent en charge --json pour le rapport d'analyse structuré complet.
L'inspection BMC prend également en charge --sarif --fail-on-warning pour la CI. Les signatures FIT sont rapportées comme métadonnées stockées ; la validité cryptographique et l'application du démarrage matériel ne sont pas testées.
Exécutez les services BMC pris en charge avec fat emulate --project <project> --pack bmc-romulus ou le profil explicite du noyau du fournisseur ASUS. Listez les profils avec fat rehost profiles list ; consultez Émulation BMC pour les hachages d'entrée, les adaptations, les vérifications Redfish et le débogage.
Pour les comptes de laboratoire jetables, fat debug redfish-session vérifie l'application du rôle ReadOnly et la révocation de session avec un contrôle positif administrateur. fat debug process s'attache à un démon invité via SSH et enregistre son identité et son nettoyage. Consultez Débogage des sessions et processus BMC pour la configuration et les résultats Romulus/ASUS.