APKDeepLens

Что такое APKDeepLens?

APKDeepLens — это инструмент статического анализа на Python для APK-файлов Android. Он декомпилирует APK с помощью JADX и выполняет глубокое многоуровневое сканирование безопасности, охватывающее OWASP Mobile Top 10 (2024). Каждая находка помечается уровнем серьезности (CRITICAL / HIGH / MEDIUM / LOW / INFO) и категорией OWASP, а результаты экспортируются в форматах JSON, HTML, PDF или TXT.

Возможности

• Декомпиляция APK с помощью JADX (Windows, Linux, macOS, Docker)
• Анализ AndroidManifest.xml — разрешения, экспортированные компоненты, неправильные конфигурации
• Глубокое сканирование кода — обход всех декомпилированных исходных файлов Java/Kotlin/XML
• Обнаружение жестко закодированных секретов — ключи API, токены OAuth, закрытые ключи, пароли
• Обнаружение небезопасной связи — HTTP, FTP, SMTP, URL-адреса JavaScript-протоколов
• Обнаружение слабой криптографии — слабые алгоритмы, режим ECB, небезопасный random
• Анализ безопасности WebView — интерфейс JavaScript, доступ к файлам, игнорирование SSL
• Неправильная конфигурация SSL/TLS — сертификаты с полным доверием, обход имени хоста, устаревшие протоколы
• Динамическое выполнение кода — DexClassLoader, Runtime.exec(), ProcessBuilder
• Небезопасное хранение данных — файлы, доступные для чтения всеми, буфер обмена, внешнее хранилище, сырой SQL
• Конфиденциальные данные в логах — Log.*, System.out.println, printStackTrace
• Безопасность Intent — неявные PendingIntent, липкие широковещательные рассылки
• Обнаружение обхода пути Zip (Zip Slip)
• Классификация серьезности — CRITICAL, HIGH, MEDIUM, LOW, INFO для каждой находки
• Сопоставление с OWASP Mobile Top 10 (2024) для каждой находки
• Отчеты в нескольких форматах — JSON, HTML, PDF, TXT
• Готовность к CI/CD — вывод JSON напрямую интегрируется в конвейеры
• Кроссплатформенность — Windows, Linux, macOS, Docker

Обнаружение с первого взгляда

Полные идентификаторы проверок, шаблоны регулярных выражений и примеры доказательств см. в DETECTION.md.

Установка

Требования: Python 3.10+, Java / OpenJDK

Linux / macOS

git clone https://github.com/d78ui98/APKDeepLens.git
cd APKDeepLens
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python APKDeepLens.py --help

Windows

git clone https://github.com/d78ui98/APKDeepLens.git
cd APKDeepLens
python3 -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt
python APKDeepLens.py --help

Docker

docker build -t apkdeeplens .
docker run --rm -v /path/to/apk/files:/apk apkdeeplens -apk /apk/file.apk

Использование

# Basic scan — outputs JSON report
python APKDeepLens.py -apk app.apk

# Skip decompilation when source is already extracted
python APKDeepLens.py -apk app.apk -source_code_path /path/to/source

# Generate HTML report
python APKDeepLens.py -apk app.apk -report html

# Generate PDF report
python APKDeepLens.py -apk app.apk -report pdf

# Generate plain-text report
python APKDeepLens.py -apk app.apk -report txt

# Specify output directory
python APKDeepLens.py -apk app.apk -report json -o /path/to/output/

# Skip virtualenv check (CI/CD)
python APKDeepLens.py -apk app.apk --ignore_virtualenv

Все отчеты сохраняются в подкаталог reports/ пути вывода.

Отчеты

Полную схему вывода JSON см. в DETECTION.md.

Структура проекта

APKDeepLens/
├── APKDeepLens.py               # Main entry point
├── report_gen.py                # Report generation (JSON, HTML, PDF, TXT)
├── report_template.html         # HTML report template
├── requirements.txt
└── static_tools/
    ├── code_scanner.py          # Deep code-pattern security scanner (40+ checks)
    ├── scan_android_manifest.py # Manifest parser + security checker
    ├── sensitive_info_extractor.py  # Hardcoded secret + insecure URL scanner
    ├── known_false_positives.txt    # Curated false-positive filter list
    └── utility/
        └── utility_class.py    # Shared constants (DANGEROUS_PERMISSIONS, util)

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

Запросы функций, сообщения об ошибках и pull request’ы приветствуются на github.com/d78ui98/APKDeepLens/issues.

Представлен на

• Black Hat MEA 2023 — APKaleidoscope: Безопасность Android в полном спектре
• Black Hat ASIA 2024 — APKDeepLens: Безопасность Android в полном спектре
• Black Hat MEA 2024 — APKDeepLens: Безопасность Android в полном спектре
• GISEC Global Dubai 2024 — APKDeepLens: Безопасность Android в полном спектре