Frida 튜토리얼

Reading time: 10 minutes

설치

다음으로 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 server vs. Gadget (root vs. no-root)

Two common ways to instrument Android apps with Frida:

• Frida server (rooted devices): 네이티브 데몬을 푸시하고 실행하여 어떤 프로세스에도 attach할 수 있게 해줍니다.
• Frida Gadget (no root): Frida를 APK 내부에 shared library로 번들링하고 대상 프로세스 내에서 자동으로 로드합니다.

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와 config를 추가하세요:

• 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. 가젯을 참조/로딩하여 초기에 초기화되도록 합니다:

• 가장 쉬운 방법: 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. 호스트에서 gadget 프로세스에 연결:

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

참고

• Gadget는 일부 보호 조치에서 탐지됩니다; 필요하면 이름/경로를 은폐하고 늦게 또는 조건부로 로드하세요.
• 보호가 강화된 앱에서는 rooted 테스트를 server + late attach와 함께 수행하거나 Magisk/Zygisk 숨김과 결합하는 것을 권장합니다.

독립형 에이전트 + Gadget 임베딩 (Frida 17+; Objection로 자동화)

Frida 17은 GumJS에서 내장된 Java/ObjC bridges를 제거했습니다. 에이전트가 Java를 후킹(hook)한다면 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 내부의 on-disk path를 지정하세요:

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

3. Objection으로 APK 패치 자동화

# 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 (your _agent.js)

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

5. Split APKs

• base APK(MAIN/LAUNCHER activity를 선언하는 APK)를 패치
• 나머지 splits을 동일한 키로 재서명:

objection signapk split1.apk split2.apk ...

• splits를 함께 설치:

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

• 배포를 위해, APKEditor로 분할된 APK들을 단일 APK로 병합한 뒤 align/sign 하세요.

방어적 메모 (보안 강화 시 확인할 사항)

• 서명/재패키징 검사와 런타임 무결성/attestation을 구현하세요
• 시작 시 예상치 못한 System.loadLibrary("frida-gadget") 호출이나 의심스러운 네이티브 라이브러리를 탐지하세요
• 사용하지 않는 INTERNET permission을 선언하지 마세요; gadget 탐지 표면을 줄이세요

튜토리얼

튜토리얼 1

출처: https://medium.com/infosec-adventures/introduction-to-frida-5a3f51595ca1
APK: https://github.com/t0thkr1s/frida-demo/releases
소스 코드: https://github.com/t0thkr1s/frida-demo

읽으려면 링크로 이동.

튜토리얼 2

출처: https://11x256.github.io/Frida-hooking-android-part-2/ (Parts 2, 3 & 4)
APKs 및 소스 코드: https://github.com/11x256/frida-android-examples

읽으려면 링크로 이동.

튜토리얼 3

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

읽으려면 링크로 이동.

더 많은 Frida 스크립트는 여기를 확인하세요: https://codeshare.frida.re/

빠른 예제

명령줄에서 Frida 호출하기

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 스크립트

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: 매개변수 없는 함수

클래스 sg.vantagepoint.a.c의 함수 a()를 Hook하세요.

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

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 함수(매개변수 포함) 및 값 가져오기

decryption function을 Hooking합니다. 입력을 출력하고, 원래 함수를 호출해 입력을 decrypt한 다음, 마지막으로 평문 데이터를 출력합니다:

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
}

함수를 후킹하고 우리 입력으로 호출하기

문자열을 받는 함수를 후킹하고 다른 문자열로 호출하세요 (출처: here)

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
}

이미 생성된 클래스의 객체 가져오기

이미 생성된 객체의 속성(attribute)을 추출하려면 이것을 사용할 수 있습니다.

이 예제에서는 클래스 my_activity의 객체를 얻는 방법과 객체의 private 속성을 출력하는 .secret() 함수를 호출하는 방법을 보여줍니다:

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 튜토리얼

• https://github.com/DERE-ad2001/Frida-Labs
• Part 1 of Advanced Frida Usage blog series: IOS Encryption Libraries

참고 자료

• Build a Repeatable Android Bug Bounty Lab: Emulator vs Magisk, Burp, Frida, and Medusa
• Frida Gadget documentation
• Frida releases (server binaries)
• Objection (SensePost)
• Modding And Distributing Mobile Apps with Frida