Ferramenta de hardware para análise, emulação e testes de penetração de RFID. Suporta protocolos de 125kHz, 13.56MHz (MIFARE, iClass, ISO14443/15693) com recuperação de chaves, sniffing e script para pesquisa de segurança.
# Iceman Fork - Proxmark
O Proxmark é a ferramenta canivete suíço do RFID, permitindo interações com a grande maioria das tags RFID em escala global. Originalmente criado por Jonathan Westhues, o dispositivo é agora a ferramenta de referência para análise de RFID para o entusiasta.
O repositório Iceman é considerado o pináculo em recursos e funcionalidades, possibilitando uma enorme variedade de comandos extremamente úteis e convenientes e scripts Python/LUA para automatizar a identificação de chips, testes de penetração e programação.
| Última Versão | Coverity | Contribuidores |
|:--------------:|:--------:|:------------:|
| [](https://github.com/RfidResearchGroup/proxmark3/releases/latest) | [](https://scan.coverity.com/projects/proxmark3-rrg-iceman-repo)|  |
| Actions OSX CI | Actions Ubuntu CI | Actions Windows CI |
|:--------------:|:------------------:|:------------------:|
| [](https://github.com/RfidResearchGroup/proxmark3/actions/workflows/macos.yml) | [](https://github.com/RfidResearchGroup/proxmark3/actions/workflows/ubuntu.yml) | [](https://github.com/RfidResearchGroup/proxmark3/actions/workflows/windows.yml) |
# Índice
- [Iceman Fork - Proxmark](#iceman-fork---proxmark)
- [Índice](#table-of-contents)
- [INSTALAÇÃO E VISÃO GERAL DO PROXMARK3](#proxmark3-installation-and-overview)
- [Notas / documentos úteis](#notes--helpful-documents)
- [Como compilar?](#how-to-build)
- [Proxmark5](#proxmark5)
- [Proxmark3 RDV4](#proxmark3-rdv4)
- [Plataformas genéricas do Proxmark3](#generic-proxmark3-platforms)
- [O que mudou?](#what-has-changed)
- [Desenvolvimento](#development)
- [Sistemas operacionais suportados](#supported-operating-systems)
- [Binários pré-compilados](#precompiled-binaries)
- [GUIs](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/Promark-GUIs.md)
- [Canais oficiais](#official-channels)
- [Mantenedores](#maintainers)
- [Citação](#citation)
- [Termos de direitos autorais e licenciamento](#copyright-and-licensing-terms)
# PAG-INSTALL AT PAG-OVERVIEW NG PROXMARK3
| Instalação | Uso do Proxmark3 |
| :------------------: | :------------------: |
| [Linux - Configuração e Compilação](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Linux-Installation-Instructions.md) | [Instruções de Compilação](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)|
| [Linux - Notas importantes sobre o ModemManager](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/ModemManager-Must-Be-Discarded.md) | [Validação da Funcionalidade do Cliente Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/1_Validation.md)|
| [macOS - Homebrew e Atualização da Fórmula HomeBrew Tap](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Homebrew-Installation-Instructions.md) | [Primeiro Uso e Verificação](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md)|
| [macOS - MacPorts](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-MacPorts-Installation-Instructions.md) | [Comandos e Funcionalidades](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
| [macOS - Configuração e Compilação](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Compile-From-Source-Instructions.md) |[Modos Autónomos](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/standalone)|
| [Windows - Configuração e Compilação](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Windows-Installation-Instructions.md) ||
| [Termux / Android - Configuração e Compilação](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md) ||
| [iOS - Configuração e Compilação](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/iOS-Installation-Instructions.md)
| [Manual do Blue Shark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/bt_manual_v10.md) | [Folha de Referência de Comandos](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cheatsheet.md)|
| [Parâmetros Avançados de Compilação](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md) | [Mais Folhas de Referência](https://github.com/RfidResearchGroup/proxmark3/wiki/More-cheat-sheets)|
| [Resolução de Problemas](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Troubleshooting.md) | [Conjunto Completo de Comandos do Cliente](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/commands.md) |
| [JTAG](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/jtag_notes.md) | [Guia de Introdução ao T5577](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/T5577_Guide.md)|
## Notas / documentos úteis
| Notas |||
| ------------------- |:-------------------:| -------------------:|
|[Notas sobre UART](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/uart_notes.md)|[Notas sobre Termux / Android](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md)|[Notas sobre caminhos](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/path_notes.md)|
|[Notas sobre o formato de frame](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/new_frame_format.md)|[Notas sobre tracelog / wireshark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/trace_notes.md)|[Notas sobre EMV](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/emv_notes.md)|
|[Notas sobre flash externa](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ext_flash_notes.md)|[Notas sobre loclass](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/loclass_notes.md)|[Notas sobre Configuração e Execução do Coverity Scan](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Coverity-Scan-Config-and-Run.md)|
|[Notas sobre formatos de ficheiro usados com o Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/extensions_notes.md)|[Notas sobre o formato binário MFU](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/mfu_binary_format_notes.md)|[Notas sobre FPGA e ARM](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/fpga_arm_notes.md)|
|[Desenvolvimento de modo autónomo](https://github.com/rfidresearchgroup/proxmark3/blob/master/armsrc/Standalone/readme.md)|[Wiki sobre o modo autónomo](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[Notas sobre cartões Magic UID](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/magic_cards_notes.md)|
|[Notas sobre a utilização de cores](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/colors_notes.md)|[Makefile vs CMake](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Makefile-vs-CMake.md)|[Notas sobre Cloner guns](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cloner_notes.md)|
|[Notas sobre a utilização do cliparser](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cliparser.md)|[Notas sobre relógios](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/clocks.md)|[Notas sobre MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/desfire.md)|
|[Notas sobre CIPURSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cipurse.md)|[Notas sobre NDEF type4a](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ndef_type4a.md)|[Bíblia não oficial do MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/unofficial_desfire_bible.md)|[Notas sobre recuperação de chaves iClass legrec-legbrute](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/iclass_legrec_legbrute_key_recovery.md)|[Notas sobre ataques de downgrade](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/hid_downgrade.md)|||
# Como compilar?
## Proxmark5
A última geração de hardware chama-se Proxmark5. Possui
- MCU: AT32F435, um Artery Cortex-M4 a 288 MHz
- FPGA Gowin
- TypeC Extended Port (CEP)
- Addon BLE / Wifi / Bateria, através de um ESp32c2
- Antenas intercambiáveis (LF, HF, UHF)
- Antena de Baixa Frequência (LF) de 125, 134, 250, 375, 500 KHz
- Antena de Alta Frequência (HF) de 13.56 MHz
- como addon: Antena de Ultra Alta Frequência (UHF) de 860-960 MHz, ** ainda não desenvolvida **
No momento, as instruções específicas do Proxmark5 estão todas agrupadas em [um único guia de introdução](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/PM5_Start_Here/Getting_Started_With_PM5.md).
Leia-o para compilar, gravar e executar o seu dispositivo Proxmark5. Consulte os links de instruções nas tabelas acima para obter o ambiente de compilação.
- ⚠ O firmware não está estável no momento e está a ser ativamente desenvolvido em.
## Proxmark3 RDV4
Consulte os links de instruções nas tabelas acima para compilar, gravar e executar no seu dispositivo Proxmark3 RDV4.
## Plataformas Proxmark3 genéricas
Para compilar este repositório para plataformas Proxmark3 genéricas, recomendamos vivamente que leia [Parâmetros avançados de compilação](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md)
Definimos plataformas Proxmark3 genéricas como os seguintes dispositivos.
**Suportados**
- RDV1, RDV2, RDV3 easy
- Versão Ryscorp green PCB
- Versão Radiowar black PCB
- numerosas versões chinesas adaptadas da RDV3 easy (kkmoon, PiSwords, etc.)
- Proxmark3 SE (Special Edition) (com BLE)
- Proxmark3 X
- **Nota**: Testado pela comunidade
- **Nota**: hardware do dispositivo desconhecido
- iCopy-X
- **Nota**: Compatível **APENAS** após a instalação do [firmware open source iCopy-X](https://github.com/lab-401/icopy-x)
- O firmware de fábrica **não** é compatível (os comandos do cliente são diferentes / a UI de fábrica é closed source / o firmware de fábrica impõe DRM nas tags)
**Não suportados**
- ⚠ Proxmark Evolution (EVO)
- **Nota**: atribuições de pinos desconhecidas.
- ⚠ Ryscorp Proxmark3 Pro
- **Nota**: o dispositivo tem um FPGA diferente e atribuições de pinos desconhecidas.
- **Nota**: A empresa desapareceu, deixando os seus clientes sem informação.
**Suporte experimental**
- ⚠ Proxmark3 Ultimate
- **Nota**: hardware do dispositivo desconhecido
- **Nota**: Estão a ser compiladas imagens de FPGA para ele. Utilize por sua conta e risco.
**Estado de suporte desconhecido**
- ⚠ VX
- **Nota**: hardware do dispositivo desconhecido
No que diz respeito a estes novos modelos desconhecidos, dependemos da comunidade para reportar se este repositório funciona e o que fizeram para o fazer funcionar.
**Tamanho de memória flash de 256KB das plataformas Proxmark3 genéricas**
> ⚠ **Nota**:
> Tem de estar atento ao tamanho da memória flash integrada do seu chip ARM.
> Com 512KB está tudo bem, mas se for de 256KB precisa de compilar este repositório com ainda menos funcionalidades.
> Ao executar `./pm3-flash-all` pode ver qual o tamanho que o seu dispositivo tem, se tiver o bootloader deste repositório instalado.
> Caso contrário, encontrará o tamanho reportado na mensagem inicial ao executar o cliente Proxmark3 `./pm3`.
>
> [OBS! Leia o aviso sobre memória flash de 256KB](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md#256KB-versions)
# O que mudou?
Consulte o [ficheiro Changelog](https://github.com/rfidresearchgroup/proxmark3/blob/master/CHANGELOG.md) que tentamos manter atualizado.
# Desenvolvimento
> ⚠ **Nota**: Este é um repositório bleeding edge. Os mantenedores trabalham ativamente a partir deste repositório e irão reestruturar periodicamente o código para o tornar mais fácil de compreender, navegar, compilar, testar e contribuir, por isso **ESPERE mudanças significativas na estrutura do código de forma regular**.
> 👉 **Lembre-se!** Se pretende contribuir para o código, leia primeiro as [notas de estilo de codificação](https://github.com/rfidresearchgroup/proxmark3/blob/master/CONTRIBUTING.md).
Normalmente fazemos merge das suas contribuições rapidamente, pois gostamos da ideia de adicionar uma funcionalidade ao Proxmark3 e eliminar os bugs depois.
O [roadmap público](https://github.com/RfidResearchGroup/proxmark3/wiki/Public-Roadmap) é um excelente ponto de partida para ler se estiver interessado em contribuir.
## Sistemas operativos suportados
Este repositório compila bem em
- WSL1 no Windows 10
- WSL2 no Windows 10/11
- Ambiente Proxspace [release v3.xx](https://github.com/Gator96100/ProxSpace/releases)
- 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 ubuntu 18.04 baseado no repositório Iceman ](https://hub.docker.com/r/secopsconsult/proxmark3)
- [ Contêiner v1.7 baseado no fork Iceman ](https://hub.docker.com/r/iceman1001/proxmark3/)
## Binários pré-compilados
Consulte [Proxmark3 precompiled builds](https://www.proxmarkbuilds.org/)
## Canais oficiais
Onde você encontra a comunidade?
- [Servidor Discord da comunidade RFID Hacking](https://t.ly/d4_C)
- [Canal IRC do Proxmark3](https://web.libera.chat/?channels=#proxmark3)
- [Subreddit do Proxmark3](https://www.reddit.com/r/proxmark3/)
## Mantenedores
A todos os mantenedores de distros e pacotes, tentamos facilitar a sua vida.
`make install` agora está disponível e, se você quiser saber mais.
Este documento será útil para você
- [Notas para mantenedores](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Maintainers.md)
## 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 fazer referência 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}
```
## Termos de direitos autorais e licenciamento
Cada contribuição está sob os direitos autorais de seu autor. Consulte [AUTHORS](https://github.com/rfidresearchgroup/proxmark3/blob/master/AUTHORS.md).
O código-fonte do Proxmark3 está coberto pelos seguintes termos de licenciamento, geralmente referidos como **GPLv3 ou posterior**.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
Uma cópia da GPLv3 está disponível em [LICENSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/LICENSE.txt).
Algumas dependências podem estar sob outros termos de licenciamento livre compatíveis com os termos de licenciamento do Proxmark3; consulte suas respectivas descrições.