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