Frida チュートリアル

Reading time: 13 minutes

tip

AWSハッキングを学び、実践する：HackTricks Training AWS Red Team Expert (ARTE)
GCPハッキングを学び、実践する：HackTricks Training GCP Red Team Expert (GRTE) Azureハッキングを学び、実践する：HackTricks Training Azure Red Team Expert (AzRTE)

HackTricksをサポートする

サブスクリプションプランを確認してください！
**💬 Discordグループまたはテレグラムグループに参加するか、Twitter 🐦 @hacktricks_liveをフォローしてください。
HackTricksおよびHackTricks CloudのGitHubリポジトリにPRを提出してハッキングトリックを共有してください。

インストール

frida tools をインストールする:

bash

pip install frida-tools
pip install frida

ダウンロードしてインストール Androidにfrida server (Download the latest release).\
adbをrootモードで再起動し、接続してfrida-serverをアップロードし、実行権限を付与してバックグラウンドで実行するワンライナー:

bash

adb root; adb connect localhost:6000; sleep 1; adb push frida-server /data/local/tmp/; adb shell "chmod 755 /data/local/tmp/frida-server"; adb shell "/data/local/tmp/frida-server &"

確認それが 動作しているか:

bash

frida-ps -U #List packages and processes
frida-ps -U | grep -i <part_of_the_package_name> #Get all the package name

Frida server と Gadget の比較 (root と no-root)

Two common ways to instrument Android apps with Frida:

Frida server (rooted devices): ネイティブなデーモンをプッシュして実行し、任意のプロセスにアタッチできるようにする。
Frida Gadget (no root): Frida を共有ライブラリとして APK 内にバンドルし、ターゲットプロセス内で自動的にロードする。

Frida server (rooted)

bash

# Download the matching frida-server binary for your device's arch
# https://github.com/frida/frida/releases
adb root
adb push frida-server-<ver>-android-<arch> /data/local/tmp/frida-server
adb shell chmod 755 /data/local/tmp/frida-server
adb shell /data/local/tmp/frida-server &    # run at boot via init/magisk if desired

# From host, list processes and attach
frida-ps -Uai
frida -U -n com.example.app

Frida Gadget (no-root)

APKをアンパックし、gadgetの .so と設定を追加する:

libfrida-gadget.so を lib/<abi>/ に配置する (e.g., lib/arm64-v8a/)
assets/frida-gadget.config を作成し、スクリプト読み込みの設定を記述する

frida-gadget.config の例

json

{
"interaction": { "type": "script", "path": "/sdcard/ssl-bypass.js" },
"runtime": { "logFile": "/sdcard/frida-gadget.log" }
}

gadget を参照/ロードして、早期に初期化されるようにする:

簡単: Application.onCreate() に System.loadLibrary("frida-gadget") を呼ぶ小さな Java stub を追加する、または既存の native lib loading を利用する。

APK をリパックして署名し、インストールする:

bash

apktool d app.apk -o app_m
# ... add gadget .so and config ...
apktool b app_m -o app_gadget.apk
uber-apk-signer -a app_gadget.apk -o out_signed
adb install -r out_signed/app_gadget-aligned-debugSigned.apk

ホストからgadgetプロセスにアタッチする:

bash

frida-ps -Uai
frida -U -n com.example.app

Notes

Gadgetは一部の保護機構に検出されることがあるため、名前やパスはステルスにし、必要なら遅延／条件付きでロードしてください。
ハード化されたアプリでは、rooted testingをserver + late attachで行うか、Magisk/Zygiskによる隠蔽と組み合わせるのが望ましいです。

Self-contained agent + Gadget embedding (Frida 17+; automated with Objection)

Frida 17 は GumJS から組み込みの Java/ObjC ブリッジを削除しました。エージェントが Java をフックする場合、Java ブリッジをバンドル内に含める必要があります。

Create a Frida agent (TypeScript) and include the Java bridge

bash

# Scaffolding
frida-create -t agent -o mod
cd mod && npm install
# Install the Java bridge for Frida 17+
npm install frida-java-bridge
# Dev loop (optional live-reload via REPL)
npm run watch

最小限の Java hook (ダイスの出目を1に強制する):

import Java from "frida-java-bridge";

Java.perform(function () {
var dicer = Java.use("org.secuso.privacyfriendlydicer.dicer.Dicer");
dicer.rollDice.implementation = function (numDice: number, numFaces: number) {
return Array(numDice).fill(1);
};
});

埋め込み用の単一バンドルをビルドする:

bash

npm run build    # produces _agent.js via frida-compile

簡単なUSBテスト（任意）:

bash

frida -U -f org.secuso.privacyfriendlydicer -l _agent.js

Gadget を設定して script を自動読み込みさせる Objection の patcher は Gadget の config を期待します; script mode を使用する場合、APK lib dir 内の on-disk path を指定してください:

json

{
"interaction": {
"type": "script",
"path": "libfrida-gadget.script.so"
}
}

ObjectionでAPKのパッチ適用を自動化する

bash

# Embed Gadget, config, and your compiled agent into the APK; rebuild and sign
objection patchapk -s org.secuso.privacyfriendlydicer.apk \
-c gadget-config.json \
-l mod/_agent.js \
--use-aapt2

What patchapk does (high level):

デバイスの ABI（例: arm64-v8a）を検出し、対応する Gadget を取得する
必要に応じて android.permission.INTERNET を追加する（任意）
起動アクティビティに System.loadLibrary("frida-gadget") を呼び出す静的クラス初期化子を注入する
次のファイルを lib/<abi>/ に配置する:
libfrida-gadget.so
libfrida-gadget.config.so (シリアライズされた config)
libfrida-gadget.script.so (あなたの _agent.js)

Example injected smali (static initializer):

smali

.method static constructor <clinit>()V
.locals 1
const-string v0, "frida-gadget"
invoke-static {v0}, Ljava/lang/System;->loadLibrary(Ljava/lang/String;)V
return-void
.end method

repack を検証する

bash

apktool d org.secuso.privacyfriendlydicer.apk
apktool d org.secuso.privacyfriendlydicer.objection.apk
# Inspect differences
diff -r org.secuso.privacyfriendlydicer org.secuso.privacyfriendlydicer.objection

想定される変更点:

AndroidManifest.xml に <uses-permission android:name="android.permission.INTERNET"/> が含まれる場合がある
上記のように lib// の下に新しいネイティブライブラリが追加される
起動可能な activity の smali は System.loadLibrary("frida-gadget") を呼び出す static <clinit> を含む

Split APKs

base APK をパッチする（MAIN/LAUNCHER activity を宣言しているもの）
残りの splits を同じキーで再署名する:

bash

objection signapk split1.apk split2.apk ...

splits を一緒にインストールする:

bash

adb install-multiple split1.apk split2.apk ...

配布向けには、APKEditorで分割を単一のAPKにマージし、その後 align/sign を行います

Defensive notes (what to look for when hardening)

署名や再パッケージ検出、ランタイムの整合性／attestation を実装する
起動時に予期しない System.loadLibrary("frida-gadget") や疑わしいネイティブライブラリを検出する
未使用の INTERNET パーミッションを宣言しないことで、gadget 検出の攻撃面を減らす

Tutorials

Tutorial 1

From: https://medium.com/infosec-adventures/introduction-to-frida-5a3f51595ca1
APK: https://github.com/t0thkr1s/frida-demo/releases
Source Code: https://github.com/t0thkr1s/frida-demo

Follow the link to read it.

Tutorial 2

From: https://11x256.github.io/Frida-hooking-android-part-2/ (Parts 2, 3 & 4)
APKs and Source code: https://github.com/11x256/frida-android-examples

Follow the link to read it.

Tutorial 3

From: https://joshspicer.com/android-frida-1
APK: https://github.com/OWASP/owasp-mstg/blob/master/Crackmes/Android/Level_01/UnCrackable-Level1.apk

Follow the link to read it.

You can find more Awesome Frida scripts here: https://codeshare.frida.re/

Quick Examples

Calling Frida from command line

bash

frida-ps -U

#Basic frida hooking
frida -l disableRoot.js -f owasp.mstg.uncrackable1

#Hooking before starting the app
frida -U --no-pause -l disableRoot.js -f owasp.mstg.uncrackable1
#The --no-pause and -f options allow the app to be spawned automatically,
#frozen so that the instrumentation can occur, and the automatically
#continue execution with our modified code.

基本的な Python スクリプト

python

import frida, sys

jscode = open(sys.argv[0]).read()
process = frida.get_usb_device().attach('infosecadventures.fridademo')
script = process.create_script(jscode)
print('[ * ] Running Frida Demo application')
script.load()
sys.stdin.read()

パラメータなしの関数をフックする

クラス sg.vantagepoint.a.c の関数 a() をフックする

javascript

Java.perform(function () {
;  rootcheck1.a.overload().implementation = function() {
rootcheck1.a.overload().implementation = function() {
send("sg.vantagepoint.a.c.a()Z   Root check 1 HIT!  su.exists()");
return false;
};
});

java の exit() をフックする

javascript

var sysexit = Java.use("java.lang.System")
sysexit.exit.overload("int").implementation = function (var_0) {
send("java.lang.System.exit(I)V  // We avoid exiting the application  :)")
}

Hook MainActivity .onStart() と .onCreate()

javascript

var mainactivity = Java.use("sg.vantagepoint.uncrackable1.MainActivity")
mainactivity.onStart.overload().implementation = function () {
send("MainActivity.onStart() HIT!!!")
var ret = this.onStart.overload().call(this)
}
mainactivity.onCreate.overload("android.os.Bundle").implementation = function (
var_0
) {
send("MainActivity.onCreate() HIT!!!")
var ret = this.onCreate.overload("android.os.Bundle").call(this, var_0)
}

android .onCreate() を Hook する

javascript

var activity = Java.use("android.app.Activity")
activity.onCreate.overload("android.os.Bundle").implementation = function (
var_0
) {
send("Activity HIT!!!")
var ret = this.onCreate.overload("android.os.Bundle").call(this, var_0)
}

関数の引数をフックして値を取得する

復号関数をフックします。入力を表示し、元の関数を呼び出して入力を復号し、最後に平文データを表示します:

javascript

function getString(data) {
var ret = ""
for (var i = 0; i < data.length; i++) {
ret += data[i].toString()
}
return ret
}
var aes_decrypt = Java.use("sg.vantagepoint.a.a")
aes_decrypt.a.overload("[B", "[B").implementation = function (var_0, var_1) {
send("sg.vantagepoint.a.a.a([B[B)[B   doFinal(enc)  // AES/ECB/PKCS7Padding")
send("Key       : " + getString(var_0))
send("Encrypted : " + getString(var_1))
var ret = this.a.overload("[B", "[B").call(this, var_0, var_1)
send("Decrypted : " + ret)

var flag = ""
for (var i = 0; i < ret.length; i++) {
flag += String.fromCharCode(ret[i])
}
send("Decrypted flag: " + flag)
return ret //[B
}

Hooking functions を自分の入力で呼び出す

文字列を受け取る関数をHookし、別の文字列で呼び出す (from here)

javascript

var string_class = Java.use("java.lang.String") // get a JS wrapper for java's String class

my_class.fun.overload("java.lang.String").implementation = function (x) {
//hooking the new function
var my_string = string_class.$new("My TeSt String#####") //creating a new String by using `new` operator
console.log("Original arg: " + x)
var ret = this.fun(my_string) // calling the original function with the new String, and putting its return value in ret variable
console.log("Return value: " + ret)
return ret
}

既に作成されたクラスのオブジェクトを取得する

作成済みのオブジェクトから属性を抽出したい場合は、これを使用できます。

この例では、クラス my_activity のオブジェクトを取得し、オブジェクトのプライベート属性を出力する .secret() 関数を呼び出す方法を示します:

javascript

Java.choose("com.example.a11x256.frida_test.my_activity", {
onMatch: function (instance) {
//This function will be called for every instance found by frida
console.log("Found instance: " + instance)
console.log("Result of secret func: " + instance.secret())
},
onComplete: function () {},
})

その他のFridaチュートリアル

参考資料

tip

HackTricksをサポートする

サブスクリプションプランを確認してください！
**💬 Discordグループまたはテレグラムグループに参加するか、Twitter 🐦 @hacktricks_liveをフォローしてください。
HackTricksおよびHackTricks CloudのGitHubリポジトリにPRを提出してハッキングトリックを共有してください。