APKDeepLens

¿Qué es APKDeepLens?

APKDeepLens es una herramienta de análisis estático basada en Python para archivos APK de Android. Descompila los APK usando JADX y realiza un escaneo de seguridad profundo de múltiples capas que cubre el OWASP Mobile Top 10 (2024). Cada hallazgo está etiquetado con un nivel de gravedad (CRÍTICO / ALTO / MEDIO / BAJO / INFO) y una categoría OWASP, y los resultados se exportan en formato JSON, HTML, PDF o TXT.

Características

• Descompilación de APK mediante JADX (Windows, Linux, macOS, Docker)
• Análisis de AndroidManifest.xml — permisos, componentes exportados, configuraciones incorrectas
• Escaneo profundo de código — recorre todo el código fuente Java/Kotlin/XML descompilado
• Detección de secretos codificados — claves API, tokens OAuth, claves privadas, contraseñas
• Detección de comunicaciones inseguras — HTTP, FTP, SMTP, URLs con protocolo JavaScript
• Detección de debilidades criptográficas — algoritmos débiles, modo ECB, generación insegura de números aleatorios
• Análisis de seguridad de WebView — interfaz JavaScript, acceso a archivos, ignorar SSL
• Configuración incorrecta de SSL/TLS — certificados de confianza total, omisión de nombre de host, protocolos obsoletos
• Ejecución dinámica de código — DexClassLoader, Runtime.exec(), ProcessBuilder
• Almacenamiento inseguro de datos — archivos legibles por todos, portapapeles, almacenamiento externo, SQL sin preparar
• Datos sensibles en registros — Log.*, System.out.println, printStackTrace
• Seguridad de Intents — PendingIntents implícitos, broadcasts persistentes
• Detección de path traversal en ZIP (Zip Slip)
• Clasificación de gravedad — CRÍTICO, ALTO, MEDIO, BAJO, INFO por hallazgo
• Mapeo OWASP Mobile Top 10 (2024) en cada hallazgo
• Informes en múltiples formatos — JSON, HTML, PDF, TXT
• Preparado para CI/CD — la salida JSON se integra directamente en pipelines
• Multiplataforma — Windows, Linux, macOS, Docker

Detección de un vistazo

Para ver los IDs completos de las comprobaciones, patrones regex y ejemplos de evidencia, consulte DETECTION.md.

Instalación

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

# Escaneo básico — genera informe JSON
python APKDeepLens.py -apk app.apk

# Omitir descompilación cuando el código fuente ya está extraído
python APKDeepLens.py -apk app.apk -source_code_path /path/to/source

# Generar informe HTML
python APKDeepLens.py -apk app.apk -report html

# Generar informe PDF
python APKDeepLens.py -apk app.apk -report pdf

# Generar informe en texto plano
python APKDeepLens.py -apk app.apk -report txt

# Especificar directorio de salida
python APKDeepLens.py -apk app.apk -report json -o /path/to/output/

# Omitir verificación de virtualenv (CI/CD)
python APKDeepLens.py -apk app.apk --ignore_virtualenv

Todos los informes se guardan en un subdirectorio reports/ de la ruta de salida.

Informes

Consulte DETECTION.md para ver el esquema completo de salida JSON.

Estructura del proyecto

APKDeepLens/
├── APKDeepLens.py               # Punto de entrada principal
├── report_gen.py                # Generación de informes (JSON, HTML, PDF, TXT)
├── report_template.html         # Plantilla de informe HTML
├── requirements.txt
└── static_tools/
    ├── code_scanner.py          # Escáner de seguridad de patrones de código profundo (más de 40 comprobaciones)
    ├── scan_android_manifest.py # Analizador de manifiesto + comprobador de seguridad
    ├── sensitive_info_extractor.py  # Escáner de secretos codificados + URLs inseguras
    ├── known_false_positives.txt    # Lista curada de filtros de falsos positivos
    └── utility/
        └── utility_class.py    # Constantes compartidas (DANGEROUS_PERMISSIONS, util)

Contribuciones

Las solicitudes de funciones, informes de errores y pull requests son bienvenidos en github.com/d78ui98/APKDeepLens/issues.

Presentado en

• Black Hat MEA 2023 — APKaleidoscope: Información de Seguridad de Android en Espectro Completo
• Black Hat ASIA 2024 — APKDeepLens: Información de Seguridad de Android en Espectro Completo
• Black Hat MEA 2024 — APKDeepLens: Información de Seguridad de Android en Espectro Completo
• GISEC Global Dubai 2024 — APKDeepLens: Información de Seguridad de Android en Espectro Completo