From 2191da06fae07890ad4c1cb70970a9337f216ad0 Mon Sep 17 00:00:00 2001 From: shen <> Date: Mon, 9 Nov 2026 06:09:14 -0800 Subject: [PATCH] fix(docs): fix signing sequence, Mach-O padding underflow, ObjC ASLR types, VMP bounds, and refine M1 scope --- docs/03_COMPLETE_IMPLEMENTATION_PLAN.md | 42 +-- docs/04_DETAILED_SUBSYSTEMS_DESIGN.md | 325 +++++++++++++++++------- 2 files changed, 255 insertions(+), 112 deletions(-) diff --git a/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md b/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md index 79ec56c..b8428c0 100644 --- a/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md +++ b/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md @@ -187,23 +187,27 @@ flowchart TD ### 7. 跨平台自动化重签名流水线 (Cross-Platform Signer Engine) * **模块目标**:支持在 **macOS(本地终端)** 与 **Linux/Docker(SaaS 云端服务器)** 两种环境下全自动完成加固后 IPA 的重签名。 -* **签名核心算法实现流程**: +* **签名核心算法实现流程 (严格顺序)**: ```mermaid sequenceDiagram autonumber participant Runner as 签名调度器 - participant Prov as Mobileprovision 解析 - participant Dylibs as Frameworks/PlugIns - participant MachO as 主可执行文件 - participant Res as CodeResources 生成 + participant Prov as Mobileprovision 与 Entitlements 协调 + participant Dylibs as Frameworks/PlugIns (内部组件) + participant Res as CodeResources 资源清单 + participant MachO as 主可执行文件 CodeDirectory + participant CMS as OpenSSL 签名核 - Runner->>Prov: 解析 embedded.mobileprovision 提取 Entitlements (XML + DER) - Runner->>Dylibs: 由内向外遍历 Frameworks/*.dylib 逐一计算 16KB PageHash 并追加 CMS 签名 - Runner->>Dylibs: 遍历 PlugIns/*.appex (独立 Entitlements 签名) - Runner->>MachO: 计算主二进制每 16KB(0x4000) 页面 SHA256,生成 CodeDirectory (CDHash) - Runner->>MachO: 使用证书私钥对 CDHash 生成 PKCS#7 (CMS) 签名 SuperBlob - Runner->>MachO: 写入 LC_CODE_SIGNATURE (强制包含 DER-encoded entitlements) - Runner->>Res: 遍历 Bundle 内部所有资源计算散列,生成 _CodeSignature/CodeResources + Runner->>Prov: 解析 embedded.mobileprovision 提取授权白名单 + Runner->>Prov: 协调生成目标所需 Entitlements (XML + DER 编码) + Runner->>Dylibs: 先行签名内部 Frameworks/*.dylib 与 *.framework + Runner->>Dylibs: 先行签名 PlugIns/*.appex (使用插件各自的 bundle_id 与 entitlements) + Runner->>Res: 扫描 Bundle 全部文件生成 _CodeSignature/CodeResources + Runner->>MachO: 将 CodeResources 的 SHA256 填入 CodeDirectory Slot -3 (极关键) + Runner->>MachO: 将 Info.plist、Entitlements 哈希填入 Slot -1, -2, -5, -7 + Runner->>MachO: 按 16KB 页面计算主二进制代码页 SHA256 填入 Slot 0..N + Runner->>CMS: 计算 CodeDirectory 整体哈希 (CDHash) 并生成 PKCS#7 签名 + Runner->>MachO: 组装 SuperBlob 回写至主 Mach-O 尾部,更新 LC_CODE_SIGNATURE Runner->>Runner: 重新打包为 Payload 结构并压缩为 .ipa ``` * **跨平台工具选型**: @@ -217,7 +221,7 @@ flowchart TD 1. **代码段模糊哈希(SSDEEP / TLSH)**:提取主 Mach-O `__TEXT,__text` 段,计算基于上下文触发分段哈希(CTPH),比对机器码序列相似度。 2. **符号表 Jaccard 相似系数**:计算两包之间导出的类名、方法名集合交并比:$J(A, B) = \frac{|A \cap B|}{|A \cup B|}$。 3. **资源感知哈希(pHash & SSIM)**:对所有图片计算感知哈希与结构相似性,检测图片指纹重合度。 - 4. **风险阈值预警**:综合打分 $> 45\%$ 时标黄预警,$> 60\%$ 时标红阻断,提示必须调整混淆策略库。 + 4. **内部风控基准评分**:内部相似度 $< 35\%$ 判定为低相似度;$35\% \sim 50\%$ 建议调换混淆特征库;$> 50\%$ 建议内部阻断提审。(注:苹果 4.3 条款为人工审查与机审结合的行为政策,指标仅作内部风控参考,不构成绝对过审保证)。 --- @@ -268,16 +272,20 @@ iOSGuard/ ```mermaid flowchart LR - M1["里程碑 1 (MVP)\n主动防御内核\n+ 基础签名"] --> M2["里程碑 2\nMach-O 深度加固\n+ Class-Dump 抹除"] - M2 --> M3["里程碑 3\nLLVM 编译混淆\n+ dSYM 还原"] + M1["里程碑 1 (MVP)\nPadding充足下注入\n+ macOS 原生签名闭环"] --> M2["里程碑 2\n段平移与Fixup修复\n+ ObjC 动态元数据恢复"] + M2 --> M3["里程碑 3\nLLVM 编译混淆\n+ dSYM 崩溃符号化还原"] M3 --> M4["里程碑 4\n代码虚拟化 (VMP)\n+ 游戏资产保护"] M4 --> M5["里程碑 5\n4.3 预检分析器\n+ 商业平台化"] ``` | 阶段 | 周期 | 研发重点与技术验证 | 关键交付产物 | | :--- | :--- | :--- | :--- | -| **M1: 主动防御与重签名闭环 (MVP)** | 4 周 | 1. 编写 `libDefender.dylib`,跑通内联汇编反调试与反 Frida;
2. 搭建基于 `zsign` 的 Linux 自动化重签名管线;
3. 实现无源码注入并成功在真机运行不闪退。 | 1. `libDefender.dylib` 原型
2. 跨平台重签名 CLI 工具
3. 真机对抗拦截验证报告 | -| **M2: Mach-O 二进制深度加固** | 5 周 | 1. 攻克 Header Padding 探测与全局 Segment Shift 平移算法;
2. 实施 Objective-C 元数据抹除(防 class-dump)与运行时动态重映射。 | 1. `macho_rewriter` 工具
2. `objc_scrambler` 模块
3. class-dump 逆向彻底失效测试用例 | +| **M1: 极简闭环验证 (MVP 收敛范围)** | 3~4 周 | 1. **目标载体**:自有简单 arm64 测试 App(UIKit/SwiftUI);
2. **注入约束**:仅在 Header Padding 充足条件下验证 `LC_LOAD_DYLIB` 原地注入;
3. **签名验证**:使用 macOS 原生 `codesign`(带 `--generate-entitlement-der`);
4. **真机闭环**:验证真机安装、冷启动通过、`libDefender` 基础反调试生效、制造崩溃并跑通 dSYM 符号化还原。 | 1. 自建 arm64 测试工程
2. `libDefender.dylib` 最小原型
3. 原地注入脚本与重签流水线
4. 真机冷启与崩溃还原验证报告 | +| **M2: Mach-O 进阶加固与重定位修复** | 5 周 | 1. 攻克全局段平移(Segment Shift)与 `LC_DYLD_CHAINED_FIXUPS` 重定位链表重构;
2. 实施 Objective-C 元数据精细化抽取与 ASLR 动态还原;
3. 验证 Linux 端 `zsign` 无 Mac 依赖签名闭环。 | 1. 支持段平移的 `macho_rewriter`
2. 保持语义的 `objc_scrambler`
3. Linux Docker 自动化签名工具 | +| **M3: LLVM 编译管线与 dSYM 深度还原** | 5 周 | 1. 研发控制流平坦化、虚假分支与常量字符串加密 LLVM Pass;
2. 完善 DWARF 重写工具,确保 UUID 严格匹配。 | 1. Xcode 自定义 LLVM Toolchain / Plugin
2. `dsym_restorer` 崩溃堆栈还原器 | +| **M4: 原生代码虚拟化 (VMP) 与游戏加固** | 6 周 | 1. 完善基于 ARM64 的私有解释型虚拟机 (VMP),补充边界安全检查;
2. 实现 Unity `global-metadata.dat` 加密与 Cocos 脚本内存流解密。 | 1. 包含安全防御的 `vmp_compiler` 与 `vm_interpreter`
2. Unity / Cocos 游戏专用加固套件 | +| **M5: 4.3 审核预检与商业化平台** | 4 周 | 1. 实现基于 SSDEEP 与符号图谱的内部风控评分算法;
2. 构建 SaaS 网页端控制台或跨平台桌面客户端 (macOS/Windows)。 | 1. `ipa_diff` 相似度检测中心
2. 完整的商业级加固发布包 | + | **M3: LLVM 编译管线与 dSYM 还原** | 5 周 | 1. 研发控制流平坦化、虚假分支与常量字符串加密 LLVM Pass;
2. 解析 DWARF 格式,实现 dSYM 调试信息反向还原。 | 1. Xcode 自定义 LLVM Toolchain / Plugin
2. `dsym_restorer` 崩溃堆栈还原器 | | **M4: 原生代码虚拟化 (VMP) 与游戏加固** | 6 周 | 1. 研发基于 ARM64 的私有解释型虚拟机 (VMP);
2. 实现 Unity `global-metadata.dat` 加密与 Cocos 脚本内存流解密。 | 1. `vmp_compiler` 与 `vm_interpreter`
2. Unity / Cocos 游戏专用加固套件 | | **M5: 4.3 审核预检与商业化平台** | 4 周 | 1. 实现基于 SSDEEP 与符号图谱的 4.3 风险评估算法;
2. 构建 SaaS 网页端控制台或跨平台桌面客户端 (macOS/Windows)。 | 1. `ipa_diff` 相似度检测中心
2. 完整的商业级加固发布包 | diff --git a/docs/04_DETAILED_SUBSYSTEMS_DESIGN.md b/docs/04_DETAILED_SUBSYSTEMS_DESIGN.md index 65c747d..d6de112 100644 --- a/docs/04_DETAILED_SUBSYSTEMS_DESIGN.md +++ b/docs/04_DETAILED_SUBSYSTEMS_DESIGN.md @@ -46,30 +46,31 @@ struct MachOBinary { ```mermaid flowchart TD - A["读取 mach_header_64 & load_commands"] --> B{"计算 Header Padding\n首个Section偏移 - (header + sizeofcmds)"} - B -- "Padding >= sizeof(dylib_command)" --> C["直接就地追加 LC_LOAD_DYLIB\n递增 ncmds & sizeofcmds"] - B -- "Padding 不足" --> D["执行全局段平移 (Segment Shift)\n平移增量 Delta = 0x4000 (16KB)"] - D --> E["更新所有 Segment fileoff >= Delta\n更新 Section.offset, Rebase, Binding, Export Trie"] - C --> F["追加 __PROTECT Segment (0x4000对齐)"] - E --> F - F --> G["重设 LC_CODE_SIGNATURE 指向文件末尾"] + A["读取 mach_header_64 & load_commands"] --> B{"检测 Header Padding\n安全检查: first_section_offset >= header_size_with_cmds"} + B -- "不满足安全检查" --> B1["异常防御: 退出,防止无符号溢出"] + B -- "满足" --> C{"计算可用 Padding 空间\nfirst_section_offset - header_size_with_cmds"} + C -- "Padding >= sizeof(dylib_command)" --> D["直接就地追加 LC_LOAD_DYLIB\n递增 ncmds & sizeofcmds (M1 MVP 路径)"] + C -- "Padding 不足" --> E["触发全局段平移 (Segment Shift, 进阶阶段)\n平移增量 Delta = 0x4000 (16KB)"] + E --> F["更新所有 Segment fileoff >= Delta\n修复 LC_DYLD_CHAINED_FIXUPS、Rebase、Binding、Export Trie"] + D --> G["追加 __PROTECT Segment (0x4000对齐)"] + F --> G + G --> H["重设 LC_CODE_SIGNATURE 指向文件末尾"] ``` -#### 代码实现原型:Header 扩容与 LC_LOAD_DYLIB 注入 +#### 代码实现原型:Header 扩容与 LC_LOAD_DYLIB 注入 (含边界防御) ```cpp bool InjectDylib(std::vector& binary, const std::string& dylib_path) { auto* header = reinterpret_cast(binary.data()); if (header->magic != MH_MAGIC_64) return false; - // 1. 计算对齐后的 dylib_command 大小 + // 1. 计算对齐后的 dylib_command 大小 (8 字节对齐) uint32_t cmd_size = sizeof(dylib_command) + dylib_path.length() + 1; - cmd_size = (cmd_size + 7) & ~7; // 8 字节对齐 + cmd_size = (cmd_size + 7) & ~7; - // 2. 检测 Header Padding + // 2. 检测 Header Padding 与首个 Section 偏移 uint8_t* cmds_start = binary.data() + sizeof(mach_header_64); - uint8_t* cmds_end = cmds_start + header->sizeofcmds; + uint32_t header_and_cmds = sizeof(mach_header_64) + header->sizeofcmds; - // 查找第一个 Section 的起始文件偏移 (通常在 __TEXT 段) uint32_t first_section_offset = UINT32_MAX; uint8_t* cur_cmd = cmds_start; for (uint32_t i = 0; i < header->ncmds; i++) { @@ -77,6 +78,7 @@ bool InjectDylib(std::vector& binary, const std::string& dylib_path) { if (sc->cmd == LC_SEGMENT_64) { auto* sec = reinterpret_cast(cur_cmd + sizeof(segment_command_64)); for (uint32_t j = 0; j < sc->nsects; j++) { + // 仅统计实际存在于文件中的非零偏移 Section if (sec[j].offset > 0 && sec[j].offset < first_section_offset) { first_section_offset = sec[j].offset; } @@ -85,11 +87,17 @@ bool InjectDylib(std::vector& binary, const std::string& dylib_path) { cur_cmd += sc->cmdsize; } - uint32_t available_padding = first_section_offset - (sizeof(mach_header_64) + header->sizeofcmds); + // 边界安全防御:防止异常 Mach-O 导致无符号减法下溢 (Underflow) + if (first_section_offset < header_and_cmds) { + // 首个节偏移异常或已被篡改,直接拒绝处理 + return false; + } + + uint32_t available_padding = first_section_offset - header_and_cmds; if (available_padding >= cmd_size) { - // 直接原地写入 - auto* new_cmd = reinterpret_cast(cmds_end); + // Padding 充足:原地写入新指令 (M1 MVP 推荐路径) + auto* new_cmd = reinterpret_cast(cmds_start + header->sizeofcmds); memset(new_cmd, 0, cmd_size); new_cmd->cmd = LC_LOAD_DYLIB; new_cmd->cmdsize = cmd_size; @@ -103,15 +111,22 @@ bool InjectDylib(std::vector& binary, const std::string& dylib_path) { header->sizeofcmds += cmd_size; return true; } else { - // 触发全局段平移 ShiftSegment(binary, 0x4000); - return ShiftAndInjectDylib(binary, dylib_path, cmd_size); + // Padding 不足:触发进阶的段平移与重定位链重构 + return ShiftAndInjectDylibWithChainedFixups(binary, dylib_path, cmd_size); } } ``` -### 1.4 避坑要点 -* **0x4000 严格对齐**:ARM64 架构下,`__TEXT`、`__DATA` 以及新增的 `__PROTECT` 段的 `vmaddr` 和 `fileoff` 必须是 `0x4000`(16KB)的整倍数,否则 dyld 报错 `file system page size mismatch`。 -* **Linkedit 偏移调整**:`LC_CODE_SIGNATURE`、`LC_SYMTAB` 必须保持位于文件末尾。新增段时应插入在 `__LINKEDIT` 之前。 +### 1.4 进阶重定位机制:LC_DYLD_CHAINED_FIXUPS 修复挑战 +> [!WARNING] +> **现代 iOS (iOS 14+ / Xcode 13+) 段平移技术风险**: +> 现代二进制广泛采用 `LC_DYLD_CHAINED_FIXUPS` 替代传统的 `LC_DYLD_INFO_ONLY` 重定位表。指针以链表形式编码在 `__DATA` 段内部(如 `dyld_chained_starts_in_segment` 和 `dyld_chained_ptr_arm64e`)。 +> 一旦段发生物理平移或虚拟地址变动,必须同步重构: +> 1. 每个段链表头部结构体 `dyld_chained_starts_in_segment` 中的 `page_start` 偏移数组; +> 2. `LC_DYLD_EXPORTS_TRIE` 导出树中的 ULEB128 符号偏移; +> 3. 所有指针重定位链的目标 offset。 +> **工程策略**:在 M1 MVP 阶段,限定处理 Xcode 预留有足够 Padding 的二进制包,将段平移与 Fixup 重构作为独立里程碑隔离攻关。 + --- @@ -146,8 +161,20 @@ struct class_ro_t_64 { struct method_t_64 { uint64_t name; // 指向 __objc_methname - uint64_t types; // 指向 __objc_methtype - uint64_t imp; // 函数指针 + uint64_t types; // 指向 __objc_methtype (真实类型编码,如 "@16@0:8") + uint64_t imp; // 函数虚拟地址 (相对Mach-O vmaddr基地址) +}; + +// iOS 14+ 广泛采用的小方法列表 (Relative Method List) +struct method_list_t_relative { + uint32_t entsizeAndFlags; // 包含 0x80000000 相对寻址标记 + uint32_t count; + // 相对偏移结构体: 每个字段为相对于字段自身地址的 int32_t 偏移 + struct method_relative_t { + int32_t name_offset; + int32_t types_offset; + int32_t imp_offset; + } methods[]; }; ``` @@ -155,27 +182,31 @@ struct method_t_64 { ``` [编译加固期 (Mach-O 离线重写)] - 1. 扫描 __DATA,__objc_classlist 提取所有 class_ro_t 信息 - 2. 序列化 {ClassName, [Selector, ImpOffset, Type]} 结构为二进制数据 + 1. 扫描 __DATA,__objc_classlist 提取 class_ro_t 与元类 (Meta-Class) + 2. 序列化 {ClassName, [is_meta, Selector, ImpVMAddr, TypeEncoding]} 为私有二进制 3. 使用 ChaCha20-Poly1305 加密存入 __PROTECT,__meta 节 - 4. 清空 __TEXT,__objc_methname (填 '\0'),将 class_ro_t->baseMethods 置空 + 4. 清空非白名单的 __TEXT,__objc_methname (填 '\0'),将 class_ro_t->baseMethods 置空 │ ▼ [运行时阶段 (libDefender 早期构造器 __mod_init_func)] - 1. 读取 __PROTECT 段并使用内嵌白盒秘钥解密元数据 - 2. 遍历类对象,调用 objc_allocateClassPair / class_addMethod 动态注回 - 3. 拦截 NSClassFromString 与 sel_registerName 桥接映射 + 1. 获取目标 Mach-O 的 ASLR 偏移 (Slide = _dyld_get_image_vmaddr_slide(index)) + 2. 解密元数据,准确按类型注回: + - 实例方法注回目标类 cls + - 类方法注回元类 object_getClass(cls) + 3. 使用真实 TypeEncoding 与 (ImpVMAddr + Slide) 动态注册 + 4. 对 +load、KVC 敏感类与系统协议建立白名单豁免机制 ``` -#### 运行时动态重映射 Hook 原型 +#### 运行时动态重映射 Hook 原型 (语义保持与 ASLR 修复版) ```objc #import #import +#import -void RestoreObjcMetadata(const uint8_t *decrypted_meta, size_t size) { +void RestoreObjcMetadata(const uint8_t *decrypted_meta, size_t size, intptr_t slide) { size_t offset = 0; while (offset < size) { - // 读取类名长度和字符串 + // 1. 读取类名 uint16_t name_len = *(uint16_t*)(decrypted_meta + offset); offset += 2; char class_name[256] = {0}; @@ -183,27 +214,51 @@ void RestoreObjcMetadata(const uint8_t *decrypted_meta, size_t size) { offset += name_len; Class cls = objc_getClass(class_name); - - // 读取方法数量 + if (!cls) continue; + Class meta_cls = object_getClass(cls); + + // 2. 读取方法列表 uint32_t method_count = *(uint32_t*)(decrypted_meta + offset); offset += 4; for (uint32_t i = 0; i < method_count; i++) { + uint8_t is_meta = *(uint8_t*)(decrypted_meta + offset++); + + // 读取 Selector 名字 uint16_t sel_len = *(uint16_t*)(decrypted_meta + offset); offset += 2; char sel_name[256] = {0}; memcpy(sel_name, decrypted_meta + offset, sel_len); offset += sel_len; - uint64_t imp_addr = *(uint64_t*)(decrypted_meta + offset); + // 读取真实类型编码 (如 "@16@0:8" 或 "i24@0:8@16"),严禁写死 "v@:" + uint16_t type_len = *(uint16_t*)(decrypted_meta + offset); + offset += 2; + char type_encoding[128] = {0}; + memcpy(type_encoding, decrypted_meta + offset, type_len); + offset += type_len; + + // 读取静态 VM 地址并结合 ASLR Slide 计算真实函数入口 + uint64_t imp_vmaddr = *(uint64_t*)(decrypted_meta + offset); offset += 8; + IMP real_imp = (IMP)(imp_vmaddr + slide); SEL sel = sel_registerName(sel_name); - class_addMethod(cls, sel, (IMP)imp_addr, "v@:"); + Class target_cls = is_meta ? meta_cls : cls; + + // 保持方法调用 ABI 语义完整,不破坏消息转发与参数传递 + class_addMethod(target_cls, sel, real_imp, type_encoding); } } } ``` +### 2.4 语义保持与边界防线 +> [!IMPORTANT] +> **Objective-C 元数据加固边界约束**: +> 1. **`+load` 时序限制**:`+load` 在 dyld 加载镜像时由 `libobjc` 的 `prepare_load_methods` 内部直接读取并调用,早于 C++ 动态库构造器。因此**带有 `+load` 的类方法必须保留在静态结构中或采用动态桥接白名单**,不可盲目抹除。 +> 2. **JSON 反序列化与 KVC**:`YYModel` / `MJExtension` 依赖 `class_copyPropertyList` 和 `class_copyIvarList` 进行属性映射。加固系统必须建立基于类的排除规则,对 Model 数据模型对象豁免元数据抹除。 + + --- ## 3. 原生代码虚拟化 (VMP) 引擎 (Code Virtualization) @@ -229,27 +284,31 @@ void RestoreObjcMetadata(const uint8_t *decrypted_meta, size_t size) { | `0x61` | `VM_CALL` | 调用原生 C 函数 | 调度真实函数指针 | | `0xFF` | `VM_RET` | 退出虚拟机并还原上下文 | 返回上层原生栈 | -### 3.3 解释器 Direct-Threaded 跳转循环实现原型 +### 3.3 解释器 Direct-Threaded 跳转循环实现原型 (含边界防御) ```c #include #include +#include typedef struct { - uint64_t r[31]; // 对应 ARM64 x0 - x30 + uint64_t r[31]; // 对应 ARM64 x0 - x30 通用寄存器 uint64_t sp; // 虚拟栈指针 uint64_t flags; // 标志位 NZCV uint64_t ret_val; // 返回值 } VMContext; -uint64_t VMP_Execute(const uint8_t *bytecode, uint64_t arg0, uint64_t arg1) { - VMContext ctx; +uint64_t VMP_Execute(const uint8_t *bytecode, size_t bytecode_len, uint64_t arg0, uint64_t arg1) { + if (!bytecode || bytecode_len < 4) return 0; + + VMContext ctx = {0}; ctx.r[0] = arg0; ctx.r[1] = arg1; ctx.sp = (uint64_t)malloc(4096) + 4096; // 分配独立虚拟栈 const uint8_t *pc = bytecode; + const uint8_t *pc_end = bytecode + bytecode_len; - // 静态直接线程标签跳转表 (极致性能且无条件分支预测惩罚) + // 静态直接线程标签跳转表 (极致性能且无分支预测惩罚) static const void *dispatch_table[256] = { [0x11] = &&op_mov_imm, [0x12] = &&op_mov_reg, @@ -262,56 +321,80 @@ uint64_t VMP_Execute(const uint8_t *bytecode, uint64_t arg0, uint64_t arg1) { [0xFF] = &&op_ret }; - #define DISPATCH() goto *dispatch_table[*pc] + #define DISPATCH() \ + do { \ + if (pc + 4 > pc_end) goto op_ret; \ + void *target = (void*)dispatch_table[*pc]; \ + if (!target) goto op_ret; \ + goto *target; \ + } while(0) DISPATCH(); op_mov_imm: { uint8_t dst = pc[1]; uint8_t imm = pc[3]; - ctx.r[dst] = imm; + if (dst < 31) ctx.r[dst] = imm; + pc += 4; + DISPATCH(); + } +op_mov_reg: { + uint8_t dst = pc[1]; + uint8_t src = pc[2]; + if (dst < 31 && src < 31) ctx.r[dst] = ctx.r[src]; pc += 4; DISPATCH(); } op_add: { uint8_t dst = pc[1]; uint8_t src = pc[2]; - ctx.r[dst] += ctx.r[src]; + if (dst < 31 && src < 31) ctx.r[dst] += ctx.r[src]; pc += 4; DISPATCH(); } op_xor: { uint8_t dst = pc[1]; uint8_t src = pc[2]; - ctx.r[dst] ^= ctx.r[src]; + if (dst < 31 && src < 31) ctx.r[dst] ^= ctx.r[src]; pc += 4; DISPATCH(); } op_load64: { uint8_t dst = pc[1]; uint8_t src = pc[2]; - ctx.r[dst] = *(uint64_t*)(ctx.r[src]); + if (dst < 31 && src < 31 && ctx.r[src] != 0) { + ctx.r[dst] = *(uint64_t*)(ctx.r[src]); + } pc += 4; DISPATCH(); } op_store64: { uint8_t dst = pc[1]; uint8_t src = pc[2]; - *(uint64_t*)(ctx.r[dst]) = ctx.r[src]; + if (dst < 31 && src < 31 && ctx.r[dst] != 0) { + *(uint64_t*)(ctx.r[dst]) = ctx.r[src]; + } pc += 4; DISPATCH(); } op_cmp: { uint8_t dst = pc[1]; uint8_t src = pc[2]; - ctx.flags = (ctx.r[dst] == ctx.r[src]) ? 1 : 0; // 模拟 Z 标志 + if (dst < 31 && src < 31) { + ctx.flags = (ctx.r[dst] == ctx.r[src]) ? 1 : 0; + } pc += 4; DISPATCH(); } op_jz: { int8_t offset = (int8_t)pc[3]; if (ctx.flags == 1) { - pc += offset * 4; + const uint8_t *next_pc = pc + offset * 4; + if (next_pc >= bytecode && next_pc + 4 <= pc_end) { + pc = next_pc; + } else { + goto op_ret; // 跳转越界防御 + } } else { pc += 4; } @@ -325,27 +408,50 @@ op_ret: { } ``` +### 3.4 虚拟化适用范围与验收边界 +> [!NOTE] +> **VMP 研发边界与验收范围**: +> 当前原型用于验证自定义字节码指令调度与寄存器映射机制。通用 C/C++/Swift 函数若包含浮点/SIMD(NEON `Q0~Q31`)、C++ 异常栈解退(`eh_frame`)、动态栈分配(`alloca`)或变长参数(`va_list`),需要完备的编译器后端支持。 +> **工程策略**:VMP 首期仅用于保护加固关键的算法、鉴权校验与密钥派生纯整型逻辑函数,不作为通用全量函数虚拟化方案。 + --- ## 4. 全维度内核级主动防御对抗矩阵 (Defender Core) -### 4.1 内联汇编 SVC 0x80 反调试 (Anti-Debug) -不使用 libc 导出的 `ptrace`,使用裸汇编直接触发 XNU 系统调用 26 号中断(`SYS_ptrace`): +### 4.1 内联汇编 SVC 0x80 反调试与 App Store 2.5.1 合规双模设计 +不使用易被 Hook 的 libc `ptrace`,直接使用内联汇编触发 XNU 26 号中断(`SYS_ptrace`)。 +但需注意:Apple 审核指南 2.5.1 规定“App 只能以规定方式使用公开 API”。直接裸汇编 `svc 0x80` 在企业签/Ad-Hoc 场景无阻碍,但在 App Store 审核期存在静态特征扫描风险。系统设计为**双模开关**: ```c -__attribute__((always_inline)) static inline void anti_debug_svc_ptrace() { +#include +#include + +typedef int (*ptrace_ptr_t)(int _request, pid_t _pid, caddr_t _addr, int _data); + +__attribute__((always_inline)) static inline void anti_debug(bool is_appstore_build) { + if (!is_appstore_build) { + // 企业版/对抗模式:裸汇编软中断,彻底免疫 libc 层 Hook #if defined(__arm64__) || defined(__aarch64__) - __asm__ volatile( - "mov x0, #31\n" // PT_DENY_ATTACH (0x1f) - "mov x1, #0\n" - "mov x2, #0\n" - "mov x3, #0\n" - "mov x16, #26\n" // SYS_ptrace = 26 - "svc #0x80\n" // 触发软中断 - : - : - : "x0", "x1", "x2", "x3", "x16" - ); + __asm__ volatile( + "mov x0, #31\n" // PT_DENY_ATTACH (0x1f) + "mov x1, #0\n" + "mov x2, #0\n" + "mov x3, #0\n" + "mov x16, #26\n" // SYS_ptrace = 26 + "svc #0x80\n" + : + : + : "x0", "x1", "x2", "x3", "x16" + ); #endif + } else { + // App Store 提审模式:动态混淆字符解析公开系统 API,规避 2.5.1 静态扫描 + char enc_sym[] = { 'p'^0x5A, 't'^0x5A, 'r'^0x5A, 'a'^0x5A, 'c'^0x5A, 'e'^0x5A, 0 }; + for (int i = 0; i < 6; i++) enc_sym[i] ^= 0x5A; + ptrace_ptr_t ptrace_func = (ptrace_ptr_t)dlsym(RTLD_DEFAULT, enc_sym); + if (ptrace_func) { + ptrace_func(31, 0, 0, 0); // PT_DENY_ATTACH + } + } } ``` @@ -451,6 +557,13 @@ def restore_dsym(dsym_path, mapping_dict, output_path): macho.save(output_path) ``` +### 5.3 崩溃符号化适用边界与限制说明 +> [!IMPORTANT] +> **dSYM 还原的适用边界**: +> 1. **符号混淆 (Symbol Renaming) 场景**:若仅对类名、方法名进行字符替换,函数体机器指令与行号映射保持未动,重写 `__debug_str` 可实现 100% 精确的行号与符号还原。此时必须保证重写后的 dSYM 与主二进制的 `LC_UUID` 严格一致。 +> 2. **代码虚拟化 (VMP) / 函数抽取场景**:一旦函数体被抽离为私有字节码或替换为跳板(Trampoline),原机器指令在二进制中已不复存在。崩溃发生时,系统捕获的堆栈顶帧将必然是 `VMP_Execute`。 +> * **解决路径**:对此类函数,无法仅靠静态 dSYM 还原;必须在 `VMPContext` 中维护虚拟 PC,并在崩溃捕获回调中输出虚拟栈帧,结合离线的 `vmp_pc_mapping.json` 完成混合回溯还原。 + --- ## 6. 资产保护与无感透明解密 (Virtual File System & Assets Protector) @@ -527,11 +640,22 @@ FILE *hook_fopen(const char *path, const char *mode) { #define CSMAGIC_CODEDIRECTORY 0xfade0c02 #define CSMAGIC_EMBEDDED_SIGNATURE 0xfade0cc0 +#define CSMAGIC_REQUIREMENTS 0xfade0c01 #define CSMAGIC_ENTITLEMENTS 0xfade7171 #define CSMAGIC_DER_ENTITLEMENTS 0xfade7172 +// CodeDirectory 特殊负数槽位定义 (Special Slots) +#define CSSLOT_CODEDIRECTORY 0 +#define CSSLOT_INFOPLIST -1 // Info.plist 哈希 +#define CSSLOT_REQUIREMENTS -2 // Requirements 需求规则哈希 +#define CSSLOT_RESOURCEDIR -3 // _CodeSignature/CodeResources 资源清单哈希 (极度关键!) +#define CSSLOT_APPLICATION -4 // 预留 +#define CSSLOT_ENTITLEMENTS -5 // XML Entitlements 哈希 +#define CSSLOT_DER_ENTITLEMENTS -7 // DER Entitlements 哈希 +#define CSSLOT_SIGNATURESLOT 0x10000 // CMS 签名块 + struct BlobIndex { - uint32_t type; // 0: CodeDirectory, 5: Entitlements, 7: DER Entitlements, 0x10000: CMS Signature + uint32_t type; // 对应上述 CSSLOT_* uint32_t offset; // 指向 Blob 距离 SuperBlob 起始处的偏移 }; @@ -545,50 +669,60 @@ struct SuperBlob { struct CodeDirectory { uint32_t magic; // CSMAGIC_CODEDIRECTORY uint32_t length; // 本结构体大小 - uint32_t version; // 0x20400 + uint32_t version; // 0x20400 (支持 SHA256 与负数槽) uint32_t flags; // 0 - uint32_t hashOffset; // 哈希数组距头部的偏移 + uint32_t hashOffset; // 正数哈希数组起始偏移 (负数槽在其左侧) uint32_t identOffset; // Bundle Identifier 字符串偏移 - uint32_t nSpecialSlots; // 负数槽位数量 (Info.plist, Requirements, CodeResources) - uint32_t nCodeSlots; // 页面正数槽位数量 - uint32_t codeLimit; // 签名覆盖的文件大小 (排除签名本身) + uint32_t nSpecialSlots; // 负数槽位数量 (通常为 7) + uint32_t nCodeSlots; // 页面正数槽位数量 (ceil(codeLimit / 16384)) + uint32_t codeLimit; // 签名覆盖的文件大小 (排除 LC_CODE_SIGNATURE 自身) uint8_t hashSize; // 32 (SHA256) uint8_t hashType; // 2 (CS_HASHTYPE_SHA256) uint8_t platform; // 0 uint8_t pageSize; // 14 (表示 1 << 14 = 16384 = 16KB) uint32_t spare2; - // ... }; ``` -### 7.2 签名流水线完整算法时序 -1. **解析描述文件 (`embedded.mobileprovision`)**: - * 提取 `Entitlements`(XML 格式); - * 通过 ASN.1 编码生成二进制的 **DER Entitlements**(iOS 15+ 强制要求)。 -2. **Inside-Out 递归遍历**: - * `Payload/App.app/Frameworks/*.dylib` - * `Payload/App.app/Frameworks/*.framework` - * `Payload/App.app/PlugIns/*.appex` -3. **计算 Mach-O 16KB 分页哈希**: - * 循环计算二进制文件每个 16384 字节区块的 SHA256,填入 `CodeDirectory.hashOffset` 数组。 -4. **生成 CMS (PKCS#7) 签名**: - * 对 `CodeDirectory` 整体计算 SHA256,生成 **CDHash**; - * 使用证书私钥通过 OpenSSL 调用 `PKCS7_sign` 签名 CDHash。 -5. **组装 SuperBlob 并写回**: - * 将 `CodeDirectory`、`Requirements`、`Entitlements`、`DER Entitlements`、`CMS Signature` 封包写入 Mach-O 尾部,更新 `LC_CODE_SIGNATURE`。 -6. **输出 `_CodeSignature/CodeResources`**: - * 扫描 Bundle 内部全部资源文件生成 XML Plist 资源哈希字典。 +### 7.2 严格合规的重签名流水线算法时序 (Correct Order) +> [!CAUTION] +> **特殊槽依赖约束**: +> `CodeDirectory` 的 Slot -3 (`CSSLOT_RESOURCEDIR`) 必须包含最终 `_CodeSignature/CodeResources` 文件的 SHA256。 +> 因此,**必须先生成 `CodeResources` 资源清单,再计算 `CodeDirectory` 的特殊槽并生成主二进制签名**。若颠倒顺序,系统校验必崩。 + +```mermaid +sequenceDiagram + autonumber + participant Runner as 签名调度器 + participant Prov as Mobileprovision 与 Entitlements 协调 + participant Dylibs as Frameworks/PlugIns (内部组件) + participant Res as CodeResources 资源哈希 + participant MachO as 主可执行文件 CodeDirectory + participant CMS as OpenSSL 签名核 + + Runner->>Prov: 解析 embedded.mobileprovision 提取授权白名单 + Runner->>Prov: 协调并生成目标实际需要的 Entitlements (XML + DER 编码) + Runner->>Dylibs: 由内向外先行签名 Frameworks/*.dylib 与 *.framework + Runner->>Dylibs: 先行签名 PlugIns/*.appex (使用插件独立的 bundle_id 与 entitlements) + Runner->>Res: 扫描全部 Bundle 资源文件生成 _CodeSignature/CodeResources + Runner->>MachO: 将 CodeResources 的 SHA256 填入 CodeDirectory Slot -3 + Runner->>MachO: 将 Info.plist、Entitlements 哈希填入 Slot -1, -5, -7 + Runner->>MachO: 按 16KB 页面计算 Mach-O 代码页 SHA256,填入 Slot 0..N + Runner->>CMS: 计算 CodeDirectory 整体哈希 (CDHash),使用私钥生成 PKCS#7 签名 + Runner->>MachO: 组装 SuperBlob 回写至主 Mach-O 尾部,更新 LC_CODE_SIGNATURE + Runner->>Runner: 重新打包压缩为 .ipa +``` --- ## 8. IPA 相似度预检中心 (App Store 4.3 预检器) -### 8.1 算法模型设计 -App Store 4.3 审核主要基于**机器码静态散列相似度**、**符号集重合度**与**媒体资源指纹**。iOSGuard 采用三维综合加权评估模型: +### 8.1 算法模型设计与免责边界 +App Store 4.3 审核(Design: Spam)属于苹果人工审核与机审结合的行为规范策略,旨在遏制重复马甲包与克隆 App。**任何静态相似度工具均无法保证 100% 过审**。 -$$\text{RiskScore} = w_1 \cdot \text{Sim}_{\text{Code}} + w_2 \cdot \text{Sim}_{\text{Symbol}} + w_3 \cdot \text{Sim}_{\text{Asset}}$$ +iOSGuard 的相似度模型定位于**企业内部风控与差异化基准度量工具**: -其中权重推荐值:$w_1 = 0.45$, $w_2 = 0.35$, $w_3 = 0.20$。 +$$\text{InternalRiskScore} = 0.45 \cdot \text{Sim}_{\text{Code}} + 0.35 \cdot \text{Sim}_{\text{Symbol}} + 0.20 \cdot \text{Sim}_{\text{Asset}}$$ ```mermaid graph TD @@ -598,12 +732,13 @@ graph TD B --> E["加权综合评分算法"] C --> E D --> E - E --> F{"RiskScore 判定"} - F -- "< 35%" --> G["安全 (可通过审核)"] - F -- "35% ~ 50%" --> H["中度风险 (建议调整符号库)"] - F -- "> 50%" --> I["极高风险 (4.3拒审高发,阻断发布)"] + E --> F{"内部风控基准评分"} + F -- "< 35%" --> G["内部低相似度 (特征分化充分)"] + F -- "35% ~ 50%" --> H["内部中度相似 (建议调换混淆特征库)"] + F -- "> 50%" --> I["内部高相似度风险 (建议阻断提审)"] ``` + ### 8.2 核心算法实现:基于 SSDEEP 的机器码片段比对 ```python import ssdeep