Files
iOSGuard/tools/build_defender_lib.sh
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

81 lines
3.6 KiB
Bash
Executable File
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.
#!/bin/sh
# build_defender_lib.sh — 把 defender/ 全部 C 源交叉编译并打包成可集成静态库。
#
# 产物(默认输出到 dist/):
# dist/lib/libIGDefender.a arm64 iphoneos 静态库
# dist/include/IGGuard.h 统一公共头(umbrella)
# dist/include/... 随附的全部公共头(保持相对目录,供 IGGuard.h 相对引用)
#
# 用法:
# sh tools/build_defender_lib.sh [输出目录]
# sh tools/build_defender_lib.sh # → ./dist
# sh tools/build_defender_lib.sh /path/to/out # → 指定目录
#
# 接入方式见 docs/18_READOOR_DEFENDER_INTEGRATION.md。
set -eu
ROOT=$(cd "$(dirname "$0")/.." && pwd)
OUT=${1:-"$ROOT/dist"}
SDK=iphoneos
ARCH=arm64
MINVER=15.0
# -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
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"
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…"
mkdir -p "$OUT/lib" "$OUT/include"
xcrun -sdk "$SDK" ar rcs "$OUT/lib/libIGDefender.a" "$OBJDIR"/*.o
xcrun -sdk "$SDK" ranlib "$OUT/lib/libIGDefender.a"
echo "[3/4] 拷贝公共头…"
# 单一 HEADER_SEARCH_PATH=<out>/include 即自洽:
# - defender/include/ 下的头(IGGuard.h / IGDefender.h …)平移到 include 根
# - 其余子目录头(poison/ policy/ syscall/ …)保持相对目录,供 umbrella 相对引用
( cd "$ROOT/defender" && \
find . -name '*.h' | sed 's|^\./||' | sort -u | while read -r h; do
case "$h" in
include/*) dst="${h#include/}" ;; # include/ 下平移到根
*) dst="$h" ;;
esac
mkdir -p "$OUT/include/$(dirname "$dst")"
cp "$ROOT/defender/$h" "$OUT/include/$dst"
done )
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"