Frida 튜토리얼

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 지원하기

• 구독 계획 확인하기!
• **💬 디스코드 그룹 또는 텔레그램 그룹에 참여하거나 트위터 🐦 @hacktricks_live를 팔로우하세요.
• HackTricks 및 HackTricks Cloud 깃허브 리포지토리에 PR을 제출하여 해킹 트릭을 공유하세요.

설치

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를 나열하고 scripts로 targets에 attach하거나 spawn할 수 있는 웹 UI를 제공합니다 (CLI 불필요).

• 설치 (device server 버전에 맞게 frida를 고정):

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

• 기능: USB/로컬 장치 검색, 원격 서버 추가 (192.168.1.x:27042), 그리고 Attach, Spawn, Spawn & Run (초기 onCreate() 로직 이전에 훅을 걸기 위해)을 지원합니다.
• 스크립팅: 편집기, .js 드래그 앤 드롭, CodeShare 가져오기, 스크립트 및 세션 로그 다운로드.
• 원격 서버: ./frida-server -l 0.0.0.0:27042 -D는 네트워크에 노출시켜 frida-ui가 ADB 없이 연결할 수 있게 합니다.

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

Frida로 Android 앱을 계측하는 두 가지 일반적인 방법:

• Frida server (rooted devices): 네이티브 데몬을 푸시하고 실행하여 어떤 프로세스에도 attach할 수 있게 합니다.
• Frida Gadget (no root): Frida를 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>/ (e.g., lib/arm64-v8a/)에 넣습니다
• assets/frida-gadget.config를 스크립트 로딩 설정으로 생성합니다

Example frida-gadget.config

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

2. gadget를 참조/로드하여 조기에 초기화되도록 함:

• 가장 쉬운 방법: Application.onCreate()에 System.loadLibrary(“frida-gadget”)를 호출하는 작은 Java 스텁을 추가하거나, 이미 존재하는 네이티브 라이브러리 로딩을 사용하세요.

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 프로세스에 Attach:

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

Notes

• Gadget는 일부 보호 메커니즘에 의해 탐지됩니다; 필요 시 이름/경로를 은밀하게 하고 늦게/조건부로 로드하세요.
• 하드닝된 앱에서는 rooted 테스트를 server + late attach로 수행하는 것을 권장하거나 Magisk/Zygisk 숨김과 결합하세요.

JDWP 기반 Frida 주입 (root/repackaging 불필요) (frida-jdwp-loader)

APK가 debuggable(android:debuggable=“true”)이면, JDWP로 attach하여 Java breakpoint에서 native library를 inject할 수 있습니다. No root 및 APK repackaging이 필요 없습니다.

• Repo: https://github.com/frankheat/frida-jdwp-loader
• Requirements: ADB, Python 3, USB/Wireless debugging. App는 debuggable이어야 합니다 (emulator에서 ro.debuggable=1, rooted device에서 resetprop 사용, 또는 manifest 재빌드).

Quick 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

참고

• 모드: spawn (Application.onCreate에서 중단) 또는 attach (Activity.onStart에서 중단). 특정 Java 메서드를 설정하려면 -b를 사용하고, Gadget 버전/경로를 선택하려면 -g, JDWP 포트를 선택하려면 -p를 사용합니다.
• Listen 모드: 필요 시 Gadget을 포워딩(기본 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는 GumJS에서 내장된 Java/ObjC 브리지를 제거했습니다. 에이전트가 Java를 후킹한다면, Java bridge를 번들에 포함해야 합니다.

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

임베딩을 위한 단일 번들 빌드:

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

간단한 USB 테스트 (선택 사항):

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

2. Gadget가 스크립트를 자동으로 로드하도록 구성 Objection의 patcher는 Gadget config를 기대합니다; script mode를 사용할 때는 APK lib dir 내부의 디스크상의 경로를 지정하세요:

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

3. Objection으로 APK patching 자동화

# 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(예: arm64-v8a)를 감지하고 일치하는 Gadget을 가져옵니다
• 필요한 경우 android.permission.INTERNET 권한을 선택적으로 추가합니다
• launch activity에 System.loadLibrary(“frida-gadget”)를 호출하는 static class initializer를 주입합니다
• 다음 파일들을 lib/<abi>/ 아래에 배치합니다:
• libfrida-gadget.so
• libfrida-gadget.config.so (직렬화된 설정)
• libfrida-gadget.script.so (사용자의 _agent.js)

주입된 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

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"/>가 포함될 수 있음
• 위와 같이 lib/<abi>/ 아래에 새로운 네이티브 라이브러리가 추가됨
• Launchable activity의 smali에는 static <clinit>가 포함되어 있으며 System.loadLibrary(“frida-gadget”)를 호출함

5. Split APKs

• 기본 APK( the one that declares MAIN/LAUNCHER activity)를 패치
• 나머지 splits를 동일한 키로 재서명:

objection signapk split1.apk split2.apk ...

• splits을 함께 설치:

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

• 배포를 위해, splits를 APKEditor로 단일 APK로 병합한 다음 align/sign할 수 있습니다

동적 분석 중 FLAG_SECURE 제거

getWindow().setFlags(LayoutParams.FLAG_SECURE, LayoutParams.FLAG_SECURE)를 호출하는 앱은 스크린샷, 원격 디스플레이 및 심지어 Android의 최근 작업 스냅샷을 차단합니다. Freedom Chat가 이 플래그를 적용했을 때 leaks를 문서화하는 유일한 방법은 런타임에 윈도우를 조작하는 것이었습니다. 신뢰할 수 있는 패턴은 다음과 같습니다:

• 플래그를 다시 적용할 수 있는 모든 Window 오버로드(setFlags, addFlags, setAttributes)를 Hook하고 비트 0x00002000 (WindowManager.LayoutParams.FLAG_SECURE)을 마스크합니다.
• 각 activity가 resume된 후, UI 스레드에서 clearFlags(FLAG_SECURE)를 호출하도록 예약하여 이후 생성되는 Dialogs/Fragments가 잠금 해제된 상태를 상속받게 합니다.
• React Native / Flutter로 빌드된 앱은 종종 중첩된 윈도우를 생성합니다; 여전히 black frames가 보이면 android.app.Dialog/android.view.View 헬퍼를 hook하거나 getWindow().peekDecorView()를 순회하세요.

</details>

Run the script with `frida -U -f <package> -l disable-flag-secure.js --no-pause`, interact with the UI, and screenshots/recordings will work again. Because everything happens on the UI thread there is no flicker, and you can still combine the hook with HTTP Toolkit/Burp to capture the traffic that revealed the `/channel` PIN leak.

## clsdumper(Frida)를 이용한 Dynamic DEX 덤핑/언패킹

`clsdumper`는 Frida 기반의 동적 **DEX/class dumper**로, anti-Frida pre-stage와 native 및 Java discovery strategies를 결합해 하드닝된 앱을 우회합니다(심지어 `Java.perform()`이 죽어도 동작). 요구사항: Python 3.10+, 루팅된 디바이스에서 `frida-server`가 실행 중이어야 하며, USB 또는 `--host` TCP 연결이 필요합니다.

**설치 및 빠른 사용법**
```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 함수들을 우리 입력으로 호출하기

string을 받는 함수를 Hook하고 다른 string으로 호출하세요 (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 () {},
})