🤖 Obfu[DE]scate : un outil de désobfuscation et de comparaison pour APK Android. 📱

Obfu[DE]scate est un outil Python conçu pour simplifier le processus de désobfuscation et de comparaison de deux versions d'un APK Android — même si les fonctions ont été renommées dans le cadre de l'obfuscation. Grâce à une logique de comparaison floue, Obfu[DE]scate peut identifier les similitudes entre les fonctions et vous aider à découvrir les changements entre les versions d'APK.

➡️ Pour commencer

Installation

Commencer avec Obfu[DE]scate est simple ! Suivez ces étapes :

1. Clonez le dépôt sur votre machine locale.
2. Installez les dépendances manuellement ou via le fichier requirements fourni, en utilisant la commande suivante :

pip install -r REQUIREMENTS.txt

3. Téléchargez APKTool pour votre système depuis leur site Web et assurez-vous qu'il est installé et disponible dans votre PATH.

Obfu[DE]scate a été testé sur Windows 11, mais devrait fonctionner sur d'autres systèmes également.

Exécution

Obfu[DE]scate propose plusieurs options en ligne de commande pour personnaliser son comportement :

Pour comparer deux fichiers APK, exécutez simplement Obfu[DE]scate avec la commande suivante :

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

Dans l'exemple ci-dessus, Obfu[DE]scate examinera toutes les fonctions dans l'APK old_example.apk au chemin de classe com.example.path et les comparera à toutes les fonctions trouvées au même chemin de classe dans new_example.apk.

🔎 Sorties

Obfu[DE]scate génère deux fichiers de sortie : un fichier de correspondance au format liste séparée par des nouvelles lignes, et un fichier HTML interactif. Ces fichiers de sortie incluent :

• mapping.txt - Un fichier texte séparé par des retours à la ligne, chaque ligne correspondant à une correspondance identifiée entre une méthode dans APK1 et APK2. Le format de ces lignes est tel que : com.chess.play.ObserveGameHelperImpl.d -> com.chess.play.ObserveGameHelperImpl.a .
• output.html - Un fichier HTML qui, lorsqu'il est ouvert dans un navigateur Web, liste toutes les fonctions d'APK1. Ce sont des listes déroulantes qui, lorsqu'on clique dessus, affichent la méthode correspondante dans APK2 (si elle existe), la confiance en cette correspondance, et le bloc de code SMALI pour cette méthode dans APK1 et APK2.

🙏 Contributions

Obfu[DE]scate est un projet open-source et accueille favorablement les contributions de la communauté. Si vous souhaitez contribuer à Obfu[DE]scate, veuillez suivre ces directives :

• Forkez le dépôt sur votre propre compte GitHub.
• Créez une nouvelle branche avec un nom descriptif pour votre contribution.
• Effectuez vos modifications et testez-les minutieusement.
• Soumettez une pull request vers le dépôt principal, incluant une description détaillée de vos changements et toute documentation pertinente.
• Attendez les retours des mainteneurs et répondez à tout commentaire ou suggestion (le cas échéant).
• Une fois vos changements examinés et approuvés, ils seront fusionnés dans le dépôt principal.

⚖️ Code de conduite

Obfu[DE]scate suit le Code de conduite du Contributor Covenant. Veuillez le consulter et vous y conformer lors de vos contributions à Obfu[DE]scate.

🐛 Signalement de bugs et demandes de fonctionnalités

Si vous rencontrez un bug ou avez une suggestion pour une nouvelle fonctionnalité, veuillez ouvrir un ticket (issue) dans le dépôt GitHub. Merci de fournir autant de détails que possible, y compris les étapes pour reproduire le problème ou une description claire de la fonctionnalité proposée. Vos commentaires sont précieux et aideront à améliorer Obfu[DE]scate pour tout le monde.

💛 Remerciements

Cet outil ne fonctionnerait pas sans APKTool ! Ensuite, une grande partie des exemples de ce README utilisent l'application Chess.com comme base, découvrez-la ici.

📜 Licence

GNU General Public License v3.0