
Macchina virtuale Android e deoffuscatore
Simplify è un deobfuscator Android generico. Esegue virtualmente il codice Dalvik, poi riscrive ogni metodo in codice che si comporta in modo identico ed è più facile da leggere per un essere umano. Le sue ottimizzazioni sono generiche, quindi funzionano indipendentemente da quale offuscatore abbia prodotto l'input.
La compilazione richiede JDK 21 selezionato tramite JAVA_HOME e un filesystem case-sensitive. Clona con il
submodule del framework Android, poi compila il jar standalone:
git clone --recursive https://github.com/CalebFenton/simplify.git
cd simplify
./gradlew :simplify:fatJar
In un clone esistente, recupera il sottomodulo con git submodule update --init --recursive.
Semplifica l'app di esempio offuscata inclusa:
java -jar simplify/build/libs/simplify.jar -it "org/cf/obfuscated" -et "MainActivity" simplify/obfuscated-app.apk
L'esecuzione richiede meno di un minuto, termina con un riepilogo dei metodi ottimizzati, falliti e saltati, e scrive
obfuscated-app_simple.apk nella directory corrente; -o sceglie un altro percorso. Esegui
java -jar simplify/build/libs/simplify.jar --help per tutte le opzioni.
Il progetto ha quattro moduli Gradle. smalivm è una macchina virtuale sandboxed per i metodi Dalvik. Restituisce
un grafo di esecuzione di ogni possibile valore di registro e di classe su ogni percorso, anche quando alcuni input sono
sconosciuti: un ramo su un valore sconosciuto prende entrambe le vie. simplify legge quei grafi e applica la propagazione delle costanti, la rimozione del codice morto, l'unreflection e le ottimizzazioni peephole, ripetendole finché il metodo
smette di cambiare o raggiunge --max-passes. Non rinomina classi o metodi. demoapp mostra come incorporare smalivm, e sdbg è
un debugger interattivo per lo stesso motore di esecuzione.
Un'ottimizzazione viene eseguita solo quando l'analisi di un metodo è completa. Un metodo la cui analisi raggiunge un limite viene
segnalato come saltato e lasciato invariato. Eccezioni, sincronizzazione, accessi volatili e scritture su oggetti visibili ad altro codice sono osservabili, quindi le loro operazioni restano. Ad esempio, salva questo come 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
Eseguendo java -jar simplify/build/libs/simplify.jar example -o example.dex e disassemblando example.dex
si ottengono questi corpi di metodo:
.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 propagazione delle costanti ripiega l'addizione e il risultato di intValue(). La rimozione del codice morto elimina poi gli input inutilizzati di add-int e l'Integer che nessuno osserva più: la sua allocazione, il costruttore e la chiamata non cambiano nulla al di fuori dell'oggetto.
Simplify legge una directory Smali, un file DEX o un APK. L'output APK sostituisce classes.dex, mantiene invariata ogni altra voce e deve essere firmato nuovamente prima dell'installazione. Un archivio che contiene anche classes2.dex viene rifiutato con Multi-DEX archives are not supported.
-v aumenta la verbosità del log a ogni ripetizione (-v, -vv). Lo stato di uscita è 1 quando l'input viene rifiutato, un metodo non riesce a essere eseguito o una modifica dell'optimizer viene rifiutata; --ignore-errors salta i metodi falliti ed esce con 0. I metodi saltati non modificano lo stato di uscita.
Se un'esecuzione fallisce, limitarla a poche classi o metodi con -it. Se un metodo supera un limite di visite, aumentare --max-address-visits, --max-call-depth o --max-method-visits. Un metodo la cui analisi riempirebbe l'heap della JVM viene saltato con MEMORY_LIMIT; assegnare più heap alla JVM con -Xmx per analizzarlo. Per segnalare un problema, eseguire di nuovo con -v o -vv e aprire una issue con il log, il comando completo e l'APK o DEX o il suo 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 demo esegue lo Smali in demoapp/resources con input noti e sconosciuti e stampa ogni risultato. Vedi
SDBG per una guida al debugger.
Domande, segnalazioni e pull request sono benvenute. Quando segnali un bug, includi l'APK o il DEX (o il suo hash) e il comando completo.
Il codice di proprietà del progetto Simplify è distribuito con la Apache License, Version 2.0. Le dipendenze incluse, il codice sorgente di terze parti e il corpus del framework Android mantengono le proprie licenze; vedi THIRD_PARTY_NOTICES e licenses.