
Hardware-Tool für RFID-Analyse, Emulation und Penetrationstests. Unterstützt 125kHz, 13.56MHz-Protokolle (MIFARE, iClass, ISO14443/15693) mit Schlüsselwiederherstellung, Sniffing und Scripting für Sicherheitsforschung.
# Iceman Fork - Proxmark
Der Proxmark ist das Schweizer Taschenmesser der RFID-Technik und ermöglicht die Interaktion mit der überwiegenden Mehrheit der RFID-Tags weltweit. Ursprünglich von Jonathan Westhues entwickelt, ist das Gerät heute das bevorzugte Werkzeug für die RFID-Analyse für Enthusiasten.
Das Iceman-Repository gilt als der Gipfel an Features und Funktionalität und ermöglicht eine große Bandbreite äußerst nützlicher und praktischer Befehle sowie Python/LUA-Skripte zur Automatisierung von Chip-Identifikation, Penetrationstests und Programmierung.
| Neueste Version | Coverity | Mitwirkende |
|:--------------:|:--------:|:------------:|
| [](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) |
# Inhaltsverzeichnis
- [Iceman Fork - Proxmark](#iceman-fork---proxmark)
- [Inhaltsverzeichnis](#table-of-contents)
- [PROXMARK3-INSTALLATION UND ÜBERSICHT](#proxmark3-installation-and-overview)
- [Hinweise / hilfreiche Dokumente](#notes--helpful-documents)
- [Wie baut man?](#how-to-build)
- [Proxmark5](#proxmark5)
- [Proxmark3 RDV4](#proxmark3-rdv4)
- [Generische Proxmark3-Plattformen](#generic-proxmark3-platforms)
- [Was hat sich geändert?](#what-has-changed)
- [Entwicklung](#development)
- [Unterstützte Betriebssysteme](#supported-operating-systems)
- [Vorkompilierte Binärdateien](#precompiled-binaries)
- [GUIs](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/Promark-GUIs.md)
- [Offizielle Kanäle](#official-channels)
- [Betreuer](#maintainers)
- [Zitation](#citation)
- [Urheberrecht und Lizenzbedingungen](#copyright-and-licensing-terms)
# PROXMARK3-INSTALLATION UND ÜBERBLICK
| Installation | Verwendung des Proxmark3 |
| :------------------: | :------------------: |
| [Linux - Einrichtung und Build](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Linux-Installation-Instructions.md) | [Kompilierungsanweisungen](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)|
| [Linux - Wichtige Hinweise zu ModemManager](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/ModemManager-Must-Be-Discarded.md) | [Validierung der Proxmark3-Client-Funktionalität](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/1_Validation.md)|
| [macOS - Homebrew & Aktualisierung der HomeBrew Tap Formula](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Homebrew-Installation-Instructions.md) | [Erste Verwendung und Verifizierung](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) | [Befehle & Funktionen](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
| [macOS - Einrichtung und Build](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Compile-From-Source-Instructions.md) |[Standalone-Modi](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/standalone)|
| [Windows - Einrichtung und Build](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Windows-Installation-Instructions.md) ||
| [Termux / Android - Einrichtung und Build](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md) ||
| [iOS - Einrichtung und Build](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/iOS-Installation-Instructions.md)
| [Blue Shark Handbuch](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/bt_manual_v10.md) | [Befehlsübersicht](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cheatsheet.md)|
| [Erweiterte Kompilierungsparameter](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md) | [Weitere Übersichten](https://github.com/RfidResearchGroup/proxmark3/wiki/More-cheat-sheets)|
| [Fehlerbehebung](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Troubleshooting.md) | [Vollständiger Client-Befehlssatz](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/commands.md) |
| [JTAG](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/jtag_notes.md) | [T5577 Einführungsleitfaden](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/T5577_Guide.md)|
## Hinweise / hilfreiche Dokumente
| Hinweise |||
| ------------------- |:-------------------:| -------------------:|
|[Hinweise zu UART](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/uart_notes.md)|[Hinweise zu Termux / Android](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md)|[Hinweise zu Pfaden](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/path_notes.md)|
|[Hinweise zum Frame-Format](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/new_frame_format.md)|[Hinweise zu Tracelog / Wireshark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/trace_notes.md)|[Hinweise zu EMV](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/emv_notes.md)|
|[Hinweise zu externem Flash](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ext_flash_notes.md)|[Hinweise zu loclass](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/loclass_notes.md)|[Hinweise zu Coverity Scan Konfiguration & Ausführung](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Coverity-Scan-Config-and-Run.md)|
|[Hinweise zu mit Proxmark3 verwendeten Dateiformaten](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/extensions_notes.md)|[Hinweise zum MFU-Binärformat](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/mfu_binary_format_notes.md)|[Hinweise zu FPGA & ARM](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/fpga_arm_notes.md)|
|[Entwicklung des Standalone-Modus](https://github.com/rfidresearchgroup/proxmark3/blob/master/armsrc/Standalone/readme.md)|[Wiki zum Standalone-Modus](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[Hinweise zu Magic-UID-Karten](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/magic_cards_notes.md)|
|[Hinweise zur Farbverwendung](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)|[Hinweise zu Cloner-Guns](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cloner_notes.md)|
|[Hinweise zur Verwendung von cliparser](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cliparser.md)|[Hinweise zu Uhren](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/clocks.md)|[Hinweise zu MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/desfire.md)|
|[Hinweise zu CIPURSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cipurse.md)|[Hinweise zu NDEF type4a](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ndef_type4a.md)|[Inoffizielle MIFARE DESFire Bibel](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/unofficial_desfire_bible.md)|[Hinweise zur iClass legrec-legbrute Schlüsselwiederherstellung](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/iclass_legrec_legbrute_key_recovery.md)|[Hinweise zu Downgrade-Angriffen](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/hid_downgrade.md)|||
# Wie baut man?
## Proxmark5
Die letzte Hardware-Generation heißt Proxmark5. Sie verfügt über
- MCU: AT32F435, ein 288 MHz Artery Cortex-M4
- Gowin FPGA
- TypeC Extended Port (CEP)
- BLE / Wifi / Akku-Addon, über einen ESp32c2
- Austauschbare Antennen (LF, HF, UHF)
- 125, 134, 250, 375, 500 KHz Niederfrequenzantenne (LF)
- 13,56 MHz Hochfrequenzantenne (HF)
- als Addon: 860-960 MHz Ultrahochfrequenzantenne (UHF), ** noch nicht entwickelt **
Derzeit sind alle Proxmark5-spezifischen Anweisungen in [einem einzigen Getting-Started-Leitfaden](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/PM5_Start_Here/Getting_Started_With_PM5.md) zusammengefasst.
Lies ihn, um dein Proxmark5-Gerät zu bauen, zu flashen und auszuführen. Siehe die Anweisungslinks in den obigen Tabellen, um die Kompilierungsumgebung einzurichten.
- ⚠ Die Firmware ist derzeit nicht stabil und wird aktiv weiterentwickelt.
## Proxmark3 RDV4
Siehe die Anweisungslinks in den obigen Tabellen, um dein Proxmark3 RDV4-Gerät zu bauen, zu flashen und auszuführen.
## Generische Proxmark3-Plattformen
Um dieses Repo für generische Proxmark3-Plattformen zu bauen, empfehlen wir dir dringend, [Erweiterte Kompilierungsparameter](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md) zu lesen.
Wir definieren generische Proxmark3-Plattformen als die folgenden Geräte.
**Unterstützt**
- RDV1, RDV2, RDV3 easy
- Ryscorp Green-PCB-Version
- Radiowar Black-PCB-Version
- zahlreiche chinesische angepasste Versionen der RDV3 easy (kkmoon, PiSwords usw.)
- Proxmark3 SE (Special Edition) (BLE-fähig)
- Proxmark3 X
- **Hinweis**: Von der Community getestet
- **Hinweis**: Geräte-Hardware unbekannt
- iCopy-X
- **Hinweis**: Kompatibel **NUR** nach Installation der [iCopy-X Open-Source-Firmware](https://github.com/lab-401/icopy-x)
- Werksfirmware ist **nicht** kompatibel (Client-Befehle sind unterschiedlich / Werks-UI ist Closed Source / Werks-Firmware erzwingt Tag-DRM)
**Nicht unterstützt**
- ⚠ Proxmark Evolution (EVO)
- **Hinweis**: Pinbelegung unbekannt.
- ⚠ Ryscorp Proxmark3 Pro
- **Hinweis**: Gerät hat ein anderes FPGA und unbekannte Pinbelegung.
- **Hinweis**: Das Unternehmen ist verschwunden und hat seine Kunden im Unklaren gelassen.
**Experimentelle Unterstützung**
- ⚠ Proxmark3 Ultimate
- **Hinweis**: Geräte-Hardware unbekannt
- **Hinweis**: FPGA-Images werden dafür gebaut. Nutzung auf eigenes Risiko.
**Unbekannter Unterstützungsstatus**
- ⚠ VX
- **Hinweis**: Geräte-Hardware unbekannt
Bei diesen neuen unbekannten Modellen sind wir auf die Community angewiesen, die meldet, ob dieses Repo funktioniert und was sie getan haben, um es zum Laufen zu bringen.
**256 KB Flash-Speichergröße bei generischen Proxmark3-Plattformen**
> ⚠ **Hinweis**:
> Du musst im Auge behalten, wie groß der integrierte Flash-Speicher deines ARM-Chips ist.
> Mit 512 KB bist du auf der sicheren Seite, aber bei 256 KB musst du dieses Repo mit noch weniger Funktionalität kompilieren.
> Wenn du `./pm3-flash-all` ausführst, kannst du sehen, welche Größe dein Gerät hat, sofern du den Bootloader aus diesem Repo installiert hast.
> Andernfalls findest du die gemeldete Größe in der Startmeldung, wenn du den Proxmark3-Client `./pm3` ausführst.
>
> [ACHTUNG! Lies den Hinweis zum 256-KB-Flash-Speicher](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md#256KB-versions)
# Was hat sich geändert?
Siehe die [Changelog-Datei](https://github.com/rfidresearchgroup/proxmark3/blob/master/CHANGELOG.md), die wir aktuell zu halten versuchen.
# Entwicklung
> ⚠ **Hinweis**: Dies ist ein Bleeding-Edge-Repository. Die Maintainer arbeiten aktiv aus diesem Repository heraus und werden den Code regelmäßig umstrukturieren, um ihn verständlicher, navigierbarer, baubar, testbar und einfacher beitragbar zu machen, also **erwarte regelmäßig erhebliche Änderungen am Code-Layout**.
> 👉 **Denk daran!** Wenn du zum Code beitragen möchtest, lies bitte zuerst die [Hinweise zum Coding-Stil](https://github.com/rfidresearchgroup/proxmark3/blob/master/CONTRIBUTING.md).
Wir führen deine Beiträge in der Regel schnell zusammen, da uns die Idee gefällt, eine Funktionalität in den Proxmark3 zu bringen und die Fehler anschließend auszumerzen.
Die [öffentliche Roadmap](https://github.com/RfidResearchGroup/proxmark3/wiki/Public-Roadmap) ist ein hervorragender Einstieg, wenn du daran interessiert bist, beizutragen.
## Unterstützte Betriebssysteme
Dieses Repo lässt sich problemlos kompilieren auf
- WSL1 unter Windows 10
- WSL2 unter Windows 10/11
- Proxspace-Umgebung [Release v3.xx](https://github.com/Gator96100/ProxSpace/releases)
- Windows/MinGW-Umgebung
- Ubuntu, ParrotOS, Gentoo, Pentoo, Kali, NetHunter, Arch Linux, Fedora, Debian, Raspbian
- Android / Termux
- macOS / Homebrew (oder MacPorts, experimentell) / Apple Silicon M1
- iOS (Jailbreak, rootful)
- Docker-Container
- [ Iceman-Repo-basierter Ubuntu-18.04-Container ](https://hub.docker.com/r/secopsconsult/proxmark3)
- [ Iceman-Fork-basierter Container v1.7 ](https://hub.docker.com/r/iceman1001/proxmark3/)
## Vorkompilierte Binärdateien
Siehe [Proxmark3 vorkompilierte Builds](https://www.proxmarkbuilds.org/)
## Offizielle Kanäle
Wo findest du die Community?
- [RFID Hacking Community Discord-Server](https://t.ly/d4_C)
- [Proxmark3 IRC-Kanal](https://web.libera.chat/?channels=#proxmark3)
- [Proxmark3 Subreddit](https://www.reddit.com/r/proxmark3/)
## Maintainer
An alle Distro- und Paket-Maintainer: Wir haben versucht, euch das Leben leichter zu machen.
`make install` ist jetzt verfügbar, und wenn du mehr wissen möchtest.
Dieses Dokument wird dir dabei helfen
- [Hinweise für Maintainer](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Maintainers.md)
## Zitation
Verwende dieses Bibtex, um dieses Repository global zu zitieren:
```
@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},
}
```
Wenn Sie sich auf einen bestimmten Stand des Repositorys beziehen müssen, verwenden Sie eine Commit-Nummer oder ein Zugriffsdatum, z. B.:
```
note = {Accessed: commit 12327f71a27da23831901847886aaf20e8ad3ca0}
note = {Accessed: 2021-01-01}
```
## Urheberrecht und Lizenzbedingungen
Jeder Beitrag unterliegt dem Urheberrecht seines Autors. Siehe [AUTHORS](https://github.com/rfidresearchgroup/proxmark3/blob/master/AUTHORS.md).
Der Quellcode von Proxmark3 unterliegt den folgenden Lizenzbedingungen, die üblicherweise als **GPLv3 oder später** bezeichnet werden.
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.
Eine Kopie der GPLv3 ist in [LICENSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/LICENSE.txt) verfügbar.
Einige Abhängigkeiten können unter anderen freien Lizenzbedingungen stehen, die mit den Lizenzbedingungen von Proxmark3 kompatibel sind; siehe deren jeweilige Beschreibung.