
Machine virtuelle Android et désobfuscateur
Simplify est un désobfuscateur Android générique. Il exécute virtuellement le code Dalvik, puis réécrit chaque méthode en un code qui se comporte de manière identique et est plus facile à lire pour un humain. Ses optimisations sont génériques, elles fonctionnent donc quel que soit l'obfuscateur ayant produit l'entrée.
La compilation nécessite le JDK 21 sélectionné via JAVA_HOME et un système de fichiers sensible à la casse. Clonez avec le
sous-module du framework Android, puis compilez le jar autonome :
git clone --recursive https://github.com/CalebFenton/simplify.git
cd simplify
./gradlew :simplify:fatJar
Dans un clone existant, récupérez le sous-module avec git submodule update --init --recursive.
Simplifiez l'application d'exemple obfusquée incluse :
java -jar simplify/build/libs/simplify.jar -it "org/cf/obfuscated" -et "MainActivity" simplify/obfuscated-app.apk
L'exécution prend moins d'une minute, se termine par un résumé des méthodes optimisées, échouées et ignorées, et écrit
obfuscated-app_simple.apk dans le répertoire courant ; -o choisit un autre chemin. Exécutez
java -jar simplify/build/libs/simplify.jar --help pour toutes les options.
Le projet comporte quatre modules Gradle. smalivm est une machine virtuelle isolée pour les méthodes Dalvik. Elle renvoie
un graphe d'exécution de chaque valeur de registre et de classe possible sur chaque chemin, même lorsque certaines entrées sont
inconnues : une branche sur une valeur inconnue prend les deux bras. simplify lit ces graphes et applique la propagation de constantes, la suppression de code mort, l'unreflection et les optimisations de peephole, en les répétant jusqu'à ce que la méthode
cesse de changer ou atteigne --max-passes. Il ne renomme pas les classes ni les méthodes. demoapp montre comment intégrer smalivm, et sdbg est
un débogueur interactif pour le même moteur d'exécution.
Une optimisation n'est exécutée que lorsque l'analyse d'une méthode est complète. Une méthode dont l'analyse atteint une limite est
signalée comme ignorée et laissée inchangée. Les exceptions, la synchronisation, les accès volatiles et les écritures dans des objets visibles par d'autres code sont observables, donc leurs opérations sont conservées. Par exemple, enregistrez ceci sous example/Example.smali :
.class public LExample;
.super Ljava/lang/Object;
.method public static add()I
.locals 2
const/4 v0, 0x4
const/4 v1, 0x3
add-int v0, v0, v1
return v0
.end method
.method public static test1()I
.locals 2
new-instance v0, Ljava/lang/Integer;
const/4 v1, 0x1
invoke-direct {v0, v1}, Ljava/lang/Integer;-><init>(I)V
invoke-virtual {v0}, Ljava/lang/Integer;->intValue()I
move-result v0
return v0
.end method
Exécuter java -jar simplify/build/libs/simplify.jar example -o example.dex et désassembler example.dex
donne ces corps de méthode :
.method public static add()I
.registers 2
const/4 v0, 0x7
return v0
.end method
.method public static test1()I
.registers 2
const/4 v0, 0x1
return v0
.end method
La propagation de constantes replie l'addition et le résultat de intValue(). La suppression de code mort supprime ensuite les entrées inutilisées de add-int et l'Integer que plus rien n'observe : son allocation, son constructeur et son appel ne modifient rien en dehors de l'objet.
Simplify lit un répertoire Smali, un fichier DEX ou un APK. La sortie APK remplace classes.dex, conserve toutes les autres entrées inchangées et doit être signée à nouveau avant l'installation. Une archive qui contient également classes2.dex est rejetée avec Multi-DEX archives are not supported.
-v augmente la verbosité des logs à chaque répétition (-v, -vv). Le code de sortie est 1 lorsque l'entrée est rejetée, qu'une méthode échoue à s'exécuter ou qu'une modification de l'optimiseur est rejetée ; --ignore-errors ignore les méthodes en échec et se termine avec le code 0. Les méthodes ignorées ne modifient pas le code de sortie.
Si une exécution échoue, limitez-la à quelques classes ou méthodes avec -it. Si une méthode dépasse une limite de visites, augmentez --max-address-visits, --max-call-depth ou --max-method-visits. Une méthode dont l'analyse saturerait le tas de la JVM est ignorée avec MEMORY_LIMIT ; accordez plus de tas à la JVM avec -Xmx pour l'analyser. Pour signaler un problème, relancez avec -v ou -vv et ouvrez un ticket avec le log, la commande complète et l'APK ou le DEX ou son hash SHA-256.
./gradlew :demoapp:fatJar :sdbg:fatJar
java -jar demoapp/build/libs/demoapp.jar demoapp/resources
java -jar sdbg/build/libs/sdbg.jar sdbg/resources 'LTest;->addNumbers()V'
La démo exécute le Smali dans demoapp/resources avec des entrées connues et inconnues et affiche chaque résultat. Voir
SDBG pour une visite guidée du débogueur.
Les questions, les problèmes et les pull requests sont les bienvenus. Lorsque vous signalez un bug, incluez l'APK ou le DEX (ou son hash) et la commande complète.
Le code appartenant au projet Simplify est sous licence Apache License, Version 2.0. Les dépendances intégrées, le code source tiers et le corpus du framework Android conservent leurs propres licences ; voir THIRD_PARTY_NOTICES et licenses.
Découvrez les outils les plus utilisés par notre communauté.
Pas encore de données de popularité.