Files
iOSGuard/tools/macho_guard/build_poison_device.py
T
shenleiandClaude Opus 4.8 3503a24bd4 test(defender): 处置链真机验证诊断进程 + 构建/执行器(step12)
补齐 docs/19 的真机 harness,交叉编译通过(iphoneos arm64),待设备执行。

- tests/fixtures/poison_device.m:真机诊断进程。D4–D7 环境无关不变量
  (apply恒等/mark坏key/构造期mask=0/策略分级)输出 IG_POISON_CASE 作套件门槛;
  D1–D3 环境相关(聚合扫描/越狱文件400/沙盒逃逸401)输出 OBS + IG_POISON_ENV
  环境判定,供 R/J 组对照判定。只被动探测,不自造越狱文件,每例 ig_poison_init 复位。
- tools/macho_guard/build_poison_device.py:照 hook 版,模块含 poison/policy/
  anti_jailbreak,专用 Bundle 前缀 poisonpilot、通配开发 profile 校验、源码快照哈希。
- tools/macho_guard/run_poison_device.py:单相位安装→启动→卸载→证据哈希;
  --expect clean|jailbroken 自动校验 R 组 jailbroken=no / J 组命中 400/401。
- docs/19 §2/§3/§6 更新为“已建、交叉编译通过、待真机执行”。

全套 63 项宿主/工具测试通过。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-11-12 22:43:03 +09:00

119 lines
5.6 KiB
Python
Executable File
Raw 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.
#!/usr/bin/env python3
"""构建处置链真机验证诊断 App(step12,见 docs/19)。
验证 poison/policy/anti_jailbreak 这条「检测→分级→数据毒化」链在真机的行为。
只支持匹配的 wildcard 开发 profile,专用 Bundle ID 前缀避免复用业务标识;
构建后不安装、不更新开发者门户。诊断进程只被动探测,不含注入/攻击构造 dylib。
"""
import argparse
import datetime
import hashlib
import json
from pathlib import Path
import plistlib
import shutil
import subprocess
ROOT = Path(__file__).resolve().parents[2]
BUNDLE_PREFIX = 'cn.touchv.iosguard.poisonpilot.'
def command(args, log: Path, label: str):
r = subprocess.run(list(map(str, args)), capture_output=True, text=True)
with log.open('a') as f:
f.write(f'== {label} ==\n' + json.dumps(list(map(str, args))) + '\n'
+ r.stdout + r.stderr + f'\nexit={r.returncode}\n')
if r.returncode:
raise RuntimeError(f'{label} 失败,详见 build.log')
return r
def build(profile, identity, bundle, output):
output = output.resolve()
if output.exists():
raise ValueError('输出目录必须不存在')
r = subprocess.run(['openssl', 'smime', '-inform', 'der', '-verify', '-noverify',
'-in', str(profile)], capture_output=True, check=True)
data = plistlib.loads(r.stdout)
ent = data['Entitlements']
team = data['TeamIdentifier'][0]
prefix = data['ApplicationIdentifierPrefix'][0]
if ent['application-identifier'] != prefix + '.*' or not ent.get('get-task-allow'):
raise ValueError('需要通配开发 profile,避免复用现有业务 Bundle ID')
if data['ExpirationDate'] <= datetime.datetime.now(datetime.timezone.utc).replace(tzinfo=None):
raise ValueError('profile 已过期')
if identity.upper() not in {hashlib.sha1(c).hexdigest().upper()
for c in data['DeveloperCertificates']}:
raise ValueError('identity 不属于指定 profile')
if not bundle.startswith(BUNDLE_PREFIX):
raise ValueError(f'诊断 Bundle ID 必须使用专用前缀 {BUNDLE_PREFIX}')
output.mkdir(parents=True)
blog = output / 'build.log'
source = output / 'source-snapshot'
inputs = [*list((ROOT / 'defender').rglob('*.c')),
*list((ROOT / 'defender').rglob('*.h')),
ROOT / 'tests/fixtures/poison_device.m',
Path(__file__)]
hashes = {}
for p in inputs:
dest = source / p.relative_to(ROOT)
dest.parent.mkdir(parents=True, exist_ok=True)
shutil.copy2(p, dest)
hashes[str(p.relative_to(ROOT))] = hashlib.sha256(p.read_bytes()).hexdigest()
app = output / 'IGPoisonPilot.app'
app.mkdir()
info = dict(CFBundleExecutable='IGPoisonPilot', CFBundleIdentifier=bundle,
CFBundleName='IGPoisonPilot', CFBundleDisplayName='IG Poison Test',
CFBundlePackageType='APPL', CFBundleVersion='1',
CFBundleShortVersionString='1.0', MinimumOSVersion='15.0',
LSRequiresIPhoneOS=True, UIDeviceFamily=[1, 2], UILaunchScreen={})
(app / 'Info.plist').write_bytes(plistlib.dumps(info))
common = ['xcrun', '--sdk', 'iphoneos', 'clang', '-arch', 'arm64',
'-miphoneos-version-min=15.0', '-O2',
'-I', source / 'defender', '-I', source / 'defender/include']
# 处置链 + 其依赖的聚合扫描全套模块(ig_policy_scan_and_mark → ig_defender_scan)。
modules = ['poison/IGPoison.c', 'policy/IGPolicy.c',
'anti_jailbreak/IGAntiJailbreak.c', 'syscall/IGSyscall.c',
'IGDefender.c', 'anti_hook/IGAntiHook.c', 'anti_hook/IGObjCBaseline.c',
'anti_frida/IGAntiInject.c', 'anti_debug/IGAntiDebug.c',
'resolve/IGResolve.c', 'dispatch/IGDispatch.c',
'dispatch/IGArchiveGuard.c', 'call_bridge/IGFileBridge.c']
objects = []
for i, module in enumerate(modules):
obj = output / f'{i}.o'
command(common + ['-c', source / 'defender' / module, '-o', obj], blog, f'compile {module}')
objects.append(obj)
command(common + ['-fobjc-arc', source / 'tests/fixtures/poison_device.m', *objects,
'-framework', 'UIKit', '-framework', 'Foundation',
'-lobjc', '-o', app / 'IGPoisonPilot'],
blog, 'link app')
shutil.copy2(profile, app / 'embedded.mobileprovision')
allowed = {k: v for k, v in ent.items()
if k not in ('application-identifier', 'keychain-access-groups')}
allowed.update({'application-identifier': prefix + '.' + bundle,
'keychain-access-groups': [prefix + '.' + bundle]})
(output / 'entitlements.plist').write_bytes(plistlib.dumps(allowed))
command(['codesign', '--force', '--sign', identity,
'--entitlements', output / 'entitlements.plist', app], blog, 'sign app')
command(['codesign', '--verify', '--strict', '--verbose=2', app], blog, 'verify app')
(output / 'manifest.json').write_text(json.dumps(
dict(bundle_id=bundle, team=team, profile_name=data['Name'],
source_hashes=hashes, signing='development',
device_validation='not_run'), ensure_ascii=False, indent=2) + '\n')
print(app)
if __name__ == '__main__':
p = argparse.ArgumentParser(description=__doc__)
p.add_argument('--profile', type=Path, required=True)
p.add_argument('--identity', required=True)
p.add_argument('--bundle-id', required=True)
p.add_argument('--output', type=Path, required=True)
a = p.parse_args()
build(a.profile, a.identity, a.bundle_id, a.output)