مساعد دوبلغانجر

تطبيق واجهة رسومية احترافي لحساب بيانات البطاقات وأتمتة عمليات Proxmark3 لكل نوع بطاقة يدعمه كل من Doppelgänger Core و Stealth. تعمل هذه الأداة على تبسيط عملية كتابة البطاقات لاختبار الاختراق المادي من خلال توفير واجهة بديهية مع شاشات عرض مزدوجة للمخرجات، وفواصل بصرية، ونسخ بنقرة واحدة إلى الحافظة، مما يلغي الحاجة إلى حفظ صيغ Proxmark3 المعقدة أو البحث في الملاحظات.

الميزات

• واجهة رسومية حديثة: تخطيط مكون من عمودين مع شاشات عرض مخصصة للحالة ومخرجات الأوامر
• عمليات البطاقات: إنشاء وتنفيذ أوامر Proxmark3 تلقائيًا لكتابة البطاقات والتحقق منها ومحاكاتها
• تنفيذ مباشر: تنفيذ عمليات الكتابة والتحقق والمحاكاة مباشرة من الواجهة الرسومية باستخدام جهاز Proxmark3 الخاص بك
• متعدد المنصات: متاح لأنظمة macOS و Linux و Windows (عبر WSL)
• اكتشاف البطاقات: اكتشاف أنواع البطاقات وقراءة بياناتها تلقائيًا
• التحكم في الوصول للفنادق: أدوات كاملة لاستعادة وتحليل بطاقات MIFARE
• تكامل الطرفية: تشغيل Proxmark3 في نافذة طرفية منفصلة

التثبيت السريع (موصى به)

ستقوم برامج التثبيت الآلية بتثبيت مساعد دوبلغانجر والتبعيات المطلوبة وأحدث نسخة Iceman من Proxmark3. أثناء التثبيت، سيُطلب منك تحديد نوع جهاز Proxmark3 الخاص بك للحصول على التكوين الأمثل.

macOS```sh

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_macos.sh)"

### Linux```bash
curl -sSL https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_linux.sh | sudo bash

ويندوز (WSL)

افتح PowerShell كمسؤول وشغّل:```powershell irm https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_windows.ps1 | iex

**ملاحظة:** سيطالبك المثبت بالاختيار بين **Ubuntu 24.04 LTS (Noble)** (موصى به) أو **Kali Linux**. سيكتشف تلقائيًا التثبيتات الموجودة وسيطالبك بالتحديث. إذا كانت إعادة التشغيل مطلوبة لتمكين ميزات WSL، ستتم مطالبتك. ما عليك سوى تشغيل نفس الأمر مرة أخرى بعد إعادة التشغيل.

⚠️ هام: WSL2 لا يدعم التشغيل داخل أجهزة افتراضية متداخلة. يكتشف المثبت تلقائيًا ويمنع التثبيت في مثل هذه البيئات. للمتابعة، قم بالتثبيت على أجهزة مادية.

## ما يمكن أن يفعله Doppelgänger Assistant

يوفر Doppelgänger Assistant سير عمل كامل لتحليل البطاقات واستنساخها، بدءًا من الاكتشاف الأولي وحتى عمليات الكتابة الناجحة. يحدد التطبيق تلقائيًا تقنيات البطاقات، ويستخرج بيانات الاعتماد، ويستعيد مفاتيح التشفير، ويكتب بطاقات مستنسخة مع التحقق.

### اكتشاف البطاقات الذكي

تقوم ميزة اكتشاف البطاقات بمسح تلقائي لشرائح التردد المنخفض والتردد العالي، وتحديد البطاقات ثنائية الشريحة وتحديد تقنيات البطاقات المحددة بما في ذلك HID Prox و iCLASS و PicoPass و MIFARE وغيرها. تتضمن النتائج بيانات Wiegand مفكوكة مع رموز المنشأة وأرقام البطاقات عند توفرها.

![اكتشاف البطاقات](https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/img/assistant_detect_card_type.png)

### تحليل بطاقات غرف الفنادق

يوفر قسم التحكم في الوصول إلى الفنادق أدوات متخصصة لأنظمة مفاتيح الفنادق القائمة على MIFARE. يقوم استرداد معلومات البطاقة تلقائيًا بتحديد بطاقات مفاتيح Saflok للفنادق ويعرض معلومات مفصلة للبطاقة بما في ذلك UID ونوع البطاقة وقدرات السحر واكتشاف PRNG. يتضمن الإخراج الخام من Proxmark3 بيانات وصفية شاملة لـ Saflok عند توفرها.

![كشف مفتاح فندق Saflok](https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/img/assistant_detect_hotel_key.png)

### استعادة المفاتيح تلقائيًا

تتضمن أدوات هجوم MIFARE طرق استعادة متعددة: Autopwn (متعدد الطرق تلقائيًا)، Darkside، Nested، Hardnested، Static Nested، Bruteforce، واختبار الثغرات NACK. يختار Autopwn تلقائيًا أفضل طريقة هجوم بناءً على خصائص البطاقة. تعرض النتائج ملخصات استعادة شاملة توضح القطاعات المستردة وإجمالي المفاتيح التي تم العثور عليها وطرق الاستعادة المستخدمة والإنشاء التلقائي لملف التفريغ للاستنساخ الفوري للبطاقة.

![MIFARE Autopwn](https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/img/assistant_mifare_autopwn.png)

### عمليات بطاقات الوصول المؤسسي

يدعم قسم التحكم في الوصول المؤسسي قراءة وكتابة بطاقات iCLASS و PicoPass و AWID و HID Prox و Indala و Avigilon وتقنيات بطاقات الشركات الأخرى. يتم تحليل بيانات البطاقة تلقائيًا من إخراج Proxmark3 لاستخراج رموز المنشأة وأرقام البطاقات وأطوال البت وأنواع التنسيق (H10301، C1k35s، إلخ) وقيم CSN والبيانات السداسية العشرية الخام. يسمح سير العمل المتكامل بالكتابة الفورية على البطاقات الفارغة مع التحقق الاختياري.

![قراءة بطاقة iCLASS](https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/img/assistant_read_corporate_card.png)

### سير عمل الاستنساخ الكامل

يتكامل Doppelgänger Assistant بسلاسة مع أجهزة Doppelgänger RFID وأجهزة Proxmark3. يمكن استيراد بيانات الاعتماد الملتقطة باستخدام أجهزة قراءة Doppelgänger مباشرة إلى واجهة المستخدم الرسومية للتحليل والكتابة. يدعم التطبيق قراءة البطاقات من عدة مصنعين، وتحليل البيانات من واجهة الويب، وتنفيذ عمليات الكتابة مع تحديثات الحالة في الوقت الفعلي والتحقق.

![سير عمل الكتابة المتكامل](https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/img/assistant_gui_write.png)

## سجل التغييرات

### الإصدار 1.1.2 (18 ديسمبر 2025)

**ميزات جديدة:**
* إضافة زر LAUNCH PM3 لفتح Proxmark3 في نافذة طرفية منفصلة
* إضافة قسم اكتشاف البطاقات مع الكشف التلقائي عن نوع البطاقة
* إضافة وظيفة READ CARD DATA لجميع أنواع البطاقات المدعومة
* إضافة قسم التحكم في الوصول إلى الفنادق / المساكن مع أدوات MIFARE
* إضافة كشف البطاقات ثنائية الشريحة للبطاقات التي تحتوي على قدرات LF و HF
* إضافة الاسترداد التلقائي لمعلومات البطاقة عند اكتشاف بطاقات MIFARE

**تحسينات:**
* تحسين كشف البطاقات لإظهار أنواع MIFARE المحددة وقدرات السحر
* تعزيز التحقق من البطاقات برسائل نجاح أوضح
* معالجة أفضل للأخطاء وتغذية راجعة للمستخدم في جميع أنحاء التطبيق
* تحسين قراءة بطاقات iCLASS مع دعم فك التشفير التلقائي

### الإصدار 1.1.1

* إصدار أولي مع ميزات الكتابة الأساسية للبطاقة والتحقق والمحاكاة
* دعم بطاقات PROX و iCLASS و AWID و Indala و Avigilon و EM4100 و PIV و MIFARE

## أجهزة Doppelgänger

يمكنك شراء قارئ Stealth أو لوحة تطوير Doppelgänger أو أجهزة قراءة بعيدة المدى مجمعة بالكامل من [متجر الاستغلال المادي](https://store.physicalexploit.com/). للحصول على البرامج الثابتة مفتوحة المصدر، تحقق من [Doppelgänger Core](https://github.com/mwgroup-io/Doppelganger_Core).

## أجهزة Proxmark3 المدعومة

يعمل Doppelgänger Assistant مع [fork Iceman من Proxmark3](https://github.com/RfidResearchGroup/proxmark3) ويدعم أنواع الأجهزة التالية:

* **Proxmark3 RDV4** - مع أو بدون إضافة Blueshark Bluetooth
* **Proxmark3 Easy (512KB)** - دعم منصة عامة

ستطالبك المثبتات الآلية بتحديد نوع جهازك أثناء التثبيت للحصول على التكوين الأمثل.

## أنواع بطاقات PACS المؤسسية

فيما يلي أنواع بطاقات PACS المؤسسية المدعومة رسميًا بناءً على البرامج الثابتة لـ Doppelgänger. تمت إضافة دعم بطاقات مفاتيح الفنادق / Mifare في الإصدار 1.1.2 مع إمكانيات استعادة المفاتيح والاستنساخ. لاحظ أن تحليل بطاقات مفاتيح الفنادق / تحليل Mifare التفصيلي لا يتوافق مع البيانات الملتقطة باستخدام منتجات Doppelgänger. هذه مجرد ميزة إضافية لدعم جهود اختبار الاختراق المادي وتعتبر قيد التطوير.