🤖 Obfu[DE]scate: Una herramienta de desofuscación y comparación para APKs de Android. 📱

Obfu[DE]scate es una herramienta en Python diseñada para simplificar el proceso de desofuscación y comparación de dos versiones de un APK de Android, incluso si las funciones han sido renombradas como parte de la ofuscación. Con una lógica de comparación difusa, Obfu[DE]scate puede identificar similitudes entre funciones y ayudarte a descubrir cambios entre versiones de APK.

➡️ Primeros pasos

Instalación

¡Empezar con Obfu[DE]scate es fácil! Sigue estos pasos:

1. Clona el repositorio en tu máquina local.
2. Instala las dependencias manualmente o mediante el archivo de requisitos incluido usando el siguiente comando:

pip install -r REQUIREMENTS.txt

3. Descarga APKTool para tu sistema desde su sitio web. y asegúrate de que esté instalado y disponible en tu PATH.

Obfu[DE]scate ha sido probado en Windows 11, pero debería funcionar también en otros sistemas.

Ejecución

Obfu[DE]scate ofrece varias opciones de línea de comandos para personalizar su comportamiento:

Para comparar dos archivos APK, simplemente ejecuta Obfu[DE]scate con el siguiente comando:

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

En el ejemplo anterior, Obfu[DE]scate revisará todas las funciones en el APK old_example.apk en la ruta de clase com.example.path y las comparará con todas las funciones encontradas en la misma ruta de clase en new_example.apk.

🔎 Salidas

Obfu[DE]scate genera dos archivos de salida: un archivo de mapeo en formato de lista separada por nuevas líneas y un archivo HTML interactivo. Estos archivos incluyen:

• mapping.txt - Un archivo de texto separado por nuevas líneas, donde cada línea corresponde a una coincidencia identificada entre un método en APK1 y APK2. El formato de estas líneas es como: com.chess.play.ObserveGameHelperImpl.d -> com.chess.play.ObserveGameHelperImpl.a .
• output.html - Un archivo HTML que, al abrirlo en un navegador web, lista todas las funciones de APK1. Estas son listas desplegables que, al hacer clic, muestran el método coincidente en APK2 (si lo hay), la confianza de que coincidan y el bloque de código en SMALI de ese método de APK1 y APK2.

🙏 Contribuciones

Obfu[DE]scate es un proyecto de código abierto y agradece las contribuciones de la comunidad. Si deseas contribuir a Obfu[DE]scate, sigue estas pautas:

• Haz un fork del repositorio en tu propia cuenta de GitHub.
• Crea una nueva rama con un nombre descriptivo para tu contribución.
• Realiza tus cambios y pruébalos a fondo.
• Envía un pull request al repositorio principal, incluyendo una descripción detallada de tus cambios y cualquier documentación relevante.
• Espera la retroalimentación de los mantenedores y atiende cualquier comentario o sugerencia (si los hay).
• Una vez que tus cambios hayan sido revisados y aprobados, se fusionarán en el repositorio principal.

⚖️ Código de Conducta

Obfu[DE]scate sigue el Código de Conducta del Pacto del Colaborador. Asegúrate de revisarlo. y adherirte a este código de conducta al contribuir a Obfu[DE]scate.

🐛 Informes de Errores y Solicitudes de Funciones

Si encuentras un error o tienes una sugerencia para una nueva función, por favor abre un issue en el repositorio de GitHub. Proporciona tanto detalle como sea posible, incluyendo pasos para reproducir el error o una descripción clara de la función propuesta. Tus comentarios son valiosos y ayudarán a mejorar Obfu[DE]scate para todos.

💛 Agradecimientos

¡Esta herramienta no funcionaría sin APKTool! En segundo lugar, muchos de los ejemplos en este README usan la aplicación de Chess.com como base, échale un vistazo aquí.

📜 Licencia

GNU General Public License v3.0