Files
iOSGuard/defender/policy/IGPolicy.c
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

100 lines
3.6 KiB
C
Raw Permalink 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.
/*
* IGPolicy.c — 策略层实现。见 .h 的分级与误报底线。
*/
#include "IGPolicy.h"
#include "poison/IGPoison.h"
typedef enum { IG_TIER_IGNORE = 0, IG_TIER_WEAK, IG_TIER_MEDIUM, IG_TIER_STRONG } IGTier;
/* reason → 档位。未列出的 DETECTED 按 WEAK 处理(保守,不触发毒化)。 */
static IGTier ig_reason_tier(int reason) {
switch (reason) {
/* STRONG:单条即可判定(误报概率极低) */
case IG_REASON_JAILBREAK_SANDBOX: /* 401 沙盒逃逸 */
case IG_REASON_JAILBREAK_FILE: /* 400 越狱特征文件 */
case IG_REASON_GOT_REBIND: /* 102 */
case IG_REASON_INLINE_HOOK: /* 101 */
case IG_REASON_INJECTED_IMAGE: /* 200 */
case IG_REASON_DEBUGGER_ATTACHED: /* 300 */
return IG_TIER_STRONG;
/* MEDIUM:需组合(含合法 swizzling 会误报的 ObjC IMP) */
case IG_REASON_SYMBOL_PROVENANCE: /* 100 */
case IG_REASON_OBJC_IMP_CHANGED: /* 110 */
case IG_REASON_FRIDA_THREAD: /* 203 */
return IG_TIER_MEDIUM;
/* WEAK:仅观察,永不触发毒化 */
case IG_REASON_FOREIGN_IMAGE: /* 201 */
case IG_REASON_FRIDA_PORT: /* 204 */
return IG_TIER_WEAK;
default:
return IG_TIER_WEAK;
}
}
void ig_policy_reset(IGPolicyState *st, IGFindingSink observer, void *observer_ctx) {
if (!st) return;
st->strong_count = 0;
st->medium_bitmap = 0;
st->medium_distinct = 0;
st->entropy = 0;
st->detected_total = 0;
st->observer = observer;
st->observer_ctx = observer_ctx;
}
/* 把 reason 映射到 medium_bitmap 的一个位(三个 MEDIUM reason 分别占位)。 */
static uint32_t ig_medium_bit(int reason) {
switch (reason) {
case IG_REASON_SYMBOL_PROVENANCE: return 1u << 0;
case IG_REASON_OBJC_IMP_CHANGED: return 1u << 1;
case IG_REASON_FRIDA_THREAD: return 1u << 2;
default: return 0u;
}
}
int ig_policy_sink(const IGFinding *f, void *ctx) {
IGPolicyState *st = (IGPolicyState *)ctx;
if (!st || !f) return 0;
/* 先转发观察打点(无论档位),便于量化误报面。 */
if (st->observer) st->observer(f, st->observer_ctx);
/* 误报底线:只有 DETECTED 参与判定;UNAVAILABLE/CLEAR 忽略。 */
if (f->status != IG_DETECTED) return 0;
st->detected_total++;
IGTier tier = ig_reason_tier(f->reason);
if (tier == IG_TIER_STRONG) {
st->strong_count++;
st->entropy ^= 0x100000001b3ULL * (uint64_t)(f->reason + 1);
} else if (tier == IG_TIER_MEDIUM) {
uint32_t bit = ig_medium_bit(f->reason);
if (bit && !(st->medium_bitmap & bit)) {
st->medium_bitmap |= bit;
st->medium_distinct++;
}
st->entropy ^= 0x100000001b3ULL * (uint64_t)(f->reason + 1);
}
/* WEAK/IGNORE:不计入判定,也不进熵。 */
return 0;
}
int ig_policy_evaluate_and_mark(IGPolicyState *st) {
if (!st) return 0;
int trigger = (st->strong_count >= 1) || (st->medium_distinct >= 2);
if (trigger) {
uint64_t e = st->entropy ? st->entropy : 0xA24BAED4963EE407ULL;
ig_poison_mark(e);
return 1;
}
return 0;
}
int ig_policy_scan_and_mark(const char *bundle_path, int probe_port,
IGFindingSink observer, void *observer_ctx) {
IGPolicyState st;
ig_policy_reset(&st, observer, observer_ctx);
ig_defender_scan(bundle_path, probe_port, ig_policy_sink, &st);
return ig_policy_evaluate_and_mark(&st);
}