Files

8.0 KiB
Raw Permalink Blame History

name, type, description, capabilities
name type description capabilities
re-frida-script-author atomic Frida 脚本生成方法论:目标特征 → 模板选择 → 改写 → 验证。独立于执行插桩(re-frida)。 触发词:生成Frida脚本、写hook脚本、frida脚本怎么写、写个hook、脚本生成。
frida-instrumentation

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(配合脚本调试)

反编译辅助(侦察用)

  • jadx(re-apk)静态出类/方法清单;Ghidra/IDA(re-ghidra / re-ida)native 侧符号与调用点定位
  • 验证: 能按包名列出目标类与方法签名

目标设备/模拟器

  • Android 真机/模拟器 + frida-server(至少与主机 frida 同 major,安装见 re-frida 工具准备);桌面目标直接本机
  • iOS 越狱环境 frida-server 见 re-ios-jb

操作步骤

按「探 → 选 → 改 → 验」四步,先探后写,不猜。每步产物(特征清单/脚本/验证输出)记录路径 + sha256(见 re-triage),供报告引用。

  1. 目标侦察:

    • 静态:目标包名/类名/关键 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 清单),供脚本与报告复用
  2. 模板选择:按特征清单对照 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),避免重复踩坑
  1. 改写:

    • 替换占位符:包名/类名/方法名(精确匹配,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 或内存特征定位
  2. 验证:

    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 排查分支

跨域联合

常见坑与陷阱

  • 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 契约存档