rovellipaolo/ninjadroidNinja: обратный инжиниринг Android APK-пакетов
NinjaDroid — это простой инструмент для реверс-инжиниринга Android APK-пакетов.
Опубликован по адресу: https://snapcraft.io/ninjadroid```shell $ snap install ninjadroid --channel=beta
[](https://github.com/rovellipaolo/NinjaDroid/actions)
[](https://coveralls.io/github/rovellipaolo/NinjaDroid)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://snapcraft.io/ninjadroid)
## Обзор
NinjaDroid использует [AXMLParser](https://github.com/appknox/pyaxmlparser) вместе с набором Python-скриптов на основе `aapt`, `keytool`, `string` и других для извлечения из заданного APK-пакета следующей информации:
- Список файлов APK: имя файла, размер, MD5, SHA-1, SHA-256 и SHA-512
- Информация из `AndroidManifest.xml`: имя приложения, имя пакета, версия, SDK, разрешения, Activity, службы, Broadcast-приёмники, ...
- Информация о цифровом сертификате `CERT.RSA/DSA`: серийный номер, срок действия, отпечаток, эмитент и владелец
- Список URL, команд оболочки и других строковых данных, жёстко заданных в файлах `classes.dex`
Кроме того, NinjaDroid использует [apktool](https://github.com/iBotPeaches/Apktool) и [dex2jar](https://github.com/pxb1988/dex2jar) для извлечения и сохранения:
- JSON-файла отчёта, содержащего всю извлечённую информацию об APK
- Файла `AndroidManifest.xml` (благодаря `apktool`)
- Файла цифрового сертификата `CERT.RSA/DSA`
- Файлов `classes.dex`
- Переведённого _.jar_ файла (благодаря `dex2jar`)
- Дизассемблированных smali-файлов (благодаря `apktool`)
- Папок `assets/` и `res/` вместе с их содержимым (благодаря `apktool`)
## Сборка
Первый шаг — клонирование репозитория NinjaDroid или загрузка его исходного кода.```shell
$ git clone https://github.com/rovellipaolo/NinjaDroid
$ cd NinjaDroid
NinjaDroid имеет несколько способов запуска: в локальной среде, в Docker, в виде Flatpak (экспериментально) и в виде Snap (экспериментально).
Для запуска NinjaDroid на локальной машине необходимо установить Python 3.5 или выше, Java 8 или выше и binutils.
При желании, если Android SDK установлен локально, можно использовать SDK-версию aapt вместо встроенной. Для этого нужно изменить расположение aapt в ninjadroid/aapt/Aapt.py (т.е. __AAPT_EXEC_PATH = "ninjadroid/aapt/aapt").
Просто выполните следующие команды, которые установят все зависимости Python (убедившись, что aapt, apktool и dex2jar имеют права на выполнение) и добавят символическую ссылку ninjadroid в /usr/local/bin/.
git clone https://github.com/kov4l3nko/NinjaDroid.git
cd NinjaDroid
pip install -r requirements.txt --user
chmod +x ninjadroid/aapt/aapt
chmod +x ninjadroid/apktool/apktool.jar
chmod +x ninjadroid/dex2jar/dex2jar.sh
chmod +x ninjadroid/jadx/jadx
sudo ln -s $(pwd)/ninjadroid.py /usr/local/bin/ninjadroid
``````shell
$ make build-linux
$ make install
$ ninjadroid --help
Просто запустите следующие команды, которые установят все необходимые зависимости Python (убедившись, что aapt, apktool и dex2jar имеют права на выполнение) и добавят символическую ссылку ninjadroid в /usr/local/bin/.```shell
$ make build-macos
$ make install
$ ninjadroid --help
### Docker
Для выполнения NinjaDroid в Docker необходим установленный `Docker`.
Для сборки образа Docker выполните следующие команды:```shell
$ make build-docker
$ docker run --name ninjadroid ninjadroid:latest ninjadroid --help
Обратите внимание, что необходимо привязать директорию, содержащую целевой APK-пакет, к образу Docker:```shell $ mkdir apks $ cp /path/to/your/package.apk apks/package.apk $ docker run --name ninjadroid -it --rm -v $(pwd)/apks:/apks ninjadroid:latest ninjadroid /apks/package.apk -aj
То же самое относится и к выходной директории при использовании опции `-e`/`--extract`, для которой вам также необходимо предоставить разрешения:```shell
$ mkdir output
$ chmod 777
$ docker run --name ninjadroid --rm -v $(pwd)/apks:/apks -v $(pwd)/output:/output ninjadroid:latest ninjadroid /apks/package.apk -ae /output
Для запуска NinjaDroid в качестве Flatpak вам потребуются установленные Flatpak и flatpak-builder.
Просто выполните следующие команды, которые установят все необходимые зависимости Flatpak:```shell
$ make build-flatpak
$ flatpak-builder --run flatpak/build flatpak/com.github.rovellipaolo.NinjaDroid.yaml ninjadroid --help
**ПРИМЕЧАНИЕ:** The `-e`/`--extract` option does not work correctly at present (see: https://github.com/rovellipaolo/NinjaDroid/issues/21).
### Snap (экспериментальный)
Чтобы запустить NinjaDroid в качестве Snap, вам потребуется установленные `Snap` и `snapcraft`.
Просто выполните следующие команды, которые установят все необходимые зависимости Snap:```shell
$ make build-snap
$ make install-snap
$ ninjadroid --help
ПРИМЕЧАНИЕ: Опция -e/--extract работает некорректно, если snap установлен без использования опции --devmode (см.: https://github.com/rovellipaolo/NinjaDroid/issues/20).
После настройки (см. раздел "Установка") вы также можете запустить тесты и проверку стиля следующим образом.
Чтобы запустить их на локальной машине, выполните следующие команды:```shell $ make test $ make regression $ make checkstyle
Вы также можете запустить тесты с покрытием, выполнив следующую команду:```shell
$ make test-coverage
И/или настройте checkstyle для автоматического запуска при каждом git-коммите, выполнив следующую команду:``` $ make install-githooks
### Docker
Чтобы запустить их в Docker, выполните следующие команды:```shell
$ make test-docker
$ make regression-docker
$ make checkstyle-docker
Чтобы запустить регрессионные тесты в Flatpak, выполните следующую команду:```shell $ make regression-flatpak
### Snap
Чтобы запустить регрессионные тесты в Snap, выполните следующую команду:```shell
$ make regression-snap
Ниже приведены примеры запуска NinjaDroid для образца пакета APK.