🤖 Obfu[DE]scate: uno strumento di de-offuscamento e confronto per APK Android. 📱

Obfu[DE]scate è uno strumento Python progettato per semplificare il processo di de-offuscamento e confronto di due versioni di un APK Android - anche se le funzioni sono state rinominata come parte dell'offuscamento. Con la logica di confronto fuzzy, Obfu[DE]scate può identificare somiglianze tra le funzioni e aiutarti a scoprire le modifiche tra le versioni degli APK.

➡️ Per Iniziare

Installazione

Iniziare con Obfu[DE]scate è facile! Segui questi passaggi:

1. Clona il repository sulla tua macchina locale.
2. Installa le dipendenze manualmente o tramite il file requirements incluso usando il seguente comando:

pip install -r REQUIREMENTS.txt

3. Scarica APKTool per il tuo sistema dal loro sito web e assicurati che sia installato e disponibile nel tuo PATH.

Obfu[DE]scate è stato testato su Windows 11, ma dovrebbe funzionare anche su altri sistemi.

Esecuzione

Obfu[DE]scate offre diverse opzioni da riga di comando per personalizzare il suo comportamento:

Per confrontare due file APK, esegui semplicemente Obfu[DE]scate con il seguente comando:

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

Nell'esempio sopra, Obfu[DE]scate esaminerà tutte le funzioni nell'APK old_example.apk al percorso della classe com.example.path e le confronterà con tutte le funzioni trovate allo stesso percorso della classe in new_example.apk.

🔎 Output

Obfu[DE]scate genera due file di output: un file di mappatura in formato elenco separato da nuove righe e un file HTML interattivo. Questi file di output includono:

• mapping.txt - Un file di testo separato da nuove righe in cui ogni riga si riferisce a una corrispondenza identificata tra un metodo in APK1 e APK2. Il formato di queste righe è ad esempio: com.chess.play.ObserveGameHelperImpl.d -> com.chess.play.ObserveGameHelperImpl.a .
• output.html - Un file HTML che, quando aperto in un browser web, elenca tutte le funzioni in APK1. Si tratta di menu a tendina che, quando cliccati, mostrano il metodo corrispondente in APK2 (se presente), la confidenza della corrispondenza e il blocco di codice in SMALI per quel metodo da APK1 e APK2.

🙏 Contributi

Obfu[DE]scate è un progetto open-source e accoglie contributi dalla comunità. Se desideri contribuire a Obfu[DE]scate, segui queste linee guida:

• Forka il repository sul tuo account GitHub.
• Crea un nuovo ramo con un nome descrittivo per il tuo contributo.
• Apporta le tue modifiche e testale accuratamente.
• Invia una pull request al repository principale, includendo una descrizione dettagliata delle tue modifiche e qualsiasi documentazione pertinente.
• Attendi feedback dai manutentori e affronta eventuali commenti o suggerimenti (se presenti).
• Una volta che le tue modifiche sono state esaminate e approvate, verranno unite al repository principale.

⚖️ Codice di Condotta

Obfu[DE]scate segue il Codice di Condotta del Contributor Covenant. Assicurati di revisionare. e aderire a questo codice di condotta quando contribuisci a Obfu[DE]scate.

🐛 Segnalazione di Bug e Richieste di Funzionalità

Se incontri un bug o hai un suggerimento per una nuova funzionalità, apri un issue nel repository GitHub. Fornisci il maggior numero di dettagli possibile, inclusi i passaggi per riprodurre il problema o una descrizione chiara della funzionalità proposta. Il tuo feedback è prezioso e aiuterà a migliorare Obfu[DE]scate per tutti.

💛 Ringraziamenti

Questo strumento non funzionerebbe senza APKTool! In secondo luogo, molti degli esempi in questo README utilizzano l'app Chess.com come base, dai un'occhiata qui.

📜 Licenza

GNU General Public License v3.0