Commit Graph
11 Commits
Author SHA1 Message Date
shenleiandClaude Opus 4.8 b76d7cdc21 harden(defender): docs/18 §7 抗静态分析硬化(符号隐藏/串混淆/副本分散/基线派生)
针对「纯客户端抗静态分析」的最高性价比项落地,守在 tests/test_static_hardening.py(6 条,gate 于 iphoneos SDK):

- 符号隐藏 + strip(§7.0 新增):IGVisibility.h 定 IG_INTERNAL=hidden,全库
  -fvisibility=hidden;仅四入口 ig_defender_scan/ig_poison_init/ig_poison_apply/
  ig_policy_scan_and_mark 标 IG_PUBLIC 保持导出,其余 ig_* 变 private external,
  链接后 strip -x 彻底消失——攻击者 nm 不再能按名定位 ig_poison_mark/mask 去 NOP。
- §7.1 串混淆:gen_jb_paths.py(唯一真源)生成 IGJailbreakPaths.inc /
  IGInjectSignatures.inc(XOR keystream,两表不共享 key),运行期解码进栈、用完擦除;
  decode 内 volatile key 屏障阻止 -O2 把常量折叠回 __const 明文。strings 已捞不到
  /var/jb、Cydia、substrate、gum-js-loop 等。--check 守 .inc 与清单同步。
- §7.2 副本分散:g_h0/h1/h2 置于不相邻命名段 __DATA,__ig_p0/p1/p2,加 __ig_pd 诱饵
  (mask 不读);刻意不用 TLS(会破坏跨线程毒化一致性)。
- §7.4 基线派生:删硬编码 0xA5C3F10E7B2D4968,改 ig_poison_baseline() 由拆分种子经
  volatile 屏障派生;otool -tV 已无旧魔数立即数。
- §7.3 OLLVM/VMP:仅留 build 的 IG_OBFUSCATOR hook,stock clang 无能力,需另备工具链(未完成)。
- §7.5 越狱设备正向验证仍阻塞(无设备)。

构建/快照同步:build_defender_lib.sh 加 -fvisibility=hidden + gen --check + IG_OBFUSCATOR
hook;build_poison_device.py 快照纳入 *.inc。全量 69 测试通过;poison_device.m 全模块
iphoneos 交叉编译通过(arm64)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-13 10:47:35 +09:00
shenleiandClaude Opus 4.8 60d868a351 docs(18): 附录 A — 灰度第一步 observer 打点骨架(只观察不处置)
开毒化前的线上体检:实验室真机证了不误报,但线上几十万台各机型/系统,
先只打点、不毒化,用真实用户群量误报率,达标再开接入点二。

- A.1 C→Swift 桥接要点:@convention(c) 闭包不能捕获,状态经 observer_ctx
  (Unmanaged 指针)传入;只读 status/reason 打点,不碰 subject/evidence 字符串
  (省桥接 + 合规不输出路径)。
- A.2 RDDefenderObserver.swift 骨架:按 reason 聚合 DETECTED 计数,statLine
  只含 reason 枚举与计数(不含 Token/手机号/用户ID/订单号/路径)。
- A.3 接 RDSecurityGuard.evaluate:灰度期与现逻辑并行加一行 observeWithDefender,
  铁律——不调 ig_poison_apply、不 exit、不改业务;triggered 只进日志。
- A.4 判读与退出条件:STRONG 非越狱出现率≈0、MEDIUM 不成对、triggered 占比可解释
  三项达标 → 按 §4 开毒化。§5 加指向附录的交叉引用。

基于 readoor 现版 evaluate(event:) 与 RDOSLogManager.logStat/logInfo 实签名;
不碰 readoor 工程,落地须走其 Skill 流程 + xcodebuild。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-13 10:02:02 +09:00
shenleiandClaude Opus 4.8 4fb76ae528 test(defender): 加 D8 svc-access 真机活性验证,收窄无越狱设备缺口
无越狱设备下 J 组真实越狱文件命中无法证;但 R 组 D2 的 400=0 单看无法区分
「无越狱文件」与「svc 直发在 iOS 静默失败恒返 0」的致命假阴性。

- poison_device.m 加 D8 svc_access_live:自身沙盒建真实可访问文件喂
  ig_anti_jb_check_paths,命中即证 svc #0x80 access(2) 在真机 iOS arm64 能工作。
- iPhone 16 Plus(非越狱)实测:verdict PASS,不变量 5/5,D8 accessible_file_hits=1。
  坐实 D2 的 0 命中是真阴性(无越狱文件)而非探针坏;聚合扫描 mask=0x0 零毒化。
- docs/19 §2 补 D8 用例与价值说明,§6 记 R 组达标、J 组环境天花板与残留缺口收窄。

至此无越狱设备下的最大可得验证完成:机制真机可命中 + 非越狱零误报。
残留仅「真越狱环境端到端正向(400真文件/401沙盒逃逸)」,补越狱机即闭合。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-13 09:39:07 +09:00
shenleiandClaude Opus 4.8 d0675a4b3a docs(19): R 组真机验证达标(非越狱 iPhone 16 Plus,反向零毒化)
在连接的 iPhone 16 Plus(iPhone17,4,非越狱)实跑处置链真机验证:
run_poison_device.py --expect clean → verdict PASS。
- D4–D7 不变量 4/4:构造期 mask=0x0、apply 恒等、mark 坏 key、分级一致。
- D1 baseline_scan triggered=0 mask=0x0:非越狱聚合扫描零毒化(§4.1 核心反向门槛)。
- D2/D3 越狱探针 400=0 401=0,jailbroken=no。
证据存 test-results/step12-device-poison/20261113-R/(gitignore,不进库)。

J 组待跑:当前无越狱设备在线;harness 现成,补一台越狱机即可证正向命中 400/401。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-13 09:29:32 +09:00
shenleiandClaude Opus 4.8 3503a24bd4 test(defender): 处置链真机验证诊断进程 + 构建/执行器(step12)
补齐 docs/19 的真机 harness,交叉编译通过(iphoneos arm64),待设备执行。

- tests/fixtures/poison_device.m:真机诊断进程。D4–D7 环境无关不变量
  (apply恒等/mark坏key/构造期mask=0/策略分级)输出 IG_POISON_CASE 作套件门槛;
  D1–D3 环境相关(聚合扫描/越狱文件400/沙盒逃逸401)输出 OBS + IG_POISON_ENV
  环境判定,供 R/J 组对照判定。只被动探测,不自造越狱文件,每例 ig_poison_init 复位。
- tools/macho_guard/build_poison_device.py:照 hook 版,模块含 poison/policy/
  anti_jailbreak,专用 Bundle 前缀 poisonpilot、通配开发 profile 校验、源码快照哈希。
- tools/macho_guard/run_poison_device.py:单相位安装→启动→卸载→证据哈希;
  --expect clean|jailbroken 自动校验 R 组 jailbroken=no / J 组命中 400/401。
- docs/19 §2/§3/§6 更新为“已建、交叉编译通过、待真机执行”。

全套 63 项宿主/工具测试通过。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-12 22:43:03 +09:00
shenleiandClaude Opus 4.8 c4c9a6925a test(defender): 固化处置链宿主基线 + 真机验证协议(docs/19),修越狱聚合回归
P0 验真:真机验证前先把「检测→分级→数据毒化」闭环做成可复现宿主绿灯。

新增:
- tests/fixtures/poison_host.c + tests/test_poison_policy.py:poison/policy/
  anti_jailbreak 闭环自测 19/19(poison 恒等+坏key+不可逆、policy 分级+去重+
  mask一致、jailbreak 反向零误报+400+401),集成进 unittest 套件。
- docs/19_DISPOSITION_CHAIN_DEVICE_VERIFICATION.md:真机验证协议——R(非越狱)/
  J(越狱)两组、D1–D7 用例、验收门槛(反向零毒化为开毒化前提)、边界与进度。

修复(接越狱探针进 ig_defender_scan 聚合器时埋下的回归):
- test_defender_host.py SOURCES 漏 anti_jailbreak/IGAntiJailbreak.c → 链接缺符号。
- defender_host.c:reasons[] 由 256 扩到 512(400/401 越界漏计);clean 断言排除
  越狱文件命中(macOS 自带 Unix userland,按 iOS 标准宿主本身即“越狱”,非真实误报)。

全套 63 项宿主/工具测试通过。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-12 22:35:35 +09:00
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
shenandshen ff0aee7f47 fix(docs): resolve ASan injection overflow, correct signing order & slots, remove non-public ptrace, fix ObjC desync, and harden VMP 2026-11-09 06:25:35 -08:00
shenandshen 2191da06fa fix(docs): fix signing sequence, Mach-O padding underflow, ObjC ASLR types, VMP bounds, and refine M1 scope 2026-11-09 06:09:14 -08:00
shenandshen 948e62c22f docs: add comprehensive specification for eight core subsystems 2026-11-09 06:00:17 -08:00
shenandshen 0ea02d50d2 Initial commit: iOSGuard architecture and implementation plans 2026-11-09 05:53:26 -08:00