Аппаратный инструмент для анализа RFID, эмуляции и тестирования на проникновение. Поддерживает протоколы 125kHz и 13.56MHz (MIFARE, iClass, ISO14443/15693) с восстановлением ключей, сниффингом и скриптингом для исследований в области безопасности.
# Iceman Fork - Proxmark
Proxmark — это швейцарский армейский нож в мире RFID, позволяющий взаимодействовать с подавляющим большинством RFID-меток по всему миру. Изначально устройство было создано Джонатаном Вестхьюзом, а теперь это основной инструмент для анализа RFID для энтузиастов.
Репозиторий Iceman считается вершиной по набору возможностей и функциональности: он предоставляет огромный спектр чрезвычайно полезных и удобных команд, а также скриптов на Python/LUA для автоматизации идентификации чипов, тестирования на проникновение и программирования.
| Последний релиз | Coverity | Участники |
|:--------------:|:--------:|:------------:|
| [](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) |
# Содержание
- [Iceman Fork - Proxmark](#iceman-fork---proxmark)
- [Содержание](#table-of-contents)
- [УСТАНОВКА И ОБЗОР PROXMARK3](#proxmark3-installation-and-overview)
- [Примечания / полезные документы](#notes--helpful-documents)
- [Как собрать?](#how-to-build)
- [Proxmark5](#proxmark5)
- [Proxmark3 RDV4](#proxmark3-rdv4)
- [Универсальные платформы Proxmark3](#generic-proxmark3-platforms)
- [Что изменилось?](#what-has-changed)
- [Разработка](#development)
- [Поддерживаемые операционные системы](#supported-operating-systems)
- [Предкомпилированные бинарные файлы](#precompiled-binaries)
- [GUI](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/Promark-GUIs.md)
- [Официальные каналы](#official-channels)
- [Сопровождающие](#maintainers)
- [Цитирование](#citation)
- [Условия авторского права и лицензирования](#copyright-and-licensing-terms)
# УСТАНОВКА И ОБЗОР PROXMARK3
| Установка | Использование Proxmark3 |
| :------------------: | :------------------: |
| [Linux — настройка и сборка](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Linux-Installation-Instructions.md) | [Инструкции по компиляции](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)|
| [Linux — важные замечания о ModemManager](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/ModemManager-Must-Be-Discarded.md) | [Проверка работоспособности клиента Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/1_Validation.md)|
| [macOS — Homebrew и обновление формулы HomeBrew Tap](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Homebrew-Installation-Instructions.md) | [Первое использование и проверка](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) | [Команды и возможности](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
| [macOS — настройка и сборка](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/macOS-Compile-From-Source-Instructions.md) |[Автономные режимы](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/standalone)|
| [Windows — настройка и сборка](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Windows-Installation-Instructions.md) ||
| [Termux / Android — настройка и сборка](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md) ||
| [iOS — настройка и сборка](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/iOS-Installation-Instructions.md)
| [Руководство по Blue Shark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/bt_manual_v10.md) | [Шпаргалка по командам](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cheatsheet.md)|
| [Расширенные параметры компиляции](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md) | [Другие шпаргалки](https://github.com/RfidResearchGroup/proxmark3/wiki/More-cheat-sheets)|
| [Устранение неполадок](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Installation_Instructions/Troubleshooting.md) | [Полный набор команд клиента](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/commands.md) |
| [JTAG](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/jtag_notes.md) | [Вводное руководство по T5577](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/T5577_Guide.md)|
## Заметки / полезные документы
| Заметки |||
| ------------------- |:-------------------:| -------------------:|
|[Заметки о UART](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/uart_notes.md)|[Заметки о Termux / Android](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/termux_notes.md)|[Заметки о путях](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/path_notes.md)|
|[Заметки о формате кадров](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/new_frame_format.md)|[Заметки о tracelog / wireshark](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/trace_notes.md)|[Заметки об EMV](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/emv_notes.md)|
|[Заметки о внешней флеш-памяти](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ext_flash_notes.md)|[Заметки о loclass](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/loclass_notes.md)|[Заметки о конфигурации и запуске Coverity Scan](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Coverity-Scan-Config-and-Run.md)|
|[Заметки о форматах файлов, используемых с Proxmark3](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/extensions_notes.md)|[Заметки о бинарном формате MFU](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/mfu_binary_format_notes.md)|[Заметки об FPGA и ARM](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/fpga_arm_notes.md)|
|[Разработка автономного режима](https://github.com/rfidresearchgroup/proxmark3/blob/master/armsrc/Standalone/readme.md)|[Wiki об автономном режиме](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[Заметки о картах Magic UID](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/magic_cards_notes.md)|
|[Заметки об использовании цветов](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/colors_notes.md)|[Makefile против CMake](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Makefile-vs-CMake.md)|[Заметки о клонирующих устройствах](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cloner_notes.md)|
|[Заметки об использовании cliparser](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cliparser.md)|[Заметки о тактовых генераторах](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/clocks.md)|[Заметки о MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/desfire.md)|
|[Заметки о CIPURSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/cipurse.md)|[Заметки о NDEF type4a](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/ndef_type4a.md)|[Неофициальная библия MIFARE DESFire](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/unofficial_desfire_bible.md)|[Заметки о восстановлении ключей iClass legrec-legbrute](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/iclass_legrec_legbrute_key_recovery.md)|[Заметки об атаках с понижением версии](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/hid_downgrade.md)|||
# Как собрать?
## Proxmark5
Последнее поколение аппаратного обеспечения называется Proxmark5. Оно имеет
- MCU: AT32F435, 288 МГц Artery Cortex-M4
- Gowin FPGA
- TypeC Extended Port (CEP)
- BLE / Wifi / Battery Addon, через ESp32c2
- Сменные антенны (LF, HF, UHF)
- 125, 134, 250, 375, 500 КГц низкочастотная антенна (LF)
- 13.56 МГц высокочастотная антенна (HF)
- как дополнение: 860-960 МГц сверхвысокочастотная антенна (UHF), ** ещё не разработана **
На данный момент все инструкции, специфичные для Proxmark5, собраны в [едином руководстве по началу работы](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/PM5_Start_Here/Getting_Started_With_PM5.md).
Прочитайте его, чтобы собрать, прошить и запустить ваше устройство Proxmark5. Ссылки на инструкции в таблицах выше помогут настроить среду компиляции.
- ⚠ Прошивка на данный момент нестабильна и активно разрабатывается.
## Proxmark3 RDV4
Ссылки на инструкции в таблицах выше помогут собрать, прошить и запустить ваше устройство Proxmark3 RDV4.
## Универсальные платформы Proxmark3
Чтобы собрать этот репозиторий для универсальных платформ Proxmark3, мы настоятельно рекомендуем прочитать [Расширенные параметры компиляции](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md)
Мы определяем универсальные платформы Proxmark3 как следующие устройства.
**Поддерживаемые**
- RDV1, RDV2, RDV3 easy
- Ryscorp green PCB version
- Radiowar black PCB version
- многочисленные китайские адаптированные версии RDV3 easy (kkmoon, PiSwords и др.)
- Proxmark3 SE (Special Edition) (с поддержкой BLE)
- Proxmark3 X
- **Примечание**: протестировано сообществом
- **Примечание**: неизвестное аппаратное обеспечение устройства
- iCopy-X
- **Примечание**: совместимо **ТОЛЬКО** после установки [открытой прошивки iCopy-X](https://github.com/lab-401/icopy-x)
- Заводская прошивка **не** совместима (команды клиента отличаются / заводской интерфейс закрыт / заводская прошивка навязывает DRM меток)
**Не поддерживаемые**
- ⚠ Proxmark Evolution (EVO)
- **Примечание**: неизвестное назначение выводов.
- ⚠ Ryscorp Proxmark3 Pro
- **Примечание**: устройство имеет другой FPGA и неизвестное назначение выводов.
- **Примечание**: компания исчезла, оставив своих клиентов в неведении.
**Экспериментальная поддержка**
- ⚠ Proxmark3 Ultimate
- **Примечание**: неизвестное аппаратное обеспечение устройства
- **Примечание**: для него собираются образы FPGA. Используйте на свой страх и риск.
**Неизвестный статус поддержки**
- ⚠ VX
- **Примечание**: неизвестное аппаратное обеспечение устройства
Что касается этих новых неизвестных моделей, мы полагаемся на сообщество в вопросах сообщения о том, работает ли этот репозиторий и что было сделано для того, чтобы он заработал.
**Размер флеш-памяти 256 КБ у универсальных платформ Proxmark3**
> ⚠ **Примечание**:
> Вам нужно следить за тем, насколько велика встроенная флеш-память вашего ARM-чипа.
> С 512 КБ всё в порядке, но если это 256 КБ, вам нужно скомпилировать этот репозиторий с ещё меньшим объёмом функциональности.
> При запуске `./pm3-flash-all` вы можете увидеть, какой размер у вашего устройства, если у вас установлен загрузчик из этого репозитория.
> В противном случае размер будет указан в стартовом сообщении при запуске клиента Proxmark3 `./pm3`.
>
> [ВНИМАНИЕ! Прочитайте рекомендации по флеш-памяти 256 КБ](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md#256KB-versions)
# Что изменилось?
См. [файл Changelog](https://github.com/rfidresearchgroup/proxmark3/blob/master/CHANGELOG.md), который мы стараемся поддерживать в актуальном состоянии.
# Разработка
> ⚠ **Примечание**: это репозиторий с самыми свежими изменениями. Сопровождающие активно работают в этом репозитории и будут периодически реструктурировать код, чтобы его было проще понимать, ориентироваться в нём, собирать, тестировать и вносить вклад, поэтому **ОЖИДАЙТЕ значительных изменений в структуре кода на регулярной основе**.
> 👉 **Помните!** Если вы намерены внести вклад в код, пожалуйста, сначала прочитайте [заметки о стиле кодирования](https://github.com/rfidresearchgroup/proxmark3/blob/master/CONTRIBUTING.md).
Обычно мы быстро объединяем ваши вклады, поскольку нам нравится идея добавлять функциональность в Proxmark3 и вычищать ошибки afterwards.
[Публичная дорожная карта](https://github.com/RfidResearchGroup/proxmark3/wiki/Public-Roadmap) — отличное начало для чтения, если вам интересно внести вклад.
## Поддерживаемые операционные системы
Этот репозиторий успешно компилируется в
- WSL1 на Windows 10
- WSL2 на Windows 10/11
- среде Proxspace [release v3.xx](https://github.com/Gator96100/ProxSpace/releases)
- среде Windows/MinGW
- Ubuntu, ParrotOS, Gentoo, Pentoo, Kali, NetHunter, Arch Linux, Fedora, Debian, Raspbian
- Android / Termux
- macOS / Homebrew (или MacPorts, экспериментально) / Apple Silicon M1
- iOS (с джейлбрейком, rootful)
- контейнере Docker
- [ Iceman repo based ubuntu 18.04 container ](https://hub.docker.com/r/secopsconsult/proxmark3)
- [ Iceman fork based container v1.7 ](https://hub.docker.com/r/iceman1001/proxmark3/)
## Предкомпилированные бинарные файлы
См. [Proxmark3 precompiled builds](https://www.proxmarkbuilds.org/)
## Официальные каналы
Где найти сообщество?
- [RFID Hacking community discord server](https://t.ly/d4_C)
- [Proxmark3 IRC channel](https://web.libera.chat/?channels=#proxmark3)
- [Proxmark3 sub reddit](https://www.reddit.com/r/proxmark3/)
## Сопровождающие
Всем сопровождающим дистрибутивов и пакетов: мы постарались облегчить вам жизнь.
Теперь доступна команда `make install`, и если вы хотите узнать больше.
Этот документ будет вам полезен
- [Notes for maintainers](https://github.com/rfidresearchgroup/proxmark3/blob/master/doc/md/Development/Maintainers.md)
## Цитирование
Используйте этот bibtex, чтобы цитировать этот репозиторий в целом:
```
@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},
}
```
Если вам нужно сослаться на конкретное состояние репозитория, используйте номер коммита или дату обращения, например:
```
note = {Accessed: commit 12327f71a27da23831901847886aaf20e8ad3ca0}
note = {Accessed: 2021-01-01}
```
## Условия авторского права и лицензирования
Каждый вклад находится под авторским правом его автора. См. [AUTHORS](https://github.com/rfidresearchgroup/proxmark3/blob/master/AUTHORS.md).
Исходный код Proxmark3 распространяется на следующих условиях лицензирования, обычно обозначаемых как **GPLv3 или более поздняя версия**.
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.
Копия GPLv3 доступна в [LICENSE](https://github.com/rfidresearchgroup/proxmark3/blob/master/LICENSE.txt).
Некоторые зависимости могут распространяться на других условиях свободного лицензирования, совместимых с условиями лицензирования Proxmark3; см. их соответствующие описания.