hacktricks/mobile-pentesting/android-app-pentesting/frida-tutorial/README.md

18 KiB

Tutorial do Frida

☁️ HackTricks Cloud ☁️ -🐦 Twitter 🐦 - 🎙️ Twitch 🎙️ - 🎥 Youtube 🎥

Dica de bug bounty: inscreva-se no Intigriti, uma plataforma premium de bug bounty criada por hackers, para hackers! Junte-se a nós em https://go.intigriti.com/hacktricks hoje mesmo e comece a ganhar recompensas de até $100.000!

{% embed url="https://go.intigriti.com/hacktricks" %}

Instalação

Instale as ferramentas do frida:

pip install frida-tools
pip install frida

Baixe e instale no Android o servidor frida (Baixe a versão mais recente).
Um comando para reiniciar o adb no modo root, conectar-se a ele, fazer upload do frida-server, dar permissões de execução e executá-lo em segundo plano:

{% code overflow="wrap" %}

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

{% endcode %}

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

Tutoriais

Tutorial 1

De: https://medium.com/infosec-adventures/introduction-to-frida-5a3f51595ca1
APK: https://github.com/t0thkr1s/frida-demo/releases
Código-fonte: https://github.com/t0thkr1s/frida-demo

Siga o link para ler.

Tutorial 2

De: https://11x256.github.io/Frida-hooking-android-part-2/ (Partes 2, 3 e 4)
APKs e Código-fonte: https://github.com/11x256/frida-android-examples

Siga o link para ler.

Tutorial 3

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

Siga o link para ler.
Você pode encontrar alguns scripts incríveis do Frida aqui: https://codeshare.frida.re/

Exemplos Rápidos

Aqui você pode encontrar as funcionalidades mais básicas e interessantes do Frida para criar um script rápido:

Chamando o Frida a partir da linha de comando

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.

Script Python Básico

import frida

# Attach to the target process
session = frida.attach("com.example.app")

# Define the JavaScript code to be injected
js_code = """
Java.perform(function () {
    // Intercept the target method
    var targetClass = Java.use("com.example.app.TargetClass");
    targetClass.targetMethod.implementation = function () {
        // Modify the behavior of the method
        console.log("Method intercepted!");
        return this.targetMethod();
    };
});
"""

# Create the script
script = session.create_script(js_code)

# Load the script into the target process
script.load()

# Detach from the target process
session.detach()

Script Python Básico

import frida

# Anexar ao processo alvo
session = frida.attach("com.example.app")

# Definir o código JavaScript a ser injetado
js_code = """
Java.perform(function () {
    // Interceptar o método alvo
    var targetClass = Java.use("com.example.app.TargetClass");
    targetClass.targetMethod.implementation = function () {
        // Modificar o comportamento do método
        console.log("Método interceptado!");
        return this.targetMethod();
    };
});
"""

# Criar o script
script = session.create_script(js_code)

# Carregar o script no processo alvo
script.load()

# Desanexar do processo alvo
session.detach()
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 de funções sem parâmetros

Faça o hook da função a() da classe sg.vantagepoint.a.c

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

Hook java exit()

Neste tutorial, vamos aprender como fazer um hook na função exit() em um aplicativo Android usando o Frida. O Frida é uma poderosa ferramenta de instrumentação e manipulação de código que nos permite modificar o comportamento de um aplicativo em tempo de execução.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

  • Um dispositivo Android com acesso root ou um emulador Android configurado.
  • O Frida instalado no seu dispositivo ou emulador Android.
  • Um ambiente de desenvolvimento configurado para executar comandos adb.

Passo 1: Conectando-se ao dispositivo

Conecte-se ao seu dispositivo Android usando o adb:

adb connect <IP_DO_DISPOSITIVO>:<PORTA>

Passo 2: Iniciando o aplicativo de destino

Inicie o aplicativo de destino no dispositivo Android.

Passo 3: Escrevendo o script Frida

Crie um novo arquivo chamado hook_exit.js e adicione o seguinte código:

Java.perform(function() {
  var System = Java.use('java.lang.System');
  var Runtime = Java.use('java.lang.Runtime');

  // Hooking System.exit()
  System.exit.implementation = function(code) {
    console.log('System.exit() called with code: ' + code);
    // Faça o que quiser aqui antes de sair do aplicativo
    // ...

    // Chame a implementação original de System.exit()
    this.exit(code);
  };

  // Hooking Runtime.exit()
  Runtime.exit.implementation = function(code) {
    console.log('Runtime.exit() called with code: ' + code);
    // Faça o que quiser aqui antes de sair do aplicativo
    // ...

    // Chame a implementação original de Runtime.exit()
    this.exit(code);
  };
});

Passo 4: Executando o script Frida

Agora, execute o script Frida usando o seguinte comando:

frida -U -f <NOME_DO_PACOTE_DO_APLICATIVO> -l hook_exit.js --no-pause

Substitua <NOME_DO_PACOTE_DO_APLICATIVO> pelo nome do pacote do aplicativo que você deseja fazer o hook.

Passo 5: Testando o hook

Agora, quando o aplicativo chamar a função exit(), o nosso script Frida será executado e exibirá uma mensagem no console. Você pode adicionar qualquer lógica adicional que desejar dentro do hook.

Lembre-se de que o Frida é uma ferramenta poderosa e pode ser usada para fins maliciosos. Certifique-se de usá-lo apenas para fins legítimos, como testes de segurança e desenvolvimento de aplicativos.

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

Tutorial Frida: Hook MainActivity .onStart() & .onCreate()

Neste tutorial, vamos aprender como usar o Frida para fazer hook nos métodos .onStart() e .onCreate() da classe MainActivity em um aplicativo Android.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

  • Um dispositivo Android ou um emulador Android configurado.
  • O Frida instalado no seu dispositivo ou emulador Android.
  • Um ambiente de desenvolvimento configurado para executar comandos Frida.

Passo 1: Identificar o nome do pacote e o nome da classe

Primeiro, precisamos identificar o nome do pacote e o nome da classe do aplicativo Android que queremos pentestar. Para fazer isso, podemos usar o comando frida-ps -U para listar os processos em execução no dispositivo ou emulador Android.

frida-ps -U

Anote o nome do pacote e o nome da classe do aplicativo Android que você deseja pentestar.

Passo 2: Criar o script Frida

Agora, vamos criar um script Frida para fazer hook nos métodos .onStart() e .onCreate() da classe MainActivity. Crie um arquivo chamado hook.js e adicione o seguinte código:

Java.perform(function() {
    var MainActivity = Java.use('com.example.app.MainActivity');

    MainActivity.onStart.implementation = function() {
        console.log('Hooked MainActivity.onStart()');
        this.onStart();
    };

    MainActivity.onCreate.implementation = function() {
        console.log('Hooked MainActivity.onCreate()');
        this.onCreate();
    };
});

Passo 3: Executar o script Frida

Agora, vamos executar o script Frida que criamos no passo anterior. Use o seguinte comando para executar o script:

frida -U -l hook.js -f <nome_do_pacote_do_aplicativo>

Substitua <nome_do_pacote_do_aplicativo> pelo nome do pacote do aplicativo Android que você anotou no Passo 1.

Passo 4: Testar o hook

Após executar o script Frida, abra o aplicativo Android que você está pentestando. Você verá mensagens de log indicando que os métodos .onStart() e .onCreate() da classe MainActivity foram hookados com sucesso.

Isso conclui o tutorial sobre como fazer hook nos métodos .onStart() e .onCreate() da classe MainActivity usando o Frida. Agora você pode explorar e modificar o comportamento desses métodos para fins de pentestagem.

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

Neste tutorial, vamos aprender como fazer hook no método .onCreate() de um aplicativo Android usando o Frida.

Pré-requisitos

Certifique-se de ter o seguinte instalado em seu ambiente de desenvolvimento:

  • Frida
  • Android Studio
  • Dispositivo Android ou emulador

Passo 1: Configuração do ambiente

Antes de começar, certifique-se de ter configurado corretamente o ambiente de desenvolvimento Android e o Frida. Isso inclui a instalação do Android Studio, a configuração do dispositivo Android ou emulador e a instalação do Frida no seu sistema.

Passo 2: Crie um projeto Android

Crie um novo projeto Android no Android Studio ou use um projeto existente.

Passo 3: Adicione o Frida ao projeto

Adicione o Frida ao projeto Android adicionando a dependência correta ao arquivo build.gradle do módulo do aplicativo.

dependencies {
    implementation 'com.github.frida.frida:frida-android:14.2.18'
}

Passo 4: Implemente o hook

Agora, vamos implementar o hook no método .onCreate() do aplicativo Android. Abra a classe principal do seu aplicativo e adicione o seguinte código:

import com.frida.Hooks;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        Hooks.onCreateHook();
    }
}

Passo 5: Crie a classe de hooks

Crie uma nova classe chamada Hooks e adicione o seguinte código:

import android.util.Log;

public class Hooks {

    public static void onCreateHook() {
        Log.d("Frida", "Hooked .onCreate()");
        // Seu código de hook aqui
    }
}

Passo 6: Execute o aplicativo

Agora, execute o aplicativo no dispositivo Android ou emulador. O método .onCreate() será hookado e você verá a mensagem "Hooked .onCreate()" no logcat.

Conclusão

Neste tutorial, aprendemos como fazer hook no método .onCreate() de um aplicativo Android usando o Frida. Isso nos permite injetar código personalizado e realizar várias ações durante a execução do aplicativo.

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 de funções com parâmetros e recuperando o valor

Hooking de uma função de descriptografia. Imprimir a entrada, chamar a função original para descriptografar a entrada e, por fim, imprimir os dados em texto simples:

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

Hooking de funções e chamando-as com nossa entrada

Faça o hook de uma função que recebe uma string e chame-a com outra string (de aqui)

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

Obtendo um objeto já criado de uma classe

Se você deseja extrair algum atributo de um objeto criado, você pode usar isso.

Neste exemplo, você verá como obter o objeto da classe my_activity e como chamar a função .secret() que imprimirá um atributo privado do objeto:

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

Dica de recompensa por bugs: inscreva-se no Intigriti, uma plataforma premium de recompensa por bugs criada por hackers, para hackers! Junte-se a nós em https://go.intigriti.com/hacktricks hoje mesmo e comece a ganhar recompensas de até $100.000!

{% embed url="https://go.intigriti.com/hacktricks" %}

☁️ HackTricks Cloud ☁️ -🐦 Twitter 🐦 - 🎙️ Twitch 🎙️ - 🎥 Youtube 🎥