diff --git a/README.md b/README.md
index d3fc7af..95dea6b 100644
--- a/README.md
+++ b/README.md
@@ -70,16 +70,17 @@ iOSGuard/
## 🚀 研发里程碑规划
-- **M1 (第 1~4 周,MVP)**:主动防御内核库 `libDefender.dylib` + Linux 跨平台自动化重签名管线闭环。
-- **M2 (第 5~9 周,Mach-O 深度加固)**:Mach-O 段平移扩容工具 + Objective-C 元数据彻底抹除与动态重映射。
-- **M3 (第 10~14 周,LLVM 混淆与 dSYM 还原)**:控制流平坦化、字符串加密 Pass + DWARF 重写与线上崩溃还原。
-- **M4 (第 15~20 周,代码虚拟化与游戏安全)**:原生纯解释型 VMP 虚拟机 + Unity IL2CPP / Cocos 加密保护。
-- **M5 (第 21~24 周,4.3 预检与平台化)**:SSDEEP 相似度分析工具 + CLI 命令行与商业控制台交付。
+- **M1 (第 1~4 周,极简闭环 MVP)**:自建 arm64 测试工程 + Padding 充足条件下验证 `LC_LOAD_DYLIB` 原地注入 + 物理嵌入 `libDefender.dylib` 与 `@rpath` 解析 + macOS 原生 `codesign` 重签名 + 真机冷启/基础合规反调试/崩溃符号化全流程闭环验证。
+- **M2 (第 5~9 周,进阶加固与重定位修复)**:全局段平移(Segment Shift)与 `LC_DYLD_CHAINED_FIXUPS` 修复 + Objective-C 元数据精细化抽取与 ASLR 动态恢复 + Linux 端 `zsign` 无 Mac 依赖签名闭环。
+- **M3 (第 10~14 周,LLVM 混淆与 dSYM 还原)**:控制流平坦化、字符串加密 Pass + DWARF 定点重写与线上崩溃还原。
+- **M4 (第 15~20 周,代码虚拟化与游戏安全)**:原生纯解释型 VMP 虚拟机 + 完整内存/指令边界防御 + Unity IL2CPP / Cocos 加密保护。
+- **M5 (第 21~24 周,4.3 预检与平台化)**:SSDEEP 相似度分析工具 + 内部风控度量体系 + CLI 命令行与商业控制台交付。
---
## ⚖️ 苹果审核与合规声明
1. **AMFI 与 W^X 合规**:本系统代码虚拟化 (VMP) 采用纯解释型虚拟机,不申请可执行内存(无 `mprotect(PROT_EXEC)`),严格遵守苹果 W^X 内存安全规范。
-2. **私有 API 零依赖**:主动防御与反逆向对抗全量下沉至公开 POSIX 标准接口与 ARM64 裸汇编软中断,零引入苹果私有 Framework。
+2. **公开 API 提审合规 (Guideline §2.5.1)**:App Store 提审版本中通过宏开关物理排除所有私有未公开符号(如 iPhoneOS SDK 未包含的 `ptrace` 相关调用)及裸汇编 syscall,仅依赖公开文档支持的 `sysctl` 调试检测;内核级汇编软中断与 `PT_DENY_ATTACH` 严格限制于企业内部分发 (Enterprise) / Ad-Hoc 场景。
3. **签名标准化**:重签名引擎严格遵从苹果 iOS 15+ DER-encoded Entitlements 与 CodeDirectory 16KB 分页哈希规范,保证 App Store 提审解签正常。
+
diff --git a/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md b/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md
index b8428c0..454783b 100644
--- a/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md
+++ b/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md
@@ -195,19 +195,20 @@ flowchart TD
participant Prov as Mobileprovision 与 Entitlements 协调
participant Dylibs as Frameworks/PlugIns (内部组件)
participant Res as CodeResources 资源清单
- participant MachO as 主可执行文件 CodeDirectory
+ participant MachO as 主可执行文件 Header 与 CodeDirectory
participant CMS as OpenSSL 签名核
- Runner->>Prov: 解析 embedded.mobileprovision 提取授权白名单
+ Runner->>Prov: 解析 embedded.mobileprovision 提取授权范围
Runner->>Prov: 协调生成目标所需 Entitlements (XML + DER 编码)
Runner->>Dylibs: 先行签名内部 Frameworks/*.dylib 与 *.framework
- Runner->>Dylibs: 先行签名 PlugIns/*.appex (使用插件各自的 bundle_id 与 entitlements)
+ Runner->>Dylibs: 先行签名 PlugIns/*.appex (独立 Entitlements 与 BundleID)
Runner->>Res: 扫描 Bundle 全部文件生成 _CodeSignature/CodeResources
+ Runner->>MachO: 预先计算 SuperBlob 大小,在 Header 预设 LC_CODE_SIGNATURE (dataoff=codeLimit, datasize=blob_size)
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->>MachO: 按 16KB 页面计算 0..codeLimit 范围内的代码页 SHA256 填入 Slot 0..N
+ Runner->>CMS: 传入完整的 CodeDirectory 序列化字节数据,由 OpenSSL 生成 PKCS#7 签名
+ Runner->>MachO: 组装 SuperBlob (包含 0, 2, 5, 7, 0x10000 槽位) 回写至 dataoff 偏移
Runner->>Runner: 重新打包为 Payload 结构并压缩为 .ipa
```
* **跨平台工具选型**:
@@ -280,12 +281,8 @@ flowchart LR
| 阶段 | 周期 | 研发重点与技术验证 | 关键交付产物 |
| :--- | :--- | :--- | :--- |
-| **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. 真机冷启与崩溃还原验证报告 |
+| **M1: 极简闭环验证 (MVP 收敛范围)** | 3~4 周 | 1. **目标载体**:自有简单 arm64 测试 App(UIKit/SwiftUI);
2. **注入约束**:仅在 Header Padding 充足条件下验证 `LC_LOAD_DYLIB` 原地注入(空间不足直接拒绝,不盲目平移);
3. **依赖与路径**:物理嵌入 `libDefender.dylib` 至 `Payload/App.app/Frameworks/`,解析并验证 `@rpath` 依赖链;
4. **签名验证**:使用 macOS 原生 `codesign`(带 `--generate-entitlement-der`);
5. **真机闭环**:验证真机安装、冷启动通过、`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 游戏专用加固套件 |
+| **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 d6de112..90babcd 100644
--- a/docs/04_DETAILED_SUBSYSTEMS_DESIGN.md
+++ b/docs/04_DETAILED_SUBSYSTEMS_DESIGN.md
@@ -42,90 +42,106 @@ struct MachOBinary {
};
```
-### 1.3 底层算法与平移逻辑
+### 1.3 底层算法与 M1 注入逻辑
```mermaid
flowchart TD
- 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 指向文件末尾"]
+ A["读取并校验 Mach-O 边界\nbinary.size >= sizeof(mach_header_64)"] --> B["遍历与校验 load_commands\n边界检查: cmdsize >= 8 且在 cmds_end 范围内"]
+ B --> C["遍历 LC_SEGMENT_64 与 sections\n统计真实存在的第一节最小 offset (found_valid_section)"]
+ C --> D{"有效性安全检查\nfound_valid_section && first_section_offset >= header_and_cmds && <= binary.size"}
+ D -- "检查不通过" --> D1["退出拒绝处理 (防御非法头部/下溢/越界)"]
+ D -- "通过" --> E{"检测可用 Padding 空间\navailable_padding = first_section_offset - header_and_cmds"}
+ E -- "available_padding >= cmd_size" --> F["M1 MVP 路径: 原地追加 LC_LOAD_DYLIB\n更新 ncmds & sizeofcmds 并写入 @rpath 路径"]
+ E -- "available_padding 不足" --> G["M1 策略: 直接拒绝,报错退出\n(段平移与 Fixup 重构隔离至 M2 研发)"]
```
-#### 代码实现原型:Header 扩容与 LC_LOAD_DYLIB 注入 (含边界防御)
+#### 代码实现原型:严格边界防御的 LC_LOAD_DYLIB 原地注入
```cpp
bool InjectDylib(std::vector& binary, const std::string& dylib_path) {
+ // 1. 基础头部尺寸校验
+ if (binary.size() < sizeof(mach_header_64)) return false;
auto* header = reinterpret_cast(binary.data());
if (header->magic != MH_MAGIC_64) return false;
- // 1. 计算对齐后的 dylib_command 大小 (8 字节对齐)
+ // 2. sizeofcmds 边界校验
+ uint32_t header_and_cmds = sizeof(mach_header_64) + header->sizeofcmds;
+ if (binary.size() < header_and_cmds) return false;
+
+ // 3. 计算对齐后的 dylib_command 大小 (8 字节对齐)
uint32_t cmd_size = sizeof(dylib_command) + dylib_path.length() + 1;
cmd_size = (cmd_size + 7) & ~7;
- // 2. 检测 Header Padding 与首个 Section 偏移
uint8_t* cmds_start = binary.data() + sizeof(mach_header_64);
- uint32_t header_and_cmds = sizeof(mach_header_64) + header->sizeofcmds;
+ uint8_t* cmds_end = cmds_start + header->sizeofcmds;
+ // 4. 遍历所有 Load Commands 并严格检查边界,查找首个 Section 偏移
uint32_t first_section_offset = UINT32_MAX;
+ bool found_valid_section = false;
uint8_t* cur_cmd = cmds_start;
+
for (uint32_t i = 0; i < header->ncmds; i++) {
- auto* sc = reinterpret_cast(cur_cmd);
- if (sc->cmd == LC_SEGMENT_64) {
+ if (cur_cmd + sizeof(load_command) > cmds_end) return false;
+ auto* lc = reinterpret_cast(cur_cmd);
+ if (lc->cmdsize < sizeof(load_command) || cur_cmd + lc->cmdsize > cmds_end) {
+ return false; // 非法 cmdsize
+ }
+
+ if (lc->cmd == LC_SEGMENT_64) {
+ if (cur_cmd + sizeof(segment_command_64) > cmds_end) return false;
+ auto* sc = reinterpret_cast(cur_cmd);
+ if (cur_cmd + sizeof(segment_command_64) + sc->nsects * sizeof(section_64) > cmds_end) {
+ return false; // Section 数组超出 load commands 边界
+ }
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;
+ // 仅统计实际存在于文件内的有效非零偏移 Section
+ if (sec[j].offset > 0 && sec[j].size > 0) {
+ if (sec[j].offset < first_section_offset) {
+ first_section_offset = sec[j].offset;
+ found_valid_section = true;
+ }
}
}
}
- cur_cmd += sc->cmdsize;
+ cur_cmd += lc->cmdsize;
}
- // 边界安全防御:防止异常 Mach-O 导致无符号减法下溢 (Underflow)
- if (first_section_offset < header_and_cmds) {
- // 首个节偏移异常或已被篡改,直接拒绝处理
+ // 5. 严格防御:无 Section、偏移异常或首节偏移超出文件长度时直接拒绝,彻底杜绝下溢
+ if (!found_valid_section || first_section_offset < header_and_cmds || first_section_offset > binary.size()) {
return false;
}
uint32_t available_padding = first_section_offset - header_and_cmds;
- if (available_padding >= cmd_size) {
- // 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;
- new_cmd->dylib.name.offset = sizeof(dylib_command);
- new_cmd->dylib.timestamp = 2;
- new_cmd->dylib.current_version = 0x10000;
- new_cmd->dylib.compatibility_version = 0x10000;
- memcpy(reinterpret_cast(new_cmd) + sizeof(dylib_command), dylib_path.c_str(), dylib_path.length() + 1);
-
- header->ncmds += 1;
- header->sizeofcmds += cmd_size;
- return true;
- } else {
- // Padding 不足:触发进阶的段平移与重定位链重构
- return ShiftAndInjectDylibWithChainedFixups(binary, dylib_path, cmd_size);
+ // 6. M1 策略:Padding 空间充足时原地写入,不足时直接拒绝处理
+ if (available_padding < cmd_size || header_and_cmds + cmd_size > binary.size()) {
+ // 空间不足,在 M1 阶段明确拒绝,不隐式调用段平移
+ return false;
}
+
+ // 原地写入 LC_LOAD_DYLIB
+ 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;
+ new_cmd->dylib.name.offset = sizeof(dylib_command);
+ new_cmd->dylib.timestamp = 2;
+ new_cmd->dylib.current_version = 0x10000;
+ new_cmd->dylib.compatibility_version = 0x10000;
+ memcpy(reinterpret_cast(new_cmd) + sizeof(dylib_command), dylib_path.c_str(), dylib_path.length() + 1);
+
+ header->ncmds += 1;
+ header->sizeofcmds += cmd_size;
+ return true;
}
```
-### 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 重构作为独立里程碑隔离攻关。
+### 1.4 M1 运行环境与 @rpath 依赖解析
+在 M1 真机验收中,注入的 `libDefender.dylib` 必须满足动态链接器解析路径:
+1. **注入路径规范**:推荐使用 `@rpath/libDefender.dylib`;
+2. **实际物理嵌入**:IPA 解包后,必须将 `libDefender.dylib` 拷贝至 `Payload/App.app/Frameworks/libDefender.dylib`;
+3. **LC_RPATH 校验**:主二进制必须包含 `LC_RPATH` 指向 `@executable_path/Frameworks`,若不存在需在注入时同步检测并补齐。
+
---
@@ -197,66 +213,83 @@ struct method_list_t_relative {
4. 对 +load、KVC 敏感类与系统协议建立白名单豁免机制
```
-#### 运行时动态重映射 Hook 原型 (语义保持与 ASLR 修复版)
+#### 运行时动态重映射 Hook 原型 (严格流同步与边界防御版)
```objc
#import
#import
#import
void RestoreObjcMetadata(const uint8_t *decrypted_meta, size_t size, intptr_t slide) {
+ if (!decrypted_meta || size == 0) return;
+
size_t offset = 0;
- while (offset < size) {
- // 1. 读取类名
+ while (offset + 2 <= size) {
+ // 1. 安全读取类名长度与字符串
uint16_t name_len = *(uint16_t*)(decrypted_meta + offset);
offset += 2;
+ if (name_len == 0 || name_len >= 256 || offset + name_len > size) {
+ break; // 数据流受损,安全终止
+ }
char class_name[256] = {0};
memcpy(class_name, decrypted_meta + offset, name_len);
offset += name_len;
+ // 查找目标类 (即便类不存在,游标也必须完整跳过后续方法体,绝不可直接 continue 导致流失步)
Class cls = objc_getClass(class_name);
- if (!cls) continue;
- Class meta_cls = object_getClass(cls);
+ Class meta_cls = cls ? object_getClass(cls) : nil;
- // 2. 读取方法列表
+ // 2. 读取方法数量
+ if (offset + 4 > size) break;
uint32_t method_count = *(uint32_t*)(decrypted_meta + offset);
offset += 4;
+
for (uint32_t i = 0; i < method_count; i++) {
+ if (offset + 1 > size) break;
uint8_t is_meta = *(uint8_t*)(decrypted_meta + offset++);
// 读取 Selector 名字
+ if (offset + 2 > size) break;
uint16_t sel_len = *(uint16_t*)(decrypted_meta + offset);
offset += 2;
+ if (sel_len >= 256 || offset + sel_len > size) break;
char sel_name[256] = {0};
memcpy(sel_name, decrypted_meta + offset, sel_len);
offset += sel_len;
- // 读取真实类型编码 (如 "@16@0:8" 或 "i24@0:8@16"),严禁写死 "v@:"
+ // 读取真实类型编码 (如 "@16@0:8" 或 "i24@0:8@16")
+ if (offset + 2 > size) break;
uint16_t type_len = *(uint16_t*)(decrypted_meta + offset);
offset += 2;
+ if (type_len >= 128 || offset + type_len > size) break;
char type_encoding[128] = {0};
memcpy(type_encoding, decrypted_meta + offset, type_len);
offset += type_len;
// 读取静态 VM 地址并结合 ASLR Slide 计算真实函数入口
+ if (offset + 8 > size) break;
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 target_cls = is_meta ? meta_cls : cls;
-
- // 保持方法调用 ABI 语义完整,不破坏消息转发与参数传递
- class_addMethod(target_cls, sel, real_imp, type_encoding);
+ // 仅在类存在时执行注回;即使类缺失,游标也已完整解析完当前方法,下一记录依然对齐
+ if (cls) {
+ IMP real_imp = (IMP)(imp_vmaddr + slide);
+ SEL sel = sel_registerName(sel_name);
+ Class target_cls = is_meta ? meta_cls : cls;
+ class_addMethod(target_cls, sel, real_imp, type_encoding);
+ }
}
}
}
```
-### 2.4 语义保持与边界防线
+### 2.4 语义保持、分类顺序与共享 Selector 防线
> [!IMPORTANT]
-> **Objective-C 元数据加固边界约束**:
-> 1. **`+load` 时序限制**:`+load` 在 dyld 加载镜像时由 `libobjc` 的 `prepare_load_methods` 内部直接读取并调用,早于 C++ 动态库构造器。因此**带有 `+load` 的类方法必须保留在静态结构中或采用动态桥接白名单**,不可盲目抹除。
-> 2. **JSON 反序列化与 KVC**:`YYModel` / `MJExtension` 依赖 `class_copyPropertyList` 和 `class_copyIvarList` 进行属性映射。加固系统必须建立基于类的排除规则,对 Model 数据模型对象豁免元数据抹除。
+> **Objective-C 进阶语义约束**:
+> 1. **分类 (Category) 覆盖顺序保持**:在 Objective-C 运行时中,分类的方法会被追加到类方法列表前端(优先命中)。元数据序列化时,必须保证**主类记录在前、分类记录在后**,运行时按序注回,以维持既有的分类覆盖优先级。
+> 2. **共享与系统 Selector 保护**:若某个 Selector 仍被系统 Framework(如 `UITableViewDelegate` 回调)、KVO 或未加固模块显式调用,**其 `__TEXT,__objc_methname` 字符串绝不可盲目抹除**,必须建立静态交叉引用扫描(Xref),只抹除非暴露、纯内部调用的私有 Selector。
+> 3. **`+load` 时序限制**:`+load` 在 dyld 加载镜像时由 `libobjc` 的 `prepare_load_methods` 内部直接读取并调用,早于 C++ 动态库构造器。因此**带有 `+load` 的类方法必须保留在静态结构中或采用动态桥接白名单**,不可盲目抹除。
+> 4. **JSON 反序列化与 KVC**:`YYModel` / `MJExtension` 依赖 `class_copyPropertyList` 和 `class_copyIvarList`。加固系统必须建立基于类的排除规则,对 Model 数据模型对象豁免元数据抹除。
+
---
@@ -284,31 +317,58 @@ void RestoreObjcMetadata(const uint8_t *decrypted_meta, size_t size, intptr_t sl
| `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 sp; // 虚拟栈指针
- uint64_t flags; // 标志位 NZCV
- uint64_t ret_val; // 返回值
+ bool success;
+ uint64_t ret_val;
+ uint32_t error_code; // 0: 正常, 1: 未知操作码, 2: 非法内存越界, 3: 指令跳转越界
+} VMResult;
+
+typedef struct {
+ uint64_t r[31]; // ARM64 x0 - x30 通用虚拟寄存器
+ uint64_t sp; // 当前栈指针
+ uint64_t sp_base; // 虚拟栈底边界 (安全检查)
+ uint64_t sp_top; // 虚拟栈顶边界 (安全检查)
+ uint64_t flags; // 标志位 NZCV
} VMContext;
-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;
+// 校验地址是否落在合法的虚拟栈或有效数据内存区内
+static inline bool is_vm_memory_accessible(const VMContext *ctx, uint64_t addr, size_t size) {
+ if (addr < 4096) return false; // 严防空指针及低地址零页异常 (如 0x1)
+ if (addr >= ctx->sp_base && addr + size <= ctx->sp_top) return true;
+ return false; // 原型阶段严格限制在虚拟栈内存空间,后续扩展堆区白名单
+}
+
+VMResult VMP_Execute(const uint8_t *bytecode, size_t bytecode_len, uint64_t arg0, uint64_t arg1) {
+ VMResult result = {false, 0, 0};
+ if (!bytecode || bytecode_len < 4) {
+ result.error_code = 1;
+ return result;
+ }
VMContext ctx = {0};
ctx.r[0] = arg0;
ctx.r[1] = arg1;
- ctx.sp = (uint64_t)malloc(4096) + 4096; // 分配独立虚拟栈
+
+ size_t stack_size = 4096;
+ void *stack_mem = malloc(stack_size);
+ if (!stack_mem) {
+ result.error_code = 2;
+ return result;
+ }
+ ctx.sp_base = (uint64_t)stack_mem;
+ ctx.sp_top = ctx.sp_base + stack_size;
+ ctx.sp = ctx.sp_top; // 栈自顶向下生长
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,
@@ -323,9 +383,15 @@ uint64_t VMP_Execute(const uint8_t *bytecode, size_t bytecode_len, uint64_t arg0
#define DISPATCH() \
do { \
- if (pc + 4 > pc_end) goto op_ret; \
+ if (pc + 4 > pc_end) { \
+ result.error_code = 1; \
+ goto vm_exit; \
+ } \
void *target = (void*)dispatch_table[*pc]; \
- if (!target) goto op_ret; \
+ if (!target) { \
+ result.error_code = 1; /* 未知操作码,明确报错,绝不伪装正常返回 */ \
+ goto vm_exit; \
+ } \
goto *target; \
} while(0)
@@ -362,8 +428,14 @@ op_xor: {
op_load64: {
uint8_t dst = pc[1];
uint8_t src = pc[2];
- if (dst < 31 && src < 31 && ctx.r[src] != 0) {
- ctx.r[dst] = *(uint64_t*)(ctx.r[src]);
+ int8_t imm = (int8_t)pc[3]; // 正确计入 ISA 规范中定义的 imm 偏移
+ if (dst < 31 && src < 31) {
+ uint64_t target_addr = ctx.r[src] + imm;
+ if (!is_vm_memory_accessible(&ctx, target_addr, 8)) {
+ result.error_code = 2; // 内存越界/非法指针,明确捕获异常
+ goto vm_exit;
+ }
+ ctx.r[dst] = *(uint64_t*)target_addr;
}
pc += 4;
DISPATCH();
@@ -371,8 +443,14 @@ op_load64: {
op_store64: {
uint8_t dst = pc[1];
uint8_t src = pc[2];
- if (dst < 31 && src < 31 && ctx.r[dst] != 0) {
- *(uint64_t*)(ctx.r[dst]) = ctx.r[src];
+ int8_t imm = (int8_t)pc[3]; // 正确计入 ISA 规范中定义的 imm 偏移
+ if (dst < 31 && src < 31) {
+ uint64_t target_addr = ctx.r[dst] + imm;
+ if (!is_vm_memory_accessible(&ctx, target_addr, 8)) {
+ result.error_code = 2; // 内存越界/非法指针,明确捕获异常
+ goto vm_exit;
+ }
+ *(uint64_t*)target_addr = ctx.r[src];
}
pc += 4;
DISPATCH();
@@ -393,7 +471,8 @@ op_jz: {
if (next_pc >= bytecode && next_pc + 4 <= pc_end) {
pc = next_pc;
} else {
- goto op_ret; // 跳转越界防御
+ result.error_code = 3; // 跳转目标越界,明确报错
+ goto vm_exit;
}
} else {
pc += 4;
@@ -401,10 +480,15 @@ op_jz: {
DISPATCH();
}
op_ret: {
- uint64_t result = ctx.r[0];
- free((void*)(ctx.sp - 4096));
- return result;
+ result.success = true;
+ result.ret_val = ctx.r[0];
+ result.error_code = 0;
+ goto vm_exit;
}
+
+vm_exit:
+ free(stack_mem);
+ return result;
}
```
@@ -418,41 +502,60 @@ op_ret: {
## 4. 全维度内核级主动防御对抗矩阵 (Defender Core)
-### 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 审核期存在静态特征扫描风险。系统设计为**双模开关**:
+### 4.1 反调试机制与 App Store §2.5.1 公开 API 边界
+> [!CAUTION]
+> **iPhoneOS SDK 真实接口与提审红线**:
+> 在 iOS 官方 SDK(`iPhoneOS.platform`)中,**苹果并未提供公开的 `` 头文件**。
+> `ptrace` 在 iOS 底层 `libSystem.dylib` 中被视作私有未公开符号。无论是直接调用、还是通过 `dlsym(RTLD_DEFAULT, "ptrace")` 动态查找并混淆符号名,均属于调用非公开 API,直接违反 **App Store Review Guideline §2.5.1**。
+>
+> **方案修正与合规边界**:
+> 1. **提审产物必须物理排除**:通过预编译宏 `#ifndef APPSTORE_RELEASE`,在生成提审包时**将 `PT_DENY_ATTACH`、`dlsym("ptrace")` 以及裸汇编 `svc #0x80` 源码彻底编译排除**,绝不残留任何私有符号或未文档化系统调用路径;
+> 2. **提审版反调试方案**:仅使用苹果公开文档许可的标准接口,即通过 `sysctl` 检查进程 `P_TRACED` 标志位;
+> 3. **内核级软中断定位**:裸汇编 `svc #0x80` 与 `PT_DENY_ATTACH` 仅供**企业内部分发 (Enterprise) / Ad-Hoc / 内部反作弊测试**使用,收回此前“可直接提审”和“完全合规”的不严谨表述。
+
```c
-#include
+#include
+#include
+#include
#include
-typedef int (*ptrace_ptr_t)(int _request, pid_t _pid, caddr_t _addr, int _data);
+// 1. App Store 提审合规反调试:仅依赖公开 documented sysctl API
+bool is_debugger_attached_appstore_compliant(void) {
+ int name[4];
+ struct kinfo_proc info;
+ size_t info_size = sizeof(info);
+ info.kp_proc.p_flag = 0;
-__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"
- );
-#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
- }
+ name[0] = CTL_KERN;
+ name[1] = KERN_PROC;
+ name[2] = KERN_PROC_PID;
+ name[3] = getpid();
+
+ if (sysctl(name, 4, &info, &info_size, NULL, 0) == -1) {
+ return false;
}
+ // 检查进程标志位中的 P_TRACED
+ return ((info.kp_proc.p_flag & P_TRACED) != 0);
}
+
+// 2. 企业版/内测专用反调试:裸汇编软中断 (提审构建时由预处理器物理排除)
+#ifndef APPSTORE_RELEASE
+__attribute__((always_inline)) static inline void anti_debug_enterprise_svc(void) {
+#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"
+ );
+#endif
+}
+#endif
```
### 4.2 硬件断点 (DR0-DR7) 探测
@@ -530,40 +633,51 @@ flowchart LR
F --> G
```
-#### DWARF 重构伪代码原型
+#### DWARF 定点引用解析与重构伪代码 (杜绝全局子串误替)
```python
-def restore_dsym(dsym_path, mapping_dict, output_path):
- # 1. 打开 DWARF 调试文件
+def restore_dsym_targeted(dsym_path, mapping_dict, output_path):
+ # 严禁在 __debug_str 中执行全文 replace!
+ # 必须通过 __debug_info 树定位具体 DIE 的 DW_FORM_strp 偏移进行定点更新
with open(dsym_path, "r+b") as f:
macho = MachO(f)
- debug_str_section = macho.get_section("__DWARF", "__debug_str")
- debug_info_section = macho.get_section("__DWARF", "__debug_info")
+ debug_str = bytearray(macho.get_section("__DWARF", "__debug_str").data)
+ debug_info = macho.get_section("__DWARF", "__debug_info").data
+
+ # 1. 遍历 .debug_info 中的 Compilation Units 与 DIE 树
+ die_offsets = parse_dwarf_die_string_offsets(debug_info) # 提取 (die_id, attr_type, str_offset)
- # 2. 扫描并替换符号
- str_data = bytearray(debug_str_section.data)
- for obfuscated, original in mapping_dict.items():
- obf_bytes = obfuscated.encode('utf-8')
- orig_bytes = original.encode('utf-8')
+ # 2. 定点校验与改写
+ for str_offset in die_offsets:
+ # 读取当前位置以 \0 结尾的完整原始字符串
+ end_idx = debug_str.find(b'\x00', str_offset)
+ if end_idx == -1: continue
+ current_sym = debug_str[str_offset:end_idx].decode('utf-8', errors='ignore')
- # 若等长替换直接原位覆写
- if len(orig_bytes) <= len(obf_bytes):
- padded_orig = orig_bytes.ljust(len(obf_bytes), b'\x00')
- str_data = str_data.replace(obf_bytes, padded_orig)
- else:
- # 不等长则需调整 .debug_str 长度并修复 DIE 偏移
- str_data = append_and_fix_die_offsets(debug_info_section, str_data, obf_bytes, orig_bytes)
-
- debug_str_section.write(str_data)
+ # 精确匹配(非子串模糊替换)
+ if current_sym in mapping_dict:
+ restored_sym = mapping_dict[current_sym].encode('utf-8')
+ orig_len = end_idx - str_offset
+ if len(restored_sym) <= orig_len:
+ # 原位填充并截断,严格保证不越界污染相邻字符串
+ debug_str[str_offset:str_offset + len(restored_sym)] = restored_sym
+ debug_str[str_offset + len(restored_sym):end_idx] = b'\x00' * (orig_len - len(restored_sym))
+ else:
+ # 超长符号追加至表尾,并同步校准该 DIE 的 DW_FORM_strp 指针值
+ new_offset = append_debug_str(debug_str, restored_sym)
+ update_die_strp_offset(debug_info, str_offset, new_offset)
+
+ macho.get_section("__DWARF", "__debug_str").write(debug_str)
macho.save(output_path)
```
### 5.3 崩溃符号化适用边界与限制说明
> [!IMPORTANT]
-> **dSYM 还原的适用边界**:
-> 1. **符号混淆 (Symbol Renaming) 场景**:若仅对类名、方法名进行字符替换,函数体机器指令与行号映射保持未动,重写 `__debug_str` 可实现 100% 精确的行号与符号还原。此时必须保证重写后的 dSYM 与主二进制的 `LC_UUID` 严格一致。
+> **dSYM 还原的适用边界与客观约束**:
+> 1. **符号混淆场景**:仅在函数体指令未发生偏移(仅改名)且通过 DIE 引用定点恢复时,堆栈可获得良好还原。但需注意:编译器内联优化(Inlining)或尾调用消除可能使部分行号产生轻微漂移,收回“100% 精确还原”的绝对表述;同时必须严格校验新产物与原始构建的 `LC_UUID` 严格匹配。
> 2. **代码虚拟化 (VMP) / 函数抽取场景**:一旦函数体被抽离为私有字节码或替换为跳板(Trampoline),原机器指令在二进制中已不复存在。崩溃发生时,系统捕获的堆栈顶帧将必然是 `VMP_Execute`。
> * **解决路径**:对此类函数,无法仅靠静态 dSYM 还原;必须在 `VMPContext` 中维护虚拟 PC,并在崩溃捕获回调中输出虚拟栈帧,结合离线的 `vmp_pc_mapping.json` 完成混合回溯还原。
+
---
## 6. 资产保护与无感透明解密 (Virtual File System & Assets Protector)
@@ -638,44 +752,50 @@ FILE *hook_fopen(const char *path, const char *mode) {
```cpp
#include
-#define CSMAGIC_CODEDIRECTORY 0xfade0c02
-#define CSMAGIC_EMBEDDED_SIGNATURE 0xfade0cc0
-#define CSMAGIC_REQUIREMENTS 0xfade0c01
-#define CSMAGIC_ENTITLEMENTS 0xfade7171
-#define CSMAGIC_DER_ENTITLEMENTS 0xfade7172
+#define CSMAGIC_CODEDIRECTORY 0xfade0c02
+#define CSMAGIC_EMBEDDED_SIGNATURE 0xfade0cc0
+#define CSMAGIC_REQUIREMENTS 0xfade0c01
+#define CSMAGIC_BLOBWRAPPER 0xfade0b01
+#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 签名块
+// 1. SuperBlob 索引类型 (BlobIndex.type,均为正数或标准常量)
+#define CSSLOT_CODEDIRECTORY 0 // 0x0: 主 CodeDirectory
+#define CSSLOT_REQUIREMENTS 2 // 0x2: Requirements 规则
+#define CSSLOT_ENTITLEMENTS 5 // 0x5: XML Entitlements
+#define CSSLOT_DER_ENTITLEMENTS 7 // 0x7: DER-encoded Entitlements
+#define CSSLOT_SIGNATURESLOT 0x10000 // 0x10000: CMS 签名块 (BlobWrapper)
+
+// 2. CodeDirectory 负数特殊散列槽位 (Special Slots,相对于 hashOffset 的负索引)
+#define CD_SLOT_INFOPLIST -1 // Info.plist SHA256
+#define CD_SLOT_REQUIREMENTS -2 // Requirements SHA256
+#define CD_SLOT_RESOURCEDIR -3 // _CodeSignature/CodeResources SHA256 (关键依赖)
+#define CD_SLOT_APPLICATION -4 // 预留
+#define CD_SLOT_ENTITLEMENTS -5 // XML Entitlements SHA256
+#define CD_SLOT_DER_ENTITLEMENTS -7 // DER Entitlements SHA256
struct BlobIndex {
- uint32_t type; // 对应上述 CSSLOT_*
- uint32_t offset; // 指向 Blob 距离 SuperBlob 起始处的偏移
+ uint32_t type; // 必须为上述正数常量: 0, 2, 5, 7, 0x10000
+ uint32_t offset; // 指向 Blob 距离 SuperBlob 起始处的字节偏移
};
struct SuperBlob {
uint32_t magic; // CSMAGIC_EMBEDDED_SIGNATURE
- uint32_t length; // 整个 SuperBlob 大小
- uint32_t count; // 包含的 Blob 数量
+ uint32_t length; // 整个 SuperBlob 大小 (包含所有子 Blob)
+ uint32_t count; // 包含的子 Blob 数量
BlobIndex index[];
};
struct CodeDirectory {
uint32_t magic; // CSMAGIC_CODEDIRECTORY
- uint32_t length; // 本结构体大小
- uint32_t version; // 0x20400 (支持 SHA256 与负数槽)
+ uint32_t length; // CodeDirectory 自身结构及前后哈希数组大小
+ uint32_t version; // 0x20400 (支持 SHA256 及负数槽)
uint32_t flags; // 0
- uint32_t hashOffset; // 正数哈希数组起始偏移 (负数槽在其左侧)
- uint32_t identOffset; // Bundle Identifier 字符串偏移
+ uint32_t hashOffset; // 代码正数哈希数组起始偏移 (负数特殊槽位于其左侧)
+ uint32_t identOffset; // Bundle ID 字符串距头部的偏移
uint32_t nSpecialSlots; // 负数槽位数量 (通常为 7)
uint32_t nCodeSlots; // 页面正数槽位数量 (ceil(codeLimit / 16384))
- uint32_t codeLimit; // 签名覆盖的文件大小 (排除 LC_CODE_SIGNATURE 自身)
+ uint32_t codeLimit; // 签名覆盖的文件大小 (即 SuperBlob 起始偏移)
uint8_t hashSize; // 32 (SHA256)
uint8_t hashType; // 2 (CS_HASHTYPE_SHA256)
uint8_t platform; // 0
@@ -684,11 +804,11 @@ struct CodeDirectory {
};
```
-### 7.2 严格合规的重签名流水线算法时序 (Correct Order)
+### 7.2 严格合规的重签名流水线算法时序 (包含 LC_CODE_SIGNATURE 预占位)
> [!CAUTION]
-> **特殊槽依赖约束**:
-> `CodeDirectory` 的 Slot -3 (`CSSLOT_RESOURCEDIR`) 必须包含最终 `_CodeSignature/CodeResources` 文件的 SHA256。
-> 因此,**必须先生成 `CodeResources` 资源清单,再计算 `CodeDirectory` 的特殊槽并生成主二进制签名**。若颠倒顺序,系统校验必崩。
+> **两大签名底层陷阱**:
+> 1. **`LC_CODE_SIGNATURE` 命令属于 Page 0**:`load_commands` 位于二进制头部,属于 Page 0(0 ~ 16KB 范围)。如果在计算代码页哈希之后再更新 `LC_CODE_SIGNATURE` 的 `dataoff` 和 `datasize`,会导致 Page 0 哈希瞬间失效!因此**必须预先在 Header 中完成 `LC_CODE_SIGNATURE` 的位置与大小占位**,再执行分页代码哈希!
+> 2. **CMS 签名的真实入参**:苹果规范中,CMS `signedData` 签名封装的是**完整的 `CodeDirectory` 序列化二进制字节数据**(作为 SignedContent 或 Authenticated Attributes),绝非仅对 32 字节的 CDHash 做简单签名。
```mermaid
sequenceDiagram
@@ -696,23 +816,25 @@ sequenceDiagram
participant Runner as 签名调度器
participant Prov as Mobileprovision 与 Entitlements 协调
participant Dylibs as Frameworks/PlugIns (内部组件)
- participant Res as CodeResources 资源哈希
- participant MachO as 主可执行文件 CodeDirectory
+ participant Res as CodeResources 资源清单
+ participant MachO as 主可执行文件 Header
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->>Prov: 解析 embedded.mobileprovision 提取授权范围
+ Runner->>Prov: 协调并生成目标所需 Entitlements (XML + DER 编码)
+ Runner->>Dylibs: 先行签名内部 Frameworks/*.dylib 与 *.framework
+ Runner->>Dylibs: 先行签名 PlugIns/*.appex (独立 Entitlements 与 BundleID)
+ Runner->>Res: 扫描 Bundle 全部文件生成 _CodeSignature/CodeResources
+ Runner->>MachO: 预先计算 SuperBlob 大小,在 Mach-O Header 预设 LC_CODE_SIGNATURE (dataoff=codeLimit, datasize=blob_size)
+ Runner->>MachO: 将 CodeResources 哈希填入 CodeDirectory Slot -3
+ Runner->>MachO: 将 Info.plist、Entitlements 哈希填入 Slot -1, -2, -5, -7
+ Runner->>MachO: 计算 0..codeLimit 范围内的每 16KB 代码页 SHA256,填入 Slot 0..N
+ Runner->>CMS: 传入完整的 CodeDirectory 序列化字节,由 OpenSSL 使用私钥生成 CMS PKCS#7 签名
+ Runner->>MachO: 组装 SuperBlob (包含 0, 2, 5, 7, 0x10000 槽位),写入 dataoff
Runner->>Runner: 重新打包压缩为 .ipa
```
+
---
## 8. IPA 相似度预检中心 (App Store 4.3 预检器)