8.0 KiB
8.0 KiB
name, type, description, capabilities
| name | type | description | capabilities | |
|---|---|---|---|---|
| re-frida-script-author | atomic | Frida 脚本生成方法论:目标特征 → 模板选择 → 改写 → 验证。独立于执行插桩(re-frida)。 触发词:生成Frida脚本、写hook脚本、frida脚本怎么写、写个hook、脚本生成。 |
|
Frida 脚本生成
何时使用 / 何时不用
- 用:需要新脚本时——拦截(加密/网络/文件)、绕过(检测/固定)、追踪(JNI/方法调用)
- 用:现成模板没有的变体——按 re-frida/frida-scripts 模板改写出目标专用脚本
- 不用:执行现成脚本 → 转 re-frida(本技能只产出脚本,运行与进程管理在 re-frida)
- 不用:反检测对抗面整体分析 → re-analyze/anti-dynamic-workflow
- 不用:纯静态可解的问题——先走 re-apk / re-ghidra 静态路径,动态是最后手段
- 不用:目标不可达(无设备/无 root/无越狱、加固拦注入)——先解决环境(re-frida 工具准备),不硬写脚本
工具准备
frida-tools(脚本编写与运行验证)
- 推荐(upstream 路径):
python -m pip install -U frida-tools,建议用 venv 或 pipx 隔离环境 - 第三方渠道:
brew install frida等非 upstream 渠道,安装前核验版本与维护状态,不与 pip 路径等同看待 - 验证:
frida --version、frida-ps -U(连设备后) - 注意:
frida(运行时)与frida-tools(CLI)版本需配套;跨大版本升级(16 → 17)有 API 移除,写法差异见 gotchas 版本组
python3(配合脚本调试)
- 各平台同 re-python 工具准备
反编译辅助(侦察用)
目标设备/模拟器
- Android 真机/模拟器 + frida-server(至少与主机 frida 同 major,安装见 re-frida 工具准备);桌面目标直接本机
- iOS 越狱环境 frida-server 见 re-ios-jb
操作步骤
按「探 → 选 → 改 → 验」四步,先探后写,不猜。每步产物(特征清单/脚本/验证输出)记录路径 + sha256(见 re-triage),供报告引用。
-
目标侦察:
- 静态:目标包名/类名/关键 API(re-apk jadx 输出)、加固商特征(re-mobile-pack)、Flutter/RN 混合结构(re-hybrid-app)
- 动态基线:原样跑一次抓崩溃与日志(崩溃特征 → 保护机制对照,见 re-analyze/anti-dynamic-workflow)
- 产出:目标特征清单——检测点/目标 API 全限定名/输入输出形态/方法 overload 数
- 不确定的类名/方法名先小脚本枚举(
Java.enumerateLoadedClasses/Java.use(...).overloads),不猜名字 - 侦察结论记入 re-analyze/analysis-contract 契约字段(包名/类名/API 清单),供脚本与报告复用
-
模板选择:按特征清单对照 re-frida/frida-scripts 模板表:
| 目标特征 | 模板 |
|---|---|
| HTTPS 抓包被 TLS 加密(BoringSSL) | TLS 密钥日志(SSLKEYLOGFILE) |
| 证书固定挡抓包 | SSL 固定绕过(TrustManager/CertificatePinner) |
| 加密算法/密钥要提取 | 加密拦截(Cipher/SecretKeySpec 全 overload) |
| 加固/运行时解密 | DEX dump(类加载点)/ SO dump |
| 双向 TLS 客户端证书 | keystore p12 导出 |
| JNI 动态注册要还原 | RegisterNatives + 汇聚点双 hook |
| 反调试/检测拦截 | 检测绕过表(root/属性/文件/命令) |
- 特征不匹配任何模板 → 组合改写(多个模板拼装)而非从零写
- 选完模板先读模板内已知边界注释(re-frida/frida-scripts),避免重复踩坑
-
改写:
- 替换占位符:包名/类名/方法名(精确匹配,Java 全限定名)
- overload 精确匹配:先
overloads枚举再逐个定义或按参数类型选(见坑 1) - 结构规范:Java 操作包在
Java.perform;保存 original 引用、带原this调用;Interceptor.attach里 onEnter 用this.context读寄存器,改返回值只能在 onLeave 用参数retval.replace(...)——this上只有 returnAddress/context/errno/lastError/threadId/depth,没有this.returnValue;且 retval 跨调用复用,需留存时先ptr(retval.toString())复制 - 输出统一 JSON(可打印 ASCII + hex 双格式)经
send()传出;每个 hook 主体try/catch,错误发消息不静默 - 同一类多 hook 合并进一个
.implementation(缓存静默覆盖,见坑 2) - 骨架参考(Java + native 双面最小结构,按目标裁剪):
Java.perform(function () { var Cls = Java.use("com.target.Cls"); Cls.method.overload("java.lang.String").implementation = function (s) { try { send({ type: "call", arg: s ? s.toString() : null }); } catch (e) { send({ type: "error", msg: String(e) }); } return this.method(s); // 调原实现(保留原 this) }; }); Interceptor.attach( Process.getModuleByName("libtarget.so").getExportByName("func"), { onEnter: function (args) { send({ type: "native", arg0: args[0].toInt32() }); } } ); - native 侧:导出符号优先(
Process.getModuleByName(...).getExportByName;旧写法Module.getExportByName见 gotchas 版本组);非导出函数用调用点 hook 或内存特征定位
-
验证:
frida -U -f <pkg> -l script.js --pause # spawn + 停在早期代码前 frida -U -f <pkg> -l script.js -o out.json # 输出存文件(大流量/批量时)- 验证清单:hook 挂载成功(无报错输出)→ 触发目标路径(操作 app 或复现调用)→ 输出与静态分析一致 → 重复触发输出稳定
- 输出 JSON 可解析、目标行为符合预期(拦截到目标调用/绕过生效)
- 失败 → 回步骤 2 重选模板或细化特征;崩溃 → 按 re-analyze/anti-dynamic-workflow 崩溃对照表定位;输出为空 → 见 decision-tree 排查分支
跨域联合
- re-frida:脚本执行(本技能产出 → re-frida 运行)
- re-mobile / re-android-native:移动目标场景衔接
- re-analyze/anti-dynamic-workflow:检测面与崩溃迭代法
- re-frida/frida-scripts:模板素材库(re-frida references)
- re-analyze/analysis-contract:脚本输出按数据契约消费(证据存档)
- re-ios-jb:iOS 越狱环境执行侧
常见坑与陷阱
- overload 不匹配静默失效:现象——hook 无输出;原因——目标方法 overload 签名与定义不符;对策——先
Java.use(...).<method>.overloads列出全部重载再选 - Java.use 缓存覆盖:现象——多个 hook 只生效最后一个;原因——同类多次
.implementation赋值静默覆盖;对策——合并进一个 hook - 参数索引版本相关:现象——native 参数读错;原因——目标版本字段/参数位次变化;对策——对照目标符号核实,不照搬经验值
- 不侦察就写脚本:现象——脚本对不上目标;原因——跳过步骤 1;对策——先探后写
- 绕过类脚本只观察不持久化:现象——测试后目标状态被改;原因——脚本含写操作;对策——脚本只做读取/日志,绕过仅用于观察(红线)
- 类未加载时 hook 不生效:现象——类存在但无输出;原因——懒加载/加固延迟加载;对策——
Java.choose或对类加载点下 hook(re-analyze/anti-dynamic-workflow) - 版本相关 API 报错:现象——
Module.getExportByName is not a function;原因——Frida 17 移除静态 Module 查找 API;对策——按 gotchas 版本组迁移写法 - 模板选择分支与验证排查树见 decision-tree;版本差异与边界见 gotchas;全部在沙箱内执行(re-analyze/platform-tips 最高原则),脚本输出按 re-analyze/analysis-contract 契约存档