🤖 Obfu[DE]scate: Ein Tool zur De-Obfuskation und zum Vergleich von Android APKs. 📱

Obfu[DE]scate ist ein Python-Tool, das den Prozess der De-Obfuskation und des Vergleichs von zwei Versionen einer Android-APK vereinfacht – selbst wenn die Funktionen im Rahmen der Obfuskation umbenannt wurden. Mit einer Fuzzy-Vergleichslogik kann Obfu[DE]scate Ähnlichkeiten zwischen Funktionen identifizieren und Ihnen helfen, Änderungen zwischen APK-Versionen aufzudecken.

➡️ Erste Schritte

Installation

Der Einstieg in Obfu[DE]scate ist einfach! Befolgen Sie diese Schritte:

1. Klonen Sie das Repository auf Ihren lokalen Rechner.
2. Installieren Sie die Abhängigkeiten manuell oder über die mitgelieferte Requirements-Datei mit folgendem Befehl:

pip install -r REQUIREMENTS.txt

3. Laden Sie APKTool für Ihr System von deren Website. herunter und stellen Sie sicher, dass es installiert und in Ihrem PATH verfügbar ist.

Obfu[DE]scate wurde unter Windows 11 getestet, sollte aber auch auf anderen Systemen funktionieren.

Ausführen

Obfu[DE]scate bietet mehrere Befehlszeilenoptionen zur Anpassung seines Verhaltens:

Um zwei APK-Dateien zu vergleichen, führen Sie Obfu[DE]scate einfach mit folgendem Befehl aus:

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

Im obigen Beispiel überprüft Obfu[DE]scate alle Funktionen in der APK old_example.apk unter dem Klassenpfad com.example.path und vergleicht sie mit allen Funktionen, die unter demselben Klassenpfad in new_example.apk gefunden werden.

🔎 Ausgaben

Obfu[DE]scate erzeugt zwei Ausgabedateien: eine Mapping-Datei im Format einer durch Zeilenumbrüche getrennten Liste und eine interaktive HTML-Datei. Diese Ausgabedateien enthalten:

• mapping.txt - Eine durch Zeilenumbrüche getrennte Textdatei, deren jede Zeile eine identifizierte Übereinstimmung zwischen einer Methode in APK1 und APK2 darstellt. Das Format dieser Zeilen ist z. B.: com.chess.play.ObserveGameHelperImpl.d -> com.chess.play.ObserveGameHelperImpl.a .
• output.html - Eine HTML-Datei, die beim Öffnen in einem Webbrowser alle Funktionen in APK1 auflistet. Es handelt sich um Dropdowns, die beim Anklicken die passende Methode in APK2 (falls vorhanden), die Konfidenz der Übereinstimmung und den Codeblock in SMALI für diese Methode aus APK1 und APK2 anzeigen.

🙏 Beiträge

Obfu[DE]scate ist ein Open-Source-Projekt und freut sich über Beiträge aus der Community. Wenn Sie zu Obfu[DE]scate beitragen möchten, befolgen Sie bitte diese Richtlinien:

• Forken Sie das Repository auf Ihr eigenes GitHub-Konto.
• Erstellen Sie einen neuen Branch mit einem beschreibenden Namen für Ihren Beitrag.
• Nehmen Sie Ihre Änderungen vor und testen Sie sie gründlich.
• Reichen Sie einen Pull-Request an das Haupt-Repository ein, einschließlich einer detaillierten Beschreibung Ihrer Änderungen und aller relevanten Dokumentation.
• Warten Sie auf Rückmeldung der Maintainer und gehen Sie auf Kommentare oder Vorschläge ein (falls vorhanden).
• Sobald Ihre Änderungen überprüft und genehmigt wurden, werden sie in das Haupt-Repository eingefügt.

⚖️ Verhaltenskodex

Obfu[DE]scate folgt dem Verhaltenskodex des Contributor Covenant. Bitte lesen Sie. und halten Sie sich an diesen Verhaltenskodex, wenn Sie zu Obfu[DE]scate beitragen.

🐛 Fehlerberichte und Funktionsanfragen

Wenn Sie einen Fehler entdecken oder einen Vorschlag für eine neue Funktion haben, eröffnen Sie bitte ein Issue im GitHub-Repository. Bitte geben Sie so viele Details wie möglich an, einschließlich Schritten zur Reproduktion des Fehlers oder einer klaren Beschreibung der vorgeschlagenen Funktion. Ihr Feedback ist wertvoll und wird dazu beitragen, Obfu[DE]scate für alle zu verbessern.

💛 Danksagungen

Dieses Tool wäre ohne APKTool nicht möglich! Zweitens verwenden viele der Beispiele in dieser README die Chess.com-App als Basis, schauen Sie hier vorbei.

📜 Lizenz

GNU General Public License v3.0