Iceman Fork - Proxmark3

Proxmark3はRFIDのスイスアーミーナイフ的ツールであり、世界中の大多数のRFIDタグとの対話を可能にします。元々はJonathan Westhuesによって製作されましたが、現在では愛好家にとってRFID解析の定番ツールとなっています。Icemanリポジトリは機能と実用性の頂点と見なされており、チップ識別、ペネトレーションテスト、プログラミングを自動化するための極めて有用で便利なコマンドとLUAスクリプトの幅広い範囲を実現しています。

最新リリース	Coverity	コントリビューター

Actions OSX CI	Actions Ubuntu CI	Actions Windows CI

PROXMARK3のインストールと概要

インストール	Proxmark3の使用方法
Linux - セットアップとビルド	コンパイル手順
Linux - ModemManagerに関する重要な注意事項	Proxmark3クライアント機能の検証
macOS - Homebrew & Homebrew Tap Formulaのアップグレード	初回使用と検証
macOS - MacPorts	コマンドと機能
macOS - セットアップとビルド	スタンドアロンモード
Windows - セットアップとビルド
Termux / Android - セットアップとビルド
iOS - セットアップとビルド
Blue Sharkマニュアル	コマンド早見表
高度なコンパイルパラメータ	その他の早見表
トラブルシューティング	完全なクライアントコマンドセット
JTAG	T5577入門ガイド

メモ / 参考ドキュメント

メモ
UARTに関するメモ	Termux / Androidに関するメモ	パスに関するメモ
フレームフォーマットに関するメモ	トレースログ / Wiresharkに関するメモ	EMVに関するメモ
外部フラッシュに関するメモ	loclassに関するメモ	Coverity Scanの設定と実行に関するメモ
Proxmark3で使用されるファイルフォーマットに関するメモ	MFUバイナリフォーマットに関するメモ	FPGAとARMに関するメモ
スタンドアロンモードの開発	スタンドアロンモードに関するWiki	Magic UIDカードに関するメモ
色の使用に関するメモ	MakefileとCMake	クローナーガンに関するメモ
cliparserの使用方法に関するメモ	クロックに関するメモ	MIFARE DESFireに関するメモ
CIPURSEに関するメモ	NDEF type4aに関するメモ	非公式MIFARE DESFireバイブル

ビルド方法

Proxmark3 RDV4

お使いのProxmark3 RDV4デバイス向けにビルド、フラッシュ、実行する手順は、上記の表のリンクを参照してください。

汎用Proxmark3プラットフォーム

汎用Proxmark3プラットフォーム向けにこのリポジトリをビルドするには、高度なコンパイルパラメータをお読みになることを強くお勧めします。

ここで言う汎用Proxmark3プラットフォームとは、以下のデバイスを指します。

サポート対象

RDV1、RDV2、RDV3 easy
Ryscorp グリーンPCB版
Radiowar ブラックPCB版
RDV3 easyの多数の中国製派生版（kkmoon、PiSwordsなど）
Proxmark3 SE（スペシャルエディション）（BLE対応）
Proxmark3 X
- 注記: コミュニティによるテスト済み
- 注記: デバイスHW不明

非サポート

⚠ Proxmark Evolution (EVO)
- 注記: ピン割り当て不明。
⚠ Ryscorp Proxmark3 Pro
- 注記: デバイスは異なるFPGAを搭載しており、ピン割り当ても不明。
- 注記: 会社は消滅し、顧客を置き去りにした。

試験的サポート

⚠ iCopy-X
- 注記: Proxmarkクライアントのコマンドが異なる構文を使用するため、現在iCopy-X GUIとは互換性がありません。
- 注記: 上流ソースやリバースエンジニアリングされたHWなどについては、icopyx-communityリポジトリも参照してください。
- 注記: DRMを使用してタグをロックし、オープンソースライセンスを無視しています。使用は自己責任で行ってください。
⚠ Proxmark3 Ultimate
- 注記: デバイスHW不明
- 注記: FPGAイメージはビルド中です。使用は自己責任で行ってください。

サポート状況不明

⚠ VX
- 注記: デバイスHW不明

これらの新しい不明なモデルについては、このリポジトリが動作するかどうか、また動作させるために何を行ったかをコミュニティが報告してくれることに依存しています。

汎用Proxmark3プラットフォームの256KBフラッシュメモリサイズ

⚠ 注記: ARMチップ内蔵フラッシュメモリのサイズに注意する必要があります。 512KBなら問題ありませんが、256KBの場合は、このリポジトリをさらに機能を絞ってコンパイルする必要があります。 ./pm3-flash-allを実行すると、このリポジトリのブートローダーがインストールされていれば、デバイスのサイズを確認できます。そうでない場合は、Proxmark3クライアント./pm3を実行したときの起動メッセージでサイズが報告されます。

注意！256KBフラッシュメモリに関する勧告をお読みください

変更点

Proxmark3 RDV4のハードウェア変更点:

256KBフラッシュメモリを追加
スマートカードモジュールを追加
Bluetooth+バッテリーアドオンなどの周辺機器用FPCコネクタを追加
アンテナを改良
- 交換可能
- LF Qファクタースイッチ
- LF 125/134周波数スイッチ
小型PCBフォームファクター
ABSケース

このリポジトリと公式Proxmark3リポジトリの比較:

更新に努めている変更履歴ファイルを参照してください。

要するに、このリポジトリはProxmark3に関してまったく異なるユーザー体験を提供します。

コマンドのタブ補完をサポート
色 / 絵文字を使用したよりリッチなCLI
あらゆる場所にヘルプテキストシステムを実装
ヒントシステム
ユーザー環境設定
Linux、OSX、Windowsでの継続的インテグレーションビルドシステムによる広範なテスト、および以下のような静的解析ツールの定期的な使用
- Coverity Scan
- Cppcheck (v2.6)
- GCCとClangによる診断フラグの積極的な適用
シリアルポートの自動検出とBluetoothアドオンとのシームレスな統合
クライアント内からデバイスに再接続
ティアオフ攻撃をサポート
NFC NDEF type1、type2、type4a、type4b、mifare、バーコードをサポート
pm3クライアントスクリプト、luaスクリプト、pythonスクリプトをサポート
最も包括的なスクリプトコレクションを提供
Wiegandエンコード、デコード。
EMVをサポート
CIPURSEをサポート
ほとんどのスタンドアロンモードを簡単なコンパイルで利用可能
クライアントと外部ツール向けの広範なテストスクリプト
最も包括的なコンパイル済み既知鍵辞書
NGフレームによりスリム化されたUSB通信
最も多くコンパイルされている公開既知鍵回復ソフトウェア
上記ソフトウェアの最速実装
ダンプファイル用の複数ファイルフォーマット（BIN/EML/JSON）をサポート
上記ファイルフォーマットとlibnfc、MFCツールアプリなどとの相互運用性
これまでにないほど多くのRFIDベースのプロトコルをサポート
パッケージメンテナー、ディストリビューションメンテナー向けの簡単インストール
cmake、makeをサポート
これまでにないほど多くのOS/プラットフォームでエラーや警告なしにビルド
Gentoo、Kali、Termux、Macports、Homebrewなどの既知のディストリビューションでパッケージとして利用可能
はるかに多くのドキュメント

開発

⚠ 注記: これは最先端の（bleeding edge）リポジトリです。メンテナーはこのリポジトリを拠点に積極的に開発しており、コードを理解、閲覧、ビルド、テスト、貢献しやすくするために定期的に再構築します。したがって、コードレイアウトの大幅な変更が定期的に発生することを想定してください。

👉 忘れないでください！ コードへの貢献を予定している場合は、まずコーディングスタイルノートをお読みください。私たちはProxmark3に機能を追加してから後でバグを除去するという考え方を好むため、通常はあなたの貢献を迅速にマージします。

貢献に興味があるなら、公開ロードマップを読むのが最適な出発点です。

対応オペレーティングシステム

このリポジトリは以下の環境で問題なくコンパイルできます。

WSL1 on Windows 10
WSL2 on 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コンテナ
- Icemanリポジトリベースのubuntu 18.04コンテナ
- Iceman forkベースのコンテナv1.7

プリコンパイル済みバイナリ

Proxmark3プリコンパイル済みビルドを参照してください。

Proxmark3 GUI

Gaucho製の公式PM3-GUIは動作しません。かなり古く、もはやメンテナンスされていないことは言うまでもありません。

Proxmark3 Universal GUIは多かれ少なかれ動作します。
最近更新され、このリポジトリの最新ソースをサポートすると謳っているProxmark3 GUI cross-compiled。
Proxmark3_GUIはvb.net製のシンプルなGUI。

公式チャンネル

コミュニティはどこにありますか？

メンテナー

すべてのディストリビューション、パッケージメンテナーの皆さん、あなたの作業を楽にするよう努めました。

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のライセンス条件と互換性のある他のフリーライセンス条件の下にある場合があります。それぞれの説明を参照してください。

proxmark3 v4.23346

カテゴリ