北京网站设计课程,新闻报道最近,做网站公司未来的发展方向,好的建站软件官方 API (JavaScript API)#xff1a;https://frida.re/docs/javascript-api/
From#xff1a; ( FRIDA-API使用篇 )#xff1a;https://www.anquanke.com/post/id/195215 前言 在这篇文章中来对其官方的一些非常常用的 API 进行学习。所谓工欲善其事#xff0c;必先利其…
官方 API (JavaScript API)https://frida.re/docs/javascript-api/
From ( FRIDA-API使用篇 )https://www.anquanke.com/post/id/195215 前言 在这篇文章中来对其官方的一些非常常用的 API 进行学习。所谓工欲善其事必先利其器。想要好好学习 FRIDA 我们就必须对 FRIDA API 深入的学习以对其有更深的了解和使用通常大部分核心原理也在官方 API 中写着我们学会来使用一些案例来结合 API 的使用。 注意运行以下任何代码时都需要提前启动手机中的 frida-server 文件。 系列文章目录搬新“家”了地址https://github.com/r0ysue/AndroidSecurityStudy 接下来窝会努力写更多喔 ~ rpc、Process、Module、Memory使用方法及示例 1.1 FRIDA 输出打印 1.1.1 console 输出
不论是什么语言都好第一个要学习总是如何 输出和打印那我们就来学习在 FRIDA 打印值。
在官方 API 有两种打印的方式分别是console、send
我们先来学习非常的简单的 console这里我创建一个 js 文件代码示例如下。
function hello_printf() {Java.perform(function () {console.log();console.log(hello-log);console.warn(hello-warn);console.error(hello-error);});
}
setImmediate(hello_printf,0);当文件创建好之后我们需要运行在手机中安装的 frida-server 文件在上一章我们学过了如何安装在 android 手机安装 frida-server现在来使用它我们在 ubuntu 中开启一个终端运行以下代码启动我们安装好的 frida-server 文件。
roysueubuntu:~$ adb shell
sailfish:/ $ su
sailfish:/ $ ./data/local/tmp/frida-server然后执行以下代码对目标应用 app 的进程 com.roysue.roysueapplication 使用 -l 命令注入 Chap03.js 中的代码。1-1以及执行脚本之后的效果图1-1
frida -U com.roysue.roysueapplication -l Chap03.js图1-1 终端执行 可以到终点已经成功注入了脚本并且打印了 hello但是颜色不同这是 log 的级别的原因在 FRIDA 的 console 中有三个级别分别是 log、warn、error。
级别含义log正常warn警告error错误1.1.2 console 之 hexdump
console 的三个级别
error 级别最为严重其次 warn但是一般在使用中我们只会使用 log 来输出想看的值
然后我们继续学习 console 的好兄弟hexdump其含义打印内存中的地址target 参数可以是 ArrayBuffer 或者 NativePointer而 options 参数则是自定义输出格式可以填这几个参数 offset、lengt、header、ansi。
hexdump 代码示例以及执行效果如下。
var libc Module.findBaseAddress(libc.so);
console.log(hexdump(libc, {offset: 0,length: 64,header: true,ansi: true
}));0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
00000000 7f 45 4c 46 01 01 01 00 00 00 00 00 00 00 00 00 .ELF............
00000010 03 00 28 00 01 00 00 00 00 00 00 00 34 00 00 00 ..(.........4...
00000020 34 a8 04 00 00 00 00 05 34 00 20 00 08 00 28 00 4.......4. ...(.
00000030 1e 00 1d 00 06 00 00 00 34 00 00 00 34 00 00 00 ........4...4...1.1.3 send
send 是在 python 层定义的 on_message 回调函数jscode 内所有的信息都被监控 script.on(message, on_message)当输出信息的时候 on_message 函数会拿到其数据再通过 format 转换 其最重要的功能也是最核心的是能够直接将数据以 json 格式输出当然数据是二进制的时候也依然是可以使用 send十分方便我们来看代码1-2示例以及执行效果。
# -*- coding: utf-8 -*-
import frida
import sysdef on_message(message, data):if message[type] send:print([*] {0}.format(message[payload]))else:print(message)jscode Java.perform(function () {var jni_env Java.vm.getEnv();console.log(jni_env);send(jni_env);});process frida.get_usb_device().attach(com.roysue.roysueapplication)
script process.create_script(jscode)
script.on(message, on_message)
script.load()
sys.stdin.read()运行脚本效果如下roysueubuntu:~/Desktop/Chap09$ python Chap03.py
[object Object]
[*] {handle: 0xdf4f8000, vm: {}}可以看出这里两种方式输出的不同的效果
console 直接输出了[object Object]无法输出其正常的内容因为 jni_env实际上是一个对象但是使用 send 的时候会自动将对象转 json 格式输出。通过对比我们就知道 send 的好处啦~1.2 FRIDA 变量类型
学完输出之后我们来学习如何声明变量类型。
索引API含义1new Int64(v)定义一个有符号Int64类型的变量值为v参数v可以是字符串或者以0x开头的的十六进制值2new UInt64(v)定义一个无符号Int64类型的变量值为v参数v可以是字符串或者以0x开头的的十六进制值3new NativePointer(s)定义一个指针指针地址为s4ptr(“0”)同上
代码示例以及效果
Java.perform(function () {console.log();console.log(new Int64(1):new Int64(1));console.log(new UInt64(1):new UInt64(1));console.log(new NativePointer(0xEC644071):new NativePointer(0xEC644071));console.log(new ptr(0xEC644071):new ptr(0xEC644071));
});输出效果如下new Int64(1):1new UInt64(1):1new NativePointer(0xEC644071):0xec644071new ptr(0xEC644071):0xec644071frida 也为 Int64(v) 提供了一些相关的 API
索引API含义1add(rhs)、sub(rhs)、and(rhs)、or(rhs)、xor(rhs)加、减、逻辑运算2shr(N)、shl(n)向右/向左移位n位生成新的Int643Compare(Rhs)返回整数比较结果4toNumber()转换为数字5toString([radix10])转换为可选基数的字符串(默认为10)
我也写了一些使用案例代码如下。
function hello_type() {Java.perform(function () {console.log();//8888 1 8889console.log(8888 1:new Int64(8888).add(1));//8888 - 1 8887console.log(8888 - 1:new Int64(8888).sub(1));//8888 1 4444console.log(8888 1:new Int64(8888).shr(1));//8888 22 1 1是falseconsole.log(8888 22:new Int64(8888).compare(22));//转stringconsole.log(8888 toString:new Int64(8888).toString());});
}代码执行效果如图1-2。 图1-2 Int64 API 1.3 RPC 远程调用
可以替换或插入的空对象以向应用程序公开RPC样式的API。该键指定方法名称该值是导出的函数。此函数可以返回一个纯值以立即返回给调用方或者承诺异步返回。也就是说可以通过rpc的导出的功能使用在python层使python层与js交互官方示例代码有Node.js版本与python版本我们在这里使用python版本代码如下。 1.3.1 远程调用代码示例
import fridadef on_message(message, data):if message[type] send:print(message[payload])elif message[type] error:print(message[stack])session frida.get_usb_device().attach(com.roysue.roysueapplication)source rpc.exports {add: function (a, b) {return a b;},sub: function (a, b) {return new Promise(function (resolve) {setTimeout(function () {resolve(a - b);}, 100);});}};
script session.create_script(source)
script.on(message, on_message)
script.load()
print(script.exports.add(2, 3))
print(script.exports.sub(5, 3))
session.detach()1.3.2 远程调用代码示例详解
官方源码示例是附加在目标进程为 iTunes再通过将 rpc 的 ./agent.js 文件读取到 source进行使用。我这里修改了附加的目标的进程以及直接将 rpc 的代码定义在 source 中。我们来看看这段是咋运行的仍然先对目标进程附加然后在写 js 中代码也是 source 变量通过 rpc.exports 关键字定义需要导出的两个函数上面定义了 add函数 和 sub函数两个的函数写作方式不一样大家以后写按照 add 方法写就好了sub 稍微有点复杂。声明完函数之后创建了一个脚本并且注入进程加载了脚本之后可以到 print(script.exports.add(2, 3)) 以及 print(script.exports.sub(5, 3))在 python 层直接调用。add 的返回的结果为5sub则是2下见下图1-3。 图1-3 执行python脚本 1.4 Process 对象
我们现在来介绍以及使用一些Process对象中比较常用的api~
1.4.1 Process.id
Process.id返回附加目标进程的PID
1.4.2 Process.isDebuggerAttached()
Process.isDebuggerAttached()检测当前是否对目标程序已经附加
1.4.3 Process.enumerateModules()
枚举当前加载的模块返回模块对象的数组。 Process.enumerateModules() 会 枚举当前所有已加载的 so 模块并且返回了 Module对象 的 数组 Module对象下一节我们来详细说在这里我们暂时只使用 Module对象的name属性。
function frida_Process() {Java.perform(function () {var process_Obj_Module_Arr Process.enumerateModules();for(var i 0; i process_Obj_Module_Arr.length; i) {console.log(,process_Obj_Module_Arr[i].name);}});
}
setImmediate(frida_Process,0);我来们开看看这段 js 代码写了啥在 js 中能够直接使用 Process 对象的所有 api调用了 Process.enumerateModules() 方法之后会返回一个数组数组中存储 N 个叫 Module 的 对象既然已经知道返回了的是一个数组很简单我们就来 for 循环它便是这里我使用下标的方式调用了 Module对象的 name 属性name 是 so 模块的名称。见下图1-4。 图1-4 终端输出了所有已加载的so 1.4.4 Process.enumerateThreads()
Process.enumerateThreads()枚举当前所有的线程返回包含以下属性的对象数组
索引属性含义1id线程id2state当前运行状态有running, stopped, waiting, uninterruptible or halted3context带有键pc和sp的对象它们是分别为ia32/x64/arm指定EIP/RIP/PC和ESP/RSP/SP的NativePointer对象。也可以使用其他处理器特定的密钥例如eax、rax、r0、x0等。
使用代码示例如下
function frida_Process() {Java.perform(function () {var enumerateThreads Process.enumerateThreads();for(var i 0; i enumerateThreads.length; i) {console.log();console.log(id:,enumerateThreads[i].id);console.log(state:,enumerateThreads[i].state);console.log(context:,JSON.stringify(enumerateThreads[i].context));}});
}
setImmediate(frida_Process,0);获取当前所有线程之后返回了一个数组然后循环输出它的值如下图1-5。 图1-4 终端执行 1.4.5 Process.getCurrentThreadId()
Process.getCurrentThreadId()获取此线程的操作系统特定 ID 作为数字 1.5 Module 对象
3.4 章节中 Process.EnumererateModules() 方法返回了就是一个 Module对象咱们这里来详细说说 Module对象先来瞧瞧它都有哪些属性。 1.5.1 Module对象 的 属性
索引属性含义1name模块名称2base模块地址其变量类型为NativePointer3size大小4path完整文件系统路径
除了属性我们再来看看它有什么方法。 1.5.2 Module对象 的 API
索引API含义1Module.load()加载指定so文件返回一个Module对象2enumerateImports()枚举所有Import库函数返回Module数组对象3enumerateExports()枚举所有Export库函数返回Module数组对象4enumerateSymbols()枚举所有Symbol库函数返回Module数组对象5Module.findExportByName(exportName)、Module.getExportByName(exportName)寻找指定so中export库中的函数地址6Module.findBaseAddress(name)、Module.getBaseAddress(name)返回so的基地址findExportByName(exportName) 和 getExportByName(exportName) 区别
findExportByName 参数就是 lib 中 函数的名字 推荐用这个 例如
var string_with_jni_addr Module.findExportByName(libnative-lib.so,Java_myapplication_example_com_ndk_1demo_MainActivity_stringWithJNI
)
getExportByName 参数是 需要在 ida 中查找的例如 1.5.3 Module.load()
在 frida-12-5 版本中更新了该 API主要用于加载指定 so 文件返回一个 Module对象。
使用代码示例如下
function frida_Module() {Java.perform(function () {//参数为so的名称 返回一个Module对象const hooks Module.load(libhello.so);//输出console.log(模块名称:,hooks.name);console.log(模块地址:,hooks.base);console.log(大小:,hooks.size);console.log(文件系统路径,hooks.path);});
}
setImmediate(frida_Module,0);输出如下
模块名称: libhello.so
模块地址: 0xdf2d3000
大小: 24576
文件系统路径 /data/app/com.roysue.roysueapplication-7adQZoYIyp5t3G5Ef5wevQ/lib/arm/libhello.so这边如果去除判断的话会打印所有加载的so的信息这里我们就知道了哪些方法返回了Module对象了然后我们再继续深入学习Module对象自带的API。 1.5.5 enumerateImports()
该 API 会枚举模块中所有的 Import 函数示例代码如下。
function frida_Module() {Java.perform(function () {const hooks Module.load(libhello.so);var Imports hooks.enumerateImports();for(var i 0; i Imports.length; i) {//函数类型console.log(type:,Imports[i].type);//函数名称console.log(name:,Imports[i].name);//属于的模块console.log(module:,Imports[i].module);//函数地址console.log(address:,Imports[i].address);}});
}
setImmediate(frida_Module,0);输出如下
[Google Pixel::com.roysue.roysueapplication]- type: function
name: __cxa_atexit
module: /system/lib/libc.so
address: 0xf58f4521
type: function
name: __cxa_finalize
module: /system/lib/libc.so
address: 0xf58f462d
type: function
name: __stack_chk_fail
module: /system/lib/libc.so
address: 0xf58e2681
...1.5.6 enumerateExports()
该 API 会枚举模块中所有的 Export 函数示例代码如下。
function frida_Module() {Java.perform(function () {const hooks Module.load(libhello.so);var Exports hooks.enumerateExports();for(var i 0; i Exports.length; i) {//函数类型console.log(type:,Exports[i].type);//函数名称console.log(name:,Exports[i].name);//函数地址console.log(address:,Exports[i].address);}});
}
setImmediate(frida_Module,0);输出如下
[Google Pixel::com.roysue.roysueapplication]- type: function
name: Java_com_roysue_roysueapplication_hellojni_getSum
address: 0xdf2d411b
type: function
name: unw_save_vfp_as_X
address: 0xdf2d4c43
type: function
address: 0xdf2d4209
type: function
...1.5.7 enumerateSymbols()
代码示例如下。
function frida_Module() {Java.perform(function () {const hooks Module.load(libc.so);var Symbol hooks.enumerateSymbols();for(var i 0; i Symbol.length; i) {console.log(isGlobal:,Symbol[i].isGlobal);console.log(type:,Symbol[i].type);console.log(section:,JSON.stringify(Symbol[i].section));console.log(name:,Symbol[i].name);console.log(address:,Symbol[i].address);}});
}
setImmediate(frida_Module,0);输出如下
isGlobal: true
type: function
section: {id:13.text,protection:r-x}
name: _Unwind_GetRegionStart
address: 0xf591c798
isGlobal: true
type: function
section: {id:13.text,protection:r-x}
name: _Unwind_GetTextRelBase
address: 0xf591c7cc
...1.5.8 Module.findExportByName(exportName), Module.getExportByName(exportName)
返回 so文件 中 Export函数库 中 函数名称为exportName函数 的 绝对地址。
代码示例如下。
function frida_Module() {Java.perform(function () {Module.getExportByName(libhello.so, c_getStr)console.log(Java_com_roysue_roysueapplication_hellojni_getStr address:,Module.findExportByName(libhello.so, Java_com_roysue_roysueapplication_hellojni_getStr));console.log(Java_com_roysue_roysueapplication_hellojni_getStr address:,Module.getExportByName(libhello.so, Java_com_roysue_roysueapplication_hellojni_getStr));});
}
setImmediate(frida_Module,0);输出如下
Java_com_roysue_roysueapplication_hellojni_getStr address: 0xdf2d413d
Java_com_roysue_roysueapplication_hellojni_getStr address: 0xdf2d413d1.5.9 Module.findBaseAddress(name)、Module.getBaseAddress(name)
返回 name 模块的基地址。
代码示例如下。
function frida_Module() {Java.perform(function () {var name libhello.so;console.log(so address:,Module.findBaseAddress(name));console.log(so address:,Module.getBaseAddress(name));});
}
setImmediate(frida_Module,0);输出如下
so address: 0xdf2d3000
so address: 0xdf2d30001.6 Memory 对象
Memory 的一些 API 通常是对 内存处理譬如 Memory.copy() 复制内存又如 writeByteArray 写入字节到指定内存中那我们这章中就是学习使用 Memory API 向内存中写入数据、读取数据。 1.6.1 Memory.scan 搜索内存数据 其主要功能是搜索内存中以 address 地址开始搜索长度为 size需要搜是条件是 patterncallbacks搜索之后的回调函数此函数相当于搜索内存的功能。 我们来直接看例子然后结合例子讲解如下图1-5。 图1-5 IDA中 so 文件某处数据
如果我想搜索在内存中 112A地址 的起始数据要怎么做代码示例如下。
function frida_Memory() {Java.perform(function () {//先获取so的module对象var module Process.findModuleByName(libhello.so); //??是通配符var pattern 03 49 ?? 50 20 44;//基址console.log(base:module.base)//从so的基址开始搜索搜索大小为so文件的大小搜指定条件03 49 ?? 50 20 44的数据var res Memory.scan(module.base, module.size, pattern, {onMatch: function(address, size){//搜索成功console.log(搜索到 pattern 地址是: address.toString()); }, onError: function(reason){//搜索失败console.log(搜索失败);},onComplete: function(){//搜索完毕console.log(搜索完毕)}});});
}
setImmediate(frida_Memory,0);先来看看回调函数的含义
onMatchfunction(addresssize)使用包含作为NativePointer的实例地址的address和指定大小为数字的size调用此函数可能会返回字符串STOP以提前取消内存扫描。onErrorFunction(Reason)当扫描时出现内存访问错误时使用原因调用。onCompletefunction()当内存范围已完全扫描时调用。
我们来来说上面这段代码做了什么事情搜索libhello.so文件在内存中的数据搜索以pattern条件的在内存中能匹配的数据。搜索到之后根据回调函数返回数据。
我们来看看执行之后的效果图1-6。 图1-6 终端执行
我们要如何验证搜索到底是不是图1-5中112A地址其实很简单。so的基址是0xdf2d3000而搜到的地址是0xdf2d412a我们只要df2d412a-df2d3000112A。就是说我们已经搜索到了 1.6.2 搜索内存数据 Memory.scanSync
功能与Memory.scan一样只不过它是返回多个匹配到条件的数据。 代码示例如下。
function frida_Memory() {Java.perform(function () {var module Process.findModuleByName(libhello.so); var pattern 03 49 ?? 50 20 44;var scanSync Memory.scanSync(module.base, module.size, pattern);console.log(scanSync:JSON.stringify(scanSync));});
}
setImmediate(frida_Memory,0);输出如下可以看到地址搜索出来是一样的
scanSync:[{address:0xdf2d412a,size:6}]1.6.3 内存分配 Memory.alloc
在目标进程中的堆上申请size大小的内存并且会按照Process.pageSize对齐返回一个NativePointer并且申请的内存如果在JavaScript里面没有对这个内存的使用的时候会自动释放的。也就是说如果你不想要这个内存被释放你需要自己保存一份对这个内存块的引用。
使用案例如下
function frida_Memory() {Java.perform(function () {const r Memory.alloc(10);console.log(hexdump(r, {offset: 0,length: 10,header: true,ansi: false}));});
}
setImmediate(frida_Memory,0);以上代码在目标进程中申请了10字节的空间~我们来看执行脚本的效果图1-7。 图1-7 内存分配
可以看到在0xdfe4cd40处申请了10个字节内存空间~
也可以使用
Memory.allocUtf8String(str) 分配 utf字符串Memory.allocUtf16String 分配 utf16字符串Memory.allocAnsiString 分配 ansi字符串1.6.4 内存复制 Memory.copy
如同c api memcp一样调用使用案例如下。
function frida_Memory() {Java.perform(function () {//获取so模块的Module对象var module Process.findModuleByName(libhello.so); //条件var pattern 03 49 ?? 50 20 44;//搜字符串 只是为了将so的内存数据复制出来 方便演示~var scanSync Memory.scanSync(module.base, module.size, pattern);//申请一个内存空间大小为10个字节const r Memory.alloc(10);//复制以module.base地址开始的10个字节 那肯定会是7F 45 4C 46...因为一个ELF文件的Magic属性如此。Memory.copy(r,module.base,10);console.log(hexdump(r, {offset: 0,length: 10,header: true,ansi: false}));});
}
setImmediate(frida_Memory,0);输出如下。0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
e8142070 7f 45 4c 46 01 01 01 00 00 00 .ELF......从 module.base 中复制10个字节的内存到新申请的 r 内。 1.6.5 写入内存 Memory.writeByteArray
将字节数组写入一个指定内存代码示例如下:
function frida_Memory() { Java.perform(function () {//定义需要写入的字节数组 这个字节数组是字符串roysue的十六进制var arr [ 0x72, 0x6F, 0x79, 0x73, 0x75, 0x65];//申请一个新的内存空间 返回指针 大小是arr.lengthconst r Memory.alloc(arr.length);//将arr数组写入R地址中Memory.writeByteArray(r,arr);//输出console.log(hexdump(r, {offset: 0,length: arr.length,header: true,ansi: false})); });
}
setImmediate(frida_Memory,0);输出如下。0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
00000000 72 6f 79 73 75 65 roysue1.6.6 读取内存 Memory.readByteArray
将一个指定地址的数据代码示例如下:
function frida_Memory() { Java.perform(function () {//定义需要写入的字节数组 这个字节数组是字符串roysue的十六进制var arr [ 0x72, 0x6F, 0x79, 0x73, 0x75, 0x65];//申请一个新的内存空间 返回指针 大小是arr.lengthconst r Memory.alloc(arr.length);//将arr数组写入R地址中Memory.writeByteArray(r,arr);//读取r指针长度是arr.length 也就是会打印上面一样的值var buffer Memory.readByteArray(r, arr.length);//输出console.log(Memory.readByteArray:);console.log(hexdump(buffer, {offset: 0,length: arr.length,header: true,ansi: false}));}); });
}
setImmediate(frida_Memory,0);输出如下。
[Google Pixel::com.roysue.roysueapplication]- Memory.readByteArray:0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
00000000 72 6f 79 73 75 65 roysue结语
在这篇中我们学会了在 FRIDACLI 中如何输出想要输出格式也学会如何声明变量一步步的学习。在逐步的学习的过程总是会遇到不同的问题。歌曲奇迹再现我相信你一定听过吧~新的风暴已经出现,怎么能够停止不前…遇到问题不要怕总会解决的。
咱们会在下一篇中来学会如何使用 FRIDA 中的 Java对象、Interceptor对象、NativePointer对象、NativeFunction对象、NativeCallback对象咱们拭目以待吧~ Java、Interceptor、NativePointer ( Function / Callback ) 使用方法及示例 1.1 Java对象 Java 是极其重要的 API无论是想对 so层亦或 java层 进行拦截都必须编写 Java.perform在使用上面这些 API 时应该都已经发现了吧。 这章我们就来详细看看 Java对象 都有哪些 API 1.1.1 Java.available
该函数一般用来判断当前进程是否加载了JavaVMDalvik或ART虚拟机咱们来看代码示例
import sys
import fridajs_code
function inject_func() {var pid Process.id;console.log(pid);
}function frida_Java() {Java.perform(function () {//作为判断用if (Java.available) {//注入的逻辑代码console.log(, Java.androidVersion);inject_func();} else {//未能正常加载JAVA VMconsole.log(error);}});
}setImmediate(frida_Java, 0);
def js_callback_func(msg, data):# js中执行send函数后要回调的函数if send msg[type]:print(f[*] {msg[payload]})else:print(msg)devices frida.get_remote_device()
pid devices.spawn([com.android.settings])
process devices.attach(pid)
script process.create_script(js_code)
script.on(message, js_callback_func)
script.load()
devices.resume(pid)
sys.stdin.read()
核心注入的逻辑代码写在 注入的逻辑代码 内会非常的安全万无一失~ 1.1.2 Java.androidVersion
显示 android 系统版本号
function frida_Java() {Java.perform(function () {//作为判断用if(Java.available){//注入的逻辑代码console.log(,Java.androidVersion);}else{//未能正常加载JAVA VMconsole.log(error);}});
}
setImmediate(frida_Java,0);输出如下。
9
因为我的系统版本是9版本~1.1.3 枚举类 Java.enumerateLoadedClasses
该 API 枚举当前加载的所有类信息它有一个回调函数分别是 onMatch、onComplete 函数我们来看看代码示例以及效果
function frida_Java() {Java.perform(function () {if(Java.available){//console.log(,Java.androidVersion);//枚举当前加载的所有类Java.enumerateLoadedClasses({//每一次回调此函数时其参数className就是类的信息onMatch: function (className){//输出类字符串console.log(,className);},//枚举完毕所有类之后的回调函数onComplete: function (){//输出类字符串console.log(输出完毕);}});}else{console.log(error);}});
}
setImmediate(frida_Java,0);咱们来看执行的效果图1-7。 图1-7 终端执行
它还有一个好兄弟 Java.enumerateLoadedClassesSync()它返回的是一个数组。 1.1.4 枚举类加载器 Java.enumerateLoadeders 该 api 枚举 Java VM 中存在的 类加载器其有一个回调函数分别是 onMatch: function (loader) 与 onComplete: function () 接着我们来看代码示例。
function frida_Java() {Java.perform(function () {if(Java.available){//枚举当前加载的Java VM类加载器Java.enumerateClassLoaders({//回调函数参数loader是类加载的信息onMatch: function (loader){console.log(,loader);},//枚举完毕所有类加载器之后的回调函数onComplete: function (){console.log(end);}});}else{console.log(error);}});
}
setImmediate(frida_Java,0);执行的效果图1-8。 图1-8 终端执行
它也有一个好兄弟叫 Java.enumerateClassLoadersSync() 也是返回的数组。 1.1.5 附加调用 Java.perform 该 API 极其重要Java.performfn主要用于当前线程附加到 Java VM并且调用 fn 方法。 我们来看看示例代码及其含义。
function frida_Java() {//运行当前js脚本时会对当前线程附加到Java VM虚拟机并且执行function方法Java.perform(function () {//判断是否Java VM正常运行if(Java.available){//如不意外会直接输出 helloconsole.log(hello);}else{console.log(error);}});
}
setImmediate(frida_Java,0);输出如下。
[Google Pixel::com.roysue.roysueapplication]- hello没错你猜对了它也有一个好兄弟。Java.performNow(fn)~ 1.1.6 获取类 Java.use Java.use(className)动态获取 className 的类定义通过对其调用 $new() 来调用构造函数可以从中实例化对象。 当想要回收类时可以调用 $Dispose()方法显式释放当然也可以等待 JavaScript 的垃圾回收机制 当实例化一个对象之后可以通过其实例对象调用类中的静态或非静态的方法 官方代码示例定义如下。
Java.perform(function () {//获取android.app.Activity类var Activity Java.use(android.app.Activity);//获取java.lang.Exception类var Exception Java.use(java.lang.Exception);//拦截Activity类的onResume方法Activity.onResume.implementation function () {//调用onResume方法的时候会在此处被拦截并且调用以下代码抛出异常throw Exception.$new(Oh noes!);};
});1.1.7 扫描实例类 Java.choose 在堆上查找 实例化 的 对象 示例代码如下
Java.perform(function () {//查找android.view.View类在堆上的实例化对象Java.choose(android.view.View, {//枚举时调用onMatch:function(instance){//打印实例console.log(instance);},//枚举完成后调用onComplete:function() {console.log(end)}});
});输出如下
android.view.View{2292774 V.ED..... ......ID 0,1794-1080,1920 #1020030 android:id/navigationBarBackground}
android.view.View{d43549d V.ED..... ......ID 0,0-1080,63 #102002f android:id/statusBarBackground}
end1.1.8 类型转换器 Java.cast
Java.cast(handle, klass)就是将指定 变量 或者 数据 强制转换成你所有需要的类型创建一个 JavaScript 包装器给定从 Java.use 返回的给定类klas的句柄的现有实例。此类包装器还具有用于获取其类的包装器的类属性以及用于获取其类名的字符串表示的$className属性通常在拦截so层时会使用此函数将 jstring、jarray等等转换之后查看其值。 1.1.9 定义任意数组类型 Java.array frida 提供了在 js 代码中定义 java 数组 的 api该数组可以用于传递给 java API。 我们来看看如何定义代码示例如下。
Java.perform(function () {//定义一个int数组、值是1003, 1005, 1007var intarr Java.array(int, [ 1003, 1005, 1007 ]);//定义一个byte数组、值是0x48, 0x65, 0x69var bytearr Java.array(byte, [ 0x48, 0x65, 0x69 ]);for(var i0;ibytearr.length;i){//输出每个byte元素console.log(bytearr[i])}
});我们通过上面定义 int数组 和 byte数组 的例子可以知道其定义格式为Java.array(type, [value1,value2,....]); 那它都支持 type 呢我们来看看~
索引type含义1Zboolean2Bbyte3Cchar4Sshort5Iint6Jlong7Ffloat8Ddouble9Vvoid1.1.10 注册类 Java.registerClass(spec)
Java.registerClass创建一个新的 Java类并返回一个包装器其中规范是一个包含
name指定类名称的字符串。superClass可选父类。要从 java.lang.Object 继承的省略。implements可选由此类实现的接口数组。fields可选对象指定要公开的每个字段的名称和类型。methods可选对象指定要实现的方法。
注册一个类返回类的实例下面我贴一个基本的用法~实例化目标类对象并且调用类中的方法
Java.perform(function () {//注册一个目标进程中的类返回的是一个类对象var hellojni Java.registerClass({name: com.roysue.roysueapplication.hellojni});console.log(hellojni.addInt(1,2));
});我们再深入看看官方怎么来玩的
//获取目标进程的SomeBaseClass类
var SomeBaseClass Java.use(com.example.SomeBaseClass);
//获取目标进程的X509TrustManager类
var X509TrustManager Java.use(javax.net.ssl.X509TrustManager);var MyWeirdTrustManager Java.registerClass({//注册一个类是进程中的MyWeirdTrustManager类name: com.example.MyWeirdTrustManager,//父类是SomeBaseClass类superClass: SomeBaseClass,//实现了MyWeirdTrustManager接口类implements: [X509TrustManager],//类中的属性fields: {description: java.lang.String,limit: int,},//定义的方法methods: {//类的构造函数$init: function () {console.log(Constructor called);},//X509TrustManager接口中方法之一该方法作用是检查客户端的证书checkClientTrusted: function (chain, authType) {console.log(checkClientTrusted);},//该方法检查服务器的证书不信任时。在这里通过自己实现该方法可以使之信任我们指定的任何证书。在实现该方法时也可以简单的不做任何处理即一个空的函数体由于不会抛出异常它就会信任任何证书。checkServerTrusted: [{//返回值类型returnType: void,//参数列表argumentTypes: [[Ljava.security.cert.X509Certificate;, java.lang.String],//实现方法implementation: function (chain, authType) {//输出console.log(checkServerTrusted A);}}, {returnType: java.util.List,argumentTypes: [[Ljava.security.cert.X509Certificate;, java.lang.String, java.lang.String],implementation: function (chain, authType, host) {console.log(checkServerTrusted B);//返回null会信任所有证书return null;}}],// 返回受信任的X509证书数组。getAcceptedIssuers: function () {console.log(getAcceptedIssuers);return [];},}
});我们来看看上面的示例都做了啥? 实现了证书类的javax.net.ssl.X509TrustManager类这里就是相当于自己在目标进程中重新创建了一个类实现了自己想要实现的类构造重构造了其中的三个接口函数、从而绕过证书校验。 1.1.11 Java.vm 对象 Java.vm 对象十分常用比如想要拿到 JNI层 的 JNIEnv对象可以使用 getEnv() 我们来看看具体的使用和基本小实例。~
function frida_Java() { Java.perform(function () {//拦截getStr函数Interceptor.attach(Module.findExportByName(libhello.so , Java_com_roysue_roysueapplication_hellojni_getStr), {onEnter: function(args) {console.log(getStr);},onLeave:function(retval){//它的返回值的是retval 在jni层getStr的返回值的jstring //我们在这里做的事情就是替换掉结果//先获取一个Env对象var env Java.vm.getEnv();//通过newStringUtf方法构建一个jstirng字符串var jstring env.newStringUtf(roysue);//replace替换掉结果retval.replace(jstring);console.log(getSum方法返回值为:roysue)}});
}
setImmediate(frida_Java,0);1.2 Interceptor 对象
该对象功能十分强大函数原型是 Interceptor.attach(target, callbacks):
参数 target 是需要拦截的位置的函数地址也就是填某个 so层 函数的地址即可对其拦截target 是一个 NativePointer参数用来指定你想要拦截的函数的地址NativePointer 是一个指针。需要注意的是对于 Thumb 函数需要对函数地址1参数 callbacks 是回调函数分别是以下两个回调函数1.2.1 Interceptor.attach
onEnter函数args回调函数给定一个参数 args可用于读取或写入参数作为 NativePointer对象的数组。onLeave函数retval回调函数给定一个参数 retval该参数是包含原始返回值的 NativePointer 派生对象。可以调用 retval.replace1337 以整数 1337 替换返回值或者调用 retval.replaceptr0x1234以替换为指针。请注意此对象在OnLeave 调用中回收因此不要将其存储在回调之外并使用它。如果需要存储包含的值请制作深副本例如ptrretval.toString())。
我们来看看示例代码~
//使用Module对象getExportByNameAPI直接获取libc.so中的导出函数read的地址对read函数进行附加拦截
Interceptor.attach(Module.getExportByName(libc.so, read), {//每次read函数调用的时候会执行onEnter回调函数onEnter: function (args) {this.fileDescriptor args[0].toInt32();},//read函数执行完成之后会执行onLeave回调函数onLeave: function (retval) {if (retval.toInt32() 0) {/* do something with this.fileDescriptor */}}
});通过我们对 Interceptor.attach 函数有一些基本了解了~它还包含一些属性。
索引属性含义1returnAddress返回地址类型是NativePointer2context上下文具有键pc和sp的对象它们是分别为ia32/x64/arm指定EIP/RIP/PC和ESP/RSP/SP的NativePointer对象。其他处理器特定的键也可用例如eax、rax、r0、x0等。也可以通过分配给这些键来更新寄存器值。3errno当前errno值4lastError当前操作系统错误值5threadId操作系统线程ID6depth相对于其他调用的调用深度
我们来看看示例代码。
function frida_Interceptor() {Java.perform(function () {//对So层的导出函数getSum进行拦截Interceptor.attach(Module.findExportByName(libhello.so , Java_com_roysue_roysueapplication_hellojni_getSum), {onEnter: function(args) {//输出console.log(Context information:);//输出上下文因其是一个Objection对象需要它进行接送、转换才能正常看到值console.log(Context : JSON.stringify(this.context));//输出返回地址console.log(Return : this.returnAddress);//输出线程idconsole.log(ThreadId : this.threadId);console.log(Depth : this.depth);console.log(Errornr : this.err);},onLeave:function(retval){}});});
}
setImmediate(frida_Interceptor,0);我们注入脚本之后来看看执行之后的效果以及输出的这些都是啥执行的效果图1-9。 图1-9 终端执行 1.2.2 Interceptor.detachAll
简单来说这个的函数的作用就是让之前所有的Interceptor.attach附加拦截的回调函数失效。 1.2.3 Interceptor.replace
相当于替换掉原本的函数用替换时的实现替换目标处的函数。如果想要完全或部分替换现有函数的实现则通常使用此函数。我们也看例子例子是最直观的代码如下。
function frida_Interceptor() {Java.perform(function () {//这个c_getSum方法有两个int参数、返回结果为两个参数相加//这里用NativeFunction函数自己定义了一个c_getSum函数var add_method new NativeFunction(Module.findExportByName(libhello.so, c_getSum), int,[int,int]);//输出结果 那结果肯定就是 3console.log(result:,add_method(1,2));//这里对原函数的功能进行替换实现Interceptor.replace(add_method, new NativeCallback(function (a, b) {//h不论是什么参数都返回123return 123;}, int, [int, int]));//再次调用 则返回123console.log(result:,add_method(1,2));});
}我来看注入脚本之后的终端是是不是显示了3和123见下图1-10。 图1-10 终端执行 1.3 NativePointer 对象
同等与C语言中的指针 1.3.1 new NativePointer(s)
声明定义NativePointer类型
function frida_NativePointer() {Java.perform(function () {//第一种字符串定义方式 十进制的100 输出为十六进制0x64const ptr1 new NativePointer(100);console.log(ptr1:,ptr1);//第二种字符串定义方式 直接定义0x64 同等与定义十六进制的64const ptr2 new NativePointer(0x64);console.log(ptr2:,ptr2); //第三种定数值义方式 定义数字int类型 十进制的100 是0x64const ptr3 new NativePointer(100);console.log(ptr3:,ptr3);});
}
setImmediate(frida_NativePointer,0);输出如下都会自动转为十六进制的0x64
ptr1: 0x64
ptr2: 0x64
ptr3: 0x641.3.2 运算符以及指针读写 API
它也能调用以下运算符 看完API含义之后我们来使用他们下面该脚本是readByteArray()示例~
function frida_NativePointer() {Java.perform(function () {console.log();//拿到libc.so在内存中的地址var pointer Process.findModuleByName(libc.so).base;//读取从pointer地址开始的16个字节console.log(pointer.readByteArray(0x10));});
}
setImmediate(frida_NativePointer,0);
输出如下0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
00000000 7f 45 4c 46 01 01 01 00 00 00 00 00 00 00 00 00 .ELF............首先我先来用readByteArray函数来读取libc.so文件在内存中的数据这样我们方便测试我们从libc文件读取0x10个字节的长度肯定会是7F 45 4C 46...因为ELF文件头部信息中的Magic属性。 1.3.3 readPointer()
咱们直接从API索引11开始玩readPointer()定义是从此内存位置读取NativePointer示例代码如下。省略function以及Java.perform~ var pointer Process.findModuleByName(libc.so).base;console.log(pointer.readByteArray(0x10));console.log(readPointer():pointer.readPointer());输出如下。readPointer():0x464c457f也就是将readPointer的前四个字节的内容转成地址产生一个新的NativePointer。 1.3.4 writePointer(ptr)
读取ptr指针地址到当前指针 //先打印pointer指针地址console.log(pointer :pointer);//分配四个字节的空间地址const r Memory.alloc(4);//将pointer指针写入刚刚申请的r内r.writePointer(pointer);//读取r指针的数据var buffer Memory.readByteArray(r, 4);//r指针内放的pointer指针地址console.log(buffer);输出如下。
//console.log(pointer :pointer); 这句打印的地址 也就是libc的地址
pointer :0xf588f000
//console.log(buffer); 输出buffer 0xf588f000在内存数据会以00 f0 88 f5方式显示0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
00000000 00 f0 88 f5 ....1.3.5 readS32()、readU32()
从该内存位置读取有符号或无符号8/16/32/etc或浮点数/双精度值并将其作为数字返回。这里拿readS32()、readU32()作为演示. //从pointer地址读4个字节 有符号console.log(pointer.readS32());//从pointer地址读4个字节 无符号console.log(pointer.readU32());输出如下。0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
00000000 7f 45 4c 46 01 01 01 00 00 00 00 00 00 00 00 00 .ELF............
1179403647 0x464c457f
1179403647 0x464c457f1.3.6 writeS32()、writeU32()
将有符号或无符号8/16/32/等或浮点数/双精度值写入此内存位置。 //申请四个字节的内存空间const r Memory.alloc(4);//将0x12345678写入r地址中r.writeS32(0x12345678);//输出console.log(r.readByteArray(0x10));
// writeS32()、writeU32()输出的也是一样的只是区别是有符号和无符号
输出如下。0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
00000000 78 56 34 12 00 00 00 00 00 00 00 00 00 00 00 00 xV4.............1.3.7 readByteArray(length))、writeByteArray(bytes)
readByteArray(length))连续读取内存length个字节writeByteArray连续写入内存bytes。 //先定义一个需要写入的字节数组var arr [ 0x72, 0x6F, 0x79, 0x73, 0x75, 0x65];//这里申请以arr大小的内存空间const r Memory.alloc(arr.length);//将arr数组字节写入rMemory.writeByteArray(r,arr);//读取arr.length大小的数组var buffer Memory.readByteArray(r, arr.length);console.log(Memory.readByteArray:);console.log(hexdump(buffer, {offset: 0,length: arr.length,header: true,ansi: false}));输出如下。
Memory.readByteArray:0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789ABCDEF
00000000 72 6f 79 73 75 65 roysue1.3.8 readCString([size -1])、writeUtf8String(str)
readCString功能是读取指针地址位置的字节字符串对应的writeUtf8String是写入指针地址位置的字符串处。这里的r是接着上面的代码的变量。 //在这里直接使用readCString读取会把上面的roysue字符串读取出来console.log(readCString():r.readCString());//这里是写入字符串 也就是 roysue起始位置开始被替换为hahaconst newPtrstr r.writeUtf8String(haha);//替换完了之后再继续输出 必然是hahaconsole.log(readCString():newPtrstr.readCString());咱们来看看执行的效果~~见下图1-11。 图1-11 终端执行 1.4 NativeFunction对象
创建新的NativeFunction以调用address处的函数(用NativePointer指定)其中rereturn Type指定返回类型argTypes数组指定参数类型。如果不是系统默认值还可以选择指定ABI。对于可变函数添加一个‘.’固定参数和可变参数之间的argTypes条目我们来看看官方的例子。
// LargeObject HandyClass::friendlyFunctionName();
//创建friendlyFunctionPtr地址的函数
var friendlyFunctionName new NativeFunction(friendlyFunctionPtr,void, [pointer, pointer]);
//申请内存空间
var returnValue Memory.alloc(sizeOfLargeObject);
//调用friendlyFunctionName函数
friendlyFunctionName(returnValue, thisPtr);我来看看它的格式函数定义格式为new NativeFunction(address, returnType, argTypes[, options])参照这个格式能够创建函数并且调用returnType和argTypes[]分别可以填void、pointer、int、uint、long、ulong、char、uchar、float、double、int8、uint8、int16、uint16、int32、uint32、int64、uint64这些类型根据函数的所需要的type来定义即可。
在定义的时候必须要将参数类型个数和参数类型以及返回值完全匹配假设有三个参数都是int则new NativeFunction(address, returnType, [int, int, int])而返回值是int则new NativeFunction(address, int, argTypes[, options])必须要全部匹配并且第一个参数一定要是函数地址指针。 1.5 NativeCallback对象
new NativeCallback(funcrereturn TypeargTypes[ABI])创建一个由JavaScript函数func实现的新NativeCallback其中rereturn Type指定返回类型argTypes数组指定参数类型。您还可以指定ABI(如果不是系统默认值)。有关支持的类型和Abis的详细信息请参见NativeFunction。注意返回的对象也是一个NativePointer因此可以传递给Interceptor#replace。当将产生的回调与Interceptor.replace()一起使用时将调用func并将其绑定到具有一些有用属性的对象就像Interceptor.Attach()中的那样。我们来看一个例子。如下利用NativeCallback做一个函数替换。 Java.perform(function () {var add_method new NativeFunction(Module.findExportByName(libhello.so, c_getSum), int,[int,int]);console.log(result:,add_method(1,2));//在这里new一个新的函数但是参数的个数和返回值必须对应Interceptor.replace(add_method, new NativeCallback(function (a, b) {return 123;}, int, [int, int]));console.log(result:,add_method(1,2));});结语
本篇咱们学习了非常实用的 API如
Interceptor对象 对 so层 导出库函数拦截、NativePointer对象的指针操作、NativeFunction对象的实例化so函数的使用 等
这些都是当前灰常好用的函数建议多多尝试
