🔒 كاشف تثبيت SSL

SSLPinDetect هي أداة لتحليل ملفات 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 (مطلوب): مسار ملف apktool jar.
• -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 إلى المستوى التالي؟ ساهم بأفكارك وتحسيناتك أو ارفع مشكلات لجعل هذه الأداة أكثر قوة! دعنا نبني شيئًا رائعًا معًا!

إثبات المفهوم