アップデート一覧に戻る
New releaseSep 9, 2026

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

ファームウェアセキュリティ研究プラットフォーム。IoT、エッジAI、モバイルデバイス、ロボティクスを対象に、バイナリ解析、テイントトレーシング、エミュレーションを組み合わせたツールです。

共有

FAT — ファームウェア解析ツールキット

FAT release 最新リリースをダウンロード · 変更履歴 · インストール

Firmware Analysis Toolkit は、IoT、Physical AI、モバイルデバイス、ロボティクス向けのファームウェアセキュリティを調査するためのセキュリティ研究ツールキットです。主に Attify が実施する "Offensive IoT Exploitation" トレーニング向けに構築されています。

実際に重要となるファームウェアセキュリティ調査において、何が本当に重要なのかという実践的な現場経験に基づいて構築されています。

FAT の目標は、ファームウェアセキュリティ研究のための世界最高水準の最先端ツールキットを構築するだけにとどまらず、特定の使い方をすればツールが認知的超能力となるような、最高のパフォーマンスを発揮するプロフェッショナルや実務家を育成することにあります。同時に、この分野に不慣れな人でも使えるほど簡単であることも目指しています。

機能には、未知のファームウェアの分類、ファイルシステムの抽出、信頼に関連するコードのマッピング、テイントの追跡、QEMU エミュレーションの調整などが含まれます。

FAT で解析できるもの

  • 未知の blob とディレクトリ: コンテナ、圧縮メンバー、高エントロピー領域、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 実行ファイルのみをインストールします。インストールしたバージョンに対応するランタイムデータバンドルを一度だけインストールしてください。--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 インストール手順 から始めてください。

サポート対象ホスト向けのワンショットインストーラー:

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

インストーラのオプションと任意ツールについては INSTALL.md を参照してください。

Unreleased に記載されている機能を使用するには、上記の clone コマンドで --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

シンボルを削除されたバイナリ

シンクを静的に特定し、同じアドレスに対してランタイムフックを準備します:

fat r2-triage --file ./usr/sbin/httpd --json
fat sink-discovery --file ./usr/sbin/httpd --json > sinks.json
fat handler-table --file ./usr/sbin/httpd --json > handlers.json
fat taint --file ./usr/sbin/httpd --sink-candidates sinks.json --json > taint.json
fat instrument-hooks --from-sinks sinks.json --output hooks.yaml
fat emulate --project .fat-projects/firmware --instrument hooks.yaml

ファイルシステム全体の証拠スイープ

fat tree --rootfs ./rootfs --profile inventory --summary --json
fat search --rootfs ./rootfs --profile credentials -I --context 2
fat startup-map --rootfs ./rootfs --profile cloud-tls
fat crypto-census --rootfs ./rootfs
fat trust-map --rootfs ./rootfs

ソースに基づく不変条件クエリ

fat invariant query \
  --fixture tests/fixtures/query/source/invariant-permission \
  --rule 'Every privileged override method must call enforcePermission()'
fat patch check --help
fat verify --help

セキュリティ

  • エミュレーションは信頼できないベンダーコードを実行します。
  • 信頼できないイメージを処理したり、エミュレートされたサービスをネットワークに公開したりする前に、SECURITY.md を確認してください。
  • 作業対象に対する許可を取得するのはあなたの責任です。

詳細ガイド

カテゴリ