Zurück zu den Updates
New releaseSep 9, 2026

firmware-analysis-toolkit v2.0.0-alpha.1

Firmware-Sicherheitsforschungsplattform, die Binäranalyse, Taint-Tracing und Emulation über IoT, Edge-KI, mobile Geräte und Robotik hinweg kombiniert.

Teilen

FAT — Firmware-Analyse-Toolkit

FAT release Laden Sie die neueste Version herunter · Changelog · Installation

Firmware Analysis Toolkit ist ein Toolkit für die Sicherheitsforschung zur Untersuchung der Firmware-Sicherheit von IoT, Physical AI, mobilen Geräten und Robotik. Es wurde in erster Linie für die Schulung "Offensive IoT Exploitation" von Attify entwickelt.

Es basiert auf tatsächlicher praktischer Erfahrung damit, worauf es bei realen Firmware-Sicherheitsuntersuchungen wirklich ankommt.

Das Ziel von FAT ist nicht nur, ein außergewöhnliches, weltklasse Spitzen-Toolkit für die Firmware-Sicherheitsforschung zu schaffen, sondern auch Fachleute und Praktiker auszubilden, die auf ihrem Höchstniveau arbeiten, wobei das Tool bei richtiger Anwendung zu einer kognitiven Superkraft wird und zugleich einfach genug ist, um von Einsteigern in diesem Bereich genutzt zu werden.

Zu den Funktionen gehören die Klassifizierung unbekannter Firmware, das Extrahieren von Dateisystemen, das Abbilden vertrauensrelevanter Codebereiche, das Verfolgen von Taint und die Koordinierung der QEMU-Emulation.

Was FAT analysieren kann

  • Unbekannte Blobs und Verzeichnisse: Container, komprimierte Member, Bereiche hoher Entropie, MCU-Signale und Kandidaten-Firmware-Dateien
  • Firmware-Images: Header, Update-Envelopes, Partitionen, Bootloader und Unterschiede zwischen Images
  • BMC-Flash-Images: FIT-Hash-/Signatur-Metadaten, OpenBMC-/MegaRAC-Marker, CRC-gültige U-Boot-Umgebungen, native JFFS2-Wiederherstellung und explizite Emulationsprofile für vollständigen Flash/Vendor-Kernel
  • Extrahierte Linux-Dateisysteme: Inventar, Startabsichten, vertrauensrelevante Binärdateien, Krypto-Material und String-Beweise
  • ELF-Binärdateien: Importe, Exporte, Handler-Tabellen, Senken für gestrippten Code, Dekompilierung und Source-to-Sink-Taint
  • Bare-Metal- und MCU-Images: Vektortabellen, Speicherkarten, Peripherie-Hinweise, Flash-Schreibberechtigung und Boot-Handoff-Beweise
  • Edge-AI-Artefakte: MAGIK/JZDL-, TFLite-, ONNX- und Qualcomm-DLC-Dateien sowie sichtbare Inferenz-Runtimes
  • Android-Anwendungen: APK-Inventar, Ermittlungsansätze, Lokalität, Fähigkeitsketten und Übergabegrenzen
  • Quellcode-Repositories: Invarianten-Abfragen, Patch-Anleitungen und Suche nach nahegelegenen Varianten

Schnellstart

Laden Sie ein Binärpaket von Releases herunter, das bereits die passenden share/fat-Laufzeitdaten enthält, oder installieren Sie die ausführbare Datei von crates.io mit 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 installiert nur die ausführbare Datei fat. Installiere das Runtime-Datenpaket für die installierte Version einmalig; --release lädt das passende fat-data-<version>.zip herunter, verifiziert dessen SHA-256 und aktiviert es:

fat data install --release
fat doctor

Diesen Checkout bauen (für die Entwicklung oder für die unter Unreleased aufgeführten Funktionen):

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

Auf Arch Linux oder Omarchy beginnen Sie mit den Arch-Installationsschritten für erforderliche Pakete und optionale Tools.

One-Shot-Installer für unterstützte Hosts:

./scripts/install.sh --install-system-deps

Siehe INSTALL.md für Installationsoptionen und optionale Tools.

Für Funktionen, die unter Unreleased aufgeführt sind, verwenden Sie --branch master im obigen Clone-Befehl. Die BMC-Inspektion und die native JFFS2-Wiederherstellung wurden nach v2.0.1 hinzugefügt.

Kurzreferenz für Befehle

  • Hilfe : fat -h
  • Eine Firmware identifizieren: fat $firmware oder fat identify --file $firmware
  • BMC-Flash inspizieren: fat inspect bmc --file $firmware
  • Neues Projekt : fat new $firmware
  • Dateisystem extrahieren : fat extract $firmware
  • Analysieren : fat analyze $firmware
  • Emulation : fat emulate --project $firmware

Erster Kontakt mit einer unbekannten Datei

fat ./firmware.bin
fat inspect update --file ./firmware.bin --rootfs ./rootfs --reference ./older.bin

fat ./firmware.bin ist eine Kurzform für fat identify --file ./firmware.bin. Sie liefert einen kompakten Überblick über die Identität und Struktur der Datei. Fügen Sie --details hinzu, um unterstützende Tabellen zu erhalten. Bei rohen MCU-Images untersuchen Sie das Mapping, den Startup, die Interrupts und die Hardware:

fat inspect mcu --file ./firmware.bin
fat inspect mcu --file ./firmware.bin --details

Für BMC-Flash-Images Layout, FIT-Authentifizierungsmetadaten und gespeicherte Umgebungen inspizieren:

fat inspect bmc --file ./flash.mtd
fat inspect bmc --file ./flash.mtd --details

Beide Inspektions-Workflows unterstützen --json für den vollständigen strukturierten Analysebericht. Die BMC-Inspektion unterstützt außerdem --sarif --fail-on-warning für CI. FIT-Signaturen werden als gespeicherte Metadaten gemeldet; kryptografische Gültigkeit und Hardware-Boot-Durchsetzung werden nicht getestet.

Führen Sie unterstützte BMC-Dienste mit fat emulate --project <project> --pack bmc-romulus oder dem expliziten ASUS-Vendor-Kernel-Profil aus. Listen Sie Profile mit fat rehost profiles list auf; siehe BMC emulation für Eingabe-Hashes, Anpassungen, Redfish-Prüfungen und Debugging.

Für Wegwerf-Laborkonten prüft fat debug redfish-session die Durchsetzung der ReadOnly-Rolle und die Sitzungswiderrufung mit einer administrativen Positivkontrolle. fat debug process hängt sich über SSH an einen Gast-Daemon an und zeichnet dessen Identität und Bereinigung auf. Siehe BMC session and process debugging für die Einrichtung und die Romulus/ASUS-Ergebnisse.

Die native Extraktion rekonstruiert JFFS2-Dateien, bevor verschachtelte komprimierte Inhalte inspiziert werden. Siehe Inspecting BMC firmware für den Extraktions-Workflow, Anforderungen an die Groß-/Kleinschreibung des Speichers, SARIF-Ausgabe und Umgebungsüberschreibungen.

Image to Runtime

Die Pipeline aus dem Schnellstart, von Anfang bis Ende:

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

Binäre Triage und Datenfluss

Kategorien