Iceman Fork - Proxmark3

O Proxmark3 é a ferramenta canivete suíço do RFID, permitindo interações com a grande maioria das tags RFID em escala global. Originalmente construído por Jonathan Westhues, o dispositivo é agora a ferramenta de referência para análise de RFID para entusiastas. O repositório Iceman é considerado o ápice de recursos e funcionalidades, possibilitando uma enorme gama de comandos extremamente úteis e convenientes e scripts LUA para automatizar identificação de chips, testes de penetração e programação

Último Lançamento	Coverity	Contribuidores

Ações CI OSX	Ações CI Ubuntu	Ações CI Windows

Tabela de Conteúdo

• Iceman Fork - Proxmark3
• Tabela de Conteúdo
• INSTALAÇÃO E VISÃO GERAL DO PROXMARK3
  • Notas / documentos úteis
• Como compilar?
  • Proxmark3 RDV4
  • Plataformas Proxmark3 Genéricas
• O que mudou?
• Desenvolvimento
  • Sistemas operacionais suportados
  • Binários pré-compilados
  • Proxmark3 GUI
  • Canais oficiais
  • Mantenedores
  • Citação
  • Direitos autorais e termos de licenciamento

INSTALAÇÃO E VISÃO GERAL DO PROXMARK3

Notas / documentos úteis

Como compilar?

Proxmark3 RDV4

Veja os links de instrução nas tabelas acima para compilar, gravar e executar para o seu dispositivo Proxmark3 RDV4.

Plataformas Proxmark3 Genéricas

Para compilar este repositório para plataformas Proxmark3 genéricas, recomendamos que leia Parâmetros avançados de compilação

Definimos plataformas Proxmark3 genéricas como os seguintes dispositivos.

Suportadas

• RDV1, RDV2, RDV3 easy
• Ryscorp green PCB version
• Radiowar black PCB version
• inúmeras versões chinesas adaptadas do RDV3 easy (kkmoon, PiSwords etc)
• Proxmark3 SE (Special Edition) (com BLE)
• Proxmark3 X
  • Nota: Testado pela comunidade
  • Nota: hardware do dispositivo desconhecido

Não suportadas

• ⚠ Proxmark Evolution (EVO)
  • Nota: atribuições de pinos desconhecidas.
• ⚠ Ryscorp Proxmark3 Pro
  • Nota: dispositivo possui fpga diferente e atribuições de pinos desconhecidas.
  • Nota: A empresa desapareceu, deixando seus clientes no escuro.

Suporte experimental

• ⚠ iCopy-X
  • Nota: atualmente incompatível com a GUI do iCopy-X, pois os comandos do cliente Proxmark usam sintaxe diferente
  • Nota: veja também icopyx-community repos para fontes upstream, hardware invertido, etc.
  • Nota: Usa DRM para bloquear tags, ignora as licenças de código aberto. Use por sua conta e risco.
• ⚠ Proxmark3 Ultimate
  • Nota: hardware do dispositivo desconhecido
  • Nota: Imagens FPGA estão sendo compiladas para ele. Use por sua conta e risco.

Status de suporte desconhecido

• ⚠ VX
  • Nota: hardware do dispositivo desconhecido

Quando se trata desses novos modelos desconhecidos, dependemos da comunidade para relatar se este repositório funciona e o que fizeram para fazê-lo funcionar.

Tamanho de memória flash de 256KB das plataformas Proxmark3 genéricas

⚠ Nota: Você precisa ficar de olho no tamanho da memória flash embutida do seu chip ARM. Com 512KB você está seguro, mas se for 256KB, você precisa compilar este repositório com ainda menos funcionalidades. Ao executar o ./pm3-flash-all você pode ver qual tamanho seu dispositivo possui se tiver o bootloader deste repositório instalado. Caso contrário, você encontrará o tamanho relatado na mensagem de inicialização ao executar o cliente Proxmark3 ./pm3.

OBS! Leia o aviso sobre memória flash de 256KB

O que mudou?

Modificações de hardware do Proxmark3 RDV4:

• memória flash adicionada de 256KB
• módulo smart card adicionado
• conector FPC adicionado para periféricos como complemento Bluetooth+bateria
• antenas melhoradas
  • intercambiáveis
  • chave de fator Q LF
  • chave de frequência LF 125/134
• formato de PCB pequeno
• estojo ABS

Este repositório vs repositório oficial do Proxmark3:

Veja o arquivo Changelog que tentamos manter atualizado.

Em resumo, este repositório oferece uma experiência de usuário completamente diferente no que diz respeito ao Proxmark3.

• Suporta preenchimento automático de comandos com Tab
• CLI mais rica com uso de cores / emojis
• Sistema de texto de ajuda implementado em todos os lugares
• Sistema de dicas
• Configurações de preferência do usuário
• Testes extensivos com sistemas de integração contínua no Linux, OSX e Windows, e uso regular de ferramentas de análise estática como
  • Coverity Scan
  • Cppcheck (v2.6)
  • GCC e Clang com aplicação agressiva de flags de diagnóstico
• Detecção automática de portas seriais e integração perfeita com complemento Bluetooth
• Reconexão ao dispositivo a partir do cliente
• Suporta ataques de tearoff
• Suporta NFC NDEF tipo1, tipo2, tipo4a, tipo4b, mifare, código de barras
• Suporta scripts de cliente pm3, scripts lua, scripts python
• Coleção mais abrangente de scripts disponível
• Codificação, decodificação Wiegand.
• Suporta EMV
• Suporta CIPURSE
• A maioria dos modos autônomos disponível com compilação fácil
• Script de teste extensivo para cliente e ferramentas externas
• Dicionários de chaves conhecidos mais abrangentes compilados
• Comunicações USB simplificadas com NG-frames
• O software de recuperação de chave pública conhecida mais compilado
• As implementações mais rápidas do referido software
• Suporte a múltiplos formatos de arquivo para arquivos de dump (BIN/EML/JSON)
• Interoperabilidade dos referidos formatos de arquivo com libnfc, aplicativo MFC tool etc
• Suporta mais protocolos baseados em RFID do que nunca
• Instalação fácil para mantenedores de pacotes, mantenedores de distribuições
• Suporta cmake, make
• Compila sem erros ou avisos em mais sistemas operacionais/plataformas do que nunca
• Disponível como pacote em distribuições conhecidas como Gentoo, Kali, Termux, Macports, Homebrew
• Muito mais documentação

Desenvolvimento

⚠ Nota: Este é um repositório de ponta. Os mantenedores estão trabalhando ativamente neste repositório e irão reestruturar periodicamente o código para torná-lo mais fácil de compreender, navegar, compilar, testar e contribuir, portanto ESPERAM-SE mudanças significativas no layout do código regularmente.

👉 Lembre-se! Se você pretende contribuir com o código, leia primeiro as notas de estilo de codificação. Geralmente mesclamos suas contribuições rapidamente, pois gostamos da ideia de obter uma funcionalidade no Proxmark3 e eliminar os bugs depois.

O roteiro público é um excelente ponto de partida para ler se você tem interesse em contribuir.

Sistemas operacionais suportados

Este repositório compila perfeitamente em

• WSL1 no Windows 10
• WSL2 no Windows 10/11
• Ambiente Proxspace release v3.xx
• Ambiente Windows/MinGW
• Ubuntu, ParrotOS, Gentoo, Pentoo, Kali, NetHunter, Arch Linux, Fedora, Debian, Raspbian
• Android / Termux
• macOS / Homebrew (ou MacPorts, experimental) / Apple Silicon M1
• iOS (Jailbroken, rootful)
• Contêiner Docker
  • Contêiner Iceman repo baseado em ubuntu 18.04
  • Contêiner baseado no fork Iceman v1.7

Binários pré-compilados

Veja Proxmark3 precompiled builds

Proxmark3 GUI

A GUI oficial PM3-GUI do Gaucho não funcionará. Sem mencionar que é bastante antiga e não é mais mantida.

• Proxmark3 Universal GUI funcionará mais ou menos.
• Proxmark3 GUI cross-compiled que foi atualizado recentemente e afirma suportar a fonte mais recente deste repositório.
• Proxmark3_GUI gui simples em vb.net

Canais oficiais

Onde encontrar a comunidade?

• Servidor Discord da comunidade RFID Hacking
• Canal IRC do Proxmark3
• Sub reddit do Proxmark3
• Fórum do Proxmark3

Mantenedores

Para todos os mantenedores de distribuições e pacotes, tentamos facilitar sua vida.

make install agora está disponível e se você quiser saber mais.

Este documento será útil para você

• Notas para mantenedores

Citação

Use este bibtex para citar este repositório globalmente:

@misc{proxmark3,
  author = {C. {Herrmann} and P. {Teuwen} and O. {Moiseenko} and M. {Walker} and others},
  title = {{Proxmark3 -- Iceman repo}},
  howpublished = {\url{https://github.com/RfidResearchGroup/proxmark3}},
  keywords = {rfid nfc iceman proxmark3 125khz 134khz 13.56mhz},
}

Se precisar se referir a um estado específico do repositório, use um número de commit ou uma data de acesso, por exemplo:

  note = {Accessed: commit 12327f71a27da23831901847886aaf20e8ad3ca0}
  note = {Accessed: 2021-01-01}

Direitos autorais e termos de licenciamento

Cada contribuição está sob os direitos autorais de seu autor. Veja AUTHORS.

O código-fonte do Proxmark3 é coberto pelos seguintes termos de licenciamento, geralmente referidos como GPLv3 ou posterior.

Este programa é software livre: você pode redistribuí-lo e/ou modificá-lo
sob os termos da Licença Pública Geral GNU, conforme publicada pela
Free Software Foundation, seja a versão 3 da Licença, ou
(a seu critério) qualquer versão posterior.

Este programa é distribuído na esperança de que seja útil,
mas SEM QUALQUER GARANTIA; sem a garantia implícita de
COMERCIALIZAÇÃO ou ADEQUAÇÃO A UM PROPÓSITO ESPECÍFICO. Veja a
Licença Pública Geral GNU para mais detalhes.

Uma cópia da GPLv3 está disponível em LICENSE.

Algumas dependências podem estar sob outros termos de licenciamento livre compatíveis com os termos de licenciamento do Proxmark3, veja suas respectivas descrições.