用于演示 CVE-2026-24090 ABL 验证绕过、以检查和测试联想设备上 Qualcomm Keymaster RPMB 状态的教育性概念验证(PoC)研究工具。
[!CAUTION] 前提条件: 在运行此工具之前,必须在 Windows 系统上安装 Python 3.12(64 位) 并将其添加到 PATH 中。捆绑的离线依赖项和 Qualcomm EDL 通信均依赖 Python 3.12。
[!IMPORTANT] 设备兼容性通知: 此工具仅在 Lenovo TB520FU 上经过严格验证并受支持。 尝试在不受支持或未经测试的设备上运行此工具可能会导致无法恢复的硬砖。请自行承担风险。
[!WARNING] 教育与安全研究免责声明: 本软件严格用于教育、安全研究以及在您合法拥有的设备上进行硬件维护。它会执行底层 Firehose EDL 操作、原始 GPT 表操作、恢复镜像刷写、TrustZone Keymaster TA 调用以及 RPMB 修改。作者和贡献者对因使用本软件而导致的任何硬件损坏、数据丢失、永久变砖或保修失效不承担任何责任。
[!NOTE] 移植 / 适配到其他设备的要求: 要将此工具适配到其他基于 Qualcomm Snapdragon 的 Lenovo 设备,必须满足以下所有条件:
- 存在漏洞 / 较旧的固件状态:设备引导加载程序/固件必须尚未修补默认的 AOSP 测试密钥漏洞(例如 AOSP RSA-4096 测试密钥信任模式,如 CVE-2023-45779 / 供应商引导加载程序接受测试密钥),或者必须运行重新签名以接受测试密钥的固件。
- 匹配的 Firehose Loader:您必须提取并提供与您特定设备固件版本完全匹配的
xbl_s_devprg_ns.melf。- 设备资源文件夹:在
assets/device/<MODEL>下按照型号命名约定创建设备文件夹(例如assets/device/TBxxxx/)。- RSA-4096 签名的 Root Recovery:将型号匹配的
xbl_s_devprg_ns.melf和经过 AVB RSA-4096 测试密钥签名(或重新签名)的recovery.img放入该设备目录中。恢复镜像必须提供 root ADB shell 访问权限(adbd以 root 身份运行 /ro.secure=0/ro.debuggable=1,例如 TWRP 或启用了 root 的不安全原厂 recovery),以便该工具能够部署其内核模块和原生探针来与 TrustZone 交互。
Lenovo Qcom RPMB 工具是一款交互式 TUI 工程工具,专为基于 Qualcomm Snapdragon 的 Lenovo 设备(特别是 TB520FU)设计。它利用 CVE-2026-24090 Android Bootloader(ABL)验证启动架构绕过漏洞,以确定性的故障保护机制来转储、检查、测试和验证由 RPMB 支持的 Keymaster 设备状态(例如区域标签 PRC ↔ ROW)。
当前版本:1.0.4
Qualcomm Android Bootloader(ABL)通过查询存储分区表(GPT)中的 vbmeta 和 pvmfw 分区来强制执行 Android 验证启动(AVB 2.0),然后才锁定硬件验证里程碑(KM_SET_VERIFIED_BOOT_STATE)。
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 的现代高通芯片组(Snapdragon 8 Gen 3 / SM8650)上:
vendor_boot 内。fastboot boot <boot.img> 会绕过 ABL 的原生分区初始化,导致 DTB/ramdisk 无法解析,并立即触发 Qualcomm CrashDump。recovery 分区(recovery_a/b,约 100 MiB),并通过同一 EDL 会话(Firehose ws)写回一个经过验证、具备 root 能力的 TWRP recovery 镜像,随后读回并进行哈希比对。向现网 misc 分区写入一次性 Android boot-recovery BCB,并备份其原始扇区。随后 Firehose 直接复位进入 recovery,无需 Fastboot。ABL 原生加载硬件内核、厂商模块和 recovery 环境,不会触发 CrashDump 故障。清理过程中会恢复并验证原始 BCB 扇区。启动进入临时 root recovery 环境后:
qseecom_dma_heap_phys.ko,在 /dev/qseecom_ta_shm 暴露连续物理内存缓冲区接口。qcom_state_probe)建立到 TrustZone Keymaster 可信应用(TA)的通道。vendor_boot 标记推导得出。PRC 或 ROW 标记。该工具将初始信任决策与区域转换期间必须更新的元数据分离:
SHA256_RSA4096 完整认证,必须使用公共 AOSP testkey,并且必须暴露严格的 Lenovo 型号指纹。验证在该现网签名成功后即停止;该工具不会仅仅为了重复同一信任决策而扫描每个顶层 vbmeta 分区。打包的 recovery 会独立地针对同一密钥和型号系列进行检查。NONE 是哈希页脚,而非签名失败:原厂和重新签名的 vendor_boot 镜像可能包含一个内嵌的 vbmeta 块,其算法为 0(NONE)。该块有意不包含认证块、RSA 签名或公钥。其哈希描述符仍然绑定原始载荷大小、盐值和 SHA-256(salt || payload) 摘要。该工具仅在验证页脚边界、描述符边界、声明的载荷大小和载荷摘要之后才接受此形式。.PRC/.ROW 和 IPRC/IROW 标记会改变 vendor_boot 载荷摘要,但不改变其布局。内嵌的算法 0 哈希描述符会被更新,同时保持算法 0。随后更新顶层 vbmeta 中对应的哈希描述符,安装其 AOSP testkey 公钥 blob,并重新生成其认证摘要和 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
↑ / ↓:逐行浏览已知字段。选中字段以反色高亮显示(白底黑字)。← / →:逐字节水平滚动查看被截断或较大的字段(例如 2048 字节公钥、256 字节回滚索引)。Enter:在独立输入对话框中编辑当前聚焦的字段。F2:编辑运行时发现的 Region tag(PRC ↔ ROW)。J:跳转到已发现状态大小内的任意十六进制偏移。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
# Run offline simulation self-test:
release\Lenovo_Qcom_RPMB_Tool\Lenovo_Qcom_RPMB_Tool.exe --simulate --self-test
设备资源以自包含包的形式提供,位于 assets/device/<MODEL>/ 下:
xbl_s_devprg_ns.melf - 用于 EDL 操作的 Firehose 编程器。recovery.img - 经过验证的、具备 root 能力的 TWRP recovery 镜像。资源包会从直接的 assets/device/<MODEL>/ 文件夹中动态发现:
TB[0-9]{3}[A-Z]{2}(例如 TB520FU)。xbl_s_devprg_ns.melf 和 recovery.img。TB520FC 映射到 TB520 系列下的 TB520FU 包)。TB321FU)各自的有效目录放在 assets/device/ 下,即可支持这些设备。misc 会在每个 CRC 有效的 GPT(UFS LUN 0-7 或 eMMC LUN 0)上独立解析。结果缺失或存在歧义时,会在任何设备写入之前停止操作。2597c218aae470a130f61162feaae70afd97f011)匹配。AVB NONE 的 vendor_boot footer 仅当其结构和 payload 哈希描述符均通过验证时才会被接受。在 Region 转换写入之前,所有 vendor_boot 和 vbmeta 分区仍会以 SHA-256 记录进行备份;仅当需要该转换时,才会读取并重新签名顶层 vbmeta。