Frida Kılavuzu

Tip

AWS Hacking’i öğrenin ve pratik yapın:HackTricks Training AWS Red Team Expert (ARTE)
GCP Hacking’i öğrenin ve pratik yapın: HackTricks Training GCP Red Team Expert (GRTE) Azure Hacking’i öğrenin ve pratik yapın: HackTricks Training Azure Red Team Expert (AzRTE)

HackTricks'i Destekleyin

• abonelik planlarını kontrol edin!
• 💬 Discord grubuna veya telegram grubuna katılın ya da Twitter’da bizi takip edin 🐦 @hacktricks_live.**
• Hacking ipuçlarını paylaşmak için HackTricks ve HackTricks Cloud github reposuna PR gönderin.

Kurulum

Yükleyin frida tools:

pip install frida-tools
pip install frida

İndirip kurun Android’e frida server (Download the latest release).
adb’yi root modunda yeniden başlatmak, ona bağlanmak, frida-server’ı yüklemek, çalıştırma izinleri verip arka planda çalıştırmak için tek satırlık komut:

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

Bunun çalışıyor olup olmadığını kontrol edin:

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

frida-ui (tarayıcı tabanlı Frida denetleyicisi)

frida-ui http://127.0.0.1:8000 adresinde cihazları/uygulamaları listelemek ve hedeflere scripts ile attach veya spawn yapmak için bir web UI sağlar (CLI gerekmez).

• Kurulum (frida’ı device server sürümüne pinleyin):

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

• Çalıştır:

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

• Özellikler: USB/yerel cihazları keşfeder, uzak sunucular ekler (192.168.1.x:27042) ve Attach, Spawn, ve Spawn & Run destekler (erken onCreate() mantığından önce hook yapmak için).
• Scripting: editör, sürükle ve bırak .js, CodeShare içe aktar, scriptleri ve oturum loglarını indir.
• Uzak sunucular: ./frida-server -l 0.0.0.0:27042 -D bunu ağ üzerinde açar, böylece frida-ui ADB olmadan bağlanabilir.

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

Frida ile Android uygulamalarını enstrümante etmenin iki yaygın yolu:

• Frida server (rooted devices): Yerel bir daemon’u push edip çalıştırır; bu daemon herhangi bir prosese attach olmanızı sağlar.
• Frida Gadget (no root): Frida’yı APK içine shared library olarak paketler ve hedef süreç içinde otomatik olarak yükler.

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’yi açın, gadget .so ve config ekleyin:

• libfrida-gadget.so dosyasını lib/<abi>/ içine koyun (örn., lib/arm64-v8a/)
• assets/frida-gadget.config dosyasını script yükleme ayarlarınızla oluşturun

Örnek frida-gadget.config

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

2. Gadget’i erken başlatılacak şekilde referanslayın/yükleyin:

• En kolay: Application.onCreate() içine System.loadLibrary(“frida-gadget”) çağıran küçük bir Java stub ekleyin veya zaten mevcut olan native lib yüklemesini kullanın.

3. APK’ı yeniden paketleyip imzalayın, sonra yükleyin:

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’tan gadget process’e bağlan:

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

Notlar

• Gadget bazı korumalar tarafından tespit edilebilir; isimleri/yolları gizli tutun ve gerekiyorsa geç/koşullu olarak yükleyin.
• Sertleştirilmiş uygulamalarda, server + late attach ile rooted testing’i tercih edin veya Magisk/Zygisk gizlemesiyle birleştirin.

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

APK debuggable ise (android:debuggable=“true”), JDWP üzerinden bağlanıp bir Java breakpoint’inde native bir kütüphane enjekte edebilirsiniz. Root yok ve APK repackaging yok.

• Repo: https://github.com/frankheat/frida-jdwp-loader
• Gereksinimler: ADB, Python 3, USB/Wireless debugging. Uygulama debuggable olmalıdır (emülatörde ro.debuggable=1, rootlu cihazda resetprop, veya manifest’i yeniden derleme).

Hızlı başlangıç:

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

Notlar

• Modlar: spawn (break at Application.onCreate) veya attach (break at Activity.onStart). Belirli bir Java metodunu ayarlamak için -b kullanın, Gadget sürüm/yolunu seçmek için -g, JDWP portunu seçmek için -p.
• Listen modu: gerekirse Gadget’i yönlendirin (varsayılan 127.0.0.1:27042): adb forward tcp:27042 tcp:27042; sonra frida-ps -H 127.0.0.1:27042.
• Bu, JDWP debugging’inden yararlanır. Risk, debuggable builds gönderilmesi veya JDWP’nin açığa çıkmasıdır.

Bağımsız agent + Gadget gömme (Frida 17+; Objection ile otomatikleştirilmiş)

Frida 17, GumJS’ten yerleşik Java/ObjC köprülerini kaldırdı. Agent’iniz Java’yı hookluyorsa, Java köprüsünü bundle’ınızın içine eklemelisiniz.

1. Bir Frida agent (TypeScript) oluşturun ve Java köprüsünü ekleyin

# 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

Minimal Java hook (zar atışlarını 1’e zorlar):

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

Gömme için tek bir paket oluşturun:

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

Hızlı USB testi (isteğe bağlı):

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

2. Gadget’ı scriptinizi otomatik yükleyecek şekilde yapılandırın Objection’s patcher bir Gadget config bekler; script mode kullanırken, APK lib dir içindeki disk yolunu belirtin:

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

3. Objection ile APK patching’i otomatikleştir

# 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’in yaptığı (yüksek düzey):

• Cihazın ABI’sini algılar (ör. arm64-v8a) ve eşleşen Gadget’i getirir
• Gerekirse android.permission.INTERNET’i isteğe bağlı olarak ekler
• Başlatma aktivitesine System.loadLibrary(“frida-gadget”) çağıran statik sınıf başlatıcısını enjekte eder
• Aşağıdakileri lib/<abi>/ altına yerleştirir:
• libfrida-gadget.so
• libfrida-gadget.config.so (serileştirilmiş config)
• libfrida-gadget.script.so (_agent.js’iniz)

Örnek enjekte edilmiş smali (statik başlatıcı):

.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’i doğrulayın

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

Beklenen değişiklikler:

• AndroidManifest.xml <uses-permission android:name="android.permission.INTERNET"/> içerebilir
• Yukarıda olduğu gibi lib/<abi>/ altında yeni native kütüphaneler
• Launchable activity smali’si, System.loadLibrary(“frida-gadget”) çağıran statik <clinit> içerir

5. Split APKs

• Base APK’yi patch’leyin (MAIN/LAUNCHER activity’yi bildiren)
• Kalan split’leri aynı anahtarla yeniden imzalayın:

objection signapk split1.apk split2.apk ...

• Split’leri birlikte yükle:

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

• Dağıtım için, APKEditor ile split’leri tek bir APK’de birleştirip sonra align/sign yapabilirsiniz

Dinamik analiz sırasında FLAG_SECURE’i temizleme

getWindow().setFlags(LayoutParams.FLAG_SECURE, LayoutParams.FLAG_SECURE) çağıran uygulamalar ekran görüntülerini, uzak ekranları ve hatta Android’in recent-task anlık görüntülerini engeller. Freedom Chat bu flag’i zorladığında, leaks’leri belgelemek için tek yol çalışma zamanında pencere ile müdahale etmekti. Güvenilir bir yöntem:

• Hook every Window overload that can re-apply the flag (setFlags, addFlags, setAttributes) and mask out bit 0x00002000 (WindowManager.LayoutParams.FLAG_SECURE).
• Her activity resume olduktan sonra, sonraki Dialog/Fragment’lerin kilitsiz durumu miras alması için UI-thread üzerinde clearFlags(FLAG_SECURE) çağrısını zamanlayın.
• React Native / Flutter ile oluşturulan uygulamalar genellikle iç içe pencereler yaratır; hala siyah çerçeveler görüyorsanız android.app.Dialog/android.view.View yardımcılarını hooklayın veya getWindow().peekDecorView() ile gezinin.

</details>

Betiği `frida -U -f <package> -l disable-flag-secure.js --no-pause` ile çalıştırın, UI ile etkileşime girin; ekran görüntüleri/kayıtlar tekrar çalışacaktır. Her şey UI iş parçacığında gerçekleştiği için göz kırpma olmaz ve hook'u HTTP Toolkit/Burp ile birleştirerek `/channel` PIN leak'ini ortaya çıkaran trafiği yakalayabilirsiniz.

## clsdumper (Frida) ile Dinamik DEX dumping / unpacking

`clsdumper`, anti-Frida ön aşaması ile native ve Java keşif stratejilerini birleştirerek hardened apps'lere karşı dayanıklı olan Frida tabanlı dinamik **DEX/class dumper**'dır (`Java.perform()` öldüğünde bile çalışır). Gereksinimler: Python 3.10+, rootlu cihazda `frida-server` çalışıyor olmalı, USB veya `--host` TCP bağlantısı.

**Kurulum & hızlı kullanım**
```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 fonksiyonları ve bunları girdimizle çağırma

Bir string alan bir fonksiyonu Hook'layın ve onu başka bir string ile çağırın (from [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 () {},
})