feat/defender-integration
main
iOSGuard 运行时防护:可集成静态库 + readoor 接入方案(检测→分级→数据毒化闭环),含本轮抗静态分析硬化与二进制完整性探针。
ig_defender_scan
if(jb)exit()
IGPoisonInline.h
bl ig_poison_*
IGAntiTamper
ig_poison_mix_key_inline
🤖 Generated with Claude Code
在 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>
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>
补齐 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>
在连接的 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>
无越狱设备下 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>
开毒化前的线上体检:实验室真机证了不误报,但线上几十万台各机型/系统, 先只打点、不毒化,用真实用户群量误报率,达标再开接入点二。 - 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>
针对「纯客户端抗静态分析」的最高性价比项落地,守在 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>
对「链接+strip 的宿主」做攻击者视角自验(nm/otool -l/-tV/strings),揪出上一版 §7.2 的反效果设计:三副本用自定义命名段 __DATA,__ig_p0/p1/p2/pd,而命名段原样留在 Mach-O load command、strip 也抹不掉——otool -l | grep __ig_p 一把定位毒化副本位置, 比匿名 BSS 更糟(等于在 header 上挂牌)。 修法:三真副本+诱饵散进一个匿名数组 g_state[12] 的非相邻下标(IG_LANE={2,7,11}、 IG_DECOY=5,其余陪衬槽),全进匿名 __bss/__data;每槽存 baseline^lane_k(i) 使各槽值 互不相同,消除「数组里几个相同的字=一组健康值」的静态 tell;mask 只读三真副本。 mask 语义不变(健康→0,毒化→非0,无分支),毒化语义测试全过。 回归守卫:tests/test_static_hardening.py 新增 test_no_telegraphing_sections, 守 .a 不再出现 __ig_/__poison 等泄漏性命名段。 另记录自验第二发现(已写进 docs/18 §7.0):四个 public 入口名 _ig_poison_* 的字样 本身泄露用途,strip -x 抹不掉,须 readoor Release 用完整 strip(style=all) 或接入层包中性名。 设备 poison_device.m 全模块 iphoneos 交叉编译 arm64 通过;全量 70 测试通过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
docs/18 §7「断边」:符号隐藏只抹掉节点名字,调用图的边 bl ig_poison_apply/mask 仍在、 可被攻击者 NOP 或把被调函数 stub 成恒等。本提交提供能内联进接入方解密 TU 的 always_inline 核心。 - defender/poison/IGPoisonInline.h(单一真源):把「读健康值→推掩码→扰动密钥」做成 always_inline。接入方在解密 TU #include 后调用 ig_poison_mix_key_inline(key,n),编译器 把这段揉进解密函数自身——反汇编里没有 bl ig_poison_* 调用边可 NOP,毒化藏进 key schedule (比后置改输出更难摘)。推荐形态:扰动 key 派生(健康→key 不变→正常解密;毒化→乱码)。 - 跨 TU 唯一共享的是数据 ig_pstate[](中性名、hidden、strip 后无符号名),是 data 重定位 非调用边。 - IGPoison.c 重构为复用该头的 core(baseline/lane_k/spread/mask/apply 只此一处定义), 库 out-of-line 入口与接入方内联路径语义等价、永不漂移;g_state 改名 ig_pstate 并提升为 hidden 全局供跨 TU 内联直读。IGVisibility.h 加 IG_ALWAYS_INLINE。 验证(tests/test_poison_inline.py,+2): - test_inline_equals_outofline(host/macosx):内联 mask/apply == 库入口,mix_key 健康恒等、 毒化扰动,逐例 0 fail。 - test_no_call_edge_after_inline(iphoneos,gate SDK):模拟解密 TU rd_derive_key 调用 mix_key,-O2 反汇编断言零 bl、仅对 ig_pstate 的 data 引用,无 ig_poison_mask/apply 符号引用。 全量 72 测试通过;poison_device.m 全模块 iphoneos 交叉编译 arm64 通过。docs/18 §7 补 7.6 接入形态。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
补 anti_hook 只盯固定函数之外的空洞,正面反制 App Store 标准破解链 (脱壳解密→patch→重签): - FairPlay cryptid(reason=500):cryptid==0 或 LC_ENCRYPTION_INFO 被剥除=脱壳/重打包 - 代码签名 csops CS_OPS_STATUS(reason=501):CS_VALID 失效/ad-hoc 重签/分发包带 get-task-allow 误报底线:两条均按 expect_encrypted/expect_distribution 构建上下文开关, dev/诊断/TestFlight 传 0→UNAVAILABLE,绝不在非分发构建误报。作为独立探针 由 Swift 策略层/observer 带构建上下文单独调用,不并入 ig_defender_scan(不破坏现有签名)。 回归:tests/test_anti_tamper.py 合成 Mach-O 头跑 cryptid 核心五例(加密正常/脱壳/ 剥除/非分发跳过/NULL);模块接入 poison_host 与 device 链接列表。全量 73 过, iphoneos arm64 交叉编译通过。csops+真实主镜像验证待设备。docs/18 §7.7。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
poison_device.m 加 D9a–d 四条环境无关不变量 + csops_status/501 两条观察, 复用 build/run_poison_device harness。实测(verdict PASS,不变量 9/9): - 误报底线:expect_*=0 → 零 DETECTED,对应 finding UNAVAILABLE - cryptid 真读主镜像:expect=1 → reason500=1(dev 包 cryptid==0),mh=0x104390000 - 整入口贯通:ig_anti_tamper_check(1,1) → 500 + 501 - csops 真机活性:rc=0 status=0x22003305 valid=1 adhoc=0 get_task_allow=1 (坐实 csops 在 iOS arm64 活着,排除 501 假阴性) 残留缺口(只能在真 App Store/TestFlight 包验):cryptid==1 正向 CLEAR + 分发签名零误触——dev profile 无法复现 FairPlay 加密/分发签名。docs/18 §7.7、docs/19 §6。 证据 test-results/step12-device-poison/20261113-antitamper-R/(gitignore)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
No dependencies set.
The note is not visible to the blocked user.
iOSGuard 运行时防护:可集成静态库 + readoor 接入方案(检测→分级→数据毒化闭环),含本轮抗静态分析硬化与二进制完整性探针。
核心
ig_defender_scan。探针只采证经 sink 上报、不自行 exit,判级交 policy。if(jb)exit()):检测污染多副本健康值→喂进 epub 解密 key 派生;健康→key 不变→正常解密,毒化→乱码。收敛、无随机崩溃,适配 App Store 上架。本轮硬化(§7)
IGPoisonInline.h:毒化 always_inline 进解密 TU,-O2 后零bl ig_poison_*调用边,消除可 NOP 的调用点。IGAntiTamper(新增):cryptid(reason 500)+ csops 代码签名(reason 501),正面反制「脱壳解密→patch→重签」破解链;按构建上下文开关(dev/诊断 UNAVAILABLE)严防误报,不并入聚合入口以免破坏现有调用方。验证
待续(不阻塞本 PR)
ig_poison_mix_key_inline(需 readoor 工程 + xcodebuild)。🤖 Generated with Claude Code
对「链接+strip 的宿主」做攻击者视角自验(nm/otool -l/-tV/strings),揪出上一版 §7.2 的反效果设计:三副本用自定义命名段 __DATA,__ig_p0/p1/p2/pd,而命名段原样留在 Mach-O load command、strip 也抹不掉——otool -l | grep __ig_p 一把定位毒化副本位置, 比匿名 BSS 更糟(等于在 header 上挂牌)。 修法:三真副本+诱饵散进一个匿名数组 g_state[12] 的非相邻下标(IG_LANE={2,7,11}、 IG_DECOY=5,其余陪衬槽),全进匿名 __bss/__data;每槽存 baseline^lane_k(i) 使各槽值 互不相同,消除「数组里几个相同的字=一组健康值」的静态 tell;mask 只读三真副本。 mask 语义不变(健康→0,毒化→非0,无分支),毒化语义测试全过。 回归守卫:tests/test_static_hardening.py 新增 test_no_telegraphing_sections, 守 .a 不再出现 __ig_/__poison 等泄漏性命名段。 另记录自验第二发现(已写进 docs/18 §7.0):四个 public 入口名 _ig_poison_* 的字样 本身泄露用途,strip -x 抹不掉,须 readoor Release 用完整 strip(style=all) 或接入层包中性名。 设备 poison_device.m 全模块 iphoneos 交叉编译 arm64 通过;全量 70 测试通过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.