
r2frida v6.2.2
Radare2 e Frida melhores juntos.
r2frida
Radare2 e Frida melhores juntos
Descrição
Plugin autocontido para o radare2 que inclui o frida e permite instrumentar processos locais ou remotos usando comandos do r2 em vez de (mas não limitado a) scripts Frida.
O projeto radare fornece uma cadeia de ferramentas completa para engenharia reversa, é mantido ativamente e oferece funcionalidades bem mantidas, estendendo seus recursos com outras linguagens de programação e ferramentas.
Frida é um kit de ferramentas de instrumentação dinâmica que facilita a inspeção e manipulação de processos em execução ao injetar seu próprio JavaScript e, opcionalmente, também se comunicar com seus scripts.
Recursos
- Executar scripts Frida sem modificações (Use o comando
:.) - Executar trechos de código em C, Javascript ou TypeScript em qualquer processo
- Pode anexar, gerar ou iniciar em sistemas locais ou remotos
- Listar seções, símbolos, exportações, protocolos, classes, métodos
- Pesquisar valores na memória dentro do agente ou a partir do host
- Substituir implementações de métodos ou criar hooks com comandos curtos
- Carregar bibliotecas e frameworks no processo alvo
- Suporte a interfaces Dalvik, Java, ObjC, Swift e C
- Manipular descritores de arquivo e variáveis de ambiente
- Enviar sinais ao processo, continuar, breakpoints
- O plugin io do r2frida também é um backend de sistema de arquivos fs e debug
- Automatizar r2 e frida usando r2pipe
- Ler/Escrever memória do processo
- Chamar funções, syscalls e trechos de código bruto
- Conectar ao frida-server via usb ou tcp/ip
- Enumerar aplicativos e processos
- Rastrear registradores, argumentos de funções
- Testado em x64, arm32 e arm64 para Linux, Windows, macOS, iOS e Android
- Não requer que o frida esteja instalado no host (não é necessário frida-tools)
- Estender os comandos do r2frida com plugins que são executados no agente
- Alterar permissões de página, aplicar patches em código e dados
- Resolver símbolos por nome ou endereço e importá-los como flags no r2
- Executar comandos do r2 no host a partir do agente
- Usar APIs do r2 e executar comandos do r2 dentro do processo alvo remoto.
- Breakpoints nativos usando a API
:db - Acessar sistemas de arquivos remotos usando a API
r_fs.
Instalação
A maneira recomendada de instalar o r2frida é via r2pm:
$ r2pm -ci r2frida
Compilações binárias que não exigem compilação serão em breve suportadas no
r2pm e no r2env. Enquanto isso, sinta-se à vontade para baixar as últimas compilações
da página de Releases.
Compilação
Dependências
- radare2
- pkg-config (não necessário no windows)
- curl ou wget
- make, gcc
- npm, nodejs (será removido em breve)
No GNU/Debian você precisará instalar os seguintes pacotes:
$ sudo apt install -y make gcc libzip-dev nodejs npm curl pkg-config git
Instruções
$ git clone https://github.com/nowsecure/r2frida.git
$ cd r2frida
$ make
$ make user-install
Meson
$ meson setup build -Duser_install=true
$ ninja -C build
$ meson install -C build
Opções: -Dfrida_sdk=<dir>, -Dprecompiled_agent=<_agent.js>, -Dr2_plugdir=<dir>, -Dsession_debugger=false.
Windows
- Instale o meson e o Visual Studio
- Descompacte o zip da versão mais recente do radare2 no diretório raiz do r2frida
- Renomeie-o para
radare2(em vez de radare2-x.y.z) - Para disponibilizar o compilador do VS no PATH (
preconfigure.bat) - Execute
configure.bate depoismake.bat
Uso
Para testes, use r2 frida://0, pois anexar ao pid0 no frida é uma sessão
especial que é executada localmente. Agora você pode executar o comando :? para obter a lista
de comandos disponíveis.
$ r2 'frida://?'
r2 frida://[action]/[link]/[device]/[target]
* action = list | apps | attach | spawn | launch
* link = local | usb | remote host:port
* device = '' | host:port | device-id
* target = pid | appname | process-name | program-in-path | abspath
Local:
* frida://? # show this help
* frida:// # list local processes
* frida://0 # attach to frida-helper (no spawn needed)
* frida:///usr/local/bin/rax2 # abspath to spawn
* frida://rax2 # same as above, considering local/bin is in PATH
* frida://spawn/$(program) # spawn a new process in the current system
* frida://attach/(target) # attach to target PID in current host
USB:
* frida://list/usb// # list processes in the first usb device
* frida://apps/usb// # list apps in the first usb device
* frida://attach/usb//12345 # attach to given pid in the first usb device
* frida://spawn/usb//appname # spawn an app in the first resolved usb device
* frida://launch/usb//appname # spawn+resume an app in the first usb device
Remote:
* frida://attach/remote/10.0.0.3:9999/558 # attach to pid 558 on tcp remote frida-server
Environment: (Use the `%` command to change the environment at runtime)
R2FRIDA_SAFE_IO=0|1 # Workaround a Frida bug on Android/thumb
R2FRIDA_DEBUG=0|1 # Used to debug argument parsing behaviour
R2FRIDA_COMPILER_DISABLE=0|1 # Disable the new frida typescript compiler (`:. foo.ts`)
R2FRIDA_AGENT_SCRIPT=[file] # path to file of the r2frida agent
Exemplos
$ r2 frida://0 # same as frida -p 0, connects to a local session
Você pode anexar, gerar ou iniciar qualquer programa por nome ou pid. A linha a seguir anexará ao primeiro processo chamado rax2 (execute rax2 - em outro terminal para testar esta linha)
$ r2 frida://rax2 # attach to the first process named `rax2`
$ r2 frida://1234 # attach to the given pid
Usar o caminho absoluto de um binário para gerar o processo irá gerar o processo:
$ r2 frida:///bin/ls
[0x00000000]> :dc # continue the execution of the target program
Também funciona com argumentos:
$ r2 frida://"/bin/ls -al"
Para depuração USB de apps iOS/Android, use estas ações. Observe que spawn
pode ser substituído por launch ou attach, e o nome do processo pode ser
o bundleid ou o PID.
$ r2 frida://spawn/usb/ # enumerate devices
$ r2 frida://spawn/usb// # enumerate apps in the first iOS device
$ r2 frida://spawn/usb//Weather # Run the weather app
Comandos
Estes são os comandos mais frequentes, portanto você deve aprendê-los e adicionar o sufixo ? para obter ajuda sobre os subcomandos.
:i # get information of the target (pid, name, home, arch, bits, ..)
.:i* # import the target process details into local r2
:? # show all the available commands
:dm # list maps. Use ':dm|head' and seek to the program base address
:iE # list the exports of the current binary (seek)
:dt fread # trace the 'fread' function
:dt-* # delete all traces
Plugins
Os plugins do r2frida são executados no lado do agente e são registrados com a API r2frida.pluginRegister.
Consulte o diretório plugins/ para ver mais exemplos de scripts de plugins.
[0x00000000]> cat example.js
r2frida.pluginRegister('test', function(name) {
if (name === 'test') {
return function(args) {
console.log('Hello Args From r2frida plugin', args);
return 'Things Happen';
}
}
});
[0x00000000]> :. example.js # load the plugin script