Iceman Fork - Proxmark3

Proxmark3 — это швейцарский нож в мире RFID, позволяющий взаимодействовать с подавляющим большинством RFID-меток по всему миру. Первоначально созданное Джонатаном Вестхьюсом (Jonathan Westhues), устройство теперь является основным инструментом для анализа RFID среди энтузиастов. Репозиторий Iceman считается вершиной функций и возможностей, обеспечивая огромный набор чрезвычайно полезных и удобных команд и LUA-скриптов для автоматизации идентификации чипов, тестирования на проникновение и программирования.

Latest Release	Coverity	Contributors

Actions OSX CI	Actions Ubuntu CI	Actions Windows CI

Table of Contents

• Iceman Fork - Proxmark3
• Table of Contents
• PROXMARK3 INSTALLATION AND OVERVIEW
  • Notes / helpful documents
• How to build?
  • Proxmark3 RDV4
  • Generic Proxmark3 platforms
• What has changed?
• Development
  • Supported operating systems
  • Precompiled binaries
  • Proxmark3 GUI
  • Official channels
  • Maintainers
  • Citation
  • Copyright and licensing terms

УСТАНОВКА И ОБЗОР PROXMARK3

Заметки / полезные документы

Как собрать?

Proxmark3 RDV4

Смотрите ссылки с инструкциями в таблицах выше, чтобы собрать, прошить и запустить для вашего устройства Proxmark3 RDV4.

Универсальные платформы Proxmark3

Чтобы собрать этот репозиторий для универсальных платформ Proxmark3, настоятельно рекомендуем прочитать Расширенные параметры компиляции

Мы определяем универсальные платформы Proxmark3 как следующие устройства.

Поддерживаются

• RDV1, RDV2, RDV3 easy
• Ryscorp зелёная версия PCB
• Radiowar чёрная версия PCB
• многочисленные китайские адаптированные версии RDV3 easy (kkmoon, PiSwords и т.д.)
• Proxmark3 SE (Special Edition) (с поддержкой BLE)
• Proxmark3 X
  • Примечание: проверено сообществом
  • Примечание: неизвестное аппаратное обеспечение устройства

Не поддерживаются

• ⚠ Proxmark Evolution (EVO)
  • Примечание: неизвестное назначение контактов.
• ⚠ Ryscorp Proxmark3 Pro
  • Примечание: устройство имеет другой FPGA и неизвестное назначение контактов.
  • Примечание: компания исчезла, оставив своих клиентов в неведении.

Экспериментальная поддержка

• ⚠ iCopy-X
  • Примечание: в настоящее время несовместим с GUI iCopy-X, так как команды клиента Proxmark используют другой синтаксис
  • Примечание: также смотрите репозитории icopyx-community для исходников upstream, реверс-инжиниринга оборудования и т.д.
  • Примечание: использует DRM для блокировки меток, игнорирует лицензии с открытым исходным кодом. Используйте на свой страх и риск.
• ⚠ Proxmark3 Ultimate
  • Примечание: неизвестное аппаратное обеспечение устройства
  • Примечание: для него собираются образы FPGA. Используйте на свой страх и риск.

Неизвестный статус поддержки

• ⚠ VX
  • Примечание: неизвестное аппаратное обеспечение устройства

Что касается этих новых неизвестных моделей, мы полагаемся на сообщество: сообщите, работает ли этот репозиторий и что вы сделали, чтобы он заработал.

Размер встроенной флэш-памяти 256KB для универсальных платформ Proxmark3

⚠ Примечание: Нужно следить за тем, насколько велика встроенная флэш-память вашего ARM-чипа. С 512KB всё будет в порядке, но если у вас 256KB, вам нужно компилировать этот репозиторий с ещё меньшим количеством функций. При запуске ./pm3-flash-all вы можете увидеть, какого размера ваше устройство, если у вас установлен загрузчик из этого репозитория. В противном случае вы увидите размер в стартовом сообщении при запуске клиента Proxmark3 ./pm3.

ВНИМАНИЕ! Прочтите предупреждение о флэш-памяти 256KB

Что изменилось?

Аппаратные модификации Proxmark3 RDV4:

• добавлена флэш-память 256KB
• добавлен модуль смарт-карт
• добавлен FPC-разъём для периферии, такой как модуль Bluetooth+аккумулятор
• улучшенные антенны
  • сменные
  • переключатель добротности LF
  • переключатель частоты LF 125/134
• компактный форм-фактор PCB
• корпус из ABS-пластика

Этот репозиторий по сравнению с официальным репозиторием Proxmark3:

Смотрите файл изменений, который мы стараемся поддерживать в актуальном состоянии.

Короче говоря, этот репозиторий даёт совершенно другой пользовательский опыт при работе с Proxmark3.

• Поддержка автодополнения команд по Tab
• Более богатый CLI с использованием цветов / эмодзи
• Система справочных текстов, реализованная повсеместно
• Система подсказок
• Настройки пользовательских предпочтений
• Обширное тестирование с системами непрерывной интеграции на Linux, OSX и Windows, а также регулярное использование инструментов статического анализа, таких как
  • Coverity Scan
  • Cppcheck (v2.6)
  • GCC и Clang с агрессивной проверкой диагностических флагов
• Автоопределение последовательных портов и бесшовная интеграция с Bluetooth-модулем
• Переподключение к устройству из клиента
• Поддержка tearoff-атак
• Поддержка NFC NDEF type1, type2, type4a, type4b, mifare, barcode
• Поддержка скриптов клиента pm3, LUA-скриптов, Python-скриптов
• Наиболее полная коллекция доступных скриптов
• Кодирование и декодирование Wiegand
• Поддержка EMV
• Поддержка CIPURSE
• Большинство автономных режимов доступны с лёгкой компиляцией
• Обширный тестовый скрипт для клиента и внешних инструментов
• Наиболее полные скомпилированные словари известных ключей
• Упрощённая USB-связь с NG-кадрами
• Наиболее полное публичное программное обеспечение для восстановления известных ключей
• Самые быстрые реализации этого ПО
• Поддержка нескольких форматов файлов дампов (BIN/EML/JSON)
• Совместимость этих форматов с libnfc, MFC tool app и др.
• Поддержка большего количества протоколов на основе RFID, чем когда-либо
• Простая установка для сопровождающих пакетов и дистрибутивов
• Поддержка cmake, make
• Сборка без ошибок и предупреждений на большем количестве ОС/платформ, чем когда-либо
• Доступен в виде пакета в известных дистрибутивах, таких как Gentoo, Kali, Termux, Macports, Homebrew
• Гораздо больше документации

Разработка

⚠ Примечание: Это репозиторий на переднем крае (bleeding edge). Сопровождающие активно работают в этом репозитории и будут периодически реструктурировать код, чтобы его было легче понимать, перемещаться по нему, собирать, тестировать и вносить вклад, так что РАССЧИТЫВАЙТЕ на значительные изменения структуры кода на регулярной основе.

👉 Помните! Если вы собираетесь внести вклад в код, сначала прочтите заметки о стиле кодирования. Мы обычно быстро объединяем ваши вклады, поскольку нам нравится идея добавления функциональности в Proxmark3, а затем вычищаем баги.

С публичного плана развития отлично начать, если вам интересно внести вклад.

Поддерживаемые операционные системы

Этот репозиторий отлично компилируется на

• WSL1 на Windows 10
• WSL2 на Windows 10/11
• окружение Proxspace релиз v3.xx
• окружение Windows/MinGW
• Ubuntu, ParrotOS, Gentoo, Pentoo, Kali, NetHunter, Arch Linux, Fedora, Debian, Raspbian
• Android / Termux
• macOS / Homebrew (или MacPorts, экспериментально) / Apple Silicon M1
• iOS (джейлбрейк, rootful)
• Docker-контейнер
  • Контейнер на основе ubuntu 18.04 из репозитория Iceman
  • Контейнер на основе форка Iceman v1.7

Предкомпилированные бинарные файлы

Смотрите предкомпилированные сборки Proxmark3

Proxmark3 GUI

Официальный PM3-GUI от Gaucho не будет работать. Не говоря уже о том, что он довольно старый и больше не поддерживается.

• Универсальный GUI Proxmark3 будет работать более или менее.
• Proxmark3 GUI cross-compiled недавно обновлён и заявляет о поддержке последних исходников этого репозитория.
• Proxmark3_GUI — простой GUI на vb.net

Официальные каналы

Где найти сообщество?

• Discord-сервер сообщества RFID Hacking
• IRC-канал Proxmark3
• Сабреддит Proxmark3
• Форум Proxmark3

Сопровождающие

Всем сопровождающим дистрибутивов и пакетов: мы постарались облегчить вам жизнь.

Теперь доступна make install, и если вы хотите узнать больше.

Этот документ будет полезен для вас

• Заметки для сопровождающих

Цитирование

Используйте этот 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.

Исходный код 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.

Некоторые зависимости могут распространяться на других условиях свободного лицензирования, совместимых с условиями лицензирования Proxmark3; смотрите их соответствующие описания.