Fortinetファームウェアの復号および解析ツール
Fortinetファームウェアを復号・展開するための単一の静的Goバイナリ兼ライブラリ:FortiGate/FortiWiFi FortiOSイメージ、およびテスト済みのFortiAnalyzer/FortiManager KVMインストールパッケージに対応。サポートされるコンテナ、ファイルシステム、暗号化スキームは、製品・バージョン・CPUアーキテクチャのフラグを必要とせず、その内容から検出されます。テスト済みの製品、パッケージ種別、ステージについてはサポートされるファームウェアを参照してください。
フォーマットおよび暗号リーダーはGoで実装されています。実行時にopenssl、xz、tar、cpio、mount/debugfs、7z、binwalk、vmlinux-to-elf、Pythonは不要です。FortiOSのconfig-secret復号およびFortiGuard PKCS#7署名の検査も含まれています。
これまで、1つのファームウェアイメージを復号するには、バージョンごとに異なる複数のツール(forticrack、fgx、forticrack_v8、decrypt-fortigate-rootfsなど)から適切なものを選び、OSのバイナリを手作業で連鎖させる必要がありました。fortitoolはそのすべてを1つのコマンドにまとめます。
GitHub releasesからお使いのプラットフォーム向けのアーカイブをダウンロードしてください。各リリースには、すべてのビルド済みバイナリアーカイブを対象としたSHA-256チェックサムファイルが含まれています。アーカイブを展開し、fortitool(またはfortitool.exe)をPATHに配置して、fortitool versionを実行しインストールされたタグを確認してください。
あるいは、Goでインストールすることもできます:
go install github.com/mosajjal/fortitool/cmd/fortitool@latest
ソースからビルドする場合:
git clone https://github.com/mosajjal/fortitool
cd fortitool
CGO_ENABLED=0 go build -o fortitool ./cmd/fortitool
CGO_ENABLED=0 は、このプロジェクトが約束する完全に静的なバイナリを求める場合に重要です。これがないと、Go は(未使用の)net リゾルバのために glibc にリンクします。file fortitool(「statically linked」と表示されるはず)または ldd fortitool(「not a dynamic executable」と表示されるはず)で確認してください。
fortitool decrypt -o outdir image.out # full pipeline, one command
fortitool inspect image.out # read-only format/support report
fortitool decrypt -o fmg image.out.kvm.zip # FAZ/FMG single-QCOW2 package
fortitool decrypt --boot-only -o boot faz.qcow2 # original boot files only
fortitool l1 -o out.img image.out # outer XOR layer only
fortitool rootfs -o out.gz kernel rootfs.gz # kernel is flatkc or vmlinuz
fortitool unpack -o outdir archive.tar.xz # generic gzip+tar / xz+tar
fortitool pkg inspect --content payload sig.x # verify a PKCS#7 signature
fortitool pkg scan datafs/ # classify files, find sigs
fortitool config decrypt --stdin < secret.txt # config-backup ENC secret
fortitool config decrypt --file secret.txt # file input without argv exposure
すべてのコマンドには、fortitool <command> -h(またはコマンド一覧を表示する fortitool -h)で完全な説明、フラグ、例が用意されています。フラグは位置引数より前に指定する必要があります。Go の flag パッケージは getopt のように argv を並べ替えないためです。
inspect は1つのイメージを、安定した人間が読める field: value 形式の行として報告します。decrypt と同じ L1、ディスクレイアウト、必須メンバー、rootfs 暗号化、ペイロード分類の判定を使用しますが、何も抽出・書き込みせず、復元された鍵素材を表示することもありません。読み取り可能なイメージが部分的にしか認識されない場合は status: partial、last-successful-stage、unsupported-stage を報告し、その境界を記述することが正常な検査であるため終了コード 0 で終了します。入力が存在しない、またはアクセスできない場合は終了コード 1、無効なフラグや引数数の場合は終了コード 2 で終了します。
decrypt と unpack は、要求された出力ディレクトリがまだ存在しない場合にのみ、完成したツリーを公開します。Linux ではアトミックな置換なしリネームを使用し、その他のプラットフォームではリネーム前にベストエフォートの存在チェックを行います。ステージングされたツリーと単体の復号ファイルは、呼び出し元の ID に限定されます。Unix ではモード 0700 または 0600、Windows ではユーザーごとの保護された DACL です。絶対ターゲットを持つアーカイブおよびファイルシステムのシンボリックリンクは、閉じ込められた相対リンクとして書き換えられるため、抽出されたリンクはホスト上のパスを参照するのではなく、出力ツリー内に留まります。
設定シークレットについては、暗号文がプロセス一覧やシェル履歴に現れないよう、--stdin または --file を推奨します。直接指定する fortitool config decrypt <base64-blob> 形式は互換性のためにのみ利用可能で、3つの入力ソースのうちちょうど1つだけが受け付けられます。入力は 1 MiB に制限され、前後の空白はトリミングされ、残った値は空でなく、空白を含まない必要があります。
pkg inspect --content では、ラッパーに少なくとも1つの署名者が含まれ、すべての SignerInfo がペイロードに対して検証に成功した場合にのみ検証が成功します。これは PKCS#7 ラッパーに埋め込まれた証明書を使用して暗号学的な完全性を証明しますが、信頼されたルート CA への信頼チェーンを検証するものではありません。
対象範囲は製品、パッケージ種別、処理段階に固有です。FAZ/FMG ファームウェアの対応は、それらの設定バックアップシークレットや他の Fortinet 製品への対応を確立するものではありません。
バージョン 3.0 から 8.0 にわたる、テスト済みの 167 個の固有の FortiOS イメージ全体で、L1/ヘッダー復元はすべてのイメージで成功し、独立したデコーダとバイト単位で一致しました。これはその段階とテスト済みのセットのみを対象としています。後続の復号と抽出は、以下で詳述するようにフォーマットに依存します。
| レイヤー | 対応範囲 | ステータス |
|---|---|---|
L1 .out 外側暗号 | 対応する FortiOS .out レイアウト | 上記の167イメージのコーパス全体で検証済み。実際の FWF-60E 7.4.7/7.4.10/7.4.11 の出力は独立したデコーダとバイト単位で一致 |
| rootfs.gz — ChaCha20+RSA+AES-CTR ファミリー | 7.4.1–7.4.11(ARM + x86_64 分割) | ARM パスは実ファームウェアに対してバイト単位で一致することを検証済み。x86_64 分割は公開された解説記事から移植したもので、合成ラウンドトリップテストでカバーされているが、実際の x86 サンプルに対しては未実行 |
| rootfs.gz — ChaCha20 本体(7.4.1–7.4.3 時代) | シード由来の鍵/IV、非 RFC7539 カウンタ | fortigate-crypto/Bishop Fox から移植したもので、合成ラウンドトリップテストでカバーされているが、その時代の実際のサンプルに対しては未実行 |
| rootfs.gz — XOR+RSA+{FORT-RC4,modified-RC4} ファミリー | 7.6.x、8.0 | 公開された解説記事(fgx、forticrack_v8)から移植したもので、合成ラウンドトリップテストでカバーされているが、実際のサンプルに対しては未実行 |
| ディスクイメージレイアウト | アプライアンス MBR+ext3 @512、QCOW2 VM ディスク、固定オフセットボリューム | アプライアンスパスは実ファームウェアに対してバイト単位で一致することを検証済み。QCOW2/パーティションおよび ext4 エクステントの検出は合成テストでカバーされているが、実際の FortiGate VM イメージに対しては未実行 |
| ext2/3 ファイルシステム読み取り | FSoC3/ARM アプライアンス MBR+ext3 レイアウト | 二重間接ブロックマッピングを含め、実ファームウェアに対してバイト単位で一致することを検証済み |
| ext4 エクステントマップ読み取り | FortiOS 8.0 VM rootfs(xz 圧縮 ext4 イメージ) | 合成ラウンドトリップテストのみ。実際の 8.0 サンプルは入手不可 |
| tar/gzip/xz 展開 | 任意 | 実ファームウェアに対してバイト単位で一致することを検証済み |
| PKCS#7 SignedData 検証 | 分離署名(.x ファイル)、二重署名を含む | 実際の署名済みエンジン/DB ファイルに対して、両方の署名者チェーンで検証済み |
設定シークレット ENC <base64> の復号 | 全時代 | レガシーのハードコードされた AES-128 鍵は、少なくとも 7.2.3 までの実デバイスデータに対して検証済み(一般に信じられているのとは異なり、6.2 でローテーションされたことはない)。>=7.4(ビルド 2731)の AES-256-CBC 鍵は init モノリスの RE によって復元され、両方の時代にまたがる実デバイスのバックアップに対して検証済み — 両方の鍵が埋め込まれている。詳細は設定シークレット鍵を参照 |
「検証済み」とは、実際のファームウェア/設定サンプルに対して実行し、出力がバイト単位で一致するか意味的に正しいことを確認したことを意味する。それ以外はすべて、文書化された動作するリファレンス実装を忠実に移植したもので、このリポジトリのテストスイートによって実行されているが、その特定の時代の実際のサンプルに対してはまだ実行されていない — 実ファームウェアでの検証を含むパッチを歓迎する。
decrypt はアプライアンス、QCOW2、固定オフセットのディスクレイアウト内で対応する ext ファイルシステムを検出する。Rootfs コンテナには gzip tar/CPIO および XZ CPIO/ext ファイルシステムが含まれる。Rootfs の展開は 4 GiB に制限されている。
FAZ/FMG の KVM インストールディスクは、ベアの QCOW2 ファイル、または正規の QCOW2 ファイルをちょうど1つ含む ZIP パッケージとして受け付けられ、ZIP 展開後 2 GiB に制限される。これらのディスクには L1 ファームウェアヘッダがなく、flatkc の代わりに vmlinuz を使用する。製品/バージョンのフラグは不要である。
各行は FAZ_VM64_KVM と FMG_VM64_KVM の両方の .out.kvm.zip インストールパッケージとしてテストされた。合計24パッケージである。すべてがインスペクション、完全展開、およびブートのみの展開を完了した。以下のリリース/ビルドラベルはファイル名から取得したものである。古いファイル名は v5 または v6 のみを指定しており、そのマイナーリリース番号は特定されていない。実イメージのエンドツーエンド実行には ZIP パッケージを使用した。ベアの QCOW2 入力は展開後のリーダーを共有し、別途合成テストでカバーされている。
| リリース/ビルドラベル(FAZ と FMG の両方) | メイン rootfs |
|---|---|
v5-build0383 | gzip/newc CPIO |
v5-build0786 | gzip/newc CPIO |
v5-build1247 | XZ/newc CPIO |
v5-build1821 | XZ/newc CPIO |
v6-build0485 | XZ/newc CPIO |
v6-build1565 | XZ/newc CPIO |
v6-build2689 | XZ/newc CPIO |
v7.0.16-build0710 | XZ/newc CPIO |
v7.2.12-build1721 | XOR で保護されたカーネル、AES-128-CTR XZ/newc CPIO rootfs |
v7.4.11.M-build2804 | XOR で保護されたカーネル、AES-128-CTR XZ/newc CPIO rootfs |
v7.6.7.M-build3737 | XOR で保護されたカーネル、AES-128-CTR XZ/newc CPIO rootfs |
v8.0.1.F-build0189 | XOR で保護されたカーネル、AES-128-CTR XZ/newc CPIO rootfs |
保護されたカーネルは、x86-64 の伸張スタブから復元した素材を用いてデコードされます。rootfs 候補は、末尾に付加された平文 SHA-256 ダイジェストを通過し、XZ/CPIO の検証を完了する必要があります。これらのチェックは鍵の選択を確認し、破損を検出します。ダイジェストは鍵なしであり、発行元の認証や意図的な改変に対する保護を提供するものではありません。
各ベース init は、独立した libarchive による抽出結果とバイト単位で一致しました。
この対象範囲は、これらの KVM インストールパッケージに関するものであり、FAZ/FMG のアップグレード用 .out ファイル、ハードウェアアプライアンス、その他の Fortinet 製品には該当しません。
fortitool inspect FMG_VM64_KVM-v7.0.16-build0710-FORTINET.out.kvm.zip
fortitool decrypt -o fmg FMG_VM64_KVM-v7.0.16-build0710-FORTINET.out.kvm.zip
fortitool decrypt --boot-only -o boot faz.qcow2
fortitool unpack -o extensions boot/rootfs-ext.tar.xz
完全なFAZ/FMG抽出では、ベースのルートファイルシステムがrootfs/以下に保持されます。
存在する場合、ネストされたbin.tar.xz、lib.tar.xz、usr.tar.xz、migadmin.tar.xz、
node-scripts.tar.xzアーカイブはlayers/rootfs/<archive-name>/以下に個別に展開されます。
追加のsyntax.tar.xz、rootfs-ext.tar.xz、docker.tar.xz、widgets.tar.gzブートアーカイブは
layers/boot/<archive-name>/以下に配置されます。元のアーカイブは保持されます。
例えば、rootfs/bin/initとlayers/rootfs/bin.tar.xz/bin/initは
異なるブートストラッププログラムやアプリケーションプログラムを含む場合があります。これらの出力は
静的解析のために両方のバージョンを保持しますが、マージされた起動可能な
ファイルシステムを表すものではありません。既存のFortiGate抽出は引き続きネストされた
アーカイブをrootfs/にマージします。