Frida笔记 - Android 篇 (一) - HelloWorld开发者社区

前言

相信不少小伙伴对Xposed、Cydia Substrate、Frida等hook工具都有所了解, 并且用在了自己的工作中, 本文主要分享Frida的环境配置以及基本使用, 以及相关功能在日常开发调试带来的帮助

配置Frida的环境

Frida的环境安装可以参考官方文档, 或者参考网上分享的实践, 使用较为稳定的特定版本

# 通过pip3安装Frida的CLI工具
pip3 install frida-tools
# 安装的frida版本
frida --version
# 本机目前使用的15.0.8的frida版本
# 在https://github.com/frida/frida/releases下载对应的server版本frida-server-15.0.8-android-arm64.xz
# unxz 解压缩
unxz frida-server-15.0.8-android-arm64.xz
adb root
adb push frida-server-15.0.8-android-arm64 /data/locl/tmp/
adb shell
chmod 755 /data/local/tmp/frida-server-15.0.8-android-arm64
/data/local/tmp/frida-server-15.0.8-android-arm64 &
# 打印已安装程序及包名
frida-ps -Uai

基本使用

Frida的开发环境, 可以参考作者在github上的exmaple

# 下载完成后通过vscode打开
git clone git://github.com/oleavr/frida-agent-example.git
npm install

配置完成后, 使用对应函数就会有相应代码提示及函数说明

Frida笔记 - Android 篇 (一)

JavaScript API可以参考官方文档说明, 了解基本使用

Hook类的构造函数

// frida -U --no-pause -f com.gio.test.three -l agent/constructor.js

function main() {
Java.perform(function () {
  Java.use(
    "com.growingio.android.sdk.autotrack.AutotrackConfiguration"
  ).$init.overload("java.lang.String", "java.lang.String").implementation =
    function (projectId, urlScheme) {
      // 调用原函数
      var result = this.$init(projectId, urlScheme);
      // 打印参数
      console.log("projectId, urlScheme: ", projectId, urlScheme);
      return result;
    };
});
}

setImmediate(main);

Hook类的普通函数

// frida -U --no-pause -f com.gio.test.three -l agent/function.js

function main() {
Java.perform(function () {
  Java.use(
    "com.growingio.android.sdk.CoreConfiguration"
  ).setDebugEnabled.implementation = function (enabled) {
    console.log("enabled: ", enabled);
    // 直接返回原函数执行结果
    return this.setDebugEnabled(enabled);
  };
});
}

setImmediate(main);

修改类/实例参数

// 以attach的方式附加到进程, 或者使用setTimeout替换setImmediate
// frida -U -n demos -l agent/instance.js
function main() {
Java.perform(function () {
  Java.choose("com.growingio.android.sdk.autotrack.AutotrackConfiguration", {
    onMatch: function (instance) {
      console.log("instance.mProjectId", instance.mProjectId.value);
      console.log("instance.mUrlScheme", instance.mUrlScheme.value);
      // 修改变量时通过赋值, 如果变量与函数同名, 需要在变量前加'_', 如: _mProjectId
      instance.mProjectId.value = "t-bfc5d6a3693a110d";
      instance.mUrlScheme.value = "t-growing.d80871b41ef40518";
    },
    onComplete: function () {},
  });
});
}

setImmediate(main);

构造数组

frida -U -n demos -l agent/array.js

function main() {
Java.perform(function () {
  // 构造byte数组
  var byteArray = Java.array("byte", [0x46, 0x72, 0x69, 0x64, 0x61]);
  // 输出为: Frida
  console.log(Java.use("java.lang.String").$new(byteArray));
  
  // 构造char数组
  var charArray = Java.array("char", ["F", "r", "i", "d", "a"]);
  console.log(Java.use("java.lang.String").$new(charArray));
});
}

setImmediate(main);

静态函数主动调用

// 以attach的方式附加到进程, 或者使用setTimeout替换setImmediate
// frida -U -n demos -l agent/staticFunction.js

function main() {
Java.perform(function () {
  // setWebContentsDebuggingEnabled 需要在主线程调用
  Java.scheduleOnMainThread(function () {
    console.log("isMainThread", Java.isMainThread());
    // 主动触发静态函数调用, 允许WebView调试
    Java.use("android.webkit.WebView").setWebContentsDebuggingEnabled(true);
  });
});
}

setImmediate(main);

动态函数主动调用

// 以attach的方式附加到进程, 或者使用setTimeout替换setImmediate
// frida -U -n demos -l agent/dynamicFunction.js

function main() {
Java.perform(function () {
  Java.choose("com.growingio.android.sdk.autotrack.AutotrackConfiguration", {
    onMatch: function (instance) {
      // 主动触发动态函数调用
      console.log("instance.isDebugEnabled: ", instance.isDebugEnabled());
      console.log("instance.getChannel: ", instance.getChannel());
    },
    onComplete: function () {},
  });
});
}

setImmediate(main);

定义一个类

// 以attach的方式附加到进程, 或者使用setTimeout替换setImmediate
// frida -U -n demos -l agent/registerClass.js

function main() {
Java.perform(function () {
  var TestRunnable = Java.registerClass({
      name: "com.example.TestRunnable",
      // 实现接口
      implements: [Java.use("java.lang.Runnable")],
      // 成员变量
      fields: {
        testFields: "java.lang.String",
      },
      methods: {
        // 构造函数
        $init: [
          {
            returnType: "void",
            argumentTypes: ["java.lang.String"],
            implementation: function (testFields) {
              // 调用父类构造函数
              this.$super.$init();
              // 给成员变量赋值
              this.testFields.value = testFields;
              console.log("$init: ", this.testFields.value);
            },
          },
        ],
        // 方法
        run: [
          {
            returnType: "void",
            implementation: function () {
              console.log(
                "testFields: ",
                this.testFields.value
              );
            },
          },
        ],
      },
    });
    
    TestRunnable.$new("simple test").run();
});
}

setImmediate(main);

打印函数调用堆栈

// 以attach的方式附加到进程, 或者使用setTimeout替换setImmediate
// frida -U -n demos -l agent/printStackTrace.js

function main() {
Java.perform(function () {
  Java.use(
    "com.growingio.android.sdk.autotrack.click.ViewClickInjector"
  ).viewOnClick.overload(
    "android.view.View$OnClickListener",
    "android.view.View"
  ).implementation = function (listener, view) {
    // 打印当前调用堆栈信息
    console.log(
      Java.use("android.util.Log").getStackTraceString(
        Java.use("java.lang.Throwable").$new()
      )
    );
    return this.viewOnClick(listener, view);
  };
});
}

setImmediate(main);

枚举classLoader

// 以attach的方式附加到进程, 或者使用setTimeout替换setImmediate
// frida -U -n demos -l agent/enumerateClassLoaders.js
// 适用于加固的应用, 找到对应的classloader
// 通常直接在application.attach.overload('android.content.Context').implementation获取context对应的classloader

function main() {
Java.perform(function () {
  Java.enumerateClassLoaders({
    onMatch: function (loader) {
      try {
        // 判断该loader中是否存在我们需要hook的类
        if (loader.findClass("com.growingio.android.sdk.CoreConfiguration")) {
          console.log("found loader:", loader);
          Java.classFactory.loader = loader;
        }
      } catch (error) {
        console.log("found error: ", error);
        console.log("failed loader: ", loader);
      }
    },
    onComplete: function () {
      console.log("enum completed!");
    },
  });
  console.log(
    Java.use("com.growingio.android.sdk.CoreConfiguration").$className
  );
});
}

setImmediate(main);

枚举类

// 以attach的方式附加到进程, 或者使用setTimeout替换setImmediate
// frida -U -n demos -l agent/enumerateLoadedClasses.js

function main() {
Java.perform(function () {
  Java.enumerateLoadedClasses({
    onMatch: function (name, handle) {
      // 判断是否是我们要查找的类
      if (name.toString() == "com.growingio.android.sdk.CoreConfiguration") {
        console.log("name, handle", name, handle);
        Java.use(name).isDebugEnabled.implementation = function () {
          return true;
        };
      }
    },
    onComplete: function () {},
  });
});
}

setImmediate(main);

加载外部dex并通过gson打印对象

// 以attach的方式附加到进程, 或者使用setTimeout替换setImmediate
// frida -U -n demos -l agent/printObject.js
// 通过d8将 gson.jar 转为 classes.dex
// ~/Library/Android/sdk/build-tools/30.0.3/d8 --lib ~/Library/Android/sdk/platforms/android-30/android.jar gson-2.8.8.jar
// 如果SDK中已经有了, 可以直接使用Java.use加载
// adb push classes.dex /data/local/tmp 

function main() {
Java.perform(function () {
  Java.choose("com.growingio.android.sdk.autotrack.AutotrackConfiguration", {
    onMatch: function (instance) {
      // 加载外部dex
      Java.openClassFile("/data/local/tmp/classes.dex").load();
      var Gson = Java.use("com.google.gson.Gson");
      // JSON.stringify:  "<instance: com.growingio.android.sdk.autotrack.AutotrackConfiguration>"
      console.log("JSON.stringify: ", JSON.stringify(instance));
      // Gson.$new().toJson:  {"mImpressionScale":0.0,"mCellularDataLimit":10,"mDataCollectionEnabled":true,"mDataCollectionServerHost":"http://api.growingio.com","mDataUploadInterval":15,"mDebugEnabled":true,"mOaidEnabled":false,"mProjectId":"bfc5d6a3693a110d","mSessionInterval":30,"mUploadExceptionEnabled":false,"mUrlScheme":"growing.d80871b41ef40518"}
      console.log("Gson.$new().toJson: ", Gson.$new().toJson(instance));
    },
    onComplete: function () {},
  });
});
}

setImmediate(main);

使用场景

绕过证书绑定、校验, 进行埋点请求验证
SDK开发过程中, 一般客户反馈问题都需要使用客户的app进行问题的复现及排查, 此时通过frida获取运行时特定函数的参数信息及返回信息, 能有效缩短与客户的沟通时间, 该场景使用objection最为方便
新客户在集成前, 希望看到SDK能够提供的效果, 通过frida加载dex并完成初始化, 可以提前发现兼容性问题
当碰到集成早期版本SDK的应用反馈异常, 通过类似Tinker热修复的思想替换SDK验证是否已经在当前版本修复
开放SDK相关函数远程rpc调用, 用于测试埋点的协议等场景
外链地址
Frida官方文档: https://frida.re/docs/install...
Frida作者提供的example github地址: https://github.com/oleavr/fri...
JavaScript API官方文档: https://frida.re/docs/javascr...
功能介绍中所使用demo: https://github.com/growingio/...
r0capture 安卓应用层通杀脚本 github地址: https://github.com/r0ysue/r0c...
objection github地址: https://github.com/sensepost/...

前言