🤖 Obfu[DE]scate：Android APKの難読化解除と比較ツール 📱

Obfu[DE]scate は、Android APK の2つのバージョンを難読化解除し比較するプロセスを簡素化するために設計された Python ツールです。難読化の一部として関数名が変更されていても、ファジー比較ロジックを使用して関数間の類似性を特定し、APK バージョン間の変更を明らかにすることができます。

➡️ はじめに

インストール

Obfu[DE]scate の開始は簡単です！以下の手順に従ってください：

1. リポジトリをローカルマシンにクローンします。
2. 依存関係を手動でインストールするか、付属の requirements ファイルを使用して次のコマンドでインストールします：

pip install -r REQUIREMENTS.txt

3. お使いのシステム用の APKTool を公式サイトからダウンロードし、インストールして PATH に追加してください。

Obfu[DE]scate は Windows 11 でテストされていますが、他のシステムでも動作するはずです。

実行

Obfu[DE]scate では、動作をカスタマイズするためのいくつかのコマンドラインオプションを提供しています：

2 つの APK ファイルを比較するには、以下のコマンドで Obfu[DE]scate を実行するだけです：

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

上記の例では、Obfu[DE]scate は old_example.apk APK 内のクラスパス com.example.path にあるすべての関数をレビューし、new_example.apk 内の同じクラスパスにあるすべての関数と比較します。

🔎 出力

Obfu[DE]scate は 2 つの出力ファイルを生成します。改行区切りリスト形式のマッピングファイルと、インタラクティブな HTML ファイルです。これらの出力ファイルには以下が含まれます：

• mapping.txt - 各行が APK1 のメソッドと APK2 のメソッドの間で特定された一致を表す改行区切りのテキストファイル。行の形式は次の通りです：com.chess.play.ObserveGameHelperImpl.d -> com.chess.play.ObserveGameHelperImpl.a 。
• output.html - Web ブラウザで開くと、APK1 のすべての関数がリスト表示される HTML ファイル。これらはドロップダウンになっており、クリックすると APK2 のマッチしたメソッド（存在する場合）、それらが一致する確信度、および APK1 と APK2 のそのメソッドの SMALI コードブロックが表示されます。

🙏 コントリビューション

Obfu[DE]scate はオープンソースプロジェクトであり、コミュニティからのコントリビューションを歓迎します。Obfu[DE]scate にコントリビュートする場合は、次のガイドラインに従ってください：

• リポジトリを自分の GitHub アカウントにフォークします。
• コントリビューションの内容を表す説明的な名前の新しいブランチを作成します。
• 変更を加え、徹底的にテストします。
• メインリポジトリにプルリクエストを送信し、変更内容の詳細な説明と関連するドキュメントを含めます。
• メンテナからのフィードバックを待ち、コメントや提案（あれば）に対処します。
• 変更がレビューされ承認されると、メインリポジトリにマージされます。

⚖️ 行動規範

Obfu[DE]scate は Contributor Covenant の行動規範に従います。Obfu[DE]scate にコントリビュートする際は、こちらを確認し、この行動規範を遵守してください。

🐛 バグ報告と機能リクエスト

バグに遭遇した場合や新機能の提案がある場合は、GitHub リポジトリで Issue を開いてください。再現手順や提案機能の明確な説明など、できるだけ詳細な情報を提供してください。皆様のフィードバックは貴重であり、Obfu[DE]scate をより良いものにするのに役立ちます。

💛 謝辞

このツールは APKTool なしでは動作しません！また、この README の多くの例では Chess.com アプリをベースとして使用しています。詳細はこちらをご覧ください。

📜 ライセンス

GNU General Public License v3.0