Xbox 開発キットの Fiddler
このトピックを使用して、Xbox 開発キット で Fiddler を使用する方法について説明します。 Fiddler とは、Xbox One 開発キットとインターネットの間のすべての HTTP トラフィックと HTTPS トラフィックをログに記録する Web デバッグ プロキシです。 Web サービス呼び出しを把握してデバッグするために、開発者は Fiddler を使用して Xbox サービスと証明書利用者 Web サービスとの間のトラフィックをログに記録し、検査します。 Fiddler にはいくつかのバージョンがあります。 Fiddler Classic はフリーウェアです。 ダウンロードするには、Fiddler の Web サイトを参照してください。 以下のセクションでは、Fiddler Classic のみを参照します。
通常の操作では、プロキシ経由で通信する本体は、プロキシによって通信内容が変更されるリスクがあります。 これにより、ユーザーによる不適切な行為が発生する可能性があります。 そのため、リテール用 開発キットはプロキシ経由での通信を許可しないように設計されています。 Xbox 開発キットで Fiddle rを使用するには、Fiddler プロキシを使用できるように、開発キットでいくつかの特別な構成手順を実行する必要があります。
Fiddler は、本体によって報告されるネットワークの状態に影響する可能性があります。 Fiddler を実行している開発用 PC からアップストリーム接続を無効にした場合、本体は本体の認証が期限切れになるまでこの切断を検出しない可能性があります。 Fiddler を使用している場合は、Fiddler を使用して切断をシミュレートしないでください。 代わりに、本体と Fiddler を実行している開発用 PCの間の接続を切断してください。 もっと良いのは、ネットワーク負荷ツールを使用して、テスト目的で切断をシミュレートすることです。
開発用 PC に Fiddler をインストールおよび有効化する
Fiddler をインストールして有効化し、開発キットからのトラフィックを監視するには
Fiddler の Web サイトの指示に従って、Fiddler Classic を開発用 PC にインストールします。
Fiddler を開きます。 [Tools] メニュー の [Fiddler Options] を選択します。
[Connections] タブを選択し、[Allow remote computers to connect] チェック ボックスがオンになっていることを確認します。
[OK] を選択して設定の変更を受け入れます。 変更内容を有効にするには Fiddler の再起動が必要であることと、ファイアウォールの手動構成が必要な場合があることを知らせるダイアログ ボックスが表示されます。 [OK] を選択しますが、まだ Fiddler を再起動しないでください。
リモート コンピューターに接続を許可するために必要なファイアウォール規則を構成します。
a. コントロール パネルで、[Windows ファイアウォール] を選択します。
b. [詳細設定]>[インバウンド ルール] を選択します。
c. FiddlerProxy ルールに移動し、右にスクロールします。 値が次の表の値と一致することを確認します。
設定 推奨値 名前 FiddlerProxy Group グループの値は設定しない プロフィール All Enabled はい アクション 許可 優先 いいえ プログラム Fiddler.exe へのパス ローカル アドレス 任意 リモート アドレス 任意 Protocol TCP ローカル ポート 任意 リモート ポート 任意 承認されているユーザー 任意 承認されているコンピューター 任意 HTTPS トラフィックをキャプチャおよび復号化するために Fiddler を構成します。
a. パフォーマンスを最大限に高めるには、ボタン バーの [Stream] ボタンを選択することによって、Fiddler がストリーミング モードを使用するように設定します。
b. Fiddlerで、[ツール]>[Fiddler オプション]>[HTTPS] を選択します。
c. [Decrypt HTTPS traffic (HTTPS トラフィックを復号化)] チェック ボックスをオンにします。 CA 証明書を信頼するように Windows を構成するかどうかを確認するダイアログ ボックスが表示された場合は、[No] を選択します。
d. [Export Root Certificate to Desktop] ボタンを選択します。
Fiddler をいったん閉じて、改めて起動します。
インターネットへのプロキシとして Fiddler を使用するように Xbox One 開発キットを構成する
Fiddler は、Microsoft Game Development Kit (GDK) タイトルに対して有効にも無効にもできます。
Fiddler をインターネットへのプロキシとして使用するように開発キットを構成するには
Xbox Device Portal UI の [ネットワーク] ツールに移動します。
a. ブラウザーを使用して、ポート 11443 で本体のシステム IP アドレスに移動します (例: https://<本体のシステム IP アドレス>: 11443/)。
b. セキュリティ証明書のエラーは無視します。 Web ページに進みます。
c. 左側のメニューで、[Network] タブを選択します。
デスクトップにエクスポートした Fiddler ルート証明書に移動します。
Fiddler を実行している開発用 PC の IP アドレスまたはホスト名を入力します。 開発用 PC のホスト名を使用している場合は、構成したドメイン名のサフィックスを含む完全修飾ドメイン名である必要があります。
Fiddler がリッスンしているポート番号を入力します。 既定では、Fiddler はポート 8888 を使用します。
[有効にする] を選択します。 これで開発キットが再起動します。
Fiddler をインターネットへのプロキシとして使用する (Fiddler で開発キットのすべてのネットワーク トラフィックをトレースする) ことを停止するには
- Xbox Device Portal UI の [ネットワーク] ツールに移動します。
- [Disable] を選択します。 これで開発キットが再起動します。
いくつかの追加手順を使用して、Fiddler がタイトル トラフィックをキャプチャできることを確認します。 詳細については、「WinHTTP のデバッグ」を参照してください。
Fiddler から Microsoft Store のエンドポイントを除外する
Microsoft Store でのダウンロードは、Secure Sockets Layer (SSL) 傍受が検出され、Fiddler を使用して HTTPS トラフィックを暗号化すると失敗します。 これらのエンドポイントは、タイトルの分析には不要であるため、以下の手順で Fiddler から除外することもできます。
- Fiddlerで、[ツール]>[Fiddler オプション]>[接続] を選択します。
-
assets1.xboxlive.com;fe3.delivery.mp.microsoft.com;sls.update.microsoft.com
ホストを [Bypass Fiddler for URLs that start with] リストに追加します。 - 変更の確認が取れたら Fiddler を再起動します。