Frida — посібник

Tip

Вивчайте та практикуйте AWS Hacking:HackTricks Training AWS Red Team Expert (ARTE)
Вивчайте та практикуйте GCP Hacking: HackTricks Training GCP Red Team Expert (GRTE) Вивчайте та практикуйте Azure Hacking: HackTricks Training Azure Red Team Expert (AzRTE)

Підтримайте HackTricks

• Перевірте плани підписки!
• Приєднуйтесь до 💬 групи Discord або групи telegram або слідкуйте за нами в Twitter 🐦 @hacktricks_live.
• Діліться хакерськими трюками, надсилаючи PR до HackTricks та HackTricks Cloud репозиторіїв на github.

Встановлення

Встановіть frida tools:

pip install frida-tools
pip install frida

Завантажте та встановіть на Android frida server (Download the latest release).
Команда в один рядок для перезапуску adb у root-режимі, підключення до пристрою, завантаження frida-server, надання прав виконання та запуску його у фоновому режимі:

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 &"

Перевірте, чи це працює:

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

frida-ui (браузерний контролер Frida)

frida-ui надає веб-інтерфейс на http://127.0.0.1:8000 для переліку devices/apps та attach або spawn targets зі скриптами (CLI не потрібен).

• Встановлення (pin frida to the device server version):

uv tool install frida-ui --with frida==16.7.19
# pipx install frida-ui
# pip install frida-ui

• Запустіть:

frida-ui
frida-ui --host 127.0.0.1 --port 8000 --reload

• Features: виявляє USB/локальні пристрої, додає віддалені сервери (192.168.1.x:27042), і підтримує Attach, Spawn, та Spawn & Run (щоб hook перед ранньою логікою onCreate()).
• Scripting: редактор, drag & drop .js, імпорт CodeShare, завантаження скриптів і журналів сесій.
• Remote servers: ./frida-server -l 0.0.0.0:27042 -D експонує його в мережі, щоб frida-ui могла підключитися без ADB.

Frida server vs. Gadget (root vs. no-root)

Два поширені способи інструментування додатків Android за допомогою Frida:

• Frida server (rooted devices): Завантажує та запускає нативний демон, який дозволяє attach до будь-якого процесу.
• Frida Gadget (no root): Включає Frida як shared library всередині APK і автоматично завантажує її всередині цільового процесу.

Frida server (rooted)

# 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)

1. Розпакуйте APK, додайте gadget .so та конфігурацію:

• Помістіть libfrida-gadget.so у lib/<abi>/ (наприклад, lib/arm64-v8a/)
• Створіть assets/frida-gadget.config з налаштуваннями завантаження ваших скриптів

Приклад frida-gadget.config

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

2. Підключіть/завантажте gadget так, щоб він ініціалізувався на ранньому етапі:

• Найпростіше: Додайте невеликий Java stub з викликом System.loadLibrary(“frida-gadget”) в Application.onCreate(), або скористайтеся вже наявним механізмом завантаження native-бібліотек.

3. Перепакуйте та підпишіть APK, потім встановіть:

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

4. Підключіться з host до процесу gadget:

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

Примітки

• Gadget виявляється деякими механізмами захисту; тримайте імена/шляхи прихованими й завантажуйте пізно/умовно за потреби.
• Для захищених додатків краще тестувати на рутованому пристрої з сервером + пізнім приєднанням, або комбінувати з приховуванням через Magisk/Zygisk.

JDWP-based Frida injection without root/repackaging (frida-jdwp-loader)

Якщо APK є debuggable (android:debuggable=“true”), ви можете приєднатися через JDWP і інжектувати нативну бібліотеку в Java breakpoint. Без root і без перепакування APK.

• Repo: https://github.com/frankheat/frida-jdwp-loader
• Вимоги: ADB, Python 3, USB/бездротове debugging. Додаток має бути debuggable (емулятор з ro.debuggable=1, рутований пристрій з resetprop, або перебудувати маніфест).

Швидкий старт:

git clone https://github.com/frankheat/frida-jdwp-loader.git
cd frida-jdwp-loader
# Inject frida-gadget.so into a debuggable target
python frida-jdwp-loader.py frida -n com.example.myapplication
# Keep the breakpoint thread suspended for early hooks
python frida-jdwp-loader.py frida -n com.example.myapplication -s
# Networkless: run a local agent script via Gadget "script" mode
python frida-jdwp-loader.py frida -n com.example.myapplication -i script -l script.js

Notes

• Режими: spawn (break at Application.onCreate) або attach (break at Activity.onStart). Використовуйте -b щоб вказати конкретний Java method, -g щоб вибрати Gadget version/path, -p щоб обрати JDWP порт.
• Режим прослуховування: forward Gadget (default 127.0.0.1:27042) за потреби: adb forward tcp:27042 tcp:27042; потім frida-ps -H 127.0.0.1:27042.
• Це використовує JDWP для налагодження. Ризик — відвантаження debuggable builds або відкриття JDWP.

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

Frida 17 removed the built-in Java/ObjC bridges from GumJS. If your agent hooks Java, you must include the Java bridge inside your bundle.

1. Створіть Frida agent (TypeScript) і включіть Java bridge

# 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);
};
});

Створити один bundle для вбудовування:

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

Швидкий USB-тест (необов’язково):

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

2. Налаштуйте Gadget для автоматичного завантаження вашого скрипта Objection’s patcher очікує конфігурацію Gadget; при використанні script mode вкажіть on-disk path всередині APK lib dir:

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

3. Автоматизувати патчування APK за допомогою Objection

# 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

Що робить patchapk (високорівнево):

• Визначає ABI пристрою (e.g., arm64-v8a) і завантажує відповідний Gadget
• За потреби додає android.permission.INTERNET
• Вставляє статичний ініціалізатор класу, який викликає System.loadLibrary(“frida-gadget”) у launch activity
• Розміщує наступні файли під lib/<abi>/:
• libfrida-gadget.so
• libfrida-gadget.config.so (серіалізована конфігурація)
• libfrida-gadget.script.so (your _agent.js)

Приклад інжектованого smali (static initializer):

.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

4. Перевірте repack

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"/>
• Нові native libs у lib/<abi>/ як вище
• Launchable activity smali містить статичний <clinit>, який викликає System.loadLibrary(“frida-gadget”)

5. Split APKs

• Запатчити base APK (той, що оголошує MAIN/LAUNCHER activity)
• Пере-підписати решту splits тим самим ключем:

objection signapk split1.apk split2.apk ...

• Встановити splits разом:

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

• Для розповсюдження ви можете об’єднати splits в один APK за допомогою APKEditor, а потім align/sign

Очищення FLAG_SECURE під час динамічного аналізу

Додатки, які викликають getWindow().setFlags(LayoutParams.FLAG_SECURE, LayoutParams.FLAG_SECURE), забороняють знімки екрана, віддалені відображення та навіть знімки в списку недавніх задач Android. Коли Freedom Chat застосував цей прапор, єдиним способом задокументувати leaks було втручання у вікно під час виконання. Надійний підхід такий:

• Перехопіть (hook) кожне перевантаження Window, яке може знову застосувати прапор (setFlags, addFlags, setAttributes) і замаскуйте біт 0x00002000 (WindowManager.LayoutParams.FLAG_SECURE).
• Після відновлення кожної activity заплануйте виклик у UI-потоці clearFlags(FLAG_SECURE), щоб Dialogs/Fragments, створені пізніше, успадковували розблокований стан.
• Додатки, збудовані з React Native / Flutter, часто створюють вкладені вікна; hook помічники android.app.Dialog/android.view.View або пройдіться по getWindow().peekDecorView(), якщо ви все ще бачите чорні кадри.

</details>

Запустіть скрипт командою `frida -U -f <package> -l disable-flag-secure.js --no-pause`, взаємодійте з UI, і знімки екрана/записи знову працюватимуть. Оскільки все відбувається в UI thread, блимання немає, і ви все ще можете поєднати цей hook з HTTP Toolkit/Burp, щоб перехопити трафік, який розкрив `/channel` PIN leak.

## Динамічне дампування/розпакування DEX за допомогою clsdumper (Frida)

`clsdumper` — Frida-based динамічний **DEX/class dumper**, який витримує hardened apps, комбінуючи an anti-Frida pre-stage з native та Java discovery strategies (працює навіть якщо `Java.perform()` помирає). Вимоги: Python 3.10+, rooted device з запущеним `frida-server`, USB або `--host` TCP connection.

**Встановлення та швидкий старт**
```bash
pip install clsdumper
# Attach to a running app
clsdumper com.example.app
# Spawn first (hooks before early loaders)
clsdumper com.example.app --spawn
# Select strategies
clsdumper com.example.app --strategies fart_dump,oat_extract

dump_<target>/
dex/classes_001.dex ...
classes/                 # only when --extract-classes
metadata.json            # strategy per hit + hashes

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.

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()

Java.perform(function () {
rootcheck1.a.overload().implementation = function () {
return false;
};
});

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  :)")
}

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)
}

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)
}

</details>

### Hooking functions and calling them with our input

Перехопіть функцію, яка отримує string, і викличте її з іншим string (з [here](https://11x256.github.io/Frida-hooking-android-part-2/))
```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
}

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 () {},
})