Outil matériel pour l'analyse, l'émulation et les tests de pénétration RFID. Prend en charge les protocoles 125kHz et 13.56MHz (MIFARE, iClass, ISO14443/15693) avec récupération de clés, sniffing et scripting pour la recherche en sécurité.
# Iceman Fork - Proxmark
Le Proxmark est l'outil couteau suisse du RFID, permettant d'interagir avec la grande majorité des tags RFID à l'échelle mondiale. Conçu à l'origine par Jonathan Westhues, l'appareil est aujourd'hui l'outil de référence pour l'analyse RFID des passionnés.
Le dépôt Iceman est considéré comme le summum en matière de fonctionnalités et de capacités, offrant une vaste gamme de commandes extrêmement utiles et pratiques ainsi que des scripts Python/LUA pour automatiser l'identification de puces, les tests d'intrusion et la programmation.
| Dernière version | Coverity | Contributeurs |
|:--------------:|:--------:|:------------:|
| [](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) |
# Table des matières
- [Iceman Fork - Proxmark](#iceman-fork---proxmark)
- [Table des matières](#table-des-matières)
- [INSTALLATION ET APERÇU DE PROXMARK3](#installation-et-aperçu-de-proxmark3)
- [Notes / documents utiles](#notes--documents-utiles)
- [Comment compiler ?](#comment-compiler-)
- [Proxmark5](#proxmark5)
- [Proxmark3 RDV4](#proxmark3-rdv4)
- [Plateformes Proxmark3 génériques](#plateformes-proxmark3-génériques)
- [Qu'est-ce qui a changé ?](#quest-ce-qui-a-changé-)
- [Développement](#développement)
- [Systèmes d'exploitation pris en charge](#systèmes-dexploitation-pris-en-charge)
- [Binaires précompilés](#binaires-précompilés)
- [GUIs](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/Promark-GUIs.md)
- [Canaux officiels](#canaux-officiels)
- [Mainteneurs](#mainteneurs)
- [Citation](#citation)
- [Conditions de copyright et de licence](#conditions-de-copyright-et-de-licence)
# INSTALLATION ET APERÇU DE PROXMARK3
| Installation | Utilisation du Proxmark3 |
| :------------------: | :------------------: |
| [Linux - Installation et compilation](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Linux-Installation-Instructions.md) | [Instructions de compilation](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)|
| [Linux - Notes importantes sur ModemManager](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/ModemManager-Must-Be-Discarded.md) | [Validation du fonctionnement du client Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/1_Validation.md)|
| [macOS - Homebrew et mise à niveau de la formule HomeBrew Tap](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Homebrew-Installation-Instructions.md) | [Première utilisation et vérification](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) | [Commandes et fonctionnalités](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
| [macOS - Installation et compilation](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Compile-From-Source-Instructions.md) |[Modes autonomes](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/standalone)|
| [Windows - Installation et compilation](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Windows-Installation-Instructions.md) ||
| [Termux / Android - Installation et compilation](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md) ||
| [iOS - Installation et compilation](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/iOS-Installation-Instructions.md)
| [Manuel Blue Shark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/bt_manual_v10.md) | [Aide-mémoire des commandes](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cheatsheet.md)|
| [Paramètres de compilation avancés](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md) | [Plus d'aide-mémoires](https://github.com/RfidResearchGroup/proxmark3/wiki/More-cheat-sheets)|
| [Dépannage](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Troubleshooting.md) | [Ensemble complet des commandes du client](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/commands.md) |
| [JTAG](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/jtag_notes.md) | [Guide d'introduction au T5577](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/T5577_Guide.md)|
## Notes / documents utiles
| Notes |||
| ------------------- |:-------------------:| -------------------:|
|[Notes sur l'UART](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/uart_notes.md)|[Notes sur Termux / Android](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md)|[Notes sur les chemins](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/path_notes.md)|
|[Notes sur le format de trame](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/new_frame_format.md)|[Notes sur tracelog / wireshark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/trace_notes.md)|[Notes sur EMV](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/emv_notes.md)|
|[Notes sur la flash externe](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ext_flash_notes.md)|[Notes sur loclass](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/loclass_notes.md)|[Notes sur la configuration et l'exécution de Coverity Scan](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Coverity-Scan-Config-and-Run.md)|
|[Notes sur les formats de fichiers utilisés avec Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/extensions_notes.md)|[Notes sur le format binaire MFU](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/mfu_binary_format_notes.md)|[Notes sur FPGA et ARM](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/fpga_arm_notes.md)|
|[Développement du mode autonome](https://github.com/rfidresearchgroup/proxmark3/blob/master/armsrc/Standalone/readme.md)|[Wiki sur le mode autonome](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[Notes sur les cartes Magic UID](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/magic_cards_notes.md)|
|[Notes sur l'utilisation des couleurs](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)|[Notes sur les Cloner guns](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cloner_notes.md)|
|[Notes sur l'utilisation de cliparser](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cliparser.md)|[Notes sur les horloges](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/clocks.md)|[Notes sur MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/desfire.md)|
|[Notes sur CIPURSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cipurse.md)|[Notes sur NDEF type4a](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ndef_type4a.md)|[Bible non officielle de MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/unofficial_desfire_bible.md)|[Notes sur la récupération de clés iClass legrec-legbrute](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/iclass_legrec_legbrute_key_recovery.md)|[Notes sur les attaques par rétrogradation](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/hid_downgrade.md)|||
# Comment compiler ?
## Proxmark5
La dernière génération de matériel s'appelle Proxmark5. Elle dispose de
- MCU : AT32F435, un Artery Cortex-M4 à 288 MHz
- FPGA Gowin
- Port étendu TypeC (CEP)
- Module complémentaire BLE / Wifi / Batterie, via un ESP32c2
- Antennes interchangeables (LF, HF, UHF)
- Antenne basse fréquence (LF) 125, 134, 250, 375, 500 KHz
- Antenne haute fréquence (HF) 13,56 MHz
- en tant que module complémentaire : antenne ultra haute fréquence (UHF) 860-960 MHz, ** pas encore développée **
Pour le moment, les instructions spécifiques au Proxmark5 sont toutes regroupées dans [un seul guide de démarrage](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/PM5_Start_Here/Getting_Started_With_PM5.md).
Lisez-le pour compiler, flasher et exécuter votre appareil Proxmark5. Consultez les liens d'instructions dans les tableaux ci-dessus pour configurer l'environnement de compilation.
- ⚠ Le firmware n'est pas stable pour le moment et est en cours de développement actif.
## Proxmark3 RDV4
Consultez les liens d'instructions dans les tableaux ci-dessus pour compiler, flasher et exécuter votre appareil Proxmark3 RDV4.
## Plateformes Proxmark3 génériques
Afin de compiler ce dépôt pour les plateformes Proxmark3 génériques, nous vous invitons vivement à lire [Paramètres de compilation avancés](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md)
Nous définissons les plateformes Proxmark3 génériques comme les appareils suivants.
**Pris en charge**
- RDV1, RDV2, RDV3 easy
- Version PCB verte de Ryscorp
- Version PCB noire de Radiowar
- de nombreuses versions chinoises adaptées du RDV3 easy (kkmoon, PiSwords, etc.)
- Proxmark3 SE (Special Edition) (compatible BLE)
- Proxmark3 X
- **Note** : testé par la communauté
- **Note** : matériel de l'appareil inconnu
- iCopy-X
- **Note** : compatible **UNIQUEMENT** après installation du [firmware open source iCopy-X](https://github.com/lab-401/icopy-x)
- Le firmware d'usine n'est **pas** compatible (les commandes client sont différentes / l'interface d'usine est à code source fermé / le firmware d'usine impose un DRM sur les tags)
**Non pris en charge**
- ⚠ Proxmark Evolution (EVO)
- **Note** : affectations de broches inconnues.
- ⚠ Ryscorp Proxmark3 Pro
- **Note** : l'appareil possède un FPGA différent et des affectations de broches inconnues.
- **Note** : l'entreprise a disparu, laissant ses clients dans l'ignorance.
**Prise en charge expérimentale**
- ⚠ Proxmark3 Ultimate
- **Note** : matériel de l'appareil inconnu
- **Note** : des images FPGA sont compilées pour cet appareil. À utiliser à vos propres risques.
**Statut de prise en charge inconnu**
- ⚠ VX
- **Note** : matériel de l'appareil inconnu
En ce qui concerne ces nouveaux modèles inconnus, nous comptons sur la communauté pour signaler si ce dépôt fonctionne et ce qu'ils ont fait pour le faire fonctionner.
**Taille de mémoire flash de 256 Ko des plateformes Proxmark3 génériques**
> ⚠ **Note** :
> Vous devez surveiller la taille de la mémoire flash intégrée de votre puce ARM.
> Avec 512 Ko, tout va bien, mais si elle fait 256 Ko, vous devez compiler ce dépôt avec encore moins de fonctionnalités.
> Lors de l'exécution de `./pm3-flash-all`, vous pouvez voir la taille de votre appareil si vous avez le bootloader de ce dépôt installé.
> Sinon, vous trouverez la taille indiquée dans le message de démarrage lors de l'exécution du client Proxmark3 `./pm3`.
>
> [OBS ! Lisez l'avertissement sur la mémoire flash de 256 Ko](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md#256KB-versions)
# Qu'est-ce qui a changé ?
Consultez le [fichier Changelog](https://github.com/rfidresearchgroup/proxmark3/blob/master/CHANGELOG.md) que nous nous efforçons de maintenir à jour.
# Développement
> ⚠ **Note** : Il s'agit d'un dépôt de pointe. Les mainteneurs travaillent activement à partir de ce dépôt et restructureront périodiquement le code pour le rendre plus facile à comprendre, à parcourir, à compiler, à tester et à enrichir, donc **ATTENDEZ-VOUS à des changements significatifs de l'organisation du code de façon régulière**.
> 👉 **Rappel !** Si vous souhaitez contribuer au code, veuillez d'abord lire les [notes sur le style de codage](https://github.com/rfidresearchgroup/proxmark3/blob/master/CONTRIBUTING.md).
Nous fusionnons généralement vos contributions rapidement, car nous aimons l'idée d'intégrer une fonctionnalité dans le Proxmark3 et d'éliminer les bugs ensuite.
La [feuille de route publique](https://github.com/RfidResearchGroup/proxmark3/wiki/Public-Roadmap) est un excellent point de départ à lire si vous souhaitez contribuer.
## Systèmes d'exploitation pris en charge
Ce dépôt se compile correctement sur
- WSL1 sous Windows 10
- WSL2 sous Windows 10/11
- environnement Proxspace [version v3.xx](https://github.com/Gator96100/ProxSpace/releases)
- environnement Windows/MinGW
- Ubuntu, ParrotOS, Gentoo, Pentoo, Kali, NetHunter, Arch Linux, Fedora, Debian, Raspbian
- Android / Termux
- macOS / Homebrew (ou MacPorts, expérimental) / Apple Silicon M1
- iOS (jailbreaké, rootful)
- conteneur Docker
- [ conteneur ubuntu 18.04 basé sur le dépôt Iceman ](https://hub.docker.com/r/secopsconsult/proxmark3)
- [ conteneur v1.7 basé sur le fork Iceman ](https://hub.docker.com/r/iceman1001/proxmark3/)
## Binaires précompilés
Voir [les builds précompilés de Proxmark3](https://www.proxmarkbuilds.org/)
## Canaux officiels
Où trouver la communauté ?
- [Serveur Discord de la communauté RFID Hacking](https://t.ly/d4_C)
- [Canal IRC Proxmark3](https://web.libera.chat/?channels=#proxmark3)
- [Sous-reddit Proxmark3](https://www.reddit.com/r/proxmark3/)
## Mainteneurs
À tous les mainteneurs de distributions et de paquets, nous avons essayé de vous faciliter la vie.
`make install` est désormais disponible et si vous voulez en savoir plus.
Ce document vous sera utile
- [Notes pour les mainteneurs](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Maintainers.md)
## Citation
Utilisez ce bibtex pour citer ce dépôt de manière globale :
```
@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 vous devez faire référence à un état spécifique du dépôt, utilisez un numéro de commit ou une date de consultation, par exemple :
```
note = {Accessed: commit 12327f71a27da23831901847886aaf20e8ad3ca0}
note = {Accessed: 2021-01-01}
```
## Conditions de copyright et de licence
Chaque contribution est sous le copyright de son auteur. Voir [AUTHORS](https://github.com/rfidresearchgroup/proxmark3/blob/master/AUTHORS.md).
Le code source de Proxmark3 est couvert par les conditions de licence suivantes, généralement désignées sous le nom de **GPLv3 ou ultérieure**.
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.
Une copie de la GPLv3 est disponible dans [LICENSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/LICENSE.txt).
Certaines dépendances peuvent être soumises à d'autres conditions de licence libre compatibles avec les conditions de licence de Proxmark3 ; voir leur description respective.