FORK Iceman - Proxmark3

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

Последний релиз	Coverity	Участники

Экшены OSX CI	Экшены Ubuntu CI	Экшены Windows CI

Содержание

• Fork Iceman - Proxmark3
• Содержание
• УСТАНОВКА И ОБЗОР PROXMARK3
• Заметки / полезные документы
• Как собрать?
• Proxmark3 RDV4
• Стандартные платформы Proxmark3
• Что изменилось?
• Разработка
• Поддерживаемые операционные системы
• Предварительно собранные бинарные файлы
• GUI Proxmark3
• Официальные каналы
• Ответственные
• Цитирование
• Авторское право и условия лицензирования

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

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

Как собрать?

Proxmark3 RDV4

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

Стандартные платформы Proxmark3

Для сборки этого репозитория для стандартных платформ Proxmark3 мы настоятельно рекомендуем вам прочитать Продвинутые параметры компиляции

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

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

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

Экспериментальная поддержка - ⚠ iCopy-X - Примечание: в настоящее время несовместим с GUI iCopy-X, так как команды клиента Proxmark используют другой синтаксис. - Примечание: также см. репозитории icopyx-community для исходников, реверса железа и т.д. - Примечание: Использует 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 * компактный форм-фактор платы * корпус из ABS

Этот репозиторий vs официальный репозиторий Proxmark3:

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

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

• Поддержка табуляции команд
• Более богатый CLI с использованием цветов / эмодзи
• Везде реализована система справочного текста
• Система подсказок
• Настройки пользовательских предпочтений
• Обширное тестирование с системами сборки непрерывной интеграции на Linux, OSX и Windows, а также регулярное использование инструментов статического анализа, таких как
  • Coverity Scan
  • Cppcheck (v2.6)
  • Жесткая реализация флагов диагностики в GCC и Clang
• Автоопределение последовательных портов и бесшовная интеграция с аддоном Bluetooth
• Переподключение к устройству изнутри клиента
• Поддержка атак с отрывом (tearoff)
• Поддержка NFC NDEF type1, type2, type4a, type4b, mifare, штрих-кодов
• Поддержка скриптов клиента pm3, lua-скриптов, python-скриптов
• Самая полная коллекция доступных скриптов
• Кодирование, декодирование Wiegand.
• Поддержка EMV
• Поддержка CIPURSE
• Большинство автономных режимов доступны с простой компиляцией
• Обширные тестовые скрипты для клиента и внешних инструментов
• Самые полные скомпилированные словари известных ключей
• Оптимизированный usb- обмен данными с NG-фреймами
• Самое быстрое скомпилированное программное обеспечение для восстановления публично известных ключей
• Самые быстрые реализации указанного программного обеспечения
• Поддержка множества форматов файлов для дампов (BIN/EML/JSON)
• Совместимость указанных форматов файлов с libnfc, приложением MFC tool и т.д.
• Поддержка большего количества 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 repo - контейнер на базе форка Iceman v1.7

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

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

GUI Proxmark3

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

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

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

Где найти сообщество? - Дискорд-сервер RFID Hacking community - 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 или новее.

Эта программа является свободным программным обеспечением. Вы можете распространять ее и/или изменять
в соответствии с условиями GNU General Public License, опубликованной
Free Software Foundation, либо версии 3 этой лицензии, либо
(по вашему выбору) любой более поздней версии.

Эта программа распространяется в надежде, что она будет полезной,
но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
КОММЕРЧЕСКОЙ ЦЕННОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.  Подробнее см. в
GNU General Public License.

Копия GPLv3 доступна в LICENSE.

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