针对「纯客户端抗静态分析」的最高性价比项落地,守在 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>
81 lines
3.6 KiB
Bash
Executable File
81 lines
3.6 KiB
Bash
Executable File
#!/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"
|