🤖 Obfu[DE]scate: Инструмент для деобфускации и сравнения Android APK. 📱

Obfu[DE]scate — это инструмент на Python, предназначенный для упрощения процесса деобфускации и сравнения двух версий Android APK — даже если функции были переименованы в процессе обфускации. Благодаря логике нечёткого сравнения Obfu[DE]scate может определять сходства между функциями и помогать выявлять изменения между версиями APK.

➡️ Начало работы

Установка

Начать работу с Obfu[DE]scate легко! Выполните следующие шаги:

1. Клонируйте репозиторий на локальную машину.
2. Установите зависимости вручную или с помощью прилагаемого файла requirements, выполнив команду:

pip install -r REQUIREMENTS.txt

3. Загрузите APKTool для вашей системы с их сайта и убедитесь, что он установлен и доступен в вашем PATH.

Obfu[DE]scate был протестирован на Windows 11, но должен работать и на других системах.

Запуск

Obfu[DE]scate предоставляет несколько параметров командной строки для настройки поведения:

Чтобы сравнить два APK-файла, просто запустите Obfu[DE]scate следующей командой:

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

В приведённом примере Obfu[DE]scate проверит все функции в APK old_example.apk по пути класса com.example.path и сравнит их со всеми функциями, найденными по тому же пути в new_example.apk.

🔎 Выводы

Obfu[DE]scate создаёт два выходных файла: файл сопоставления в формате списка, разделённого переводами строк, и интерактивный HTML-файл. Эти выходные файлы включают:

• mapping.txt - Текстовый файл, разделённый переводами строк, где каждая строка соответствует найденному совпадению между методом в APK1 и APK2. Формат строк такой: com.chess.play.ObserveGameHelperImpl.d -> com.chess.play.ObserveGameHelperImpl.a .
• output.html - HTML-файл, который при открытии в веб-браузере выводит список всех функций в APK1. Это выпадающие списки, при нажатии на которые показывается совпавший метод в APK2 (если есть), уверенность в совпадении и блок кода на SMALI для этого метода из APK1 и APK2.

🙏 Вклад в проект

Obfu[DE]scate — это проект с открытым исходным кодом, и он приветствует вклад сообщества. Если вы хотите внести свой вклад в Obfu[DE]scate, пожалуйста, следуйте этим рекомендациям:

• Сделайте форк репозитория в свою учётную запись GitHub.
• Создайте новую ветку с описательным названием для вашего вклада.
• Внесите изменения и тщательно протестируйте их.
• Отправьте pull request в основной репозиторий, включив подробное описание ваших изменений и соответствующую документацию.
• Дождитесь обратной связи от сопровождающих и учтите все замечания или предложения (если они есть).
• После того как ваши изменения будут рассмотрены и одобрены, они будут объединены с основным репозиторием.

⚖️ Кодекс поведения

Obfu[DE]scate следует Кодексу поведения Contributor Covenant. Пожалуйста, обязательно ознакомьтесь и соблюдайте этот кодекс поведения при участии в Obfu[DE]scate.

🐛 Отчёты об ошибках и запросы функций

Если вы столкнулись с ошибкой или хотите предложить новую функцию, откройте issue в репозитории GitHub. Пожалуйста, предоставьте как можно больше подробностей, включая шаги для воспроизведения проблемы или чёткое описание предлагаемой функции. Ваш отзыв ценен и поможет улучшить Obfu[DE]scate для всех.

💛 Благодарности

Этот инструмент не работал бы без APKTool! Во-вторых, многие примеры в этом README используют приложение Chess.com в качестве основы, ознакомьтесь с ним здесь.

📜 Лицензия

GNU General Public License v3.0