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

19 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 () {
    // Find the target method
    var targetMethod = Java.use("com.example.app.TargetClass.targetMethod");

    // Hook the target method
    targetMethod.implementation = function () {
        // Print the arguments passed to the method
        console.log("Arguments: " + Array.prototype.slice.call(arguments));

        // Call the original method
        return this.targetMethod.apply(this, arguments);
    };
});
"""

# 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 () {
    // Encontrar o método alvo
    var targetMethod = Java.use("com.example.app.TargetClass.targetMethod");

    // Hook o método alvo
    targetMethod.implementation = function () {
        // Imprimir os argumentos passados para o método
        console.log("Argumentos: " + Array.prototype.slice.call(arguments));

        // Chamar o método original
        return this.targetMethod.apply(this, arguments);
    };
});
"""

# 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 script Frida será executado e você poderá adicionar seu próprio código antes de sair do aplicativo.

Conclusão

Neste tutorial, aprendemos como fazer um hook na função exit() em um aplicativo Android usando o Frida. Isso nos permite modificar o comportamento do aplicativo em tempo de execução e adicionar nosso próprio código antes de sair. O Frida é uma ferramenta poderosa para pentesting e análise de aplicativos Android.

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 para fazer o hook nos métodos .onStart() e .onCreate() da classe MainActivity. Use o seguinte comando:

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 comando acima, o Frida irá injetar o script no aplicativo Android e fazer o hook nos métodos .onStart() e .onCreate() da classe MainActivity. Agora, abra o aplicativo Android e verifique o console do Frida para ver as mensagens de log quando esses métodos forem chamados.

Isso conclui o tutorial de como fazer hook nos métodos .onStart() e .onCreate() da classe MainActivity usando o Frida. Experimente explorar mais recursos do Frida para aprimorar suas habilidades de pentesting em aplicativos Android.

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 a ferramenta Frida.

Pré-requisitos

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

  • Frida
  • Android Studio
  • Dispositivo Android ou emulador

Passo 1: Configuração do ambiente

Antes de começar, certifique-se de que seu dispositivo Android ou emulador esteja conectado ao seu ambiente de trabalho.

Passo 2: Crie um projeto Android

No Android Studio, crie um novo projeto Android vazio.

Passo 3: Adicione o código de exemplo

No arquivo MainActivity.java, adicione o seguinte código:

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

    Log.d("TAG", "onCreate() called");
}

Passo 4: Compilar e instalar o aplicativo

Compile e instale o aplicativo no seu dispositivo Android ou emulador.

Passo 5: Escreva o script Frida

Agora, vamos escrever o script Frida para fazer o hook no método .onCreate().

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

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

Passo 6: Execute o script Frida

Execute o script Frida usando o seguinte comando:

frida -U -l script.js -f com.example.myapplication

Passo 7: Verifique a saída

Ao executar o aplicativo, você verá a mensagem "Hooked onCreate()" no console.

Isso indica que o método .onCreate() foi hookado com sucesso.

Parabéns! Você aprendeu como fazer hook no método .onCreate() de um aplicativo Android usando o Frida.

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

Outros tutoriais do Frida

Dica de recompensa por bugs: inscreva-se no Intigriti, uma plataforma premium de recompensas 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 🎥