APKDeepLens

Qu'est-ce que APKDeepLens ?

APKDeepLens est un outil d'analyse statique basé sur Python pour les fichiers APK Android. Il décompile les APK à l'aide de JADX et effectue une analyse de sécurité multicouche approfondie couvrant le OWASP Mobile Top 10 (2024). Chaque résultat est associé à un niveau de sévérité (CRITIQUE / ÉLEVÉ / MOYEN / FAIBLE / INFO) et à une catégorie OWASP, et les résultats sont exportés au format JSON, HTML, PDF ou TXT.

Fonctionnalités

• Décompilation APK via JADX (Windows, Linux, macOS, Docker)
• Analyse d'AndroidManifest.xml — permissions, composants exportés, erreurs de configuration
• Analyse de code approfondie — parcourt tout le code source Java/Kotlin/XML décompilé
• Détection de secrets codés en dur — clés API, jetons OAuth, clés privées, mots de passe
• Détection de communications non sécurisées — HTTP, FTP, SMTP, URLs de protocole JavaScript
• Détection de faiblesses cryptographiques — algorithmes faibles, mode ECB, aléatoire non sécurisé
• Analyse de la sécurité WebView — interface JavaScript, accès aux fichiers, ignorance SSL
• Erreurs de configuration SSL/TLS — certificats tout-accepter, contournement de nom d'hôte, protocoles obsolètes
• Exécution de code dynamique — DexClassLoader, Runtime.exec(), ProcessBuilder
• Stockage de données non sécurisé — fichiers lisibles par tout le monde, presse-papiers, stockage externe, SQL brut
• Données sensibles dans les journaux — Log.*, System.out.println, printStackTrace
• Sécurité des intentions — PendingIntents implicites, diffusions collantes
• Détection de traversée de chemin Zip (Zip Slip)
• Classification de sévérité — CRITIQUE, ÉLEVÉ, MOYEN, FAIBLE, INFO par résultat
• Correspondance OWASP Mobile Top 10 (2024) pour chaque résultat
• Rapports multi-formats — JSON, HTML, PDF, TXT
• Prêt pour CI/CD — la sortie JSON s'intègre directement dans les pipelines
• Multi-plateforme — Windows, Linux, macOS, Docker

Aperçu de la détection

Pour les identifiants de vérification complets, les motifs regex et les exemples de preuves, voir DETECTION.md.

Installation

Prérequis : 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

Utilisation

# 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

Tous les rapports sont enregistrés dans un sous-répertoire reports/ du chemin de sortie.

Rapports

Voir DETECTION.md pour le schéma complet de sortie JSON.

Structure du projet

APKDeepLens/
├── APKDeepLens.py               # Point d'entrée principal
├── report_gen.py                # Génération de rapports (JSON, HTML, PDF, TXT)
├── report_template.html         # Modèle de rapport HTML
├── requirements.txt
└── static_tools/
    ├── code_scanner.py          # Analyseur de sécurité par motifs de code approfondi (40+ vérifications)
    ├── scan_android_manifest.py # Analyseur de manifeste + vérificateur de sécurité
    ├── sensitive_info_extractor.py  # Analyseur de secrets codés en dur + URLs non sécurisées
    ├── known_false_positives.txt    # Liste filtrée de faux positifs organisée
    └── utility/
        └── utility_class.py    # Constantes partagées (DANGEROUS_PERMISSIONS, util)

Contribution

Les demandes de fonctionnalités, les rapports de bogues et les pull requests sont les bienvenus sur github.com/d78ui98/APKDeepLens/issues.

Présenté à

• 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