Samouczek Frida

Tip

Ucz się i ćwicz Hacking AWS:HackTricks Training AWS Red Team Expert (ARTE)
Ucz się i ćwicz Hacking GCP: HackTricks Training GCP Red Team Expert (GRTE) Ucz się i ćwicz Hacking Azure: HackTricks Training Azure Red Team Expert (AzRTE)

Wsparcie dla HackTricks

Instalacja

Zainstaluj frida tools:

pip install frida-tools
pip install frida

Pobierz i zainstaluj na urządzeniu z Androidem frida server (Download the latest release).
Jednolinijkowe polecenie do restartu adb w trybie root, połączenia z nim, przesłania frida-server, nadania praw wykonywania i uruchomienia go w tle:

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

Sprawdź czy to działa:

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

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

Dwa powszechne sposoby instrumentacji aplikacji Android za pomocą Frida:

  • Frida server (rooted devices): Wgraj i uruchom natywny daemon, który pozwala dołączyć do dowolnego procesu.
  • Frida Gadget (no root): Dołącz Frida jako bibliotekę współdzieloną do APK i automatycznie załaduj ją w docelowym procesie.

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. Rozpakuj APK, dodaj gadget .so i config:
  • Umieść libfrida-gadget.so w lib/<abi>/ (np. lib/arm64-v8a/)
  • Utwórz assets/frida-gadget.config z ustawieniami ładowania skryptu

Przykład frida-gadget.config

{
"interaction": { "type": "script", "path": "/sdcard/ssl-bypass.js" },
"runtime": { "logFile": "/sdcard/frida-gadget.log" }
}
  1. Odwołaj się/załaduj gadget tak, aby był zainicjalizowany wcześnie:
  • Najprościej: Dodaj mały Java stub wywołujący System.loadLibrary(“frida-gadget”) w Application.onCreate(), lub użyj istniejącego mechanizmu ładowania bibliotek natywnych.
  1. Przepakuj i podpisz APK, następnie zainstaluj:
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
  1. Dołącz z hosta do procesu gadget:
frida-ps -Uai
frida -U -n com.example.app

Uwagi

  • Gadget jest wykrywany przez niektóre mechanizmy ochronne; zachowaj nazwy/ścieżki w ukryciu i ładuj późno/warunkowo, jeśli to konieczne.
  • W przypadku wzmocnionych aplikacji preferuj rooted testing z server + late attach, lub połącz z Magisk/Zygisk hiding.

Wstrzykiwanie Frida oparte na JDWP bez root/repackaging (frida-jdwp-loader)

Jeśli APK jest debuggable (android:debuggable=“true”), możesz podłączyć się przez JDWP i wstrzyknąć native library w Java breakpoint. Nie wymaga roota ani repackagingu APK.

  • Repo: https://github.com/frankheat/frida-jdwp-loader
  • Wymagania: ADB, Python 3, USB/Wireless debugging. Aplikacja musi być debuggable (emulator with ro.debuggable=1, rooted device with resetprop, or rebuild manifest).

Szybki start

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

Uwagi

  • Tryby: spawn (break at Application.onCreate) lub attach (break at Activity.onStart). Użyj -b aby ustawić konkretną metodę Java, -g aby wybrać wersję/ścieżkę Gadget, -p aby wybrać port JDWP.
  • Tryb nasłuchu: przekieruj Gadget (domyślnie 127.0.0.1:27042) jeśli potrzeba: adb forward tcp:27042 tcp:27042; następnie frida-ps -H 127.0.0.1:27042.
  • To wykorzystuje JDWP debugging. Ryzyko to dostarczanie debugowalnych buildów lub wystawienie JDWP.

Samodzielny agent + osadzenie Gadget (Frida 17+; zautomatyzowane przy użyciu Objection)

Frida 17 usunął wbudowane Java/ObjC bridges z GumJS. Jeśli twój agent hooks Java, musisz dołączyć Java bridge do swojego bundle.

  1. Utwórz agenta Frida (TypeScript) i dołącz 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

Minimalny Java hook (wymusza rzuty kośćmi na 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);
};
});

Zbuduj pojedynczy bundle do osadzenia:

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

Szybki test USB (opcjonalnie):

frida -U -f org.secuso.privacyfriendlydicer -l _agent.js
  1. Skonfiguruj Gadget, aby automatycznie wczytywał twój script Objection’s patcher oczekuje Gadget config; kiedy używasz script mode, wskaż on-disk path wewnątrz APK lib dir:
{
"interaction": {
"type": "script",
"path": "libfrida-gadget.script.so"
}
}
  1. Automatyzuj patchowanie APK za pomocą 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

Co robi patchapk (wysoki poziom):

  • Wykrywa ABI urządzenia (np. arm64-v8a) i pobiera pasujący Gadget
  • Opcjonalnie dodaje android.permission.INTERNET, gdy jest potrzebne
  • Wstrzykuje statyczny inicjalizator klasy wywołujący System.loadLibrary(“frida-gadget”) do launch activity
  • Umieszcza następujące pliki pod lib/<abi>/:
  • libfrida-gadget.so
  • libfrida-gadget.config.so (serialized config)
  • libfrida-gadget.script.so (your _agent.js)

Przykładowy wstrzyknięty smali (statyczny inicjalizator):

.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
  1. Zweryfikuj 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

Expected changes:

  • AndroidManifest.xml może zawierać <uses-permission android:name="android.permission.INTERNET"/>
  • Nowe natywne biblioteki w lib/<abi>/, jak wyżej
  • Launchable activity smali zawiera statyczny <clinit>, który wywołuje System.loadLibrary(“frida-gadget”)
  1. Split APKs
  • Załataj bazowy APK (ten, który deklaruje aktywność MAIN/LAUNCHER)
  • Ponownie podpisz pozostałe splity tym samym kluczem:
objection signapk split1.apk split2.apk ...
  • Zainstaluj splits razem:
adb install-multiple split1.apk split2.apk ...
  • Do dystrybucji możesz połączyć splity w pojedynczy APK przy użyciu APKEditor, a następnie align/sign

Czyszczenie FLAG_SECURE podczas analizy dynamicznej

Aplikacje, które wywołują getWindow().setFlags(LayoutParams.FLAG_SECURE, LayoutParams.FLAG_SECURE) uniemożliwiają wykonywanie zrzutów ekranu, zdalne wyświetlanie i nawet podglądy ostatnich zadań Androida. Gdy Freedom Chat wymuszał ten flag jedynym sposobem na udokumentowanie leaks było manipulowanie oknem w czasie działania. Sprawdzony schemat to:

  • Hook wszystkie przeciążenia Window, które mogą ponownie ustawić flagę (setFlags, addFlags, setAttributes) i zamaskować bit 0x00002000 (WindowManager.LayoutParams.FLAG_SECURE).
  • Po wznowieniu każdej aktywności zaplanuj wywołanie w wątku UI clearFlags(FLAG_SECURE), aby Dialogi/Fragmenty tworzone później odziedziczyły odblokowany stan.
  • Aplikacje zbudowane w React Native / Flutter często tworzą zagnieżdżone okna; hook pomocniki android.app.Dialog/android.view.View lub przejdź przez getWindow().peekDecorView() jeśli nadal widzisz czarne ramki.
Frida hook czyszczący Window.FLAG_SECURE ```javascript Java.perform(function () { var LayoutParams = Java.use("android.view.WindowManager$LayoutParams"); var FLAG_SECURE = LayoutParams.FLAG_SECURE.value; var Window = Java.use("android.view.Window"); var Activity = Java.use("android.app.Activity");

function strip(value) { var masked = value & (~FLAG_SECURE); if (masked !== value) { console.log(“[-] Stripped FLAG_SECURE from 0x” + value.toString(16)); } return masked; }

Window.setFlags.overload(‘int’, ‘int’).implementation = function (flags, mask) { return this.setFlags.call(this, strip(flags), strip(mask)); };

Window.addFlags.implementation = function (flags) { return this.addFlags.call(this, strip(flags)); };

Window.setAttributes.implementation = function (attrs) { attrs.flags.value = strip(attrs.flags.value); return this.setAttributes.call(this, attrs); };

Activity.onResume.implementation = function () { this.onResume(); var self = this; Java.scheduleOnMainThread(function () { try { self.getWindow().clearFlags(FLAG_SECURE); console.log(“[+] Cleared FLAG_SECURE on “ + self.getClass().getName()); } catch (err) { console.log(”[!] clearFlags failed: “ + err); } }); }; });

</details>

Uruchom skrypt za pomocą `frida -U -f <package> -l disable-flag-secure.js --no-pause`, wejdź w interakcję z UI, a zrzuty ekranu/nagrania będą ponownie działać. Ponieważ wszystko dzieje się w wątku UI, nie ma migotania, i nadal możesz łączyć hook z HTTP Toolkit/Burp, aby przechwycić ruch, który ujawnił `/channel` PIN leak.


## Samouczki

### [Tutorial 1](frida-tutorial-1.md)

**Źródło**: [https://medium.com/infosec-adventures/introduction-to-frida-5a3f51595ca1](https://medium.com/infosec-adventures/introduction-to-frida-5a3f51595ca1)\
**APK**: [https://github.com/t0thkr1s/frida-demo/releases](https://github.com/t0thkr1s/frida-demo/releases)\
**Kod źródłowy**: [https://github.com/t0thkr1s/frida-demo](https://github.com/t0thkr1s/frida-demo)

**Przejdź do [link to read it](frida-tutorial-1.md).**

### [Tutorial 2](frida-tutorial-2.md)

**Źródło**: [https://11x256.github.io/Frida-hooking-android-part-2/](https://11x256.github.io/Frida-hooking-android-part-2/) (Części 2, 3 & 4)\
**APKs i kod źródłowy**: [https://github.com/11x256/frida-android-examples](https://github.com/11x256/frida-android-examples)

**Przejdź do [link to read it.](frida-tutorial-2.md)**

### [Tutorial 3](owaspuncrackable-1.md)

**Źródło**: [https://joshspicer.com/android-frida-1](https://joshspicer.com/android-frida-1)\
**APK**: [https://github.com/OWASP/owasp-mstg/blob/master/Crackmes/Android/Level_01/UnCrackable-Level1.apk](https://github.com/OWASP/owasp-mstg/blob/master/Crackmes/Android/Level_01/UnCrackable-Level1.apk)

**Przejdź do [link to read it](owaspuncrackable-1.md).**

**Możesz znaleźć więcej Awesome Frida scripts tutaj:** [**https://codeshare.frida.re/**](https://codeshare.frida.re)

## Szybkie przykłady

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

Podstawowy skrypt Pythona

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

Hooking funkcji bez parametrów

Hook funkcję a() klasy sg.vantagepoint.a.c

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

Hook java exit()

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

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

Hook android .onCreate()

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

Hooking funkcji z parametrami i pobierania wartości

Hooking a decryption function. Wypisz input, wywołaj oryginalną funkcję, decrypt the input i na końcu wypisz plain data:

Hooking a decryption function (Java) — wypisz wejścia/wyjścia ```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 }

</details>

### Hooking funkcji i wywoływanie ich z naszym wejściem

Hook funkcję, która otrzymuje string i wywołaj ją z innym stringiem (z [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
}

Pobieranie już utworzonego obiektu klasy

Jeśli chcesz wydobyć jakiś atrybut z utworzonego obiektu, możesz skorzystać z tego podejścia.

W tym przykładzie zobaczysz, jak pobrać obiekt klasy my_activity i jak wywołać funkcję .secret(), która wyświetli prywatny atrybut obiektu:

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

Inne poradniki Frida

Źródła

Tip

Ucz się i ćwicz Hacking AWS:HackTricks Training AWS Red Team Expert (ARTE)
Ucz się i ćwicz Hacking GCP: HackTricks Training GCP Red Team Expert (GRTE) Ucz się i ćwicz Hacking Azure: HackTricks Training Azure Red Team Expert (AzRTE)

Wsparcie dla HackTricks