Herramienta hardware para análisis, emulación y pruebas de penetración RFID. Soporta protocolos de 125kHz, 13.56MHz (MIFARE, iClass, ISO14443/15693) con recuperación de claves, sniffing y scripting para investigación en seguridad.
# Iceman Fork - Proxmark
El Proxmark es la herramienta navaja suiza de RFID, que permite interactuar con la gran mayoría de etiquetas RFID a escala global. Originalmente construido por Jonathan Westhues, el dispositivo es ahora la herramienta de referencia para el análisis de RFID para el entusiasta.
El repositorio Iceman está considerado como la cúspide en características y funcionalidad, habilitando una enorme gama de comandos extremadamente útiles y convenientes y scripts en Python/LUA para automatizar la identificación de chips, las pruebas de penetración y la programación.
| Última versión | Coverity | Colaboradores |
|:--------------:|:--------:|:------------:|
| [](https://github.com/RfidResearchGroup/proxmark3/releases/latest) | [](https://scan.coverity.com/projects/proxmark3-rrg-iceman-repo)|  |
| Acciones CI de OSX | Acciones CI de Ubuntu | Acciones CI de Windows |
|:--------------:|:------------------:|:------------------:|
| [](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) |
# Tabla de contenidos
- [Iceman Fork - Proxmark](#iceman-fork---proxmark)
- [Tabla de contenidos](#table-of-contents)
- [INSTALACIÓN Y DESCRIPCIÓN GENERAL DE PROXMARK3](#proxmark3-installation-and-overview)
- [Notas / documentos útiles](#notes--helpful-documents)
- [¿Cómo compilar?](#how-to-build)
- [Proxmark5](#proxmark5)
- [Proxmark3 RDV4](#proxmark3-rdv4)
- [Plataformas genéricas de Proxmark3](#generic-proxmark3-platforms)
- [¿Qué ha cambiado?](#what-has-changed)
- [Desarrollo](#development)
- [Sistemas operativos compatibles](#supported-operating-systems)
- [Binarios precompilados](#precompiled-binaries)
- [GUIs](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/Promark-GUIs.md)
- [Canales oficiales](#official-channels)
- [Mantenedores](#maintainers)
- [Citación](#citation)
- [Términos de copyright y licencia](#copyright-and-licensing-terms)
# INSTALACIÓN Y DESCRIPCIÓN GENERAL DE PROXMARK3
| Instalación | Uso del Proxmark3 |
| :------------------: | :------------------: |
| [Linux - Configuración y compilación](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Linux-Installation-Instructions.md) | [Instrucciones de compilación](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)|
| [Linux - Notas importantes sobre ModemManager](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/ModemManager-Must-Be-Discarded.md) | [Validación de la funcionalidad del cliente Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/1_Validation.md)|
| [macOS - Homebrew y actualización de la fórmula HomeBrew Tap](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Homebrew-Installation-Instructions.md) | [Primer uso y verificación](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 y funciones](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
| [macOS - Configuración y compilación](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 - Configuración y compilación](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Windows-Installation-Instructions.md) ||
| [Termux / Android - Configuración y compilación](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md) ||
| [iOS - Configuración y compilación](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/iOS-Installation-Instructions.md)
| [Manual de Blue Shark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/bt_manual_v10.md) | [Chuleta de comandos](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cheatsheet.md)|
| [Parámetros avanzados de compilación](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md) | [Más chuletas](https://github.com/RfidResearchGroup/proxmark3/wiki/More-cheat-sheets)|
| [Solución de problemas](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Troubleshooting.md) | [Conjunto completo de comandos del cliente](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/commands.md) |
| [JTAG](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/jtag_notes.md) | [Guía de introducción a T5577](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/T5577_Guide.md)|
## Notas / documentos útiles
| 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 rutas](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/path_notes.md)|
|[Notas sobre el formato de trama](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 la 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 la configuración y ejecución de Coverity Scan](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Coverity-Scan-Config-and-Run.md)|
|[Notas sobre los formatos de archivo usados con Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/extensions_notes.md)|[Notas sobre el formato binario MFU](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/mfu_binary_format_notes.md)|[Notas sobre FPGA y ARM](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/fpga_arm_notes.md)|
|[Desarrollo del modo autónomo](https://github.com/rfidresearchgroup/proxmark3/blob/master/armsrc/Standalone/readme.md)|[Wiki sobre el modo autónomo](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[Notas sobre tarjetas Magic UID](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/magic_cards_notes.md)|
|[Notas sobre el uso de colores](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 pistolas clonadoras](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cloner_notes.md)|
|[Notas sobre el uso de cliparser](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cliparser.md)|[Notas sobre relojes](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)|[Biblia no oficial de MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/unofficial_desfire_bible.md)|[Notas sobre la recuperación de claves 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)|||
# ¿Cómo compilar?
## Proxmark5
La última generación de hardware se llama Proxmark5. Tiene
- MCU: AT32F435, un Artery Cortex-M4 de 288 MHz
- FPGA Gowin
- TypeC Extended Port (CEP)
- Addon BLE / Wifi / Batería, mediante un ESp32c2
- Antenas intercambiables (LF, HF, UHF)
- Antena de baja frecuencia (LF) de 125, 134, 250, 375, 500 KHz
- Antena de alta frecuencia (HF) de 13.56 MHz
- como addon: antena de ultra alta frecuencia (UHF) de 860-960 MHz, ** aún no desarrollada **
En este momento, todas las instrucciones específicas para el Proxmark5 están agrupadas en [una única guía de inicio](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/PM5_Start_Here/Getting_Started_With_PM5.md).
Léela para compilar, flashear y ejecutar tu dispositivo Proxmark5. Consulta los enlaces de instrucciones en las tablas anteriores para preparar el entorno de compilación.
- ⚠ El firmware no es estable en este momento y se encuentra en desarrollo activo.
## Proxmark3 RDV4
Consulta los enlaces de instrucciones en las tablas anteriores para compilar, flashear y ejecutar tu dispositivo Proxmark3 RDV4.
## Plataformas genéricas Proxmark3
Para compilar este repositorio para plataformas genéricas Proxmark3 te instamos a leer [Parámetros de compilación avanzados](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md)
Definimos plataformas genéricas Proxmark3 como los siguientes dispositivos.
**Compatibles**
- RDV1, RDV2, RDV3 easy
- Versión Ryscorp con PCB verde
- Versión Radiowar con PCB negra
- numerosas versiones chinas adaptadas de la RDV3 easy (kkmoon, PiSwords, etc.)
- Proxmark3 SE (Special Edition) (con BLE habilitado)
- Proxmark3 X
- **Nota**: Probado por la comunidad
- **Nota**: hardware del dispositivo desconocido
- iCopy-X
- **Nota**: Compatible **SOLO** tras la instalación del [firmware de código abierto iCopy-X](https://github.com/lab-401/icopy-x)
- El firmware de fábrica **no** es compatible (los comandos del cliente son diferentes / la interfaz de fábrica es de código cerrado / el firmware de fábrica impone DRM en las etiquetas)
**No compatibles**
- ⚠ Proxmark Evolution (EVO)
- **Nota**: asignación de pines desconocida.
- ⚠ Ryscorp Proxmark3 Pro
- **Nota**: el dispositivo tiene una FPGA diferente y asignación de pines desconocida.
- **Nota**: La empresa ha desaparecido, dejando a sus clientes en la incertidumbre.
**Soporte experimental**
- ⚠ Proxmark3 Ultimate
- **Nota**: hardware del dispositivo desconocido
- **Nota**: Se están compilando imágenes de FPGA para él. Úsalo bajo tu propio riesgo.
**Estado de soporte desconocido**
- ⚠ VX
- **Nota**: hardware del dispositivo desconocido
Cuando se trata de estos nuevos modelos desconocidos, dependemos de la comunidad para que informe si este repositorio funciona y qué hicieron para que funcionara.
**Tamaño de memoria flash de 256KB de las plataformas genéricas Proxmark3**
> ⚠ **Nota**:
> Debes vigilar el tamaño de la memoria flash integrada de tu chip ARM.
> Con 512KB estás bien, pero si es de 256KB necesitas compilar este repositorio con aún menos funcionalidad.
> Al ejecutar `./pm3-flash-all` puedes ver qué tamaño tiene tu dispositivo si tienes instalado el bootloader de este repositorio.
> De lo contrario, encontrarás el tamaño indicado en el mensaje de inicio al ejecutar el cliente Proxmark3 `./pm3`.
>
> [¡OBS! Lee el aviso sobre la memoria flash de 256KB](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md#256KB-versions)
# ¿Qué ha cambiado?
Consulta el [archivo Changelog](https://github.com/rfidresearchgroup/proxmark3/blob/master/CHANGELOG.md) que intentamos mantener actualizado.
# Desarrollo
> ⚠ **Nota**: Este es un repositorio de vanguardia. Los mantenedores trabajan activamente en este repositorio y reestructurarán periódicamente el código para facilitar su comprensión, navegación, compilación, prueba y contribución, así que **ESPERA cambios significativos en la disposición del código de forma regular**.
> 👉 **¡Recuerda!** Si tienes la intención de contribuir al código, lee primero las [notas de estilo de código](https://github.com/rfidresearchgroup/proxmark3/blob/master/CONTRIBUTING.md).
Normalmente fusionamos tus contribuciones rápidamente, ya que nos gusta la idea de incorporar una funcionalidad al Proxmark3 y eliminar los errores después.
La [hoja de ruta pública](https://github.com/RfidResearchGroup/proxmark3/wiki/Public-Roadmap) es un excelente punto de partida para leer si te interesa contribuir.
## Sistemas operativos compatibles
Este repositorio compila correctamente en
- WSL1 en Windows 10
- WSL2 en Windows 10/11
- Entorno Proxspace [release v3.xx](https://github.com/Gator96100/ProxSpace/releases)
- Entorno Windows/MinGW
- Ubuntu, ParrotOS, Gentoo, Pentoo, Kali, NetHunter, Arch Linux, Fedora, Debian, Raspbian
- Android / Termux
- macOS / Homebrew (o MacPorts, experimental) / Apple Silicon M1
- iOS (Jailbroken, rootful)
- Contenedor Docker
- [ Contenedor ubuntu 18.04 basado en el repositorio de Iceman ](https://hub.docker.com/r/secopsconsult/proxmark3)
- [ Contenedor v1.7 basado en el fork de Iceman ](https://hub.docker.com/r/iceman1001/proxmark3/)
## Binarios precompilados
Consulte [Proxmark3 precompiled builds](https://www.proxmarkbuilds.org/)
## Canales oficiales
¿Dónde encuentras a la comunidad?
- [Servidor de discord de la comunidad RFID Hacking](https://t.ly/d4_C)
- [Canal IRC de Proxmark3](https://web.libera.chat/?channels=#proxmark3)
- [Subreddit de Proxmark3](https://www.reddit.com/r/proxmark3/)
## Mantenedores
A todos los mantenedores de distros y paquetes, hemos intentado facilitaros la vida.
`make install` ya está disponible y si quieres saber más.
Este documento te será de ayuda
- [Notas para mantenedores](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Maintainers.md)
## Citación
Utiliza este bibtex para citar este repositorio de forma global:
```
@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},
}
```
Si necesitas hacer referencia a un estado específico del repositorio, utiliza un número de commit o una fecha de acceso, por ejemplo:
```
note = {Accessed: commit 12327f71a27da23831901847886aaf20e8ad3ca0}
note = {Accessed: 2021-01-01}
```
## Términos de derechos de autor y licencia
Cada contribución está bajo los derechos de autor de su autor. Consulte [AUTHORS](https://github.com/rfidresearchgroup/proxmark3/blob/master/AUTHORS.md).
El código fuente de Proxmark3 está cubierto por los siguientes términos de licencia, generalmente denominados **GPLv3 o 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.
Una copia de la GPLv3 está disponible en [LICENSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/LICENSE.txt).
Algunas dependencias pueden estar bajo otros términos de licencia libres compatibles con los términos de licencia de Proxmark3; consulte su descripción respectiva.