Doppelgänger Assistant

Card calculator and Proxmark3 Plugin for writing and/or simulating every card type that Doppelgänger Pro, Stealth, and MFAS support. This project is designed to streamline the card-writing process because every second counts in physical penetration testing. Why waste time digging through your disheveled notes to relearn how to write an iCLASS 2k card or fumble with the syntax for a 37-bit HID card? If you use doppelganger, let doppelgagner_assistant do the work for you. That way, you can spend more time creating a viable replica access control card.

Doppelgänger Devices

You can purchase Doppelgänger Pro, Stealth, and MFAS from the Physical Exploitation Store. Alternatively, you can build the community edition (less card reading support).

Officially Supported Card Types

Below are the officially supported card types based on Doppelgänger version:

Card Types	Community Edition	Pro	Stealth	MFAS	Notes
Keypad PIN Codes				X
HID H10301 26-bit	X	X	X	X
Indala 26-bit	X	X	X	X	Requires Indala reader/module
Indala 27-bit	X	X	X	X	Requires Indala reader/module
2804 WIEGAND 28-bit		X	X	X
Indala 29-bit	X	X	X	X	Requires Indala reader/module
ATS Wiegand 30-bit		X	X	X
HID ADT 31-Bit		X	X	X
EM4102 / Wiegand 32-bit			X	X
HID D10202 33-bit	X	X	X	X
HID H10306 34-bit	X	X	X	X
HID Corporate 1000 35-bit	X	X	X	X
HID Simplex 36-bit (S12906)		X	X	X
HID H10304 37-bit	X	X	X	X
HID Corporate 1000 48-bit		X	X	X
C910 PIVKey			X	X
MIFARE (Various Types)			X	X	UID Only

Supported technologies include:

iCLASS(Legacy/SE/Seos) Note: Captured SE and Seos cards can only be written to iCLASS 2k cards
PROX
Indala
AWID
EM4102
PIV
MIFARE

Installation

Manual Installation

Grab your desired package from the release page.
Ensure that you have the Iceman fork of the Proxmark3 software installed.
Install dependencies, if required (WSL).

Automated Installation

Alternatively, you can use one of the one-liners below to install on Linux and Windows (WSL). These one-liners will install Doppelganger Assistant, any required dependencies, and the latest fork of the (Iceman) Proxmark3 software.

Installation MacOS

Automated MacOS Installation (RECOMMENDED)

Run the following command in the terminal:

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

Manual MacOS Installation

Run the following command inside your preferred terminal application:

curl -sSL https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/doppelganger_install_macos.sh | sudo bash

Manual MacOS Installation

Download the application (.app) from the release page and place it in the /Applications directory. You can create a symbolic link to run the application from the terminal or you create an alias in your shell profile.

Only choose one of the following options...

# Symbolic Link
sudo ln -s /Applications/doppelganger_assistant.app/Contents/MacOS/doppelganger_assistant /usr/local/bin/doppelganger_assistant

# Profile Alias
alias doppelganger_assistant='/Applications/doppelganger_assistant.app/Contents/MacOS/doppelganger_assistant'

If you encounter an error stating that the "doppelganger_assistant.app" is damaged and can't be opened. You should move it to the Trash. Run the following command in the directory where the doppelganger assistant resides.

xattr -cr /Applications/doppelganger_assistant.app

Installation Linux

Automated Linux Installation (RECOMMEND)

Run the following command inside your preferred terminal application:

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

Manual Linux Installation

Install Doppelganger Assistant Dependencies. Note that this step should only be required if you encounter errors that prevent the deployment of doppelganger_assistant.

sudo apt update 
sudo apt upgrade
sudo apt install libgl1 xterm git

Grab the Doppelganger Assistant and install it:

sudo apt install make
wget https://github.com/tweathers-sec/doppelganger_assistant/releases/tag/latest/doppelganger_assistant_linux_{amd64/arm64}.tar.xz
tar xvf doppelganger_assistant_*
sudo make install

# Cleanup the directory, if desired
rm -rf usr/
rm doppelganger_assistant*
rm Makefile

To launch the Doppelganger Assistant GUI:

doppelganger_assistant

Installation Windows (WSL)

Automated Installation of Doppelganger Assistant (RECOMMENDED)

This process will install WSL, Doppelganger Assistant, Proxmark3 software, and create a desktop shortcut.

Open PowerShell as Administrator and run the following command.

powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/doppelganger_install_windows.ps1' -OutFile 'C:\doppelganger_assistant_install.ps1'; & 'C:\doppelganger_assistant_install.ps1'"

Alternatively, you can download the files and run them in this order:

wsl_enable.ps1
Reboot the system
doppelganger_install_windows.ps1

Manual Installation

If needed, create an Ubuntu WSL environment. From cmd.exe run:

wsl --install -d Ubuntu

Reboot Windows. When Windows starts up, WSL will finish setting up. When prompted, enter the Username and Password for your Ubuntu system.

Install Doppelganger Assistant Dependencies:

sudo apt update 
sudo apt upgrade
sudo apt install libgl1 xterm make git

Grab the Doppelganger Assistant and install it:

wget https://github.com/tweathers-sec/doppelganger_assistant/releases/tag/latest/doppelganger_assistant_linux_{amd64/arm64}.tar.xz
tar xvf doppelganger_assistant_*
sudo make install

# Cleanup the directory, if desired
rm -rf usr/
rm doppelganger_assistant*
rm Makefile

To launch the Doppelganger Assistant GUI:

doppelganger_assistant

Install Proxmark3 Dependencies:

sudo apt install --no-install-recommends git ca-certificates build-essential pkg-config \
libreadline-dev gcc-arm-none-eabi libnewlib-dev qtbase5-dev \
libbz2-dev liblz4-dev libbluetooth-dev libpython3-dev libssl-dev libgd-dev

Clone the Proxmark3 Repo:

git clone https://github.com/RfidResearchGroup/proxmark3.git
cd proxmark3

If desired, modify the Makefile to support the Blueshark Device

cp Makefile.platform.sample Makefile.platform

#uncomment #PLATFORM_EXTRAS=BTADDON
nano Makefile.platform

Compile and Install Proxmark3 software

make clean && make -j
make install

Install USBipd to passthrough the Proxmark3 device to WSL. From cmd.exe run:

winget install --interactive --exact dorssel.usbipd-win

To Connect the Proxmark3 device to WSL. Open cmd.exe as an Administrator and run:

usbipd list // This will list the usb devices attach to your computer
usbipd bind --busid 9-1 // {9-1 Should be your Proxmark3's ID}
usbipd attach --wsl --busid 9-1 // {9-1 Should be your Proxmark3's ID}

Example Usage