Tutorial do Frida

Tip

Aprenda e pratique Hacking AWS:HackTricks Training AWS Red Team Expert (ARTE)
Aprenda e pratique Hacking GCP: HackTricks Training GCP Red Team Expert (GRTE) Aprenda e pratique Hacking Azure: HackTricks Training Azure Red Team Expert (AzRTE)

Supporte o HackTricks

• Confira os planos de assinatura!
• Junte-se ao 💬 grupo do Discord ou ao grupo do telegram ou siga-nos no Twitter 🐦 @hacktricks_live.
• Compartilhe truques de hacking enviando PRs para o HackTricks e HackTricks Cloud repositórios do github.

Instalação

Instale as frida tools:

pip install frida-tools
pip install frida

Baixe e instale no Android o frida server (Download the latest release).\
Comando único para reiniciar o adb em modo root, conectar-se a ele, enviar o frida-server, dar permissões de execução e executá-lo em segundo plano:

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

Verifique se está funcionando:

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

frida-ui (controlador Frida baseado em navegador)

frida-ui fornece uma interface web em http://127.0.0.1:8000 para listar devices/apps e attach ou spawn targets com scripts (não é necessário CLI).

• Instalar (fixar frida na versão do device server):

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

• Executar:

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

• Recursos: descobre dispositivos USB/locais, adiciona servidores remotos (192.168.1.x:27042) e suporta Attach, Spawn, and Spawn & Run (para hook antes da lógica inicial onCreate()).
• Scripting: editor, arrastar e soltar .js, importar CodeShare, baixar scripts e logs de sessão.
• Servidores remotos: ./frida-server -l 0.0.0.0:27042 -D expõe-o na rede para que frida-ui possa conectar-se sem ADB.

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

Duas maneiras comuns de instrumentar apps Android com Frida:

• Frida server (rooted devices): Push and run a native daemon that lets you attach to any process.
• Frida Gadget (no root): Empacotar Frida como uma biblioteca compartilhada dentro do APK e carregá-la automaticamente dentro do processo alvo.

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. Descompacte o APK, adicione o gadget .so e o arquivo de configuração:

• Coloque libfrida-gadget.so em lib/<abi>/ (por exemplo, lib/arm64-v8a/)
• Crie assets/frida-gadget.config com as configurações de carregamento dos seus scripts

Exemplo frida-gadget.config

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

2. Referencie/carregue o gadget para que ele seja inicializado cedo:

• Mais fácil: Adicione um pequeno stub Java que chame System.loadLibrary(“frida-gadget”) em Application.onCreate(), ou use o carregamento de biblioteca nativa já presente.

3. Reempacote e assine o APK, então instale:

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. Anexar do host ao processo do gadget:

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

Notas

• Gadget é detectado por algumas proteções; mantenha nomes/caminhos discretos e carregue tarde/condicionalmente se necessário.
• Em aplicativos reforçados, prefira testes em dispositivo com root usando server + late attach, ou combine com ocultação via Magisk/Zygisk.

Injeção Frida via JDWP sem root/repackaging (frida-jdwp-loader)

Se o APK for debuggable (android:debuggable=“true”), você pode anexar via JDWP e injetar uma biblioteca nativa em um ponto de interrupção Java. Sem root e sem repackaging do APK.

• Repositório: https://github.com/frankheat/frida-jdwp-loader
• Requisitos: ADB, Python 3, USB/Wireless debugging. O app precisa ser debuggable (emulador com ro.debuggable=1, dispositivo com root com resetprop, ou reconstruir o manifest).

Início rápido

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

Notas

• Modos: spawn (interrompe em Application.onCreate) ou attach (interrompe em Activity.onStart). Use -b para definir um método Java específico, -g para selecionar Gadget version/path, -p para escolher a porta JDWP.
• Modo listen: encaminhe o Gadget (padrão 127.0.0.1:27042) se necessário: adb forward tcp:27042 tcp:27042; depois frida-ps -H 127.0.0.1:27042.
• Isto aproveita o debug JDWP. O risco é distribuir builds com debuggable habilitado ou expor JDWP.

Agente autocontido + incorporação do Gadget (Frida 17+; automatizado com Objection)

Frida 17 removeu as bridges Java/ObjC embutidas do GumJS. Se seu agente faz hook em Java, você deve incluir a Java bridge dentro do seu bundle.

1. Crie um Frida agent (TypeScript) e inclua a 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

Hook Java mínimo (força as rolagens de dados para 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);
};
});

Construir um único bundle para incorporação:

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

Teste rápido de USB (opcional):

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

2. Configure o Gadget para carregar automaticamente seu script O patcher do Objection espera uma configuração do Gadget; ao usar o modo script, especifique o caminho no disco dentro do diretório lib do APK:

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

3. Automatizar APK patching com 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

What patchapk does (high level):

• Detects device ABI (e.g., arm64-v8a) and fetches matching Gadget
• Optionally adds android.permission.INTERNET when needed
• Injects a static class initializer calling System.loadLibrary(“frida-gadget”) into the launch activity
• Places the following under lib/<abi>/:
• libfrida-gadget.so
• libfrida-gadget.config.so (serialized 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. Verificar o 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

Alterações esperadas:

• AndroidManifest.xml pode incluir <uses-permission android:name="android.permission.INTERNET"/>
• Novas bibliotecas nativas em lib/<abi>/ conforme acima
• O smali da launchable activity contém um <clinit> estático que chama System.loadLibrary(“frida-gadget”)

5. Split APKs

• Patch the base APK (aquele que declara a activity MAIN/LAUNCHER)
• Re-sign remaining splits with the same key:

objection signapk split1.apk split2.apk ...

• Instale splits juntos:

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

• Para distribuição, você pode mesclar splits em um único APK com APKEditor, depois alinhar/assinar

Limpando FLAG_SECURE durante análise dinâmica

Aplicativos que chamam getWindow().setFlags(LayoutParams.FLAG_SECURE, LayoutParams.FLAG_SECURE) impedem capturas de tela, displays remotos e até as snapshots de tarefas recentes do Android. Quando o Freedom Chat aplicou essa flag, a única maneira de documentar os leaks foi manipular a janela em tempo de execução. Um padrão confiável é:

• Hook em todas as sobrecargas de Window que podem reaplicar a flag (setFlags, addFlags, setAttributes) e mascarar o bit 0x00002000 (WindowManager.LayoutParams.FLAG_SECURE).
• Depois que cada activity for retomada, agende uma chamada na UI-thread para clearFlags(FLAG_SECURE) para que Dialogs/Fragments criados depois herdem o estado desbloqueado.
• Apps construídos com React Native / Flutter frequentemente criam janelas aninhadas; hook os helpers android.app.Dialog/android.view.View ou percorra getWindow().peekDecorView() se você ainda ver frames pretos.

</details>

Execute o script com `frida -U -f <package> -l disable-flag-secure.js --no-pause`, interaja com a UI, e as capturas de tela/gravações voltarão a funcionar. Como tudo acontece na UI thread, não há flicker, e você ainda pode combinar o hook com HTTP Toolkit/Burp para capturar o tráfego que revelou o PIN `/channel` leak.


## Tutoriais

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

**Origem**: [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)\
**Código-fonte**: [https://github.com/t0thkr1s/frida-demo](https://github.com/t0thkr1s/frida-demo)

**Siga o [link para ler](frida-tutorial-1.md).**

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

**Origem**: [https://11x256.github.io/Frida-hooking-android-part-2/](https://11x256.github.io/Frida-hooking-android-part-2/) (Parts 2, 3 & 4)\
**APKs e código-fonte**: [https://github.com/11x256/frida-android-examples](https://github.com/11x256/frida-android-examples)

**Siga o [link para ler.](frida-tutorial-2.md)**

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

**Origem**: [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)

**Siga o [link para ler](owaspuncrackable-1.md).**

**Você pode encontrar mais scripts Frida aqui:** [**https://codeshare.frida.re/**](https://codeshare.frida.re)

## Exemplos Rápidos

### Chamando o Frida na linha de comando
```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.

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 funções e chamando-as com nossa entrada

Hook uma função que recebe uma string e chame-a com outra string (a partir de [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 () {},
})