B(l)utter

Ferramenta de Engenharia Reversa de Aplicativos Flutter Mobile compilando o Runtime AOT do Dart

Atualmente, o aplicativo suporta apenas o libapp.so do Android (somente arm64). Além disso, o aplicativo atualmente funciona apenas com versões recentes do Dart.

Para funcionalidades ausentes de alta prioridade, veja TODO

Configuração do Ambiente

Este aplicativo usa a biblioteca de formatação C++20. Requer um compilador C++ muito recente, como g++>=13, Clang>=16.

Recomendo usar sistema operacional Linux (testado apenas no Debian sid/trixie) porque é fácil de configurar.

Debian Unstable (gcc 13)

NOTA: Use APENAS versões do Debian/Ubuntu que forneçam gcc>=13 a partir de seu próprio repositório principal. Usar gcc portado para versões antigas do Debian/Ubuntu não funciona.

• Instale as ferramentas de compilação e dependências

apt install python3-pyelftools python3-requests git cmake ninja-build \
    build-essential pkg-config libicu-dev libcapstone-dev

Windows

• Instale git e python 3
• Instale a versão mais recente do Visual Studio com "Desenvolvimento para desktop com C++" e "Ferramentas C++ CMake"
• Instale as bibliotecas necessárias (libcapstone e libicu4c)

python scripts\init_env_win.py

• Inicie o "Prompt de Comando de Ferramentas Nativas x64"

macOS Sequoia

• Instale o XCode
• Instale as ferramentas necessárias

brew install cmake ninja pkg-config icu4c capstone
pip3 install pyelftools requests

macOS Ventura e Sonoma (clang 16)

• Instale o XCode
• Instale o clang 16 e as ferramentas necessárias

brew install llvm@16 cmake ninja pkg-config icu4c capstone
pip3 install pyelftools requests

Uso

Extraia o diretório "lib" do arquivo apk

python3 blutter.py caminho/para/app/lib/arm64-v8a dir_saida

O blutter.py detectará automaticamente a versão do Dart a partir do motor Flutter e chamará o executável do blutter para obter as informações do libapp.so.

Se o executável do blutter para a versão necessária do Dart não existir, o script fará checkout automaticamente do código-fonte do Dart e o compilará.

Atualização

Você pode usar git pull para atualizar e executar blutter.py com a opção --rebuild para forçar a reconstrução do executável

python3 blutter.py caminho/para/app/lib/arm64-v8a dir_saida --rebuild

Arquivos de saída

• asm/* montagens do libapp com símbolos
• blutter_frida.js o modelo de script Frida para o aplicativo alvo
• objs.txt despejo completo (aninhado) de Objetos do Pool de Objetos
• pp.txt todos os objetos Dart no Pool de Objetos

Diretórios

• bin contém executáveis do blutter para cada versão do Dart no formato "blutter_dartvm<ver>_<os>_<arch>"
• blutter contém o código-fonte. precisa ser compilado contra a biblioteca da Dart VM
• build contém projetos de compilação que podem ser deletados após o término do processo de compilação
• dartsdk contém o checkout do Dart Runtime que pode ser deletado após o término do processo de compilação
• external contém bibliotecas de terceiros apenas para Windows
• packages contém as bibliotecas estáticas do Dart Runtime
• scripts contém scripts Python para obter/compilar o Dart

Gerando Solução Visual Studio para Desenvolvimento

Eu uso o Visual Studio para desenvolver o Blutter no Windows. A opção --vs-sln pode ser usada para gerar uma solução do Visual Studio.

python blutter.py caminho\para\lib\arm64-v8a build\vs --vs-sln

TODO

• Mais análise de código
  • Argumentos de funções e tipo de retorno
  • Algum pseudo-código para padrões de código
• Gerar melhor script Frida
  • Mais classes internas
  • Modificação de objetos
• Aplicativo ofuscado (ainda faltam muitas funções)
• Leitura de binário iOS
• Entrada como apk ou ipa