[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ASZF5ATD9B0PQB5V9CP0Y4":3,"skill-same:01M7ASZF5ATD9B0PQB5V9CP0Y4":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7ASZF5ATD9B0PQB5V9CP0Y4","re-tee",null,"TEE\u002FTrustZone 逆向：OP-TEE 架构、可信应用（Trusted App）、secure storage、SMC 接口与设备密钥。 触发词：TEE、TrustZone、OP-TEE、可信应用、Trusted App、secure world、SMC、安全存储、secure storage、设备密钥","dslsdzc\u002Frev-skills","dslsdzc","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F150430440?v=4","01M7ASEW5AKHWCFR1TXPAXQ237","DslsDZC","01M7ASEW5WJZ3GGBCCT12KHAQZ",243,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fre-tee\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: re-tee\ndescription: >\n  TEE\u002FTrustZone 逆向：OP-TEE 架构、可信应用（Trusted App）、secure storage、SMC 接口与设备密钥。\n  触发词：TEE、TrustZone、OP-TEE、可信应用、Trusted App、secure world、SMC、安全存储、secure storage、设备密钥\ncapabilities: [tee-analysis]\n---\n\n# TEE \u002F TrustZone 逆向（OP-TEE \u002F Trusted App \u002F secure storage）\n\n## 何时使用 \u002F 何时不用\n\n- 用：TrustZone\u002FOP-TEE 类 TEE 分析——可信应用（Trusted App）逆向、命令分发表还原、secure storage（安全存储\u002F设备密钥）对象与数据流\n- 用：设备密钥\u002F信任根方向——DRM 硬件信任根（[[re-drm]] 的 L1 类）、设备密钥提取与保护机制（授权研究）\n- 用：TEE 接口面——SMC 调用、主机侧 TEE 驱动 ioctl、client 库调用序列还原\n- 用：固件安全评估——评估目标设备 TEE 实现的接口暴露面、存储保护强度与信任根边界\n- 不用：普通 App 层（走 [[re-mobile]]）；Windows 内核\u002F驱动（走 [[re-kernel]]，TEE 侧是 Linux\u002FARM 域）\n- 不用：纯固件提取解包（先走 [[re-fw-extract]]，本技能在其后分析 TEE 组件）\n- 不用：目标只是普通加密数据（走 [[re-crypto-*]] 系列，无 TEE 组件时不必进本技能）\n- 不用：仅需判定「设备是否用了 TEE」（无镜像、无调用面可分析）——特征级证据即可，不进深度流程\n- 不用：EL2 hypervisor\u002F虚拟化域（走 [[re-hypervisor]]，TEE 是 EL1\u002FEL3 域）\n- 注意：**secure world 内动态调试通常不可行**（见坑 3）——默认静态分析 + 主机侧观察；主机侧动态执行按 [[re-analyze\u002Fplatform-tips]] 最高原则在沙箱内进行\n\n## 工具准备\n\n静态分析（镜像解析\u002F反编译）免沙箱；主机侧动态（跑 client、hook ioctl）按 [[re-analyze\u002Fplatform-tips]] 最高原则进沙箱；secure world 内动态不做（见坑 3），默认以静态 + 主机侧观察为主。\n\n### 反编译工作台（[[re-ghidra]] \u002F [[re-ida]]，ARM64）\n\n- [[re-ghidra]]（默认）：导入 TEE OS 镜像与 TA（.ta 需先切掉签名头，见步骤 2 与坑 5）\n- [[re-ida]]：备选；两者均需 ARM64 支持\n- 验证: 能反编译 ARM64 代码，定位 `smc` 指令调用点与 `TA_InvokeCommandEntryPoint` 类分发表\n\n### 固件提取工具链（[[re-fw-extract]]）\n\n- binwalk\u002Funblob、magic 扫描、字节序判断——从 bootrom\u002F启动链\u002F设备固件中定位并提取 TEE OS 与 TA 镜像\n- 验证: `binwalk --version`（安装命令见 [[re-fw-extract]]「工具准备」）\n\n### python3（二进制解析\u002F脚本）\n\n- Linux: `apt install python3` \u002F `dnf install python3` \u002F `pacman -S python`；macOS: 自带；Windows: 官方安装器或 `choco install python`\n- 验证: `python3 --version`\n- 用途: 签名头\u002FELF 载荷切分解析、结构字段标注、解密还原脚本（衔接 [[re-crypto-decrypt]]）\n\n### 参考实现（OP-TEE 官方开源，理解结构用）\n\n- 官方仓库 optee_os \u002F optee_client \u002F optee_examples（与 qemu 仿真环境）提供 TEE 结构与调用序列的权威参照——分析目标与 OP-TEE 差异时按官方源码核对，不凭经验值\n- qemu 仿真环境可跑通 client → TA 全链路调用，用于对照调用序列与参数布局；仿真与真机的差异（真实驱动\u002F中断\u002F存储介质）以真机为准\n\n### frida \u002F 主机侧观察（[[re-frida]]）\n\n- 主机侧动态：hook client 库调用序列与 ioctl 参数（frida 安装与沙箱原则见 [[re-frida]]，动态执行默认沙箱）\n- 验证: `frida --version`\n\n## 操作步骤\n\n按顺序执行，每步产物（镜像定位、头结构标注、命令号表）记录证据路径 + sha256（见 [[re-triage]]），供报告引用。\n\n1. **架构定位（world 划分 \u002F SMC \u002F TEE OS 入口）**：\n   - TrustZone 划分 normal world（普通世界，NS）与 secure world（安全世界，S）；ARMv8-A 中 TEE OS 通常运行在 secure EL1，可信应用在 secure EL0，EL3 监控层（monitor）承载安全监控固件（如 ATF BL31 类启动固件，泛化）\n   - **SMC 指令**是 normal world 进入 secure world 的通道：AArch64 为 `smc #imm`（AArch32 为 `smc`），从 EL1\u002FEL2 执行即陷入 EL3 监控层，监控层再分发给 TEE OS；反编译中搜 `smc` 指令即调用面落点\n   - SMC 参数约定（SMCCC）：功能号在 w0（含服务\u002F调用约定标识位），参数在 w1-w7（SMC32）或 x1-x17（SMC64，**SMCCC ≥1.2 才扩到 x1-x17；1.0\u002F1.1 仅 x1-x7**），返回值从 w0 起——标注调用点按约定表读寄存器，不按普通 ABI 猜（见坑 4）\n   - 特征侦查：版本字符串、导出 API 字符串表、SMC 功能号常量表先 grep 定位——字符串表往往直接给出 TEE OS 类型与版本，比逐个反编译快\n   - 定位 TEE OS 加载入口：bootrom → 启动固件 → TEE OS 镜像（镜像头 magic、加载\u002F验签代码）——沿启动链搜 TEE 镜像特征（镜像头魔数、版本字符串、导出 API 字符串表）；TEE OS 也可内嵌于设备固件分区（[[re-fw-extract]] 提取后定位）\n   - 产物：world\u002FEL 划分图 + TEE OS 镜像位置与加载入口\n\n2. **OP-TEE 结构（core 与 TA 分离、.ta 格式）**：\n   - core（可信 OS 内核，secure world 侧系统服务）与 TA（可信应用，secure world 用户态）分离；core 向 TA 提供 `TEE_*` 内部 API（密码学、secure storage、时间等），TA 依赖该 API 实现业务逻辑——分析 TA 前先确认 core\u002FTA 边界（谁提供 API、谁调用 API）\n   - **.ta 文件格式**（REE 文件系统 TA）：文件 = 签名头 + ELF 载荷。签名头（`struct shdr`，官方 core\u002Finclude\u002Fsigned_hdr.h）：magic（`0x4f545348` = \"OTSH\"）、img_type、img_size、algo、hash_size、sig_size，其后跟 hash 与签名；img_type 取值：0 明文签名 TA \u002F 1 bootstrap TA（带 UUID+版本子头）\u002F 2 加密 TA \u002F 3 子密钥链式头；加密变体（img_type=2）后跟 `shdr_encrypted_ta` 子头（enc_algo、flags、iv_size、tag_size + iv + tag），密文为 AES-GCM\n   - 解析流程：文件头 magic 定位签名头 → 按 img_size 切出 ELF 载荷 → [[re-format-elf]] 解析节表\u002F段 → 标注 `ta_head`（UUID、版本、flags 等；UUID 即 TA 接口标识，与主机侧调用的 UUID 对应）\n   - 扩展名不作依据：部分设备以 .tos\u002F.trusted 类扩展名分发 TEE OS\u002FTA——一律按 magic 判断格式，不按扩展名选解析器\n   - 产物：签名头字段标注 + 切出的 ELF 载荷 + ta_head\u002FUUID 记录\n\n3. **TA 分析（入口 \u002F 命令分发 \u002F secure storage）**：\n   - 入口链：`TA_CreateEntryPoint`（初始化）→ `TA_OpenSessionEntryPoint`（会话建立）→ `TA_InvokeCommandEntryPoint`（命令分发，按 cmd_id switch）——**命令分发表就是 TA 的对外接口目录**，逐分支标注命令号与行为\n   - 参数模型：invoke 携带参数类型描述与最多 4 个 `TEE_Param`（value 标量对 \u002F memref 内存引用两类）；memref 指向共享内存，是输入输出主通道——每个命令分支标注参数类型与结构\n   - 会话生命周期：OpenSession\u002FCloseSession 与命令调用的配对是还原对象（谁建会话、什么时机、带什么初始参数）——会话建立参数常含初始化密钥材料\n   - 命令号枚举：switch 分支逐一编号（含非法命令\u002F默认分支）；与主机侧调用面（步骤 4）对照，确认哪些命令真实可达、哪些是内部使用——可达命令是接口面\u002F攻击面主体，标注优先级\n   - **secure storage 对象操作**：定位 `TEE_*` 存储 API 调用点（对象创建\u002F打开\u002F读\u002F写\u002F定位\u002F删除类），还原对象 ID（常由 UUID + 对象名\u002F索引派生）与数据流；secure storage 密文最终落盘于普通世界文件系统（经 tee-supplicant）或硬件存储（RPMB 类，硬件侧见 [[re-hw-chip]]）——找到密文文件的解密路径即找到对象数据\n   - 落盘形态：REE 文件系统侧通常为索引文件 + 数据块文件组合（对象目录映射）——按索引找对象、按块定位密文，再还原对象内容\n   - 产物：命令号→行为表 + 参数结构标注 + secure storage 对象清单\n\n4. **主机侧调用面（ioctl \u002F client 库，两头夹逼）**：\n   - Linux 侧 TEE 子系统：`\u002Fdev\u002Ftee0`（客户端 libteec 使用）上的 `TEE_IOC_*` ioctl（打开会话、invoke、关闭会话、共享内存分配\u002F注册类）；`\u002Fdev\u002Fteepriv0` 归 tee-supplicant（特权守护进程）使用，不做客户端调用——别把 teepriv0 当「私密会话」通道（见 [[gotchas]]）\n   - 用户态 client 库调用序列（GlobalPlatform TEE Client API）：`TEEC_InitializeContext` → `TEEC_OpenSession`（带 UUID 与参数）→ `TEEC_InvokeCommand`（带命令号与 TEEC_Operation）→ `TEEC_CloseSession` → `TEEC_FinalizeContext`\n   - **夹逼法**：主机侧读 ioctl 参数（UUID、命令号、参数布局、共享内存内容）→ TA 侧分发表（步骤 3）对号入座——两侧都标注后，TA 输入输出格式即可闭合；一侧缺失时从另一侧反推（见坑 2）\n   - 动态观察（沙箱内）：frida hook client 库调用与 ioctl 参数（[[re-frida]]），记录会话打开、命令调用序列与缓冲区内容\n   - 日志侧：`dmesg` 中 tee 驱动与 OP-TEE 初始化日志（驱动版本、中断号、supplicant 状态）辅助指纹与版本判定\n   - 补充观察：tee-supplicant 进程行为（落盘\u002F外设访问）——secure storage 数据流的 REE 侧落点\n   - 产物：主机侧调用序列 + TA 接口对照表（UUID\u002F命令号\u002F参数布局一一对应）\n\n5. **厂商差异处理（自定义 TEE，泛化）**：\n   - 自定义 TEE 的差异点：SMC 功能号体系、TA 镜像格式（头结构\u002F签名\u002F加密方式）、secure storage 布局、导出 API 命名与语义——均可能与 OP-TEE 不同\n   - 思路：先指纹识别 TEE 类型（镜像头特征、字符串\u002F导出 API 特征、SMC 功能号模式）→ 确认是 OP-TEE 系还是自定义实现 → 按通用流程（架构定位 → 格式解析 → 接口枚举 → 调用面夹逼）逐层套用，OP-TEE 细节只作参考模板不当默认值\n   - 差异处理：结构对不上的地方先怀疑\"自定义扩展\"（新增字段\u002F重排\u002F魔数不同），记录差异点而非强行套用；拿不到格式文档时用「字段长度 + 常见值（UUID\u002F版本\u002F尺寸）」反推布局（[[re-proto-rev]] 思路）\n   - 反推对照：命令号与行为的对应可用「返回码 + 输出缓冲区内容」逐条比对确认——错误码语义往往暴露参数校验顺序与权限边界\n   - 产物：TEE 类型指纹 + 差异点清单\n\n## 跨域联合\n\n- [[re-fw-extract]]：TEE OS\u002FTA 镜像提取与解包前置（bootrom\u002F启动链\u002F固件分区）\n- [[re-binary-core]]：镜像反编译底座（[[re-format-elf]] 解析 TA ELF、[[re-ghidra]]\u002F[[re-ida]] 工作台）\n- [[re-kernel]]：主机侧 TEE 驱动分析（ioctl 分发、驱动加载，Linux 内核侧）\n- [[re-mobile]]：移动端 TEE 集成面（App 内 TEE 调用、DRM 集成，与主机侧调用面衔接）\n- [[re-hw-chip]]：secure storage 硬件侧（RPMB 类存储、信任根、物理防护机制）\n- [[re-frida]]：主机侧动态观察（client 库\u002Fioctl 插桩，沙箱原则）\n- [[re-drm]]：设备密钥\u002F硬件信任根方向（DRM L1 类信任根在 TEE 内）\n- [[re-crypto-decrypt]]：加密 TA 载荷\u002Fsecure storage 密文的解密还原\n- [[re-sandbox]] \u002F [[re-analyze\u002Fplatform-tips]]：主机侧动态执行隔离最高原则\n\n## 常见坑与陷阱\n\n- **TA 是签名（+加密）镜像，直接分析会失败**：现象——拿到 .ta 直接丢进反编译器，导入失败或全是乱码；原因——.ta = 签名头 + ELF 载荷（加密变体还是 AES-GCM 密文），文件头不是 ELF 头；对策——先按签名头 magic（如 \"OTSH\"）定位并切出载荷（步骤 2），加密变体先还原解密流程（[[re-crypto-decrypt]]）拿到明文 ELF 再分析；验签\u002F解密流程本身也是分析对象（信任根\u002F密钥在 core 侧）\n- **secure world 代码拿不到时用主机侧反推**：现象——TEE OS\u002FTA 固件提取不到（SoC 内部 ROM\u002F受保护存储），secure world 动态无从下手；原因——TEE OS 常内置或受保护，不随用户区固件分发；对策——主机侧 ioctl（`TEE_IOC_*`）调用面 + client 库调用序列记录 UUID\u002F命令号\u002F参数布局（步骤 4），结合返回行为反推 TA 接口与内部逻辑，静态证据不足时以调用面证据为主\n- **secure world 防 dump\u002F监测机制**：现象——附加调试无效、内存 dump 出不来或内容异常、运行行为与静态分析不符；原因——TEE 侧有反调试与完整性保护（调试口熔断、安全监测、防转储机制，泛化）；对策——不做 secure world 内动态调试，以静态 + 主机侧观察为主；行为差异记录为「TEE 侧监测触发」证据并标注置信度，不强行归因\n- **SMC 参数约定错误导致误读**：现象——把 SMC 调用点当普通函数调用，按普通 ABI 猜寄存器参数，反推的接口结构全错；原因——SMC 遵循 SMCCC 约定（功能号 w0，参数 w1-w7 \u002F x1-x17，其中 SMC64 的 x1-x17 自 SMCCC 1.2 起；返回值从 w0 起），与普通 ABI 不同，错位解读整条数据流错乱；对策——先按公开调用约定建表（功能号编码、参数寄存器布局、返回约定），再标注反编译中的 `smc` 调用点，参数含义以约定表为准不靠猜（见 [[gotchas]] 调用约定组）\n- **把签名头\u002Fta_head 当 ELF 头解析**：现象——按 ELF 头解析 .ta 失败（e_ident 对不上）、或把 ta_head 的 UUID 当字符串表；原因——.ta 文件头是签名头（ELF 头在载荷内），ta_head 是 ELF 内部首段结构而非文件头；对策——先按签名头字段（magic\u002Fimg_size）切出 ELF 载荷再走 [[re-format-elf]]；Ghidra\u002FIDA 导入前先用脚本剥离签名头（步骤 2 产物存档）\n- **自定义 TEE 套用 OP-TEE 细节**：现象——按 OP-TEE 的头结构\u002F命令模型分析自定义 TEE，字段全错位、接口对不上；原因——自定义 TEE 的格式与约定不同（镜像头、SMC 功能号、存储布局各异）；对策——先做 TEE 类型指纹（步骤 5），确认体系后再选分析模板；差异按「字段长度 + 常见值（UUID\u002F版本\u002F尺寸）反推布局」处理（[[re-proto-rev]] 思路），OP-TEE 结构仅作参考\n- **UUID 对不上别硬凑**：现象——主机侧调用的 UUID 在 TA 分发表里找不到；原因——固件包内多个 TA 版本并存、或 TA 镜像版本与系统不匹配（UUID 是接口标识，版本演进会换 UUID）；对策——按固件包内 TA 清单\u002F目录核对版本，逐个候选 TA 匹配 UUID 与命令号\n- **secure storage 密文找不到就当没数据**：现象——REE 文件系统侧找不到 secure storage 密文；原因——存储介质在 RPMB\u002F硬件侧，或落盘路径与默认不同（tee-supplicant 配置）；对策——先确认存储介质与 supplicant 配置（REE FS vs RPMB），RPMB 侧转 [[re-hw-chip]] 思路，不以「找不到」下无数据结论\n- 决策分支（镜像形态\u002F接口面\u002F证据分级）见 [[decision-tree]]；格式与调用约定边界见 [[gotchas]]\n","# TEE \u002F TrustZone 逆向（OP-TEE \u002F Trusted App \u002F secure storage）\n\n## 何时使用 \u002F 何时不用\n\n- 用：TrustZone\u002FOP-TEE 类 TEE 分析——可信应用（Trusted App）逆向、命令分发表还原、secure storage（安全存储\u002F设备密钥）对象与数据流\n- 用：设备密钥\u002F信任根方向——DRM 硬件信任根（[[re-drm]] 的 L1 类）、设备密钥提取与保护机制（授权研究）\n- 用：TEE 接口面——SMC 调用、主机侧 TEE 驱动 ioctl、client 库调用序列还原\n- 用：固件安全评估——评估目标设备 TEE 实现的接口暴露面、存储保护强度与信任根边界\n- 不用：普通 App 层（走 [[re-mobile]]）；Windows 内核\u002F驱动（走 [[re-kernel]]，TEE 侧是 Linux\u002FARM 域）\n- 不用：纯固件提取解包（先走 [[re-fw-extract]]，本技能在其后分析 TEE 组件）\n- 不用：目标只是普通加密数据（走 [[re-crypto-*]] 系列，无 TEE 组件时不必进本技能）\n- 不用：仅需判定「设备是否用了 TEE」（无镜像、无调用面可分析）——特征级证据即可，不进深度流程\n- 不用：EL2 hypervisor\u002F虚拟化域（走 [[re-hypervisor]]，TEE 是 EL1\u002FEL3 域）\n- 注意：**secure world 内动态调试通常不可行**（见坑 3）——默认静态分析 + 主机侧观察；主机侧动态执行按 [[re-analyze\u002Fplatform-tips]] 最高原则在沙箱内进行\n\n## 工具准备\n\n静态分析（镜像解析\u002F反编译）免沙箱；主机侧动态（跑 client、hook ioctl）按 [[re-analyze\u002Fplatform-tips]] 最高原则进沙箱；secure world 内动态不做（见坑 3），默认以静态 + 主机侧观察为主。\n\n### 反编译工作台（[[re-ghidra]] \u002F [[re-ida]]，ARM64）\n\n- [[re-ghidra]]（默认）：导入 TEE OS 镜像与 TA（.ta 需先切掉签名头，见步骤 2 与坑 5）\n- [[re-ida]]：备选；两者均需 ARM64 支持\n- 验证: 能反编译 ARM64 代码，定位 `smc` 指令调用点与 `TA_InvokeCommandEntryPoint` 类分发表\n\n### 固件提取工具链（[[re-fw-extract]]）\n\n- binwalk\u002Funblob、magic 扫描、字节序判断——从 bootrom\u002F启动链\u002F设备固件中定位并提取 TEE OS 与 TA 镜像\n- 验证: `binwalk --version`（安装命令见 [[re-fw-extract]]「工具准备」）\n\n### python3（二进制解析\u002F脚本）\n\n- Linux: `apt install python3` \u002F `dnf install python3` \u002F `pacman -S python`；macOS: 自带；Windows: 官方安装器或 `choco install python`\n- 验证: `python3 --version`\n- 用途: 签名头\u002FELF 载荷切分解析、结构字段标注、解密还原脚本（衔接 [[re-crypto-decrypt]]）\n\n### 参考实现（OP-TEE 官方开源，理解结构用）\n\n- 官方仓库 optee_os \u002F optee_client \u002F optee_examples（与 qemu 仿真环境）提供 TEE 结构与调用序列的权威参照——分析目标与 OP-TEE 差异时按官方源码核对，不凭经验值\n- qemu 仿真环境可跑通 client → TA 全链路调用，用于对照调用序列与参数布局；仿真与真机的差异（真实驱动\u002F中断\u002F存储介质）以真机为准\n\n### frida \u002F 主机侧观察（[[re-frida]]）\n\n- 主机侧动态：hook client 库调用序列与 ioctl 参数（frida 安装与沙箱原则见 [[re-frida]]，动态执行默认沙箱）\n- 验证: `frida --version`\n\n## 操作步骤\n\n按顺序执行，每步产物（镜像定位、头结构标注、命令号表）记录证据路径 + sha256（见 [[re-triage]]），供报告引用。\n\n1. **架构定位（world 划分 \u002F SMC \u002F TEE OS 入口）**：\n   - TrustZone 划分 normal world（普通世界，NS）与 secure world（安全世界，S）；ARMv8-A 中 TEE OS 通常运行在 secure EL1，可信应用在 secure EL0，EL3 监控层（monitor）承载安全监控固件（如 ATF BL31 类启动固件，泛化）\n   - **SMC 指令**是 normal world 进入 secure world 的通道：AArch64 为 `smc #imm`（AArch32 为 `smc`），从 EL1\u002FEL2 执行即陷入 EL3 监控层，监控层再分发给 TEE OS；反编译中搜 `smc` 指令即调用面落点\n   - SMC 参数约定（SMCCC）：功能号在 w0（含服务\u002F调用约定标识位），参数在 w1-w7（SMC32）或 x1-x17（SMC64，**SMCCC ≥1.2 才扩到 x1-x17；1.0\u002F1.1 仅 x1-x7**），返回值从 w0 起——标注调用点按约定表读寄存器，不按普通 ABI 猜（见坑 4）\n   - 特征侦查：版本字符串、导出 API 字符串表、SMC 功能号常量表先 grep 定位——字符串表往往直接给出 TEE OS 类型与版本，比逐个反编译快\n   - 定位 TEE OS 加载入口：bootrom → 启动固件 → TEE OS 镜像（镜像头 magic、加载\u002F验签代码）——沿启动链搜 TEE 镜像特征（镜像头魔数、版本字符串、导出 API 字符串表）；TEE OS 也可内嵌于设备固件分区（[[re-fw-extract]] 提取后定位）\n   - 产物：world\u002FEL 划分图 + TEE OS 镜像位置与加载入口\n\n2. **OP-TEE 结构（core 与 TA 分离、.ta 格式）**：\n   - core（可信 OS 内核，secure world 侧系统服务）与 TA（可信应用，secure world 用户态）分离；core 向 TA 提供 `TEE_*` 内部 API（密码学、secure storage、时间等），TA 依赖该 API 实现业务逻辑——分析 TA 前先确认 core\u002FTA 边界（谁提供 API、谁调用 API）\n   - **.ta 文件格式**（REE 文件系统 TA）：文件 = 签名头 + ELF 载荷。签名头（`struct shdr`，官方 core\u002Finclude\u002Fsigned_hdr.h）：magic（`0x4f545348` = \"OTSH\"）、img_type、img_size、algo、hash_size、sig_size，其后跟 hash 与签名；img_type 取值：0 明文签名 TA \u002F 1 bootstrap TA（带 UUID+版本子头）\u002F 2 加密 TA \u002F 3 子密钥链式头；加密变体（img_type=2）后跟 `shdr_encrypted_ta` 子头（enc_algo、flags、iv_size、tag_size + iv + tag），密文为 AES-GCM\n   - 解析流程：文件头 magic 定位签名头 → 按 img_size 切出 ELF 载荷 → [[re-format-elf]] 解析节表\u002F段 → 标注 `ta_head`（UUID、版本、flags 等；UUID 即 TA 接口标识，与主机侧调用的 UUID 对应）\n   - 扩展名不作依据：部分设备以 .tos\u002F.trusted 类扩展名分发 TEE OS\u002FTA——一律按 magic 判断格式，不按扩展名选解析器\n   - 产物：签名头字段标注 + 切出的 ELF 载荷 + ta_head\u002FUUID 记录\n\n3. **TA 分析（入口 \u002F 命令分发 \u002F secure storage）**：\n   - 入口链：`TA_CreateEntryPoint`（初始化）→ `TA_OpenSessionEntryPoint`（会话建立）→ `TA_InvokeCommandEntryPoint`（命令分发，按 cmd_id switch）——**命令分发表就是 TA 的对外接口目录**，逐分支标注命令号与行为\n   - 参数模型：invoke 携带参数类型描述与最多 4 个 `TEE_Param`（value 标量对 \u002F memref 内存引用两类）；memref 指向共享内存，是输入输出主通道——每个命令分支标注参数类型与结构\n   - 会话生命周期：OpenSession\u002FCloseSession 与命令调用的配对是还原对象（谁建会话、什么时机、带什么初始参数）——会话建立参数常含初始化密钥材料\n   - 命令号枚举：switch 分支逐一编号（含非法命令\u002F默认分支）；与主机侧调用面（步骤 4）对照，确认哪些命令真实可达、哪些是内部使用——可达命令是接口面\u002F攻击面主体，标注优先级\n   - **secure storage 对象操作**：定位 `TEE_*` 存储 API 调用点（对象创建\u002F打开\u002F读\u002F写\u002F定位\u002F删除类），还原对象 ID（常由 UUID + 对象名\u002F索引派生）与数据流；secure storage 密文最终落盘于普通世界文件系统（经 tee-supplicant）或硬件存储（RPMB 类，硬件侧见 [[re-hw-chip]]）——找到密文文件的解密路径即找到对象数据\n   - 落盘形态：REE 文件系统侧通常为索引文件 + 数据块文件组合（对象目录映射）——按索引找对象、按块定位密文，再还原对象内容\n   - 产物：命令号→行为表 + 参数结构标注 + secure storage 对象清单\n\n4. **主机侧调用面（ioctl \u002F client 库，两头夹逼）**：\n   - Linux 侧 TEE 子系统：`\u002Fdev\u002Ftee0`（客户端 libteec 使用）上的 `TEE_IOC_*` ioctl（打开会话、invoke、关闭会话、共享内存分配\u002F注册类）；`\u002Fdev\u002Fteepriv0` 归 tee-supplicant（特权守护进程）使用，不做客户端调用——别把 teepriv0 当「私密会话」通道（见 [[gotchas]]）\n   - 用户态 client 库调用序列（GlobalPlatform TEE Client API）：`TEEC_InitializeContext` → `TEEC_OpenSession`（带 UUID 与参数）→ `TEEC_InvokeCommand`（带命令号与 TEEC_Operation）→ `TEEC_CloseSession` → `TEEC_FinalizeContext`\n   - **夹逼法**：主机侧读 ioctl 参数（UUID、命令号、参数布局、共享内存内容）→ TA 侧分发表（步骤 3）对号入座——两侧都标注后，TA 输入输出格式即可闭合；一侧缺失时从另一侧反推（见坑 2）\n   - 动态观察（沙箱内）：frida hook client 库调用与 ioctl 参数（[[re-frida]]），记录会话打开、命令调用序列与缓冲区内容\n   - 日志侧：`dmesg` 中 tee 驱动与 OP-TEE 初始化日志（驱动版本、中断号、supplicant 状态）辅助指纹与版本判定\n   - 补充观察：tee-supplicant 进程行为（落盘\u002F外设访问）——secure storage 数据流的 REE 侧落点\n   - 产物：主机侧调用序列 + TA 接口对照表（UUID\u002F命令号\u002F参数布局一一对应）\n\n5. **厂商差异处理（自定义 TEE，泛化）**：\n   - 自定义 TEE 的差异点：SMC 功能号体系、TA 镜像格式（头结构\u002F签名\u002F加密方式）、secure storage 布局、导出 API 命名与语义——均可能与 OP-TEE 不同\n   - 思路：先指纹识别 TEE 类型（镜像头特征、字符串\u002F导出 API 特征、SMC 功能号模式）→ 确认是 OP-TEE 系还是自定义实现 → 按通用流程（架构定位 → 格式解析 → 接口枚举 → 调用面夹逼）逐层套用，OP-TEE 细节只作参考模板不当默认值\n   - 差异处理：结构对不上的地方先怀疑\"自定义扩展\"（新增字段\u002F重排\u002F魔数不同），记录差异点而非强行套用；拿不到格式文档时用「字段长度 + 常见值（UUID\u002F版本\u002F尺寸）」反推布局（[[re-proto-rev]] 思路）\n   - 反推对照：命令号与行为的对应可用「返回码 + 输出缓冲区内容」逐条比对确认——错误码语义往往暴露参数校验顺序与权限边界\n   - 产物：TEE 类型指纹 + 差异点清单\n\n## 跨域联合\n\n- [[re-fw-extract]]：TEE OS\u002FTA 镜像提取与解包前置（bootrom\u002F启动链\u002F固件分区）\n- [[re-binary-core]]：镜像反编译底座（[[re-format-elf]] 解析 TA ELF、[[re-ghidra]]\u002F[[re-ida]] 工作台）\n- [[re-kernel]]：主机侧 TEE 驱动分析（ioctl 分发、驱动加载，Linux 内核侧）\n- [[re-mobile]]：移动端 TEE 集成面（App 内 TEE 调用、DRM 集成，与主机侧调用面衔接）\n- [[re-hw-chip]]：secure storage 硬件侧（RPMB 类存储、信任根、物理防护机制）\n- [[re-frida]]：主机侧动态观察（client 库\u002Fioctl 插桩，沙箱原则）\n- [[re-drm]]：设备密钥\u002F硬件信任根方向（DRM L1 类信任根在 TEE 内）\n- [[re-crypto-decrypt]]：加密 TA 载荷\u002Fsecure storage 密文的解密还原\n- [[re-sandbox]] \u002F [[re-analyze\u002Fplatform-tips]]：主机侧动态执行隔离最高原则\n\n## 常见坑与陷阱\n\n- **TA 是签名（+加密）镜像，直接分析会失败**：现象——拿到 .ta 直接丢进反编译器，导入失败或全是乱码；原因——.ta = 签名头 + ELF 载荷（加密变体还是 AES-GCM 密文），文件头不是 ELF 头；对策——先按签名头 magic（如 \"OTSH\"）定位并切出载荷（步骤 2），加密变体先还原解密流程（[[re-crypto-decrypt]]）拿到明文 ELF 再分析；验签\u002F解密流程本身也是分析对象（信任根\u002F密钥在 core 侧）\n- **secure world 代码拿不到时用主机侧反推**：现象——TEE OS\u002FTA 固件提取不到（SoC 内部 ROM\u002F受保护存储），secure world 动态无从下手；原因——TEE OS 常内置或受保护，不随用户区固件分发；对策——主机侧 ioctl（`TEE_IOC_*`）调用面 + client 库调用序列记录 UUID\u002F命令号\u002F参数布局（步骤 4），结合返回行为反推 TA 接口与内部逻辑，静态证据不足时以调用面证据为主\n- **secure world 防 dump\u002F监测机制**：现象——附加调试无效、内存 dump 出不来或内容异常、运行行为与静态分析不符；原因——TEE 侧有反调试与完整性保护（调试口熔断、安全监测、防转储机制，泛化）；对策——不做 secure world 内动态调试，以静态 + 主机侧观察为主；行为差异记录为「TEE 侧监测触发」证据并标注置信度，不强行归因\n- **SMC 参数约定错误导致误读**：现象——把 SMC 调用点当普通函数调用，按普通 ABI 猜寄存器参数，反推的接口结构全错；原因——SMC 遵循 SMCCC 约定（功能号 w0，参数 w1-w7 \u002F x1-x17，其中 SMC64 的 x1-x17 自 SMCCC 1.2 起；返回值从 w0 起），与普通 ABI 不同，错位解读整条数据流错乱；对策——先按公开调用约定建表（功能号编码、参数寄存器布局、返回约定），再标注反编译中的 `smc` 调用点，参数含义以约定表为准不靠猜（见 [[gotchas]] 调用约定组）\n- **把签名头\u002Fta_head 当 ELF 头解析**：现象——按 ELF 头解析 .ta 失败（e_ident 对不上）、或把 ta_head 的 UUID 当字符串表；原因——.ta 文件头是签名头（ELF 头在载荷内），ta_head 是 ELF 内部首段结构而非文件头；对策——先按签名头字段（magic\u002Fimg_size）切出 ELF 载荷再走 [[re-format-elf]]；Ghidra\u002FIDA 导入前先用脚本剥离签名头（步骤 2 产物存档）\n- **自定义 TEE 套用 OP-TEE 细节**：现象——按 OP-TEE 的头结构\u002F命令模型分析自定义 TEE，字段全错位、接口对不上；原因——自定义 TEE 的格式与约定不同（镜像头、SMC 功能号、存储布局各异）；对策——先做 TEE 类型指纹（步骤 5），确认体系后再选分析模板；差异按「字段长度 + 常见值（UUID\u002F版本\u002F尺寸）反推布局」处理（[[re-proto-rev]] 思路），OP-TEE 结构仅作参考\n- **UUID 对不上别硬凑**：现象——主机侧调用的 UUID 在 TA 分发表里找不到；原因——固件包内多个 TA 版本并存、或 TA 镜像版本与系统不匹配（UUID 是接口标识，版本演进会换 UUID）；对策——按固件包内 TA 清单\u002F目录核对版本，逐个候选 TA 匹配 UUID 与命令号\n- **secure storage 密文找不到就当没数据**：现象——REE 文件系统侧找不到 secure storage 密文；原因——存储介质在 RPMB\u002F硬件侧，或落盘路径与默认不同（tee-supplicant 配置）；对策——先确认存储介质与 supplicant 配置（REE FS vs RPMB），RPMB 侧转 [[re-hw-chip]] 思路，不以「找不到」下无数据结论\n- 决策分支（镜像形态\u002F接口面\u002F证据分级）见 [[decision-tree]]；格式与调用约定边界见 [[gotchas]]\n",{"name":5,"description":24,"capabilities":25},"TEE\u002FTrustZone 逆向：OP-TEE 架构、可信应用（Trusted App）、secure storage、SMC 接口与设备密钥。 触发词：TEE、TrustZone、OP-TEE、可信应用、Trusted App、secure world、SMC、安全存储、secure storage、设备密钥\n",[26],"tee-analysis","main","1977504515d3f5fa8889da43974feb7a0f4eaab9",".claude\u002Fskills\u002Fre-tee",43,"https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills","https:\u002F\u002Fgithub.com\u002Fdslsdzc","Building systems from scratch","2026-10-12 04:15:49",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add dslsdzc\u002Frev-skills --skill re-tee",{"tool":41,"command":42},"bunx","bunx skills add dslsdzc\u002Frev-skills --skill re-tee",{"tool":44,"command":45},"pnpm","pnpm dlx skills add dslsdzc\u002Frev-skills --skill re-tee","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fre-tee\u002FSKILL.md",true,[49,55],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fdecision-tree.md","REFERENCE","参考文档",4375,"https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fre-tee\u002Freferences\u002Fdecision-tree.md",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fgotchas.md",4218,"https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fre-tee\u002Freferences\u002Fgotchas.md",[60,67,73,80,87,94],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7AT3SFGN6KTM2DBN8TCNC4K","no-tools","缺工具准备章节。missing tools section.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fno-tools\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AT3PY0QVB4A4WGAZHY43WP","good-skill","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fgood-skill\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AT3NJ1PG8DR115AMJC1Q1C","gateway-skill","网关型技能，无工具准备章节。gateway skill.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fgateway-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AT3KCJGZV60PKJX244V8Z4","broken-link","含死链接与合法 references 链接。broken link.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbroken-link\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7AT3HMVTA2MR66A5FMATVFQ","wrong-name","名字与目录不符。name mismatch.","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbad-name\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7AT3F4K5ES6N62092Y8TRNG","bad-frontmatter","https:\u002F\u002Fgithub.com\u002Fdslsdzc\u002Frev-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbad-frontmatter\u002FSKILL.md",[],[]]