🔒 SSL Pinning Detector

SSLPinDetect — это инструмент для анализа Android APK-файлов с целью обнаружения реализаций SSL-пиннинга путем сканирования известных шаблонов в декомпилированном smali-коде. Он помогает специалистам по безопасности и пентестерам эффективно выявлять механизмы SSL-пиннинга, используемые в мобильных приложениях.

🚀 Возможности

• Быстрое сканирование: Использует многопоточность и чтение файлов с отображением в память для эффективного и быстрого сканирования файлов.
• Точное обнаружение: Предварительно скомпилированные regex-шаблоны для точного обнаружения SSL-пиннинга с отображением номера строки и предварительным просмотром кода.
• Прогресс в реальном времени: Интерактивные индикаторы выполнения для сканирования и подсчета совпадений, что обеспечивает лучший мониторинг.
• Гибкий вывод: Поддерживает подробный режим для детальных логов или минимальный вывод для эффективности.

⚙️ Требования

• Python 3.8+
• Java (убедитесь, что он в системном PATH)
• Apktool (скачайте и укажите путь)

🛠 Установка

1. Клонируйте репозиторий:

git clone https://github.com/aancw/SSLPinDetect
cd SSLPinDetect

2. Установите необходимые Python-пакеты:

pip install -r requirements.txt

3. Убедитесь, что Java и Apktool установлены и доступны.

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

python sslpindetect.py -f <apk_path> -a <apktool_path> -p <pattern_file> [-v]

Аргументы:

• -f, --file (обязательно): Путь к APK-файлу.
• -a, --apktool (обязательно): Путь к JAR-файлу apktool.
• -p, --pattern (необязательно): Путь к JSON-файлу, содержащему шаблоны SSL-пиннинга (по умолчанию: patterns.json).
• -v, --verbose (необязательно): Включить подробное логирование.

🧪 Примеры

✅ 1. Базовое использование (без подробного режима и пользовательских шаблонов):

python sslpindetect.py -f app.apk -a apktool.jar

🔍 2. Включение подробного режима (для детального вывода):

python sslpindetect.py -a apktool_2.11.0.jar -f sample/app-release.apk -v

Processing APK...
APK successfully decompiled.
Scanning Smali Files: 100%|█████████████████████| 100/100 [00:05<00:00, 19.76it/s]
Pattern Matched: 5
Total Patterns Matched: 5
Pattern detected: OkHttp Certificate Pinning
  - smali/com/example/app/MainActivity.smali
	[Line 45]: invoke-static {v0}, Lcom/squareup/okhttp/CertificatePinner;->check(Ljava/lang/String;)V

🛠️ 3. Использование пользовательских шаблонов SSL-пиннинга:

python sslpindetect.py -f app.apk -a apktool.jar -p custom_patterns.json

📂 Файл шаблонов (patterns.json)

Скачайте последний файл шаблонов: smali-sslpin-patterns

Пример файла patterns.json

{
    "OkHttp Certificate Pinning": [
        "Lcom/squareup/okhttp/CertificatePinner;",
        "Lokhttp3/CertificatePinner;",
        "setCertificatePinner"
    ],
    "TrustManager Override": [
        "Ljavax/net/ssl/X509TrustManager;",
        "checkServerTrusted"
    ]
}

✅ Лицензия

Этот проект лицензирован под лицензией MIT.

✅ Вклад

🚀 Готовы вывести SSLPinDetect на новый уровень? Вносите свои идеи, улучшения или создавайте issues, чтобы сделать этот инструмент еще более мощным! Давайте создавать что-то потрясающее вместе!

PoC