APKDeepLens

Cos'è APKDeepLens?

APKDeepLens è uno strumento di analisi statica basato su Python per file APK Android. Decompila gli APK usando JADX ed esegue una scansione di sicurezza multi-livello approfondita che copre OWASP Mobile Top 10 (2024). Ogni rilevamento è contrassegnato con un livello di gravità (CRITICAL / HIGH / MEDIUM / LOW / INFO) e una categoria OWASP, e i risultati vengono esportati in formato JSON, HTML, PDF o TXT.

Funzionalità

• Decompilazione APK tramite JADX (Windows, Linux, macOS, Docker)
• Analisi di AndroidManifest.xml — permessi, componenti esportati, configurazioni errate
• Scansione approfondita del codice — esamina tutto il codice sorgente decompilato Java/Kotlin/XML
• Rilevamento di segreti hardcoded — chiavi API, token OAuth, chiavi private, password
• Rilevamento di comunicazioni non sicure — HTTP, FTP, SMTP, URL di protocollo JavaScript
• Rilevamento di debolezze crittografiche — algoritmi deboli, modalità ECB, random non sicuro
• Analisi della sicurezza WebView — interfaccia JavaScript, accesso ai file, ignorare SSL
• Configurazione errata SSL/TLS — trust-all cert, bypass hostname, protocolli legacy
• Esecuzione dinamica del codice — DexClassLoader, Runtime.exec(), ProcessBuilder
• Archiviazione dati non sicura — file leggibili da tutti, clipboard, archiviazione esterna, SQL puro
• Dati sensibili nei log — Log.*, System.out.println, printStackTrace
• Sicurezza degli Intent — PendingIntent impliciti, sticky broadcast
• Rilevamento di path traversal Zip (Zip Slip)
• Classificazione della gravità — CRITICAL, HIGH, MEDIUM, LOW, INFO per rilevamento
• Mappatura OWASP Mobile Top 10 (2024) su ogni rilevamento
• Report multi-formato — JSON, HTML, PDF, TXT
• Pronto per CI/CD — l'output JSON si integra direttamente nelle pipeline
• Multi-piattaforma — Windows, Linux, macOS, Docker

Rilevamento a Colpo d'Occhio

Per ID dei check completi, pattern regex ed esempi di evidenze vedi DETECTION.md.

Installazione

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

Utilizzo

# Scansione base — produce report JSON
python APKDeepLens.py -apk app.apk

# Salta la decompilazione quando il sorgente è già estratto
python APKDeepLens.py -apk app.apk -source_code_path /path/to/source

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

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

# Genera report in testo semplice
python APKDeepLens.py -apk app.apk -report txt

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

# Salta il controllo virtualenv (CI/CD)
python APKDeepLens.py -apk app.apk --ignore_virtualenv

Tutti i report vengono salvati in una sottodirectory reports/ del percorso di output.

Report

Vedi DETECTION.md per lo schema completo dell'output JSON.

Struttura del Progetto

APKDeepLens/
├── APKDeepLens.py               # Punto di ingresso principale
├── report_gen.py                # Generazione report (JSON, HTML, PDF, TXT)
├── report_template.html         # Template report HTML
├── requirements.txt
└── static_tools/
    ├── code_scanner.py          # Scanner di sicurezza approfondito per pattern di codice (40+ check)
    ├── scan_android_manifest.py # Analizzatore del Manifest + controllo di sicurezza
    ├── sensitive_info_extractor.py  # Scanner segreti hardcoded + URL non sicuri
    ├── known_false_positives.txt    # Lista curata di filtri per falsi positivi
    └── utility/
        └── utility_class.py    # Costanti condivise (DANGEROUS_PERMISSIONS, util)

Collaborazione

Richiedi funzionalità, segnala bug e invia pull request su github.com/d78ui98/APKDeepLens/issues.

Presentato a

• 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