EasyTokens

デバイスコードフィッシングサーバー。敵対的エミュレーション用。Microsoft 365 OAuthトークンをDevice Authorization Grantフローでキャプチャします。GraphSpyに触発されました。

警告 — 許可された使用のみ。 このツールは、明示的な書面による許可を得たペネトレーションテスターおよびレッドチームメンバーを対象としています。誤用はコンピュータ不正使用法に違反する可能性があります。

仕組み

1. オペレーターはオペレーターUIを介してデバイスコードキャンペーンを作成します。
2. 被害者向けの登録ページ（ダンダー・ミフリンをテーマ）にユーザーコードが表示され、ターゲットにmicrosoft.com/deviceloginでの認証を促します。
3. バックグラウンドのポーラーがターゲットの認証完了を検出し、取得したアクセス/リフレッシュトークンをSQLiteに保存します。
4. 被害者のブラウザは認証後の検索ページにリダイレクトされます。
5. オペレーターはキャプチャしたトークンを使用して、Microsoft Graphを介して被害者のOneDriveやメールを検索できます。

アーキテクチャ

Pythonバックエンド（キャンペーンごとに1ポート） + nginxフロントエンド + SQLite永続化。

main_server.py          ← 統一エントリポイント（これを実行）
db.py                   ← SQLite永続化レイヤー
html_enroll.py          ← 被害者登録ページビルダー
html_search.py          ← 被害者認証後検索ページビルダー
css_shared.py           ← オペレーターUI用共有CSS
nginx_helper.py         ← nginxリバースプロキシ設定の自動生成とリロード
nginx.conf              ← ベースnginx設定（/etc/nginx/conf.d/*.conf を含む）

ルート

Nginx — ドメインキャンペーン

キャンペーン作成時にドメインが設定されている場合、nginx_helper.py は自動的にNGINX_CONF（デフォルトでは/etc/nginx/conf.d/easytokens.conf）にドメインごとのサーバーブロックを書き込み、nginxをリロードします。そのドメインへのポート80に到着した被害者トラフィックは、正しいPythonサーバーインスタンスにプロキシされます。

• ドメインなしのキャンペーンはPythonポート（デフォルト3000）で直接提供されます。
• ドメインありのキャンペーンはnginx経由でポート80で提供されます。
• ベースのnginx.confは、Hostヘッダーが既知のキャンペーンと一致しないリクエストをドロップし（return 444）、Pythonバックエンドの偶発的な露出を防ぎます。
• NGINX_CONF=''またはNGINX_RELOAD_CMD=''を設定して自動nginx管理を無効にします。

クイックスタート（Docker）

docker compose up --build

Dockerが公開するポート:

• 被害者ページ（直接）: http://localhost:3000/
• オペレーターUI: http://localhost:3000/app
• ドメインキャンペーン: http://<campaign-domain>/ （nginx経由でポート80にルーティング）

キャプチャされたトークンとログはDockerボリュームに永続化されます:

手動セットアップ

必要要件: Python 3.12以上、サードパーティパッケージ不要。

python main_server.py

環境変数

PHPリレーノード

php-relay/ディレクトリには、分散型の被害者向けノードとして動作するスタンドアロンのApache/PHPコンテナが含まれています。メインサーバーと同じデバイスコード登録ページを提供し、Microsoftに直接ポーリングし、キャプチャしたトークンをPOST /webhook経由でメインパネルに転送します。

仕組み

1. 起動時に、checkin.phpはメインパネルのPOST /relay/checkinにPOSTし、RELAY_SECRETで認証します。パネルはノードを登録し、node_idを返します。
2. 被害者はリレーの登録ページ（index.php）にアクセスし、新しいデバイスコードフローを開始します。
3. ブラウザ側のJSがpoll.phpをポーリングします。トークンがキャプチャされると、poll.phpはそれをnode_idタグ付きでメインパネルのPOST /webhookに転送します。

リレー環境変数

php-relay/.envで設定:

クイックスタート

両方のコンテナを同時に（推奨）：

# from EasyTokens/
docker compose -f docker-compose.yml -f php-relay/docker-compose.yml up --build

両方を1つの-fマージで実行すると、同じDockerネットワーク上に配置されるため、MAIN_SERVER_URL=http://easytokens:3000が正しく解決されます。

アクセス：

リレーのみ（リモートパネル）：

cd php-relay
# Set MAIN_SERVER_URL to the public panel URL in .env
docker compose up --build

共有シークレットの設定

1. シークレットを生成: openssl rand -hex 32
2. EasyTokens/.env に RELAY_SECRET=<secret> を設定（docker-compose.yml 経由でメインパネルに反映されます）
3. php-relay/.env にも同じ値を設定

データベース

SQLiteデータベース内の2つのテーブル：

• tokens — キャプチャされたすべてのアクセス/リフレッシュトークン（UPN、アクセストークン、リフレッシュトークン、IDトークン、スコープ、ソース、キャプチャタイムスタンプ）
• device_codes — オペレーターが開始したキャンペーン（ユーザーコード、デバイスコード、検証URL、ステータス、リンクされたトークンID、ポート、ドメイン）

Microsoft OAuth詳細

ライセンス

MITライセンス — Copyright (c) 2026 Casey Smith