在 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>
100 lines
3.6 KiB
C
100 lines
3.6 KiB
C
/*
|
||
* 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);
|
||
}
|