Fiddler を使用した Web サービス呼び出しの検査
Fiddler は、デバイスとインターネットの間のすべての HTTP および HTTPS トラフィックをログに記録する Web デバッグ プロキシです。 Fiddler を使用して Xbox Live サービスと証明書利用者 Web サービスとの間のトラフィックをログに記録して検査することで、Web サービス呼び出しを把握してデバッグします。 Fiddler は複数のバージョンで使用できます。 「Fiddler Classic」はフリーウェアです。次のセクションでは、このバージョンのみを参照しています。
Xbox One 以降で実行されている Microsoft Game Development Kit (GDK) プロジェクトの場合
詳細については、「Fiddler」を参照してください。
Xbox One (またはそれ以降) の Xbox Oneソフトウェア開発キット プロジェクトの場合
通常の操作では、プロキシ経由で通信するコンソールは、プロキシによって通信内容が変更されるリスクがあり、プレイヤーによる不適切な行為が発生する可能性があります。 そのため、コンソールはプロキシ経由の通信を許可しないように設計されています。 Xbox One (またはそれ以降) 開発機で Fiddler を使うには、Fiddler プロキシの使用を許可するように、開発機で特別な構成手順を実行する必要があります。
Fiddler Classic は Fiddler の Web サイトからダウンロードできます。
Fiddler は、コンソールで報告されるネットワーク ステータスに影響を与える場合があります。 Fiddler を実行しているコンピューターからのアップストリーム接続が無効になっている場合、コンソールの認証の有効期限が切れるまで、コンソールでこの切断が検出されない可能性があります。 Fiddler を使っている場合、Fiddler を使って切断をシミュレートするのではなく、必ずコンソールと Fiddler を実行しているコンピューターとの接続を切断してください。 もっと良いのは、ネットワーク負荷ツールを使用して、テストのために切断をシミュレートすることです。
開発用 PC への Fiddler のインストールと有効化
Fiddler をインストールして有効化し、開発キットからのトラフィックを監視するには、以下の手順に従います。
Fiddler の Web サイトの指示に従って、Fiddler Classic を開発用 PC にインストールします。
Fiddler を起動し、[Tools] メニューの [Fiddler Options] を選択します。
[Connections] タブを選択し、[Allow remote computers to connect] チェック ボックスがオンになっていることを確認します。
[OK] をクリックして設定の変更を確認します。 ダイアログ ボックスが表示され、変更を有効にするには Fiddler を再起動する必要があり、ファイアウォールを手動で構成することが必要になる可能性があるというメッセージが表示されます。 このダイアログ ボックスで [OK] をクリックしますが、まだ Fiddler を再起動しないでください。
リモート コンピューターに接続を許可するために必要なファイアウォール規則を構成します。 Windows ファイアウォール コントロール パネル アプレットを起動します。 [詳細設定]、[受信の規則] の順にクリックします。 "FiddlerProxy" という名前の規則を探し、右にスクロールして、この規則の設定値が以下のとおりであることを確認します。
| 設定 | 推奨値 |
|---|---|
| 名前 | FiddlerProxy |
| Group | (グループの値は設定しない) |
| Profile | すべて |
| Enabled | はい |
| 操作 | 許可 |
| 優先 | いいえ |
| プログラム | fiddler.exe のパス |
| ローカル アドレス | 任意 |
| リモート アドレス | 任意 |
| プロトコル | TCP |
| ローカル ポート | 任意 |
| リモート ポート | 任意 |
| 承認されているユーザー | 任意 |
| 承認されているコンピューター | 任意 |
HTTPS トラフィックをキャプチャおよび復号化するために Fiddler を構成します。
- 最適なパフォーマンスを実現するために、ボタン バーの [Stream] ボタンをクリックして、ストリーミング モードを使用するように Fiddler を設定します。
- Fiddler で、[Tools]、[Fiddler Options]、[HTTPS] の順に選択します。
- [Decrypt HTTPS traffic] チェック ボックスをオンにします。 CA 証明書を信頼するように Windows を構成するかどうかを確認するメッセージ ボックスが表示されたら、[はい] をクリックします。
- [Export Root Certificate to Desktop] ボタンをクリックします。
Fiddler を終了し、再び起動します。
インターネットへのプロキシとして Fiddler を使用するように開発機を構成するには
開発キットでの Fiddler の構成方法は、以前のリリースで使用されていたものよりも簡素化されています。
デスクトップにエクスポートした Fiddler ルート証明書を、開発キットに
xs:\Microsoft\Cert\FiddlerRoot.cerとしてコピーします。 次のコマンドを使用できます:xbcp [local Fiddler Root directory]\FiddlerRoot.cer xs:\Microsoft\Cert\FiddlerRoot.cerProxyAddress.txtという名前のテキスト ファイルを作成し、そのファイルに、Fiddler を実行する開発用 PC の IP アドレスまたはホスト名と、Fiddler が唯一のコンテンツとしてリッスンするポート番号を記述します。 ホスト名または IP アドレスとポートは "HOST:PORT" の書式にします (既定では、Fiddler はポート 8888 を使用)。たとえば、"10.124.220.250:8888" や "my_dev_pc.contoso.com:8888" などです。そのファイルを開発キットに
xs:\Microsoft\Fiddler\ProxyAddress.txtとしてコピーします。 それを行うには、次のコマンドを使用します:xbcp [local Proxy Address file directory]\ProxyAddress.txt xs:\Microsoft\Fiddler\ProxyAddress.txtコマンド プロンプトで「
xbreboot」と入力して開発キットを再起動します。
Fiddler の使用を停止するには
Fiddler をインターネットへのプロキシとして使用して Fiddler で開発キットのすべてのネットワーク トラフィックをトレースすることを停止するには、開発キット上の FiddlerRoot.cer ファイルの名前を変更するか、または削除して、開発キットを再起動するだけです。
しくみ
起動時に xs:\Microsoft\Cert\FiddlerRoot.cer ファイルおよび xs:\Microsoft\Fiddler\ProxyAddress.txt ファイルの両方が存在している場合、開発キットは ProxyAddress.txt で指定されたプロキシ サーバーを使用するように自動的に構成されます。
どちらかのファイルが存在しない場合、開発キットは Fiddler プロキシ経由で動作するように構成されません。
Fiddler がインストールされている各 PC では、異なる Fiddler ルート証明書を使用します。
開発キットに Fiddler プロキシを提供するために使用できる PC が複数ある場合は、各 PC の Fiddler ルート証明書を xs:\Microsoft\Cert ディレクトリにコピーすることができます。ただし、それらのうちの 1 つが FiddlerRoot.cer という名前である必要があります。
Fiddler プロキシが認証されるときに、Cert ディレクトリ内のすべての証明書がチェックされます。
ProxyAddress.txt に含まれるどの PC のアドレスの Fiddler インスタンスでも、その証明書が Cert ディレクトリ内に存在していれば、プロキシとして使用されます。
Xbox One (またはそれ以降) 向け UWP プロジェクト
UWP ドキュメントにある 「UWP について開発するときに、Xbox One で Fiddler を使用する方法 ⬀」 に記載の手順に従います。
Windows UWP PC アプリの場合
現在のユーザーが、PC の Administrator グループのメンバーであることを確認します。
https://www.telerik.com/fiddler から Fiddler をダウンロードします。
".NET 4 用に作成された" バージョンが選択されていることを確認します。
インストールが済んだら、[Tools] -> [Fiddler Options] で、[Capture HTTPS CONNECTs] と [Decrypt HTTPS traffic] を有効にします。 ランタイムと Xbox サービスの間の通信はすべて、SSL で暗号化されます。 このオプションがなければ、役に立たない場合があります。 Fiddler のすべてのポップアップ ダイアログを受け入れます (UAC を含めて 5 個のダイアログが表示されるはずです)。
[WinConfig]、[すべて除外]、および [変更の保存] を参照してください。 それ以外の場合、Fiddler は、ストア アプリでは動作しません。
アプリを実行すると、アプリ、ランタイム、Xbox サービスの間の要求/応答が表示されます。
通常は必要ないが、サインインおよびゲーム内イベントのデバッグ時に役立つ UWP OS レベルの呼び出しをデバッグするには、WinHTTP トラフィックをキャプチャするように Fiddler を構成する必要があります。 これは、次の方法で行います。
netsh winhttp set proxy 127.0.0.1:8888 "<-loopback>"
ここで、ポート 8888 は Fiddler の [ツール] | [オプション] | [接続] タブで構成したポートに一致します (既定値は 8888)。
それを取り消すには、次の手順に従います。
netsh winhttp reset proxy