> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Partner Center での Web サービスの設定
> Partner Center で発行元 Web サービスを作成および構成し、XBOX Live SSO、証明書利用者の設定、サービス間呼び出しアクセスを可能にします。
このトピックは Managed Partners のみを対象としており、Web サービス構成に課される制限のため、Creators Program は対象外です。これは、Relying Parties アカウント レベルの権限が付与されている開発者のみが利用できます。アカウント レベルの権限を管理していない場合は、開発者アカウント マネージャー (DAM) にお問い合わせください。
発行元は、自社のアプリ/タイトルが XBOX services と対話する方法をカスタマイズしたい場合に Web サービスを作成できます。
Web サービスは発行元レベルの構成であり、シングル サインオン (SSO) を構成することで、発行元が所有するサンドボックス内の任意のタイトルから呼び出すことができます。
Web サービスを定義する理由:
1. **XBOX ユーザーへの SSO の提供:** Web サービスが XBOX ユーザーに SSO を提供するには、XBOX services の証明書利用者として構成する必要があります。このように構成すると、XBOX services で認証されているユーザーは、別の資格情報のセットを入力することなく、自動的にサービスでも認証されます。
2. **サービスから XBOX services へのサービス間呼び出し:** タイトルが Web サービスのいずれかを使用して、直接または個々のユーザーの代理として XBOX services に呼び出しを行う場合、ビジネス パートナー証明書が必要になります。
## Web サービスの作成
1. [Partner Center Dashboard](https://partner.microsoft.com/dashboard/windows/overview) に移動します。
2. **Apps and Games** セクションを選択します。
3. 左側のナビゲーション ウィンドウから、**XBOX services** > **Web services** の順に選択します。
4. **Web Services** ページで **New Web Service** を選択します。
5. Web サービス名を入力し、必要に応じてアクセスの種類を選択します。
* **Telemetry access** を有効にすると、任意のゲームのゲーム テレメトリ データをサービスで取得できます。
* **App Channel access** を選択すると、サービスを所有するメディア プロバイダーに、コンソールで使用するアプリ チャネルをプログラムで発行する権限が付与されます。
6. **Save** を選択します。
この時点で、サービスを定義したので、XBOX services はサービスの存在を認識しています。
Web サービスを作成した理由に応じて、証明書利用者 (SSO) またはビジネス パートナー証明書 (サービス間呼び出し) の構成が必要になります。
## Partner Center での NSAL、XSTS トークン定義、証明書利用者の構成
タイトルが XSTS トークンを使用して Web サービスと通信する前に、Partner Center で Web サービスを定義し、証明書利用者を作成し、サンドボックス内の XBOX services 構成を通じてタイトルのネットワーク セキュリティ アクセス リスト (NSAL) を公開する必要があります。
### Web サービス、証明書利用者、XSTS トークン クレームの定義
1. Partner Center で **Apps and games** セクションを選択します。
2. 左側のナビゲーション メニューから、**XBOX services** > **Relying parties** の順に選択します。
3. **Relying Parties** ページで **New Relying Party** を選択します。
4. Audience URI\* を指定します。
5. トークンで使用する暗号化タイプを選択します\*\*。
6. 次のセクションの手順に従って非対称の証明書利用者証明書を作成します。次に、公開 .cer ファイルをエクスポートしてアップロードします。識別しやすいように、.cer ファイルには証明書利用者に関連する名前を付けてください。
7. トークンの有効期間 (時間単位) を入力します (4 時間を推奨します)。
8. 必要なトークン クレームをトークン定義に追加します。
9. **Save** を選択します。
> \*Audience URI はホスト URI の形式である必要があります。ただし、名前は実際のサービスの URI と異なっていてもかまいません。たとえば、`Example.com` を証明書利用者の Audience URI にすることができますが、実際のサービス エンドポイントは `https://game.example.com/action/` です。
> \*\*非対称暗号化には `JWE RFC 7516` オプションの使用を推奨します。`JWE Draft 7` レガシー オプションは、以前のタイトルとの下位互換性のためのものです。
### 新しい証明書利用者証明書の作成
1. コンピューターで Developer Command Prompt for Visual Studio を開きます。
2. 次のコマンドを実行します。例の名前 "Contoso" を独自のものに置き換えてください:
`makecert -sv RP_Private_Key.pvk -n "CN=Contoso Relying Party" RP_Cert.cer -b 01/01/2015 -e 12/31/2199 -sky exchange -ss My -a sha256 -len 2048 -r -pe`
3. プロンプトが表示されたら、秘密鍵のパスワードを入力します。
4. 次のコマンドを実行します。末尾のパスワードを独自のものに置き換えてください:
`PVK2PFX -pvk RP_Private_Key.pvk -spc RP_Cert.cer -pfx RP_Full_Cert.pfx -po PasswordForPFX!`
5. プロンプトが表示されたら、手順 3 で秘密鍵に設定したパスワードを入力します。
6. *RP\_Cert.cer* ファイルを使用して、Partner Center でトークン定義のセットアップを行います。
7. *RP\_Full\_Cert.pfx* ファイルをサーバーにコピーし、コンピューターの証明書ストアにインポートします。
8. 完全な証明書をインポートする際は、必要に応じて他のサーバーにエクスポートできるように、**Mark this key as exportable** オプションを選択してください。
9. この証明書の公開鍵 .cer ファイルを再エクスポートする必要がある場合は、**Certificate Export** ウィザードで **Base-64 encoded X.509 (.CER)** オプションを選択します。
### タイトルの NSAL でのサービス エンドポイントの定義
証明書利用者と XSTS トークン クレームを定義したので、XBOX services 構成の NSAL でタイトルが呼び出す URL を定義する必要があります。これにより、クライアントの `GetTokenAndSignature` API に、その URL ホストを呼び出すときに提供する XSTS トークン定義が通知されます。
1. Partner Center でタイトルの概要ページに移動します。
2. 左側のナビゲーション メニューから **XBOX services** > **Gameplay settings** を選択します。**Gameplay Setting** ページが表示されます。
3. テストするサンドボックスのタブをページ上部で確認します。
4. **XBOX services** > **Single sign-on** の順に選択します。**XBOX Live single sign-on configuration** ページが表示されます。
5. **New endpoint** を選択します。
6. タイトルが呼び出すサービスの URL ホスト アドレスを入力します。
7. 前に構成した **Relying Party** をドロップダウン リストから選択します。
8. **Save** を選択します。
9. **Gameplay Setting** ページに戻ります。
10. 更新された NSAL を公開するサンドボックスのタブを選択します。
11. 右上隅の **Publish** を選択します。
### XBOX services へのサーバー間 (Business-to-Business (B2B)) 呼び出し用のビジネス パートナー証明書の作成
1. Partner Center で **Apps and games** セクションを選択します。
2. 左側のナビゲーション メニューから、**XBOX services** > **Web services** の順に選択します。
3. **New web service** を選択します。
4. Web サービスを識別する名前を入力します。この名前は、ホスト URL でも、証明書が使用される場所を識別し管理するのに役立つ任意の文字列名でもかまいません。
5. **Save** を選択します。
6. **Web services** ページに、新しい Web サービスが表示されます。
7. 新しい Web サービスの **Generate Certificate** を選択します。
8. **Show Options** リンクを選択して、必要なキーを作成する PowerShell スクリプトを表示します。このスクリプトは任意のコンピューターで実行でき、その後、証明書を他のコンピューターにエクスポートできます。
9. コンソール ウィンドウから、ワード ラップの改行を削除し、結果として得られた文字列キー出力を **Download the CSP Certificate** の下のテキスト ボックスにコピーします。
10. **Download** を選択します。
11. **Binding the Certificate** の指示に従います。
12. 証明書のインポート後に、それに秘密鍵がバインドされていることを確認します (左上隅の **small key** アイコンで示されます)。
エンドポイント接続の SSL 証明書チェーンの指定は、自己署名証明書を使用する場合にのみ必要です。既知の認証局に基づく公開 SSL 証明書は、構成なしで有効です。
自己署名証明書は開発シナリオでのみ使用でき、運用サービスでは禁止されています。
## ビジネス パートナー証明書の構成
タイトルが Web サービスのいずれかを使用して、直接または個々のユーザーの代理として XBOX services に呼び出しを行う場合、ビジネス パートナー証明書が必要になります。
### ビジネス パートナー証明書の生成
Web サービスを正常に作成した後に、次の手順を使用します。
1. **Web Services** ページで、ビジネス パートナー証明書を関連付ける Web サービスを見つけます。
2. 選択した Web サービスの **Generate Certificate** リンクを選択します。
3. **Generating a New Certificate** の横の **Show Options** を選択します。管理者権限で PowerShell から実行するコマンドが表示されます。
4. すべてのコマンドを次々に実行すると、Base64 でエンコードされた blob が正常に得られます。これが公開鍵です。PowerShell から公開鍵をコピーし、構成サービス プロバイダー (CSP) blob のプレースホルダーに貼り付けます。
5. **Download** を選択し、次にページの **Binding the certificates** の指示に従います。
1. 公開鍵の生成に使用したのと同じコンピューターを使用します。
2. PowerShell で次のコマンドを実行します: `mmc.exe`
3. **File** を選択し、次に **Add/Remove Snap In** を選択します。
4. **Certificates** を選択し、次に **Add** を選択します。証明書スナップインで **Computer Account** を必ず選択してください。**Finish** を選択し、次に **OK** を選択します。
5. Personal\Certificate ストアを開きます。
6. **Certificates** を右クリックし、次に **All Tasks** を選択します。**Import** を選択します。
7. Partner Center からダウンロードした証明書を選択します。
8. インポート後に UI で証明書を右クリックします。**All Tasks** を選択し、次に **Export** を選択します。
9. **Export** ウィザードに従います。証明書と共に秘密鍵をエクスポートすることを必ず選択してください。
10. **Export** ウィザードを完了します。
## Related topics
- [Web サービス](/ja-jp/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/web-services/live-web-services-nav.md)
- [証明書利用者の構成](/ja-jp/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/relying-parties/live-relying-parties-nav.md)
- [XBOX サービスの構成](/ja-jp/publishing/game-publishing/concepts/xbox-services.md)
- [Partner Center でのアクセスポリシーの構成](/ja-jp/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/access-policies/config/live-access-policies-udc.md)
- [ポータル構成の概要](/ja-jp/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)