Files
iOSGuard/README.md
T
shenleiandClaude Opus 4.8 599e1da5ce feat(defender): 可集成静态库 + readoor 接入方案(检测→分级→数据毒化闭环)
在 iOSGuard 侧产出可集成产物与接入文档,不修改 readoor 代码。

- defender/: anti_hook/anti_frida/anti_debug/anti_jailbreak 探针 + syscall 直发、
  policy 分级层、poison 数据依赖毒化、dispatch/resolve/call_bridge 等子模块
- poison: 三副本冗余、无分支掩码;健康恒等、毒化破坏 key(替代 if-exit 处置)
- policy: STRONG/MEDIUM/WEAK 分级,守误报底线,仅 DETECTED 参与、组合命中才毒化
- anti_jailbreak: IGSyscall 直发 svc 检测越狱文件(400)/沙盒逃逸(401),绕 libc hook
- tools/build_defender_lib.sh: 一键交叉编译打包 libIGDefender.a(arm64) + umbrella 头
- docs/18_READOOR_DEFENDER_INTEGRATION.md: 精确到文件/bridging/替换点/代码片段
- docs/05-17 + evidence + tests + macho_guard/static_sdk_redirect 工具链

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-12 22:16:47 +09:00

95 lines
9.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# iOSGuard - 企业级 iOS 加固与安全防护系统
> **反 HOOK 正向验证(2026-11-12)**:step11 真机 HOOK 正向验证完成,11/11 用例通过:真实 GOT 重绑定(fishhook 同款)、蹦床序言(B/LDR+BR)、frida 特征线程名、Documents 注入 dylib、ObjC 方法 IMP 基线替换在 iPhone 16 Plus(iOS 27.2,非越狱)全部命中对应 reason;DYLD_INSERT_LIBRARIES 真实 dyld 注入双命中 202+200。同轮新增调试器跟踪探针(reason=300)与 ObjC IMP 基线探针(reason=110)并接入聚合扫描。宿主测试 62 项通过。见 [真机 HOOK 正向验证](docs/17_DEVICE_HOOK_POSITIVE_VERIFICATION.md)。同日完成 readoor-test Swift 策略层整改(110/300 分级、越狱终止改经策略统一处置、debuggerDetected 接入探针证据)与登录/VIP/激活敏感入口门禁推广,构建通过;随后完成业务 App 内 C 探针副本同步(IGObjCBaseline 入副本与聚合接线,IGSyscall/IGAntiDebug 按合规物理排除)、Swift 侧 ObjC 基线登记(模块前缀解析,2/2 登记)与真机双向业务验证:干净启动零误报,DYLD_INSERT 真实注入双命中 202+200 判「加固锁定」且进程按白名单存活(证据 docs/evidence/20261112-readoor-inject-console.log)。强制模式各入口按钮级拦截回归仍待执行。
> **观察包进度(2026-11-11)**:SSZipArchive 动态绑定保护试点已在指定词书真机解压中命中四个文件函数,874 次转发无拒绝,9 个输出文件的聚合摘要与同构建基线一致,页面、正常缓存、返回重进及前后台恢复通过。59 项宿主/工具测试通过;真机攻击正向验证尚未完成。PDF 修复、完整业务回归和报告复测继续暂缓。见 [SSZipArchive 保护试点](docs/16_SSZIPARCHIVE_FRAMEWORK_GUARD_PILOT.md)。
> **当前状态(2026-11-10)**:已完成 ZipZap `write/close` 三层防护试点:链接后定点改写、运行时解析与间接调用、Defender 调度完整性检查。`readoor31` Release 构建、44 项自动化测试及 8 项独立真机诊断通过,本轮两处改写后整包直接调用为 558→556。详见 [三层试点与证据](docs/14_ZIPZAP_RUNTIME_DISPATCH_PILOT.md)。前一轮 v2.199.0 IPA 的 28 项测试与 878→0 仍保留为[独立基线](docs/13_REPRODUCIBLE_BASELINE.md),两轮产物不同。**尚未完成完整 App 真机业务回归和 V4.6.6 复测**;不能宣称报告问题全部解决。下文能力表仍属于规划,不代表各项均已实现或验证。
>
> **当前主线**:面向 iOS App 反 Hook 与安全加固,以 readoor 的 ECNUP 外语安全报告为首个验收案例。报告分析、源码核查、实施顺序及复测标准见 [readoor 漏洞报告分析与加固实施方案](docs/05_READOOR_SECURITY_REMEDIATION_PLAN.md)。当前优先级以该方案为准;既有文档中的审核差异化、VMP、元数据重构等内容保留为远期研究。
[![Platform](https://img.shields.io/badge/Platform-iOS%20%7C%20macOS%20%7C%20Linux-blue.svg)](https://developer.apple.com/ios/)
[![License](https://img.shields.io/badge/License-Proprietary-red.svg)]()
[![Architecture](https://img.shields.io/badge/Arch-ARM64%20%7C%20LLVM-orange.svg)]()
> **iOSGuard** 是一套融合了 **小蟹加固 (Crab iOS)** 与 **网易易盾 (NetEase YiDun)** 核心能力的企业级 iOS 应用安全加固与对抗系统。
> 支持 **“源码工程编译期深度混淆”** 与 **“无源码 IPA 纯二进制后处理加固”** 双模形态,满足 App Store 审核对抗(防 4.3 / 2.3.1 拒审)、核心代码防逆向防反编译、反外挂反调试、游戏与核心资产保护等多维需求。
---
## 🌟 核心特性概览
| 模块 | 核心能力 | 对标产品 |
| :--- | :--- | :--- |
| **Mach-O 深度重构** | Header 动态扩容、段全局平移、`LC_LOAD_DYLIB` 守护库注入、0x4000 严格页面对齐 | 网易易盾 / 顶象 |
| **Class-Dump 彻底防御** | 抹除 `__objc_methname`、`__objc_classname`,动态解密重构 `class_rw_t` | 网易易盾 / 爱加密 |
| **原生代码虚拟化 (VMP)** | ARM64 汇编抽离、私有紧凑字节码转换、合规纯解释型虚拟机(不破坏 W^X) | 网易易盾 / 梆梆安全 |
| **LLVM 编译加固 Pass** | 控制流平坦化 (Fla)、虚假控制流 (BCF)、常量字符串动态加密、调用栈蹦床代理 | 小蟹加固 / OLLVM / Hikari |
| **全维度主动防御 (Defender)** | 内联汇编 SVC 0x80 反调试、ARM64 硬件断点 (DR0-DR7) 探测、反 Frida、反 Inline/GOT Hook、沙盒越狱感知 | 网易易盾 |
| **双符号表与崩溃还原** | 编译期记录 `mapping.db`,重构 DWARF 调试节,无缝兼容 Bugly / Sentry / Crashlytics | 小蟹加固 |
| **资产与游戏安全** | 免加密文件 Hash 扰动、ChaCha20 流式透明解密、Unity `global-metadata.dat` 与 Cocos Lua/JS 保护 | 小蟹加固 / 网易易盾 |
| **跨平台自动化重签名** | 支持 macOS (`codesign`) 与 Linux/Docker (`zsign` 改造内核),强制支持 iOS 15+ DER 规范 | 企业自动化流水线 |
| **4.3 审核预检分析器** | 基于 SSDEEP 模糊哈希的 Mach-O 机器码比对、符号集 Jaccard 相似度、图片 pHash 差异度评分 | 小蟹加固 |
---
## 📂 项目模块结构
```
iOSGuard/
├── docs/ # 详细设计与实现方案文档
│ ├── 01_ROADMAP.md # 小蟹加固路线与技术全景
│ ├── 02_SECURITY_ARCHITECTURE.md # 易盾级安全加固架构深度剖析
│ └── 03_COMPLETE_IMPLEMENTATION_PLAN.md # 完整工程实现蓝图与技术规范
├── core/ # 核心 C/C++ 跨平台加固引擎
│ ├── macho/ # Mach-O 解析与重构器 (Header扩容 / 段平移 / 对齐)
│ ├── metadata/ # Objective-C 元数据清洗与加密 (防 Class-Dump)
│ ├── vmp/ # 原生代码虚拟化编译器与虚拟机解释引擎
│ └── signer/ # 跨平台重签名核心 (基于 zsign 扩展,支持 DER)
├── defender/ # 注入的运行时防护库源码 (输出 libDefender.dylib)
│ ├── anti_debug/ # 内联汇编 SVC 系统调用反调试、硬件断点轮询
│ ├── anti_hook/ # Inline Hook 前向指令探测、Dyld GOT 范围校验
│ ├── anti_frida/ # Frida 端口探测、线程扫描、动态库匹配
│ ├── anti_jailbreak/ # 沙盒感知、fork 检测、特征路径探测
│ └── vfs_crypto/ # 资源透明解密 Hook (open/read/imageNamed)
├── llvm-plugins/ # 源码加固 LLVM Pass (集成至 Xcode 自定义 Toolchain)
│ ├── Flattening/ # 控制流平坦化 Pass
│ ├── BogusControlFlow/ # 虚假控制流 Pass
│ ├── StringEncryption/ # 常量字符串加密 Pass
│ └── CallStackObfuscate/ # 调用栈伪装与蹦床代理 Pass
├── tools/ # 辅助工具链
│ ├── dsym_restorer/ # dSYM 崩溃逆向还原工具 (DWARF 重写)
│ ├── ipa_diff_analyzer/ # IPA 4.3 相似度静态评估分析器
│ └── pbx_injector/ # Xcode 工程配置与 Build Phase 自动化注入脚本
├── cli/ # 命令行终端工具
└── README.md # 本文件
```
---
## 📖 技术文档导航
详细技术实现细节与数学/算法推导请参阅 `docs/` 目录:
1. **[小蟹路线与技术全景](docs/01_ROADMAP.md)**:包含符号策略、资源 Hash 扰动、COSDK 运行时反射修复与 dSYM 崩溃还原体系。
2. **[易盾安全防护架构方案](docs/02_SECURITY_ARCHITECTURE.md)**:包含代码虚拟化 (VMP)、全维度主动防御底层汇编、游戏资产防护与白盒加密。
3. **[完整工程实现蓝图](docs/03_COMPLETE_IMPLEMENTATION_PLAN.md)**:包含八大子系统详细设计规范、Mach-O 段平移算法、跨平台签名时序与里程碑规划。
---
## 🚀 研发里程碑规划
- **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 提审合规 (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 提审解签正常。