🔒 Detector de SSL Pinning

SSLPinDetect es una herramienta para analizar APKs de Android y detectar implementaciones de SSL Pinning mediante el escaneo de patrones conocidos en código smali descompilado. Ayuda a investigadores de seguridad y testers de penetración a identificar los mecanismos de SSL Pinning utilizados en aplicaciones móviles de manera eficiente.

🚀 Características

• Escaneo Rápido: Utiliza multi-hilos y lectura de archivos mapeados en memoria para un escaneo eficiente y rápido.
• Detección Precisa: Patrones regex precompilados para detección precisa de SSL Pinning, con número de línea y vista previa del código.
• Progreso en Tiempo Real: Barras de progreso interactivas tanto para el escaneo como para el conteo de coincidencias, garantizando un mejor monitoreo.
• Salida Flexible: Soporta modo detallado para registros detallados o salida mínima para eficiencia.

⚙️ Requisitos

• Python 3.8+
• Java (Asegúrate de que esté en el PATH del sistema)
• Apktool (Descargar y especificar la ruta)

🛠 Instalación

1. Clona el repositorio:

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

2. Instala los paquetes de Python requeridos:

pip install -r requirements.txt

3. Asegúrate de que Java y Apktool estén instalados y accesibles.

🚦 Uso

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

Argumentos:

• -f, --file (obligatorio): Ruta al archivo APK.
• -a, --apktool (obligatorio): Ruta al archivo jar de apktool.
• -p, --pattern (opcional): Ruta al archivo JSON que contiene los patrones de SSL Pinning (por defecto: patterns.json).
• -v, --verbose (opcional): Habilita el registro detallado.

🧪 Ejemplos

✅ 1. Uso básico (sin modo detallado ni patrones personalizados):

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

🔍 2. Habilitar modo detallado (para salida detallada):

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. Usar patrones de SSL Pinning personalizados:

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

📂 Archivo de Patrones (patterns.json)

Descarga el archivo de patrones más reciente: smali-sslpin-patterns

Ejemplo del archivo patterns.json

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

✅ Licencia

Este proyecto está bajo la Licencia MIT.

✅ Contribuir

🚀 ¿Listo para llevar SSLPinDetect al siguiente nivel? ¡Contribuye con tus ideas, mejoras o reporta problemas para hacer esta herramienta aún más potente! ¡Construyamos algo increíble juntos!

PoC