← retour aux outils back to tools

# 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