Doppelgänger Community、Pro、Stealth、およびMFASが対応するすべてのカードタイプの書き込み・シミュレーションを行うためのカード計算機およびProxmark3プラグイン。
カードデータの計算と、Doppelgänger CoreおよびStealthが対応するすべてのカードタイプのProxmark3操作を自動化する、プロフェッショナル向けGUIアプリケーションです。このツールは、直感的なインターフェースと二重出力表示、視覚的なセパレータ、ワンクリックのクリップボードコピーを備え、複雑なProxmark3構文を暗記したりメモを調べたりする必要をなくし、物理ペネトレーションテストにおけるカード書き込みプロセスを効率化します。
自動インストーラは、Doppelganger Assistant、必要な依存関係、および最新のIceman fork of Proxmark3をインストールします。インストール中に、最適な構成のためにProxmark3デバイスの種類を選択するよう求められます。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_macos.sh)"
### Linux```bash
curl -sSL https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_linux.sh | sudo bash
管理者として PowerShell を開いて実行します:```powershell irm https://raw.githubusercontent.com/tweathers-sec/doppelganger_assistant/main/installers/doppelganger_install_windows.ps1 | iex
**注:** インストーラーは、**Ubuntu 24.04 LTS (Noble)** (推奨) または **Kali Linux** の選択を促します。既存のインストールを自動的に検出し、更新を促します。WSL機能を有効にするために再起動が必要な場合は、プロンプトが表示されます。再起動後、同じコマンドをもう一度実行してください。
⚠️ 重要: WSL2は、ネストされた仮想マシン内での実行をサポートしていません。インストーラーはそのような環境を自動的に検出し、インストールを防止します。続行するには、物理ハードウェアにインストールしてください。
## Doppelgänger Assistant にできること
Doppelgänger Assistant は、初期検出から書き込み操作の成功まで、カード解析と複製の完全なワークフローを提供します。このアプリケーションは、カード技術を自動的に識別し、認証情報データを抽出し、暗号化キーを復元し、検証付きで複製カードを書き込みます。
### インテリジェントカード検出
Card Discovery 機能は、低周波および高周波の両方のチップを自動的にスキャンし、デュアルチップカードを識別して、HID Prox、iCLASS、PicoPass、MIFARE などを含む特定のカード技術を判別します。結果には、利用可能な場合、施設コードとカード番号を含むデコードされた Wiegand データが含まれます。
### ホテルキーカード解析
Hotel Access Control セクションは、MIFARE ベースのホテルキーシステム向けの専門ツールを提供します。Card Info 取得は、Saflok ホテルキーカードを自動的に識別し、UID、カードタイプ、マジック機能、PRNG 検出などの詳細なカード情報を表示します。生の Proxmark3 出力には、利用可能な場合、包括的な Saflok メタデータが含まれます。
### 自動キー復旧
MIFARE 攻撃ツールには、複数の復旧方法が含まれます: Autopwn (自動マルチメソッド)、Darkside、Nested、Hardnested、Static Nested、Bruteforce、NACK 脆弱性テスト。Autopwn は、カードの特性に基づいて最適な攻撃方法を自動的に選択します。結果には、回復されたセクタ、見つかったキーの総数、使用された復旧方法、および即時のカード複製のための自動ダンプファイル生成を示す包括的な復旧サマリーが表示されます。
### 法人アクセスカード操作
Corporate Access Control セクションは、iCLASS、PicoPass、AWID、HID Prox、Indala、Avigilon、およびその他の法人カード技術の読み取りと書き込みをサポートしています。カードデータは Proxmark3 出力から自動的に解析され、施設コード、カード番号、ビット長、フォーマットタイプ (H10301、C1k35s など)、CSN 値、および生の 16 進データが抽出されます。統合ワークフローにより、オプションの検証付きで空白カードへの即時書き込みが可能です。
### 完全な複製ワークフロー
Doppelgänger Assistant は、Doppelgänger RFID ハードウェアおよび Proxmark3 デバイスとシームレスに統合されます。Doppelgänger リーダーで取得した認証情報は、解析と書き込みのために GUI に直接インポートできます。このアプリケーションは、複数のメーカーのカードの読み取り、Web インターフェースからのデータの解析、およびリアルタイムのステータス更新と検証を伴う書き込み操作の実行をサポートしています。
## 変更履歴
### バージョン 1.1.2 (2025年12月18日)
**新機能:**
* Proxmark3 を別のターミナルウィンドウで開く LAUNCH PM3 ボタンを追加
* 自動カードタイプ検出を備えた Card Discovery セクションを追加
* サポートされているすべてのカードタイプに対応する READ CARD DATA 機能を追加
* MIFARE ツールを備えた Hotel / Residence Access Control セクションを追加
* LF と HF の両方に対応したデュアルチップカード検出を追加
* MIFARE カードが検出されたときの自動カード情報取得を追加
**改善点:**
* 特定の MIFARE タイプとマジック機能を表示するようにカード検出を改善
* より明確な成功メッセージでカード検証を強化
* アプリケーション全体のエラー処理とユーザーフィードバックを改善
* 自動復号化サポートにより iCLASS カード読み取りを改善
### バージョン 1.1.1
* コアとなるカード書き込み、検証、シミュレーション機能を備えた初期リリース
* PROX、iCLASS、AWID、Indala、Avigilon、EM4100、PIV、MIFARE カードに対応
## Doppelgänger デバイス
Stealth リーダー、Doppelgänger Dev Board、または完全組み立て済みの長距離リーダーは、[Physical Exploitation Store](https://store.physicalexploit.com/) から購入できます。オープンソースファームウェアについては、[Doppelgänger Core](https://github.com/mwgroup-io/Doppelganger_Core) を確認してください。
## 対応 Proxmark3 デバイス
Doppelgänger Assistant は、[Proxmark3 の Iceman フォーク](https://github.com/RfidResearchGroup/proxmark3) で動作し、以下のデバイスタイプをサポートしています:
* **Proxmark3 RDV4** - Blueshark Bluetooth アドオンあり/なし
* **Proxmark3 Easy (512KB)** - 汎用プラットフォームサポート
自動インストーラーは、最適な構成のためにインストール中にデバイスタイプの選択を促します。
## 法人 PACS カードタイプ
以下は、Doppelgänger ファームウェアに基づく正式サポート対象の法人 PACS カードタイプです。ホテル/Mifare キーカードのサポートは、キー復旧および複製機能とともにバージョン 1.1.2 で追加されました。なお、ホテルのキーカード / 詳細な Mifare 解析は、Doppelgänger 製品で取得したデータとは整合していません。これは物理ペネトレーションテストの取り組みをサポートするために追加された機能であり、進行中と見なされます。
| カードタイプ | Core | Stealth | FC範囲 | CN範囲 |
| --------------------------- | ---- | ------- | ----------- | --------------- |
| キーパッド PIN コード | | X | N/A | N/A |
| HID H10301 26-bit | X | X | 0–255 | 0–65,535 |
| Indala 26-bit | X | X | 0–255 | 0–65,535 |
| Indala 27-bit | X | X | 0–4,095 | 0–8,191 |
| 2804 WIEGAND 28-bit | X | X | 0–255 | 0–16,383 |
| Indala 29-bit | X | X | 0–4,095 | 0–32,767 |
| ATS Wiegand 30-bit | X | X | 0–2,047 | 0–32,767 |
| HID ADT 31-Bit | X | X | 0–15 | 0–8,388,607 |
| EM4102 / Wiegand 32-bit | X | X | 0–32,767 | 0–65,535 |
| HID D10202 33-bit | X | X | 0–127 | 0–16,777,215 |
| HID H10306 34-bit | X | X | 0–65,535 | 0–65,535 |
| HID Corporate 1000 35-bit | X | X | 0–4,095 | 0–1,048,575 |
| HID Simplex 36-bit (S12906) | X | X | 0–255 | 0–65,535 |
| HID H10304 37-bit | X | X | 0–65,535 | 0–524,287 |
| HID H800002 46-bit | X | X | 0–16,383 | 0–1,073,741,823 |
| HID Corporate 1000 48-bit | X | X | 0–4,194,303 | 0–8,388,607 |
| AWID 50-bit | X | X | 0–65,535 | 0–8,388,607 |
| Avigilon 56-bit | X | X | 0–1,048,575 | 0–4,194,303 |
| C910 PIVKey | X | X | N/A | N/A |
| MIFARE (各種タイプ) | X | X | N/A | N/A |
対応技術は以下のとおりです:
* iCLASS(Legacy/SE/Seos) *注: 取得した SE および Seos カードは iCLASS 2k カードにのみ書き込むことができます*
* PROX
* Indala
* AWID
* Avigilon
* EM4102
* PIV (UID のみ - リーダーの Wiegand 出力で提供されるため)
* MIFARE (UID のみ - リーダーの Wiegand 出力で提供されるため)
## 詳細なインストール手順
### MacOS 手動インストール
1. お使いのアーキテクチャに適した DMG ファイルを [リリースページ](https://github.com/tweathers-sec/doppelganger_assistant/releases) からダウンロードします:
- Apple Silicon (M1/M2/M3): `doppelganger_assistant_darwin_arm64.dmg`
- Intel: `doppelganger_assistant_darwin_amd64.dmg`
2. DMG ファイルを開き、`doppelganger_assistant.app` を `/Applications` フォルダにドラッグします
3. クォレーション属性を削除します: ```sh
xattr -cr /Applications/doppelganger_assistant.app
~/.zshrc または ~/.zprofile）に追加して、コマンドラインエイリアスを作成します: ```sh
alias doppelganger_assistant='/Applications/doppelganger_assistant.app/Contents/MacOS/doppelganger_assistant'
Option 1: Using .deb package (Debian/Ubuntu/Kali - Recommended)