
Lenovoデバイス上でQualcomm Keymaster RPMB状態を検査・テストするために、CVE-2026-24090のABL検証バイパスを実証する教育用の概念実証(PoC)研究ツール。
[!CAUTION] 前提条件: このツールを実行する前に、Python 3.12 (64ビット) が Windows システムにインストールされ、PATH に追加されている必要があります。同梱のオフライン依存関係および Qualcomm EDL 通信は Python 3.12 に依存しています。
[!IMPORTANT] デバイス互換性に関する注意: このツールは Lenovo TB520FU でのみ厳密に検証され、サポートされています。 サポート対象外または未検証のデバイスでこのツールを実行しようとすると、復旧不能な ハードブリック を引き起こす可能性があります。自己責任で進めてください。
[!WARNING] 教育・セキュリティ研究に関する免責事項: このソフトウェアは、教育、セキュリティ研究、および合法的に所有するデバイスのハードウェア保守を目的としてのみ配布されています。これは低レベルの Firehose EDL 操作、生の GPT テーブル操作、リカバリのフラッシュ、TrustZone Keymaster TA の呼び出し、および RPMB の変更を実行します。作者および貢献者は、このソフトウェアの使用に起因するハードウェアの損傷、データ損失、恒久的なブリック、または保証の無効化について、いかなる責任も負いません。
[!NOTE] 他のデバイスへの移植 / 適応の要件: このツールを他の Qualcomm Snapdragon ベースの Lenovo デバイスに適応させるには、以下のすべての条件を満たす必要があります:
- 脆弱な / 古いファームウェア状態: デバイスのブートローダー/ファームウェアが、デフォルトの AOSP テストキー脆弱性 (例: CVE-2023-45779 / ベンダーブートローダーによるテストキー受け入れといった AOSP RSA-4096 テストキーの信頼パターン) にパッチを適用していないこと、またはテストキーを受け入れるように再署名されたファームウェアを実行していること。
- 一致する Firehose ローダー: 特定のデバイスファームウェアバージョンに一致する正確な
xbl_s_devprg_ns.melfを抽出して提供する必要があります。- デバイスアセットフォルダー:
assets/device/<MODEL>の下にモデル命名規則に従ったデバイスフォルダーを作成します (例:assets/device/TBxxxx/)。- RSA-4096 署名済みルートリカバリ: モデルに一致する
xbl_s_devprg_ns.melfと、AVB RSA-4096 テストキーで署名された (または再署名された)recovery.imgをそのデバイスディレクトリに配置します。リカバリイメージは、ツールがカーネルモジュールとネイティブプローブを展開して TrustZone と対話できるように、root の ADB シェルアクセス (adbdが root として実行 /ro.secure=0/ro.debuggable=1、例えば TWRP や root が有効な非セキュアな純正リカバリなど) を提供する必要があります。
Lenovo Qcom RPMB Tool は、Qualcomm Snapdragon ベースの Lenovo デバイス (具体的には TB520FU) 向けに設計された対話型 TUI エンジニアリングツールです。CVE-2026-24090 Android Bootloader (ABL) 検証付きブートのアーキテクチャ上のバイパスを利用して、RPMB に裏付けられた Keymaster デバイス状態 (例: リージョンタグ PRC ↔ ROW) を、決定論的なフェイルセーフを備えてダンプ、検査、テスト、および検証します。
現在のバージョン: 1.0.4
Qualcomm Android Bootloader (ABL) は、ハードウェア検証マイルストーン (KM_SET_VERIFIED_BOOT_STATE) をロックする前に、ストレージパーティションテーブル (GPT) に対して vbmeta および pvmfw パーティションを照会することで、Android Verified Boot (AVB 2.0) を強制します。
vbmeta_a / vbmeta_b → xbmeta_a / xbmeta_bpvmfw_a / pvmfw_b → xpvmfw_a / xpvmfw_bIs_VERIFIED_BOOT_2() は検証付きブート記述子パーティションを特定できません。起動を拒否する代わりに、ABL は暗号学的信頼チェーンを確立せずに NO_AVB モード にフォールバックし、TrustZone Keymaster マイルストーンをロック解除したままにして、実行時の状態検査と変更を可能にします。Android Boot Header v4を採用する最新のQualcommチップセット(Snapdragon 8 Gen 3 / SM8650)では:
vendor_boot内にバンドルされたハードウェアデバイスツリーブロブ(DTB)と低レベルサブシステムドライバを必要とします。fastboot boot <boot.img>を実行すると、ABLのネイティブパーティション初期化がバイパスされ、DTB/ramdiskの解決が妨げられ、直ちにQualcomm CrashDumpが引き起こされます。recoveryパーティション(recovery_a/b、約100 MiB)をEDL経由でセクタ単位でバックアップし、検証済みでroot権限に対応したTWRPリカバリイメージを同じEDLセッション(Firehose ws)経由で書き戻し、その後読み戻してハッシュ比較します。ワンショットのAndroid boot-recovery BCBが、元のセクタをバックアップした上で稼働中のmiscパーティションに書き込まれます。その後FirehoseはFastbootを介さずに直接リカバリへリセットします。ABLはCrashDump障害を起こすことなく、ハードウェアカーネル、ベンダーモジュール、リカバリ環境をネイティブにロードします。元のBCBセクタはクリーンアップ時に復元され、検証されます。一時的なrootリカバリ環境へブートした後:
qseecom_dma_heap_phys.koが挿入され、/dev/qseecom_ta_shmに連続した物理メモリバッファインターフェースが公開されます。qcom_state_probe)が、TrustZone Keymasterトラステッドアプリケーション(TA)へのチャネルを確立します。vendor_bootマーカーから独立して導出されます。PRCまたはROWトークンがちょうど1つ含まれている必要があります。本ツールは、初期のトラスト判定と、リージョン変換中に更新する必要があるメタデータを分離します:
SHA256_RSA4096として完全に認証され、AOSPの公開テストキーを使用し、厳格なLenovoモデルフィンガープリントを公開している必要があります。検証はそのライブ署名の成功後に停止します。本ツールは、同じトラスト判定を繰り返すためだけにすべてのトップレベルvbmetaパーティションをスキャンすることはありません。パッケージ化されたリカバリは、同じキーとモデルファミリーに対して独立してチェックされます。NONEは署名失敗ではなくハッシュフッター: 純正および再署名されたvendor_bootイメージには、アルゴリズム0(NONE)のvbmetaブロックが埋め込まれている場合があります。このブロックには、意図的に認証ブロック、RSA署名、公開キーが含まれていません。そのハッシュ記述子は依然として元のペイロードサイズ、ソルト、およびSHA-256(salt || payload)ダイジェストをバインドしています。本ツールは、フッター境界、記述子境界、宣言されたペイロードサイズ、およびペイロードダイジェストを検証した後にのみ、この形式を受け入れます。.PRC/.ROWおよびIPRC/IROWマーカーを置き換えると、レイアウトを変更せずにvendor_bootペイロードダイジェストが変更されます。埋め込まれたアルゴリズム0のハッシュ記述子は、アルゴリズム0のまま更新されます。次に、トップレベルvbmeta内の対応するハッシュ記述子が更新され、AOSPテストキーの公開キーブロブがインストールされ、その認証ダイジェストとRSA-4096署名が再生成されます。vbmeta検査を回避しても、バックアップのカバレッジは失われません。リージョン変更が実際に要求された場合、対象となるすべてのvendor_bootおよびvbmetaパーティションがEDL経由で完全に読み取られ、最初のリージョンイメージ書き込みの前にSHA-256サイドカーとともに記録されます。その後、各パッチ適用済みパーティションがセクタ単位で読み戻され、ステージングされた正確なペイロードと比較されます。[Device: EDL 9008]
│ (WinUSB force-bind CLI via certutil & pnputil)
▼
[Sector-Level Backup]
│ • Primary & Backup GPT headers
│ • Original recovery partitions
│ • Scan every accessible UFS LUN and validate GPT CRCs
│ • Discover misc LUN/LBA and back up its BCB before any write
▼
[Firmware & AVB Validation]
│ • Verify one live recovery AVB RSA-4096 signature
│ • Verify AOSP testkey (2597c218aae470a130f61162feaae70afd97f011)
│ • Validate vendor_boot AVB footer and payload digest
│ • Detect model family (e.g., TB520) & select matching package
▼
[NO_AVB Partition Rename]
│ • vbmeta_a/b -> xbmeta_a/b
│ • pvmfw_a/b -> xpvmfw_a/b
▼
[EDL Root Image Write]
│ • Write verified recovery to every recovery partition (Firehose)
│ • Sector readback + hash comparison
│ • Back up misc BCB, set one-shot boot-recovery
│ • Firehose reset directly into recovery
▼
[TWRP Root ADB Probe]
│ • insmod qseecom_dma_heap_phys.ko
│ • Two runtime-sized /tmp/qcom_state_probe dumps
▼
[Interactive TUI Editor]
│ • Magic-relative standard fields
│ • Runtime-discovered Region tag
│ • In-place ASCII / Hex editing & Candidate diff
▼
[Apply & Verification]
│ • Candidate written to RPMB via TA invoke
│ • Independent readback & SHA-256 validation
▼
[Guaranteed Restoration]
│ • adb reboot edl
│ • Original recovery partition(s) rewritten & verified
│ • Original misc BCB sectors rewritten & verified
│ • Original Primary & Backup GPT restored & verified
│ • Driver clean-up & device reset
↑ / ↓: 既知のフィールドを1行ずつ移動します。選択中のフィールドは反転色(白背景、黒文字)でハイライトされます。← / →: 切り詰められたフィールドや大きなフィールド(例: 2048バイトの公開鍵、256バイトのロールバックインデックス)をバイト単位で水平スクロールします。Enter: 現在フォーカスされているフィールドを独立した入力ダイアログで編集します。F2: 実行時に検出されたRegion tag(PRC ↔ ROW)を編集します。J: 検出された状態サイズ内の任意の16進オフセットにジャンプします。S: 完全なバイトレベルの差分を確認し、候補を保存します。R: 変更をディスク上のベースラインに戻します。recoveryおよびGPTパーティションヘッダーを復元し、デバイスをリセットします。certutil、pnputil、newdev.dll)を使用してWinUSBドライバ(USB\VID_05C6&PID_9008)をインストール/強制バインドします。要件: .NET 10.0 SDK、Windows 10/11 x64、Python 3.12 x64(同梱のオフラインwheelhouseと一致するもの)。
# Restore, compile, run full self-tests, and generate single-file distribution:
build.cmd