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>
This commit is contained in:
shenlei
2026-11-13 10:47:35 +09:00
co-authored by Claude Opus 4.8
parent 60d868a351
commit b76d7cdc21
14 changed files with 531 additions and 70 deletions
+28 -5
View File
@@ -19,7 +19,19 @@ OUT=${1:-"$ROOT/dist"}
SDK=iphoneos
ARCH=arm64
MINVER=15.0
CFLAGS="-arch $ARCH -miphoneos-version-min=$MINVER -O2 -Wall -Wextra -I$ROOT/defender -I$ROOT/defender/include"
# -fvisibility=hidden(§7 抗静态调用关系):默认隐藏所有符号,只有头里标 IG_PUBLIC 的
# 入口导出;内部的 ig_poison_mark/mask、ig_policy_* 等成为 private extern,接入方最终
# 链接 + strip 后从符号表消失,nm 再也捞不到名字。
CFLAGS="-arch $ARCH -miphoneos-version-min=$MINVER -O2 -Wall -Wextra -fvisibility=hidden -I$ROOT/defender -I$ROOT/defender/include"
# §7.3 OLLVM/VMP 钩子(默认不启用):设 IG_OBFUSCATOR=/path/to/ollvm-clang 时,用它编译
# 毒化/策略两个敏感 TU 并附加 Fla/BCF/Sub 混淆;未设则用 stock clang,不做混淆(如实)。
OBF_CC=${IG_OBFUSCATOR:-}
OBF_FILES="defender/poison/IGPoison.c defender/policy/IGPolicy.c"
OBF_FLAGS="-mllvm -fla -mllvm -bcf -mllvm -sub"
# 先让 §7.1 混淆表与路径清单保持同步(CI 口径:不一致即失败)。
python3 "$ROOT/tools/gen_jb_paths.py" --check
OBJDIR=$(mktemp -d)
trap 'rm -rf "$OBJDIR"' EXIT
@@ -27,7 +39,13 @@ trap 'rm -rf "$OBJDIR"' EXIT
echo "[1/4] 交叉编译 ($SDK/$ARCH)…"
find "$ROOT/defender" -name '*.c' | while read -r f; do
o="$OBJDIR/$(echo "$f" | sed "s|$ROOT/||; s|/|_|g").o"
xcrun -sdk "$SDK" clang $CFLAGS -c "$f" -o "$o"
rel=${f#"$ROOT/"}
if [ -n "$OBF_CC" ] && echo "$OBF_FILES" | grep -qw "$rel"; then
echo " [obf] $rel"
xcrun -sdk "$SDK" "$OBF_CC" $CFLAGS $OBF_FLAGS -c "$f" -o "$o"
else
xcrun -sdk "$SDK" clang $CFLAGS -c "$f" -o "$o"
fi
done
echo "[2/4] 打包 libIGDefender.a…"
@@ -49,9 +67,14 @@ echo "[3/4] 拷贝公共头…"
cp "$ROOT/defender/$h" "$OUT/include/$dst"
done )
echo "[4/4] 校验导出符号…"
xcrun -sdk "$SDK" nm "$OUT/lib/libIGDefender.a" 2>/dev/null \
| grep -E ' T _ig_(policy_scan_and_mark|poison_apply|poison_init|defender_scan)' | sort -u || true
echo "[4/4] 校验可见性(§7):公共入口导出(T)、内部符号已私有化…"
echo " — 导出入口(应为 IG_PUBLIC 四个):"
xcrun -sdk "$SDK" nm -g "$OUT/lib/libIGDefender.a" 2>/dev/null \
| grep -E ' T _ig_(policy_scan_and_mark|poison_apply|poison_init|defender_scan)$' | sort -u || true
echo " — 内部符号可见性(应标 private external,最终 strip 后消失):"
xcrun -sdk "$SDK" nm -m "$OUT/lib/libIGDefender.a" 2>/dev/null \
| grep -E '_ig_(poison_mark|poison_mask|policy_sink|policy_evaluate_and_mark|anti_jb_check)$' \
| sed 's/^/ /' | sort -u | head -20 || true
echo "完成:$OUT/lib/libIGDefender.a ($(lipo -archs "$OUT/lib/libIGDefender.a"))"
echo "公共头:$OUT/include/IGGuard.h"
+137
View File
@@ -0,0 +1,137 @@
#!/usr/bin/env python3
"""gen_jb_paths.py — 生成越狱特征路径的 XOR 混淆表(docs/18 §7.1 IG_ENC)。
越狱路径常量(/var/jb、Cydia、substrate…)若明文入二进制,`strings` 一把捞出,
等于把检测目标白送。本脚本把每条路径按位置相关的 keystream 异或编码,产出
defender/anti_jailbreak/IGJailbreakPaths.inc;运行期由 IGAntiJailbreak.c 解码进
栈缓冲、用完擦除,二进制里不再驻留明文。
路径清单以本脚本为唯一真源;改清单后重跑本脚本重生成 .inc(可复现)。
python3 tools/gen_jb_paths.py # 写回 .inc
python3 tools/gen_jb_paths.py --check # 只校验 .inc 与当前清单一致(CI 用)
"""
import argparse
from pathlib import Path
import sys
ROOT = Path(__file__).resolve().parents[1]
INC = ROOT / 'defender/anti_jailbreak/IGJailbreakPaths.inc'
INC_INJ = ROOT / 'defender/anti_frida/IGInjectSignatures.inc'
# keystream: enc[j] = plain[j] ^ ((K0 + idx*K1 + j*K2) & 0xFF)。解码端须完全一致。
K0, K1, K2 = 0x5A, 0x2F, 0x13
# anti_frida 用一组不同常量(defense in depth,两表不共享 keystream)。
IK0, IK1, IK2 = 0x3C, 0x47, 0x1D
# 已知注入/调试/越狱增强框架镜像名子串(小写,ig_strstr 子串匹配)。
INJECT = [
"frida", "gadget", "cynject", "cycript", "libcycript",
"substrate", "substitute", "libsubstrate", "tweakinject",
"rocketbootstrap", "reveal", "flexloader", "libhooker",
"shadowhook", "dobby", "fishhook",
]
# 已知 frida 线程名(精确匹配)。
THREADS = [
"gum-js-loop", "gmain", "gdbus", "pool-frida", "pool-spawner", "linjector",
]
# 内置 iOS 越狱特征(强信号)。rootless 越狱重点在 /var/jb。
PATHS = [
"/var/jb",
"/Applications/Cydia.app",
"/Applications/Sileo.app",
"/Applications/Zebra.app",
"/usr/sbin/sshd",
"/usr/bin/ssh",
"/bin/bash",
"/bin/sh",
"/etc/apt",
"/private/var/lib/apt",
"/usr/lib/substrate",
"/Library/MobileSubstrate/MobileSubstrate.dylib",
"/usr/lib/TweakInject",
]
# 沙盒外探测路径(能创建即沙盒逃逸)。
PROBE = "/private/.ig_jb_probe"
def encode(s: str, idx: int, k0=K0, k1=K1, k2=K2) -> list:
return [(ord(c) ^ ((k0 + idx * k1 + j * k2) & 0xFF)) & 0xFF for j, c in enumerate(s)]
def arr(name: str, data: list) -> str:
body = ', '.join('0x%02x' % b for b in data)
return f'static const unsigned char {name}[] = {{ {body} }};'
def render() -> str:
out = []
out.append('/* IGJailbreakPaths.inc — 由 tools/gen_jb_paths.py 生成,请勿手改。 */')
out.append('/* 越狱路径 XOR 混淆表(§7.1):enc[j]=plain[j]^((K0+idx*K1+j*K2)&0xFF)。 */')
out.append(f'#define IG_JB_XOR_K0 0x{K0:02x}u')
out.append(f'#define IG_JB_XOR_K1 0x{K1:02x}u')
out.append(f'#define IG_JB_XOR_K2 0x{K2:02x}u')
out.append('')
for i, p in enumerate(PATHS):
out.append(arr(f'kIGJbEnc{i}', encode(p, i)) + f' /* len={len(p)} */')
out.append('')
rows = ', '.join(f'{{ kIGJbEnc{i}, {len(p)} }}' for i, p in enumerate(PATHS))
out.append('static const struct { const unsigned char *b; unsigned char n; } '
f'kIGJbEnc[] = {{ {rows} }};')
out.append(f'#define IG_JB_ENC_COUNT {len(PATHS)}')
out.append('')
out.append('/* 沙盒逃逸探测路径(idx 用一个与上表不冲突的独立下标)。 */')
probe_idx = 0xA5
out.append(arr('kIGJbProbeEnc', encode(PROBE, probe_idx)) + f' /* len={len(PROBE)} */')
out.append(f'#define IG_JB_PROBE_LEN {len(PROBE)}')
out.append(f'#define IG_JB_PROBE_IDX 0x{probe_idx:02x}')
out.append('')
return '\n'.join(out) + '\n'
def render_inject() -> str:
out = []
out.append('/* IGInjectSignatures.inc — 由 tools/gen_jb_paths.py 生成,请勿手改。 */')
out.append('/* 注入/Frida 特征串 XOR 混淆表(§7.1):enc[j]=plain[j]^((K0+idx*K1+j*K2)&0xFF)。 */')
out.append(f'#define IG_INJ_XOR_K0 0x{IK0:02x}u')
out.append(f'#define IG_INJ_XOR_K1 0x{IK1:02x}u')
out.append(f'#define IG_INJ_XOR_K2 0x{IK2:02x}u')
out.append('')
for i, s in enumerate(INJECT):
out.append(arr(f'kIGInjEnc{i}', encode(s, i, IK0, IK1, IK2)) + f' /* len={len(s)} */')
rows = ', '.join(f'{{ kIGInjEnc{i}, {len(s)} }}' for i, s in enumerate(INJECT))
out.append('static const struct { const unsigned char *b; unsigned char n; } '
f'kIGInjEnc[] = {{ {rows} }};')
out.append(f'#define IG_INJ_ENC_COUNT {len(INJECT)}')
out.append('')
for i, s in enumerate(THREADS):
out.append(arr(f'kIGThrEnc{i}', encode(s, i, IK0, IK1, IK2)) + f' /* len={len(s)} */')
rows = ', '.join(f'{{ kIGThrEnc{i}, {len(s)} }}' for i, s in enumerate(THREADS))
out.append('static const struct { const unsigned char *b; unsigned char n; } '
f'kIGThrEnc[] = {{ {rows} }};')
out.append(f'#define IG_THR_ENC_COUNT {len(THREADS)}')
out.append('')
return '\n'.join(out) + '\n'
def main():
ap = argparse.ArgumentParser(description=__doc__)
ap.add_argument('--check', action='store_true', help='只校验,不写回')
a = ap.parse_args()
outputs = [(INC, render(), f'{len(PATHS)} 条路径 + probe'),
(INC_INJ, render_inject(), f'{len(INJECT)} 注入特征 + {len(THREADS)} 线程名')]
if a.check:
for path, text, _ in outputs:
cur = path.read_text() if path.exists() else ''
if cur != text:
print(f'{path.name} 与当前清单不一致,请重跑 gen_jb_paths.py', file=sys.stderr)
sys.exit(1)
print('ok: 混淆表 .inc 与清单一致')
return
for path, text, note in outputs:
path.write_text(text)
print(f'已写 {path.relative_to(ROOT)}({note})')
if __name__ == '__main__':
main()
+1
View File
@@ -53,6 +53,7 @@ def build(profile, identity, bundle, output):
source = output / 'source-snapshot'
inputs = [*list((ROOT / 'defender').rglob('*.c')),
*list((ROOT / 'defender').rglob('*.h')),
*list((ROOT / 'defender').rglob('*.inc')), # §7.1 混淆表(.inc),否则快照编译缺头
ROOT / 'tests/fixtures/poison_device.m',
Path(__file__)]
hashes = {}