tweathers-sec/doppelganger_assistantCalculadora de cartões e Plugin Proxmark3 para gravar e/ou simular todos os tipos de cartão suportados pelo Doppelgänger Community, Pro, Stealth e MFAS.
Aplicativo GUI profissional para calcular dados de cartão e automatizar operações do Proxmark3 para todos os tipos de cartão suportados pelo Doppelgänger Core e Stealth. Esta ferramenta simplifica o processo de gravação de cartões para testes de penetração física, oferecendo uma interface intuitiva com exibições duplas de saída, separadores visuais e cópia para a área de transferência com um clique, eliminando a necessidade de memorizar sintaxes complexas do Proxmark3 ou consultar anotações.
Os instaladores automatizados instalarão o Doppelganger Assistant, as dependências necessárias e o fork Iceman do Proxmark3. Durante a instalação, você será solicitado a selecionar o tipo do seu dispositivo Proxmark3 para uma configuração ideal.
/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
Abra o PowerShell como Administrador e execute:```powershell irm https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_windows.ps1 | iex
**Nota:** O instalador solicitará que você selecione entre **Ubuntu 24.04 LTS (Noble)** (recomendado) ou **Kali Linux**. Ele detectará automaticamente instalações existentes e solicitará a atualização. Se uma reinicialização for necessária para habilitar os recursos do WSL, você será notificado. Basta executar o mesmo comando novamente após reiniciar.
⚠️ IMPORTANTE: o WSL2 não oferece suporte à execução dentro de máquinas virtuais aninhadas. O instalador detecta automaticamente e impede a instalação nesses ambientes. Para prosseguir, instale em hardware físico.
## O que o Assistente Doppelgänger Pode Fazer
O Assistente Doppelgänger fornece um fluxo de trabalho completo de análise e clonagem de cartões, desde a detecção inicial até as operações de gravação bem-sucedidas. O aplicativo identifica automaticamente as tecnologias de cartão, extrai dados de credenciais, recupera chaves de criptografia e grava cartões clonados com verificação.
### Detecção Inteligente de Cartões
O recurso Card Discovery verifica automaticamente chips de Baixa Frequência (LF) e Alta Frequência (HF), identificando cartões de chip duplo e determinando tecnologias específicas de cartão, incluindo HID Prox, iCLASS, PicoPass, MIFARE e outras. Os resultados incluem dados Wiegand decodificados com facility codes e números de cartão quando disponíveis.
### Análise de Cartões-Chave de Hotel
A seção Hotel Access Control fornece ferramentas especializadas para sistemas de chave de hotel baseados em MIFARE. A recuperação de Card Info identifica automaticamente cartões-chave de hotel Saflok e exibe informações detalhadas do cartão, incluindo UID, tipo de cartão, capacidades magic e detecção de PRNG. A saída bruta do Proxmark3 inclui metadados abrangentes do Saflok quando disponíveis.
### Recuperação Automatizada de Chaves
As ferramentas de ataque MIFARE incluem vários métodos de recuperação: Autopwn (multimétodo automático), Darkside, Nested, Hardnested, Static Nested, Bruteforce e teste de vulnerabilidade NACK. O Autopwn seleciona automaticamente o melhor método de ataque com base nas características do cartão. Os resultados exibem resumos abrangentes de recuperação mostrando setores recuperados, total de chaves encontradas, métodos de recuperação utilizados e geração automática de arquivo dump para clonagem imediata do cartão.
### Operações com Cartões de Acesso Corporativo
A seção Corporate Access Control oferece suporte à leitura e gravação de iCLASS, PicoPass, AWID, HID Prox, Indala, Avigilon e outras tecnologias de cartão corporativo. Os dados do cartão são analisados automaticamente a partir da saída do Proxmark3 para extrair facility codes, números de cartão, comprimentos de bits, format types (H10301, C1k35s, etc.), valores CSN e dados hex brutos. O fluxo de trabalho integrado permite a gravação imediata em cartões em branco com verificação opcional.
### Fluxo de Trabalho Completo de Clonagem
O Assistente Doppelgänger integra-se perfeitamente ao hardware RFID Doppelgänger e aos dispositivos Proxmark3. Credenciais capturadas com leitores Doppelgänger podem ser importadas diretamente para a GUI para análise e gravação. O aplicativo suporta a leitura de cartões de vários fabricantes, o parsing dos dados da interface web e a execução de operações de gravação com atualizações de status em tempo real e verificação.
## Histórico de Alterações
### Versão 1.1.2 (18 de dezembro de 2025)
**Novos Recursos:**
* Adicionado botão LAUNCH PM3 para abrir o Proxmark3 em uma janela de terminal separada
* Adicionada seção Card Discovery com detecção automática do tipo de cartão
* Adicionada funcionalidade READ CARD DATA para todos os tipos de cartão suportados
* Adicionada seção Hotel / Residence Access Control com ferramentas MIFARE
* Adicionada detecção de cartões de chip duplo para cartões com capacidades LF e HF
* Adicionada recuperação automática de Card Info quando cartões MIFARE são detectados
**Melhorias:**
* Detecção de cartões aprimorada para exibir tipos MIFARE específicos e capacidades magic
* Verificação de cartões aprimorada com mensagens de sucesso mais claras
* Melhor tratamento de erros e feedback ao usuário em todo o aplicativo
* Leitura de cartões iCLASS aprimorada com suporte à descriptografia automática
### Versão 1.1.1
* Lançamento inicial com recursos principais de gravação, verificação e simulação de cartões
* Suporte para cartões PROX, iCLASS, AWID, Indala, Avigilon, EM4100, PIV e MIFARE
## Dispositivos Doppelgänger
Você pode comprar um leitor Stealth, um Doppelgänger Dev Board ou leitores de longo alcance totalmente montados na [Physical Exploitation Store](https://store.physicalexploit.com/). Para o firmware de código aberto, confira o [Doppelgänger Core](https://github.com/mwgroup-io/Doppelganger_Core).
## Dispositivos Proxmark3 Suportados
O Assistente Doppelgänger funciona com o [fork Iceman do Proxmark3](https://github.com/RfidResearchGroup/proxmark3) e suporta os seguintes tipos de dispositivos: