Strumento hardware per l'analisi RFID, l'emulazione e i test di penetrazione. Supporta i protocolli a 125kHz e 13.56MHz (MIFARE, iClass, ISO14443/15693) con recupero delle chiavi, sniffing e scripting per la ricerca sulla sicurezza.
# Iceman Fork - Proxmark
Il Proxmark è il coltellino svizzero dell'RFID, che consente di interagire con la stragrande maggioranza dei tag RFID su scala globale. Originariamente costruito da Jonathan Westhues, il dispositivo è ora lo strumento di riferimento per l'analisi RFID per gli appassionati.
Il repository Iceman è considerato il vertice in termini di funzionalità e caratteristiche, offrendo un'enorme gamma di comandi estremamente utili e comodi e script Python/LUA per automatizzare l'identificazione dei chip, il penetration testing e la programmazione.
| Ultima release | Coverity | Contributori |
|:--------------:|:--------:|:------------:|
| [](https://github.com/RfidResearchGroup/proxmark3/releases/latest) | [](https://scan.coverity.com/projects/proxmark3-rrg-iceman-repo)|  |
| Azioni CI OSX | Azioni CI Ubuntu | Azioni CI 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) |
# Indice
- [Iceman Fork - Proxmark](#iceman-fork---proxmark)
- [Indice](#indice)
- [INSTALLAZIONE E PANORAMICA DI PROXMARK3](#installazione-e-panoramica-di-proxmark3)
- [Note / documenti utili](#note--documenti-utili)
- [Come compilare?](#come-compilare)
- [Proxmark5](#proxmark5)
- [Proxmark3 RDV4](#proxmark3-rdv4)
- [Piattaforme Proxmark3 generiche](#piattaforme-proxmark3-generiche)
- [Cosa è cambiato?](#cosa-e-cambiato)
- [Sviluppo](#sviluppo)
- [Sistemi operativi supportati](#sistemi-operativi-supportati)
- [Binari precompilati](#binari-precompilati)
- [GUI](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/Promark-GUIs.md)
- [Canali ufficiali](#canali-ufficiali)
- [Manutentori](#manutentori)
- [Citazione](#citazione)
- [Termini di copyright e licenza](#termini-di-copyright-e-licenza)
# INSTALLAZIONE E PANORAMICA DI PROXMARK3
| Installazione | Uso del Proxmark3 |
| :------------------: | :------------------: |
| [Linux - Configurazione e compilazione](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Linux-Installation-Instructions.md) | [Istruzioni di compilazione](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)|
| [Linux - Note importanti su ModemManager](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/ModemManager-Must-Be-Discarded.md) | [Verifica della funzionalità del client Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/1_Validation.md)|
| [macOS - Homebrew e aggiornamento della formula HomeBrew Tap](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Homebrew-Installation-Instructions.md) | [Primo utilizzo e verifica](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) | [Comandi e funzionalità](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
| [macOS - Configurazione e compilazione](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Compile-From-Source-Instructions.md) |[Modalità standalone](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/standalone)|
| [Windows - Configurazione e compilazione](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Windows-Installation-Instructions.md) ||
| [Termux / Android - Configurazione e compilazione](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md) ||
| [iOS - Configurazione e compilazione](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/iOS-Installation-Instructions.md)
| [Manuale Blue Shark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/bt_manual_v10.md) | [Riferimento rapido dei comandi](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cheatsheet.md)|
| [Parametri di compilazione avanzati](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md) | [Altri riferimenti rapidi](https://github.com/RfidResearchGroup/proxmark3/wiki/More-cheat-sheets)|
| [Risoluzione dei problemi](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Troubleshooting.md) | [Set completo dei comandi del client](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/commands.md) |
| [JTAG](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/jtag_notes.md) | [Guida introduttiva al T5577](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/T5577_Guide.md)|
## Note / documenti utili
| Note |||
| ------------------- |:-------------------:| -------------------:|
|[Note su UART](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/uart_notes.md)|[Note su Termux / Android](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md)|[Note sui percorsi](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/path_notes.md)|
|[Note sul formato dei frame](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/new_frame_format.md)|[Note su tracelog / wireshark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/trace_notes.md)|[Note su EMV](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/emv_notes.md)|
|[Note sulla flash esterna](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ext_flash_notes.md)|[Note su loclass](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/loclass_notes.md)|[Note su configurazione ed esecuzione di Coverity Scan](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Coverity-Scan-Config-and-Run.md)|
|[Note sui formati di file usati con Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/extensions_notes.md)|[Note sul formato binario MFU](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/mfu_binary_format_notes.md)|[Note su FPGA e ARM](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/fpga_arm_notes.md)|
|[Sviluppo della modalità standalone](https://github.com/rfidresearchgroup/proxmark3/blob/master/armsrc/Standalone/readme.md)|[Wiki sulla modalità standalone](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[Note sulle carte Magic UID](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/magic_cards_notes.md)|
|[Note sull'uso dei colori](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)|[Note sulle cloner gun](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cloner_notes.md)|
|[Note sull'uso di cliparser](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cliparser.md)|[Note sui clock](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/clocks.md)|[Note su MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/desfire.md)|
|[Note su CIPURSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cipurse.md)|[Note su NDEF type4a](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ndef_type4a.md)|[Bibbia non ufficiale di MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/unofficial_desfire_bible.md)|[Note sul recupero delle chiavi iClass legrec-legbrute](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/iclass_legrec_legbrute_key_recovery.md)|[Note sugli attacchi di downgrade](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/hid_downgrade.md)|||
# Come compilare?
## Proxmark5
L'ultima generazione hardware si chiama Proxmark5. Dispone di
- MCU: AT32F435, un Artery Cortex-M4 a 288 MHz
- FPGA Gowin
- TypeC Extended Port (CEP)
- Addon BLE / Wifi / Batteria, tramite un ESP32c2
- Antenne intercambiabili (LF, HF, UHF)
- Antenna a bassa frequenza (LF) da 125, 134, 250, 375, 500 KHz
- Antenna ad alta frequenza (HF) da 13.56 MHz
- come addon: antenna a frequenza ultra alta (UHF) da 860-960 MHz, ** non ancora sviluppata **
Al momento, le istruzioni specifiche per Proxmark5 sono tutte raggruppate in [una singola guida introduttiva](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/PM5_Start_Here/Getting_Started_With_PM5.md).
Leggila per compilare, flashare ed eseguire il tuo dispositivo Proxmark5. Consulta i link alle istruzioni nelle tabelle sopra per configurare l'ambiente di compilazione.
- ⚠ Il firmware al momento non è stabile ed è in fase di sviluppo attivo presso.
## Proxmark3 RDV4
Consulta i link alle istruzioni nelle tabelle sopra per compilare, flashare ed eseguire il tuo dispositivo Proxmark3 RDV4.
## Piattaforme Proxmark3 generiche
Per compilare questo repo per le piattaforme Proxmark3 generiche ti invitiamo a leggere [Parametri di compilazione avanzati](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md)
Definiamo piattaforme Proxmark3 generiche i seguenti dispositivi.
**Supportati**
- RDV1, RDV2, RDV3 easy
- Versione Ryscorp con PCB verde
- Versione Radiowar con PCB nero
- numerose versioni cinesi adattate della RDV3 easy (kkmoon, PiSwords ecc.)
- Proxmark3 SE (Special Edition) (con BLE abilitato)
- Proxmark3 X
- **Nota**: testato dalla community
- **Nota**: hardware del dispositivo sconosciuto
- iCopy-X
- **Nota**: compatibile **SOLO** dopo l'installazione del [firmware open source iCopy-X](https://github.com/lab-401/icopy-x)
- Il firmware di fabbrica **non** è compatibile (i comandi client sono diversi / l'interfaccia di fabbrica è closed source / il firmware di fabbrica impone il DRM sui tag)
**Non supportati**
- ⚠ Proxmark Evolution (EVO)
- **Nota**: assegnazione dei pin sconosciuta.
- ⚠ Ryscorp Proxmark3 Pro
- **Nota**: il dispositivo ha un FPGA diverso e un'assegnazione dei pin sconosciuta.
- **Nota**: l'azienda è scomparsa, lasciando i propri clienti all'oscuro.
**Supporto sperimentale**
- ⚠ Proxmark3 Ultimate
- **Nota**: hardware del dispositivo sconosciuto
- **Nota**: le immagini FPGA vengono compilate per esso. Usalo a tuo rischio.
**Stato di supporto sconosciuto**
- ⚠ VX
- **Nota**: hardware del dispositivo sconosciuto
Per quanto riguarda questi nuovi modelli sconosciuti, dipendiamo dalla community per sapere se questo repo funziona e cosa hanno fatto per farlo funzionare.
**Dimensione della memoria flash da 256KB delle piattaforme Proxmark3 generiche**
> ⚠ **Nota**:
> Devi tenere d'occhio quanto è grande la memoria flash integrata del tuo chip ARM.
> Con 512KB sei a posto, ma se è da 256KB devi compilare questo repo con ancora meno funzionalità.
> Eseguendo `./pm3-flash-all` puoi vedere quale dimensione ha il tuo dispositivo se hai installato il bootloader di questo repo.
> Altrimenti troverai la dimensione riportata nel messaggio iniziale all'avvio del client Proxmark3 `./pm3`.
>
> [OBS! Leggi l'avviso sulla memoria flash da 256KB](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md#256KB-versions)
# Cosa è cambiato?
Consulta il [file Changelog](https://github.com/rfidresearchgroup/proxmark3/blob/master/CHANGELOG.md) che cerchiamo di mantenere aggiornato.
# Sviluppo
> ⚠ **Nota**: Questo è un repository bleeding edge. I maintainer lavorano attivamente su questo repository e ristruttureranno periodicamente il codice per renderlo più facile da comprendere, navigare, compilare, testare e a cui contribuire, quindi **ASPETTATI cambiamenti significativi alla struttura del codice su base regolare**.
> 👉 **Ricorda!** Se intendi contribuire al codice, leggi prima le [note sullo stile di codifica](https://github.com/rfidresearchgroup/proxmark3/blob/master/CONTRIBUTING.md).
Di solito uniamo rapidamente i tuoi contributi, poiché ci piace l'idea di aggiungere una funzionalità al Proxmark3 e ripulire i bug in seguito.
La [roadmap pubblica](https://github.com/RfidResearchGroup/proxmark3/wiki/Public-Roadmap) è un ottimo punto di partenza da leggere se sei interessato a contribuire.
## Sistemi operativi supportati
Questo repo si compila correttamente su
- WSL1 su Windows 10
- WSL2 su 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 (o MacPorts, sperimentale) / Apple Silicon M1
- iOS (Jailbroken, rootful)
- container Docker
- [ container ubuntu 18.04 basato sul repo Iceman ](https://hub.docker.com/r/secopsconsult/proxmark3)
- [ container v1.7 basato sul fork Iceman ](https://hub.docker.com/r/iceman1001/proxmark3/)
## Binari precompilati
Vedi [build precompilate di Proxmark3](https://www.proxmarkbuilds.org/)
## Canali ufficiali
Dove trovi la community?
- [server discord della community RFID Hacking](https://t.ly/d4_C)
- [canale IRC di Proxmark3](https://web.libera.chat/?channels=#proxmark3)
- [sub reddit di Proxmark3](https://www.reddit.com/r/proxmark3/)
## Maintainer
A tutti i maintainer delle distro e dei pacchetti, abbiamo cercato di rendervi la vita più facile.
`make install` è ora disponibile e se vuoi saperne di più.
Questo documento ti sarà utile
- [Note per i maintainer](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Maintainers.md)
## Citazione
Usa questo bibtex per citare globalmente questo repository:
```
@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 devi fare riferimento a uno stato specifico del repository, usa un numero di commit o una data di accesso, ad es.:
```
note = {Accessed: commit 12327f71a27da23831901847886aaf20e8ad3ca0}
note = {Accessed: 2021-01-01}
```
## Termini di copyright e licenza
Ogni contributo è sotto il copyright del suo autore. Vedi [AUTHORS](https://github.com/rfidresearchgroup/proxmark3/blob/master/AUTHORS.md).
Il codice sorgente di Proxmark3 è coperto dai seguenti termini di licenza, solitamente indicati come **GPLv3 o successiva**.
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 della GPLv3 è disponibile in [LICENSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/LICENSE.txt).
Alcune dipendenze possono essere soggette ad altri termini di licenza libera compatibili con i termini di licenza di Proxmark3; consulta le rispettive descrizioni.