tweathers-sec/doppelganger_assistant카드 계산기 및 Doppelgänger Community, Pro, Stealth, MFAS가 지원하는 모든 카드 유형을 작성 및/또는 시뮬레이션하기 위한 Proxmark3 플러그인
모든 카드 유형에 대해 Doppelgänger Core 및 Stealth가 지원하는 카드 데이터 계산과 Proxmark3 작업 자동화를 위한 전문 GUI 애플리케이션입니다. 이 도구는 직관적인 인터페이스에 이중 출력 표시, 시각적 구분선, 원클릭 클립보드 복사 기능을 제공하여 복잡한 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, 카드 유형, 매직 기능, 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 값 및 원시 16진수 데이터를 추출합니다. 통합 워크플로우를 통해 선택적 검증과 함께 빈 카드에 즉시 쓸 수 있습니다.
### 완전한 복제 워크플로우
Doppelgänger Assistant는 Doppelgänger RFID 하드웨어 및 Proxmark3 장치와 완벽하게 통합됩니다. Doppelgänger 리더기로 캡처한 자격 증명은 분석 및 쓰기를 위해 GUI로 직접 가져올 수 있습니다. 이 애플리케이션은 여러 제조업체의 카드 읽기, 웹 인터페이스에서 데이터 파싱, 실시간 상태 업데이트 및 검증을 통한 쓰기 작업 실행을 지원합니다.
## 변경 로그
### 버전 1.1.2 (2025년 12월 18일)
**새로운 기능:**
* 별도의 터미널 창에서 Proxmark3를 여는 LAUNCH PM3 버튼 추가
* 자동 카드 유형 감지 기능이 포함된 Card Discovery 섹션 추가
* 지원되는 모든 카드 유형에 대한 READ CARD DATA 기능 추가
* MIFARE 도구가 포함된 Hotel / Residence Access Control 섹션 추가
* LF와 HF 기능을 모두 가진 카드에 대한 듀얼 칩 카드 감지 추가
* MIFARE 카드 감지 시 자동 카드 정보 검색 추가
**개선 사항:**
* 특정 MIFARE 유형과 매직 기능을 표시하도록 카드 감지 개선
* 더 명확한 성공 메시지로 카드 검증 강화
* 애플리케이션 전반에 걸친 오류 처리 및 사용자 피드백 개선
* 자동 복호화 지원을 통한 iCLASS 카드 읽기 개선
### 버전 1.1.1
* 핵심 카드 쓰기, 검증 및 시뮬레이션 기능을 갖춘 최초 릴리스
* PROX, iCLASS, AWID, Indala, Avigilon, EM4100, PIV 및 MIFARE 카드 지원
## Doppelgänger 장치
Stealth 리더기, 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는 [Iceman fork of Proxmark3](https://github.com/RfidResearchGroup/proxmark3)와 함께 작동하며 다음 장치 유형을 지원합니다:
* **Proxmark3 RDV4** - Blueshark Bluetooth 애드온 유무에 관계없이 지원
* **Proxmark3 Easy (512KB)** - 범용 플랫폼 지원
자동 설치 프로그램은 최적의 구성을 위해 설치 중에 장치 유형을 선택하도록 안내합니다.
## 기업 PACS 카드 유형
아래는 Doppelgänger 펌웨어 기반의 공식 지원 기업 PACS 카드 유형입니다. 호텔/MIFARE 키 카드 지원은 키 복구 및 복제 기능과 함께 버전 1.1.2에서 추가되었습니다. 참고로, 호텔 키 카드 / 상세 MIFARE 분석은 Doppelgänger 제품을 사용하여 캡처된 데이터와 일치하지 않습니다. 이는 물리적 침투 테스트 노력을 지원하기 위해 추가된 기능일 뿐이며 작업 진행 중인 기능으로 간주됩니다.
| Card Types | Core | Stealth | FC Range | CN Range |
| --------------------------- | ---- | ------- | ----------- | --------------- |
| Keypad PIN Codes | | X | N/A | N/A |
| HID H10301 26-bit | X | X | 0–255 | 0–65,535 |
| Indala 26-bit | X | X | 0–255 | 0–65,535 |
| Indala 27-bit | X | X | 0–4,095 | 0–8,191 |
| 2804 WIEGAND 28-bit | X | X | 0–255 | 0–16,383 |
| Indala 29-bit | X | X | 0–4,095 | 0–32,767 |
| ATS Wiegand 30-bit | X | X | 0–2,047 | 0–32,767 |
| HID ADT 31-Bit | X | X | 0–15 | 0–8,388,607 |
| EM4102 / Wiegand 32-bit | X | X | 0–32,767 | 0–65,535 |
| HID D10202 33-bit | X | X | 0–127 | 0–16,777,215 |
| HID H10306 34-bit | X | X | 0–65,535 | 0–65,535 |
| HID Corporate 1000 35-bit | X | X | 0–4,095 | 0–1,048,575 |
| HID Simplex 36-bit (S12906) | X | X | 0–255 | 0–65,535 |
| HID H10304 37-bit | X | X | 0–65,535 | 0–524,287 |
| HID H800002 46-bit | X | X | 0–16,383 | 0–1,073,741,823 |
| HID Corporate 1000 48-bit | X | X | 0–4,194,303 | 0–8,388,607 |
| AWID 50-bit | X | X | 0–65,535 | 0–8,388,607 |
| Avigilon 56-bit | X | X | 0–1,048,575 | 0–4,194,303 |
| C910 PIVKey | X | X | N/A | N/A |
| MIFARE (Various Types) | X | X | N/A | N/A |
지원되는 기술은 다음과 같습니다:
* iCLASS(Legacy/SE/Seos) *참고: 캡처된 SE 및 Seos 카드는 iCLASS 2k 카드에만 쓸 수 있습니다.*
* PROX
* Indala
* AWID
* Avigilon
* EM4102
* PIV (UID만 해당 - 리더기의 Wiegand 출력을 통해 제공되는 정보이기 때문)
* MIFARE (UID만 해당 - 리더기의 Wiegand 출력을 통해 제공되는 정보이기 때문)
## 상세 설치 안내
### 수동 MacOS 설치
1. [릴리스 페이지](https://github.com/tweathers-sec/doppelganger_assistant/releases)에서 아키텍처에 맞는 DMG 파일을 다운로드하세요:
- Apple Silicon (M1/M2/M3): `doppelganger_assistant_darwin_arm64.dmg`
- Intel: `doppelganger_assistant_darwin_amd64.dmg`
2. DMG 파일을 열고 `doppelganger_assistant.app`을 `/Applications` 폴더로 드래그하세요.
3. 격리 속성을 제거하세요: ```sh
xattr -cr /Applications/doppelganger_assistant.app
~/.zshrc 또는 ~/.zprofile)에 추가하여 명령줄 별칭을 만드세요: ```sh
alias doppelganger_assistant='/Applications/doppelganger_assistant.app/Contents/MacOS/doppelganger_assistant'
Option 1: Using .deb package (Debian/Ubuntu/Kali - Recommended)