tweathers-sec/doppelganger_assistantКалькулятор карт и плагин для Proxmark3 для записи и/или симуляции всех типов карт, которые поддерживают Doppelgänger Community, Pro, Stealth и MFAS.
Профессиональное GUI-приложение для расчета данных карт и автоматизации операций Proxmark3 для всех типов карт, поддерживаемых Doppelgänger Core и Stealth. Этот инструмент упрощает процесс записи карт для физического тестирования на проникновение, предоставляя интуитивно понятный интерфейс с двумя окнами вывода, визуальными разделителями и копированием в буфер обмена одним кликом, что избавляет от необходимости запоминать сложный синтаксис Proxmark3 или просматривать заметки.
Автоматические установщики установят Doppelganger Assistant, необходимые зависимости и последнюю версию форка Iceman Proxmark3. В процессе установки вам будет предложено выбрать тип вашего устройства Proxmark3 для оптимальной конфигурации.
/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
Откройте 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 предоставляет полный рабочий процесс анализа и клонирования карт — от начального обнаружения до успешных операций записи. Приложение автоматически определяет технологии карт, извлекает данные учётных записей, восстанавливает ключи шифрования и записывает клонированные карты с проверкой.
### Интеллектуальное обнаружение карт
Функция Card Discovery автоматически сканирует как низкочастотные (LF), так и высокочастотные (HF) чипы, определяя двухчиповые карты и конкретные технологии, включая HID Prox, iCLASS, PicoPass, MIFARE и другие. Результаты включают декодированные данные Wiegand с кодом объекта и номером карты, если они доступны.
### Анализ карт-ключей для гостиниц
Раздел Hotel Access Control предоставляет специализированные инструменты для гостиничных ключей на базе MIFARE. Извлечение информации о карте (Card Info) автоматически идентифицирует гостиничные карты Saflok и отображает подробные данные, включая UID, тип карты, поддержку Magic, обнаружение PRNG. Вывод данных с Proxmark3 включает полную метаинформацию Saflok, если она доступна.
### Автоматическое восстановление ключей
Инструменты атаки на MIFARE включают несколько методов восстановления: Autopwn (автоматический многометодный), Darkside, Nested, Hardnested, Static Nested, Bruteforce и тестирование уязвимости NACK. Метод Autopwn автоматически выбирает наилучший метод атаки на основе характеристик карты. Результаты содержат сводки восстановления с указанием обработанных секторов, найденных ключей, использованных методов и автоматически создаваемые дамп-файлы для немедленного клонирования карт.
### Работа с корпоративными картами доступа
Раздел Corporate Access Control поддерживает чтение и запись карт iCLASS, PicoPass, AWID, HID Prox, Indala, Avigilon и других корпоративных технологий. Данные карт автоматически извлекаются из вывода Proxmark3 для получения кодов объекта, номеров карт, длины битов, типов форматов (H10301, C1k35s и т.д.), значений CSN и «сырых» шестнадцатеричных данных. Встроенный рабочий процесс позволяет немедленно записывать данные на чистые карты с опциональной проверкой.
### Полный процесс клонирования
Doppelgänger Assistant интегрируется с оборудованием Doppelgänger RFID и устройствами Proxmark3. Данные учётных записей, захваченные считывателями Doppelgänger, можно напрямую импортировать в графический интерфейс для анализа и записи. Приложение поддерживает чтение карт от разных производителей, разбор данных из веб-интерфейса и выполнение операций записи с обновлением статуса в реальном времени и проверкой.
## Журнал изменений
### Версия 1.1.2 (18 декабря 2025 г.)
**Новые возможности:**
* Добавлена кнопка LAUNCH PM3 для открытия Proxmark3 в отдельном окне терминала
* Добавлен раздел Card Discovery с автоматическим определением типа карты
* Добавлена функция READ CARD DATA для всех поддерживаемых типов карт
* Добавлен раздел Hotel / Residence Access Control с инструментами MIFARE
* Добавлено обнаружение двухчиповых карт (одновременно LF и HF)
* Добавлено автоматическое извлечение информации о карте при обнаружении MIFARE
**Улучшения:**
* Улучшено определение типов MIFARE и поддержки Magic
* Улучшена проверка карт с более понятными сообщениями об успехе
* Улучшена обработка ошибок и обратная связь с пользователем по всему приложению
* Улучшено чтение карт iCLASS с поддержкой автоматического дешифрования
### Версия 1.1.1
* Начальная версия с основными функциями записи, проверки и симуляции карт
* Поддержка PROX, iCLASS, AWID, Indala, Avigilon, EM4100, PIV и MIFARE
## Устройства Doppelgänger
Вы можете приобрести скрытый считыватель (Stealth reader), плату разработчика Doppelgänger Dev Board или полностью собранные считыватели дальнего действия в [Physical Exploitation Store](https://store.physicalexploit.com/). Прошивку с открытым исходным кодом можно найти на [Doppelgänger Core](https://github.com/mwgroup-io/Doppelganger_Core).
## Поддерживаемые устройства Proxmark3
Doppelgänger Assistant работает с [форком Proxmark3 от Iceman](https://github.com/RfidResearchGroup/proxmark3) и поддерживает следующие типы устройств:
* **Proxmark3 RDV4** — с Bluetooth-модулем Blueshark или без него
* **Proxmark3 Easy (512 КБ)** — поддержка универсальной платформы
Автоматические установщики предложат вам выбрать тип устройства во время установки для оптимальной конфигурации.
## Типы корпоративных карт PACS