Proxmark3 client

Client en ligne de commande pour l'appareil de recherche RFID/NFC Proxmark3 : lecture, écriture, clonage, sniffing et émulation de cartes RFID/NFC basse et haute fréquence. Command-line client for the Proxmark3 RFID/NFC research device — read, write, clone, sniff, and emulate low- and high-frequency RFID/NFC cards.

↗ https://github.com/RfidResearchGroup/proxmark3

Overview

The Proxmark3 client is the software side of the Proxmark3, the reference hardware platform for RFID/NFC security research. It talks to the Proxmark3 device over USB and drives its ability to read, clone, brute-force, sniff, and emulate both low-frequency (125kHz — HID prox, EM4x, indala) and high-frequency (13.56MHz — MIFARE Classic/DESFire, iCLASS, NFC) access-control and payment cards, making it central to physical-access-control assessments.

Common Usage

Launch the interactive client (connects to device over USB/serial)

pm3
# Auto-detect a card and identify its type (LF or HF)
[usb] pm3--> lf search
[usb] pm3--> hf search

Read a low-frequency HID prox card

[usb] pm3--> lf hid read

Clone a captured HID card to a blank T5577

[usb] pm3--> lf hid clone --raw <captured_hex>

Dump a MIFARE Classic card (nested/darkside attack for key recovery)

[usb] pm3--> hf mf autopwn

Emulate a MIFARE Classic dump on the Proxmark3 itself

[usb] pm3--> hf mf sim -t 1 --data dumped.bin

Typical Physical-Access Assessment Flow

# Step 1: Identify the card type
hf search
lf search

# Step 2: For MIFARE Classic, recover keys and dump data
hf mf autopwn

# Step 3: Save the dump
hf mf esave dump.eml

# Step 4: Clone onto a blank/magic card
hf mf cload dump.eml
# or emulate directly from the Proxmark3
hf mf sim -t 1 --data dump.eml

Common Commands

lf search           identify a low-frequency card
hf search             identify a high-frequency (13.56MHz) card
lf hid read/clone      read/clone HID Prox cards
lf em410x read/clone    read/clone EM410x cards
hf mf autopwn            full auto attack chain against MIFARE Classic
hf mf dump/restore        dump/restore MIFARE Classic card contents
hf 14a info                ISO14443A tag info
hf iclass info              iCLASS tag info
hw tune                      check antenna tuning

Tips

  • Run hw tune first on a new device — poor antenna tuning is the most common cause of “no card found” issues.
  • hf mf autopwn chains multiple known MIFARE Classic key-recovery attacks (darkside, nested, hardnested) automatically — start there before attempting individual attacks.
  • Magic (“Chinese magic”) cards support direct UID/block writes for perfect cloning; a standard card can only be emulated, not rewritten to a new UID.
Help / Man page
Proxmark3 interactive client

Usage: pm3 [options]

  -p PORT       serial port to connect to (auto-detected if omitted)
  -c COMMAND    run a single command and exit
  -s SCRIPT      run a Lua/command script file
  -f              flush output immediately
  -w              wait for Proxmark to appear

Inside the client, top-level command groups:
  lf     low-frequency (125 kHz) commands
  hf     high-frequency (13.56 MHz) commands
  hw     hardware (tune, version, status)
  data   raw trace/data manipulation
  script run Lua/Python scripts
  help   list commands, or 'help <command>' for details

Vue d’ensemble

Le client Proxmark3 est le côté logiciel du Proxmark3, la plateforme matérielle de référence pour la recherche en sécurité RFID/NFC. Il communique avec l’appareil Proxmark3 via USB et pilote sa capacité à lire, cloner, brute-forcer, sniffer et émuler des cartes de contrôle d’accès et de paiement en basse fréquence (125 kHz : HID prox, EM4x, indala) comme en haute fréquence (13,56 MHz : MIFARE Classic/DESFire, iCLASS, NFC), ce qui en fait un outil central pour les évaluations de contrôle d’accès physique.

Utilisation courante

# Lancer le client interactif (se connecte à l'appareil via USB/série)
pm3

# Détecter automatiquement une carte et identifier son type (LF ou HF)
[usb] pm3--> lf search
[usb] pm3--> hf search

# Lire une carte HID prox basse fréquence
[usb] pm3--> lf hid read

# Cloner une carte HID capturée sur un T5577 vierge
[usb] pm3--> lf hid clone --raw <captured_hex>

# Dumper une carte MIFARE Classic (attaque nested/darkside pour récupérer les clés)
[usb] pm3--> hf mf autopwn

# Émuler un dump MIFARE Classic directement sur le Proxmark3
[usb] pm3--> hf mf sim -t 1 --data dumped.bin

Déroulement type d’une évaluation d’accès physique

# Étape 1 : identifier le type de carte
hf search
lf search

# Étape 2 : pour MIFARE Classic, récupérer les clés et dumper les données
hf mf autopwn

# Étape 3 : sauvegarder le dump
hf mf esave dump.eml

# Étape 4 : cloner sur une carte vierge/magique
hf mf cload dump.eml
# ou émuler directement depuis le Proxmark3
hf mf sim -t 1 --data dump.eml

Commandes courantes

lf search           identify a low-frequency card
hf search             identify a high-frequency (13.56MHz) card
lf hid read/clone      read/clone HID Prox cards
lf em410x read/clone    read/clone EM410x cards
hf mf autopwn            full auto attack chain against MIFARE Classic
hf mf dump/restore        dump/restore MIFARE Classic card contents
hf 14a info                ISO14443A tag info
hf iclass info              iCLASS tag info
hw tune                      check antenna tuning

Conseils

  • Lancez hw tune en premier sur un nouvel appareil : un mauvais réglage d’antenne est la cause la plus courante des problèmes de « carte non détectée ».
  • hf mf autopwn enchaîne automatiquement plusieurs attaques connues de récupération de clés MIFARE Classic (darkside, nested, hardnested) : commencez par là avant de tenter des attaques individuelles.
  • Les cartes magiques (« Chinese magic ») permettent l’écriture directe de l’UID/des blocs pour un clonage parfait ; une carte standard ne peut être qu’émulée, pas réécrite avec un nouvel UID.
Aide / Page de manuel
Proxmark3 interactive client

Usage: pm3 [options]

  -p PORT       serial port to connect to (auto-detected if omitted)
  -c COMMAND    run a single command and exit
  -s SCRIPT      run a Lua/command script file
  -f              flush output immediately
  -w              wait for Proxmark to appear

Inside the client, top-level command groups:
  lf     low-frequency (125 kHz) commands
  hf     high-frequency (13.56 MHz) commands
  hw     hardware (tune, version, status)
  data   raw trace/data manipulation
  script run Lua/Python scripts
  help   list commands, or 'help <command>' for details