APKDeepLens

O que é APKDeepLens?

APKDeepLens é uma ferramenta de análise estática baseada em Python para arquivos APK Android. Ela descompila APKs usando JADX e executa uma varredura de segurança profunda em múltiplas camadas cobrindo o OWASP Mobile Top 10 (2024). Cada descoberta é marcada com um nível de severidade (CRITICAL / HIGH / MEDIUM / LOW / INFO) e uma categoria OWASP, e os resultados são exportados em formato JSON, HTML, PDF ou TXT.

Recursos

• Descompilação de APK via JADX (Windows, Linux, macOS, Docker)
• Análise do AndroidManifest.xml — permissões, componentes exportados, configurações incorretas
• Varredura profunda de código — percorre todo o código-fonte Java/Kotlin/XML descompilado
• Detecção de segredos hardcoded — chaves de API, tokens OAuth, chaves privadas, senhas
• Detecção de comunicação insegura — HTTP, FTP, SMTP, URLs de protocolo JavaScript
• Detecção de fraquezas criptográficas — algoritmos fracos, modo ECB, aleatório inseguro
• Análise de segurança WebView — interface JavaScript, acesso a arquivos, ignorar SSL
• Configuração incorreta de SSL/TLS — certificados que confiam em todos, bypass de hostname, protocolos legados
• Execução de código dinâmico — DexClassLoader, Runtime.exec(), ProcessBuilder
• Armazenamento inseguro de dados — arquivos legíveis por todos, área de transferência, armazenamento externo, SQL bruto
• Dados sensíveis em logs — Log.*, System.out.println, printStackTrace
• Segurança de Intents — PendingIntents implícitos, broadcasts sticky
• Detecção de path traversal em ZIP (Zip Slip)
• Classificação de severidade — CRITICAL, HIGH, MEDIUM, LOW, INFO por descoberta
• Mapeamento OWASP Mobile Top 10 (2024) em cada descoberta
• Relatórios em múltiplos formatos — JSON, HTML, PDF, TXT
• Pronto para CI/CD — saída JSON integra-se diretamente em pipelines
• Multiplataforma — Windows, Linux, macOS, Docker

Detecção em Resumo

Para IDs de verificação completos, padrões regex e exemplos de evidências, veja DETECTION.md.

Instalação

Requisitos: 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

Uso

# 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

Todos os relatórios são salvos em um subdiretório reports/ do caminho de saída.

Relatórios

Veja DETECTION.md para o esquema completo da saída JSON.

Estrutura do Projeto

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)

Contribuindo

Solicitações de funcionalidades, relatórios de bugs e pull requests são bem-vindos em github.com/d78ui98/APKDeepLens/issues.

Apresentado em

• Black Hat MEA 2023 — APKaleidoscope: Android Security Insights in Full Spectrum
• Black Hat ASIA 2024 — APKDeepLens: Android Security Insights in Full Spectrum
• Black Hat MEA 2024 — APKDeepLens: Android Security Insights in Full Spectrum
• GISEC Global Dubai 2024 — APKDeepLens: Android Security Insights in Full Spectrum