IoTファームウェアの識別と抽出
IoTファームウェアの識別と抽出
moriaは、ファームウェアやIoTイメージに埋め込まれたファイルや構造(ファイルシステム、カーネル、ブートローダー、アーカイブ、鍵)を識別し、発見したものの大部分をroot権限なしで展開します。各検出結果はバイトオフセット、種類、信頼度スコアとともに報告され、クリーンなJSONで出力されるため、スクリプトやLLMエージェントが人間と同様に容易に操作できます。
upx -dを妨害するためにヘッダーがゼロ化または改変されたスタブも検出します。openat + O_NOFOLLOWを経由し(パストラバーサルやシンボリックリンクによる脱出なし)、展開は爆弾に対して上限が設けられています。-j)で、すべての検出結果にオフセットと信頼度が付きます。cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
cmake --install build --prefix ~/.local # or /usr/local (needs sudo)
ビルドには cmake、C++20 コンパイラ、および zlib、liblzma、lz4、zstd の開発用ライブラリ(--extract で使用する伸張処理用)が必要です。Debian/Ubuntu では sudo apt install cmake g++ zlib1g-dev liblzma-dev liblz4-dev libzstd-dev を実行します。いずれかを省いたビルド(最小構成または識別専用ビルド)を行うには、-DMORIA_OPTIONAL_CODECS=ON を付けて構成すると、不足しているコーデックが単に無効化されます。
moria バイナリは自己完結型です。すべてのシグネチャセットがビルド時に埋め込まれるため、バイナリは何もインストールされていない環境でも動作します(cp build/moria ~/.local/bin だけで十分であり、ダウンロードしたリリースバイナリもそのまま実行できます)。埋め込みシグネチャの代わりに外部シグネチャを使用する場合(たとえば、再ビルドせずに新しい .toml をテストする場合)は、--sigs DIR を渡すか、$MORIA_SIGDIR を設定してください。
出力はデフォルトで人間が読める形式です。JSON を出力するには -j を渡します。
moria <file> # identify: a findings tree with offsets, types, and confidence
moria <dir> # scan a tree: a type summary plus the notable files
moria -j <file> # JSON, for tools and agents
moria -e <file> # extract to <file>.extracted/ (-C DIR to choose the output dir)
moria -c <file> # carve raw byte ranges to <file>.carved/ (no parsing)
moria -E <file> # entropy pass: flag unidentified / possibly-encrypted regions
moria --list <archive> # list tar/cpio/zip/cab/CE-ROM members without extracting
moria --broad <path> # also load the ~2.5k general file-type signatures
moria --unpack-executables # unpack executables inside other extracted output (cfbf/msi files)
moria --help
-e は認識されたフォーマットを <file>.extracted/ 以下に展開します。リージョンごとに 1 ディレクトリ (0x<offset>-<type>/) を作成し、さらにオフセットからパスへの対応を記した manifest.json を生成します。ネストされたコンテナへは自動的に再帰し、UBI イメージはボリューム単位で再構築します。ガード (--depth、--max-files、--max-bytes、および展開比率の上限) によって悪意ある入力を制限します。ガードが作動した場合はそのブランチを停止しつつ、復元できたものはすべて返します。
プロセス内で展開し、外部ツールも sudo も使用しません:
.msi、ISO 9660、Android sparse、Android boot.hv)signatures/ は手書きのコアです。ファームウェアのファイルシステム、コンテナ、カーネル、一般的なフォーマットを扱い、それぞれ構造検証を伴います。signatures-firmware/ はベンダーのファームウェアコンテナのマジックを保持し、デフォルトで読み込まれます。signatures-generated/ は file(1) のマジックデータベースから導出した約 2.5k の汎用ファイルタイプマジックを保持し、--broad を指定した場合にのみ読み込まれます。フォーマットを追加するには、signatures/ に .toml を置くだけです。CRC やブロック間ポインタなど、宣言的なレイヤーでは表現できないチェックに限り、小さな C++ バリデータが必要になります。フィールドの意味 (magic_offset、マジックのエンディアン、短いシグネチャ、ソフト制約、バリデータの契約) は SIGAUTHORING.md に記載されています。
moria は構造の識別、抽出、およびカービングを行います。シークレット/認証情報のスキャン、SBOM、CVE、ライセンス解析は別のツール (mithril) の役割です。
MIT、LICENSE を参照してください。
一部のオンディスクフォーマットの処理は、他のオープンソースプロジェクトのアルゴリズムをクリーンに再実装したもので、moria 独自の I/O レイヤーに対して独立して書かれています (ソースコードのコピーはありません): UPX/UCL の UCL/NRV2B 展開器と CTO アンフィルタ (GPL-2.0、アルゴリズムのみ)、littlefs のメタデータコミットと CTZ スキップリストのレイアウト (BSD-3-Clause)、および SPIFFS のページ/オブジェクトレイアウト (MIT) です。