🤖 Obfu[DE]scate: Uma ferramenta de desofuscação e comparação para APKs Android. 📱

Obfu[DE]scate é uma ferramenta Python projetada para simplificar o processo de desofuscar e comparar duas versões de um APK Android - mesmo que as funções tenham sido renomeadas como parte da ofuscação. Com lógica de comparação difusa, o Obfu[DE]scate pode identificar semelhanças entre funções e ajudar você a descobrir mudanças entre as versões do APK.

➡️ Primeiros Passos

Instalação

Começar com Obfu[DE]scate é fácil! Siga estes passos:

1. Clone o repositório para sua máquina local.
2. Instale as dependências manualmente ou através do arquivo de requirements incluído usando o seguinte comando:

pip install -r REQUIREMENTS.txt

3. Baixe o APKTool para seu sistema a partir do site deles e certifique-se de que está instalado e disponível no seu PATH.

O Obfu[DE]scate foi testado no Windows 11, mas deve funcionar em outros sistemas também.

Execução

O Obfu[DE]scate fornece várias opções de linha de comando para personalizar seu comportamento:

Para comparar dois arquivos APK, basta executar o Obfu[DE]scate com o seguinte comando:

python ObfuDeScate.py -a1 "old_example.apk" -a2 "new_example.apk" -cp "com.example.path"

No exemplo acima, o Obfu[DE]scate revisará todas as funções no APK old_example.apk no caminho de classe com.example.path e as comparará com todas as funções encontradas no mesmo caminho de classe em new_example.apk.

🔎 Saídas

O Obfu[DE]scate gera dois arquivos de saída: um arquivo de mapeamento em formato de lista separada por quebras de linha, e um arquivo HTML interativo. Esses arquivos de saída incluem:

• mapping.txt - Um arquivo de texto separado por quebras de linha, onde cada linha se refere a uma correspondência identificada entre um método no APK1 e no APK2. O formato dessas linhas é como: com.chess.play.ObserveGameHelperImpl.d -> com.chess.play.ObserveGameHelperImpl.a .
• output.html - Um arquivo HTML que, quando aberto em um navegador, lista todas as funções no APK1. São menus suspensos que, ao serem clicados, mostram o método correspondente no APK2 (se houver), a confiança de serem uma correspondência e o bloco de código em SMALI para aquele método do APK1 e APK2.

🙏 Contribuições

O Obfu[DE]scate é um projeto de código aberto e aceita contribuições da comunidade. Se você deseja contribuir com o Obfu[DE]scate, siga estas diretrizes:

• Faça um fork do repositório para sua própria conta do GitHub.
• Crie um novo branch com um nome descritivo para sua contribuição.
• Faça suas alterações e teste-as completamente.
• Envie um pull request para o repositório principal, incluindo uma descrição detalhada das suas alterações e qualquer documentação relevante.
• Aguarde feedback dos mantenedores e responda a quaisquer comentários ou sugestões (se houver).
• Uma vez que suas alterações forem revisadas e aprovadas, elas serão mescladas no repositório principal.

⚖️ Código de Conduta

O Obfu[DE]scate segue o Código de Conduta do Contributor Covenant. Por favor, certifique-se de revisar. e seguir este código de conduta ao contribuir com o Obfu[DE]scate.

🐛 Relatórios de Bugs e Solicitações de Funcionalidades

Se você encontrar um bug ou tiver uma sugestão de nova funcionalidade, por favor abra uma issue no repositório do GitHub. Forneça o máximo de detalhes possível, incluindo passos para reproduzir o problema ou uma descrição clara da funcionalidade proposta. Seu feedback é valioso e ajudará a melhorar o Obfu[DE]scate para todos.

💛 Agradecimentos

Esta ferramenta não funcionaria sem o APKTool! Em segundo lugar, muitos dos exemplos neste README usam o aplicativo Chess.com como base, confira aqui.

📜 Licença

GNU General Public License v3.0