Microsoft Store API を使用してサービスを認証する

• ユーザー Store ID および Microsoft Entra ID: 認証と結果を Microsoft Store アプリにサインインしているユーザー アカウントに紐付けます。
• 委任認証 X-トークン: 認証と結果を、現在ゲームをプレイしているユーザーの XBOX services アカウントに紐付けます。

​

Microsoft Entra ID とユーザー Store ID を使用した認証

Authorization: Bearer <Entra ID access token>  

  "sbx": "XDKS.1"

  "beneficiaries": [
    {
        "identitytype" : "b2b",
        "identityValue" : "eyJ0eXAiOiJ...",
        "localTicketReference" : "testReference"
    }
  ],

• Microsoft.StoreServices (GitHub): バックエンドから Microsoft Store サービスを認証および呼び出すためのライブラリとソース。
• Microsoft.StoreServices Sample (GitHub): 認証、コマース統合、および返金の照合パターンを示すサービス サンプル。
• サービス間認証用のユーザー Store ID を要求する
• ユーザー Store ID キーを更新する
• サービスから製品エンタイトルメントを管理する

​

Microsoft Store API を呼び出す図

​

ユーザー Store ID と Microsoft Entra ID 認証を使用して製品を表示および管理するために必要な追加構成

​

Microsoft Entra ID とユーザー Store ID を使用してサービスから製品を表示できるように構成する

1. ゲームのパートナー センター ページから、左側のパネルで [製品コレクションおよび購入] を選択します。
2. サービスの認証に使用する Microsoft Entra アプリケーションのクライアント ID を入力します。
3. [保存] ボタンを選択します。
4. ゲーム製品とその配下のすべてのアドオンを、サンドボックスまたは開発者環境で Microsoft Store に再公開します。

​

委任認証 X-トークンを使用した認証

Authorization: XBL3.0 x=<user hash>;<X-token>

• Game Service Sample: クライアントからの X-トークンの検証と処理、サーバー間認証、コマース サービスなどを示す包括的な Web サービス サンプル。最新バージョンは GDK ダウンロード サイト からダウンロードしてください。All Samples の最新リリースをダウンロードします。Game Service Samples は、ダウンロードされた .zip ファイル内の samples\Live\GameService にあります。
• Xfest 2019 - XSTS Auth and Server to Server made Easy: X-トークンの概要と説明、および Game Service Sample がどのようにサービス間認証の取り組みを始めるのに役立つかを説明します。プレゼンテーション情報をダウンロードするには、アーカイブ サイトで [GDK Track Downloads] を選択します。
• XBOX services 認証およびサービス間呼び出し: 認証、X-トークン、および XBOX services へのサービス間呼び出しを行うために必要な手順と呼び出しに関する、より詳細なドキュメント。

​

委任認証 X-トークンを使用して製品を表示および管理するために必要な追加構成

​

パートナー センターで製品と Web サービスを構成するには

1. Web サービスの [Generate Certificate] リンクを使用して、ビジネス パートナー証明書を作成します。([Developer Settings] > [XBOX Live] > [Web Services] を選択します。) 証明書利用者に紐付けられている Web サービスの行のリンクを選択します。
2. ビジネス パートナー管理 UI に移動 ([Developer Settings] > [XBOX Live] > [Business Partner] を選択) し、手順 1 で使用した Web サービスと一致するビジネス パートナー ID をコピーします。(ビジネス パートナー ID の例: 12345678-9012-3456-7890-123456789012)
3. 製品の [パートナー センターの概要] ページから、[新規作成] を選択し、[製品グループ] を選択します。
4. この製品グループを Dev Studio に割り当てるか、まだ Dev Studio を持っていない場合は [新しい Dev Studio を作成] を選択します。
5. 選択した Dev Studio の ID が手順 2 のビジネス パートナー ID と一致していることを確認します。[Dev Studio ID (省略可能)] が空の場合、ビジネス パートナー ID をコピーします。このフィールドに既に使用中の値がある場合、既存のサービス間の製品マッピングを壊さないように、上書きせずに新しい Dev Studio を作成してください。
6. Dev Studio がビジネス パートナーの一致する ID で構成されたら、作成した製品グループに戻ります。[この製品グループに含まれる] リストに、ゲームとすべての製品を追加します。
7. [保存] を選択して、製品グループの作成を終了します。
8. ゲームの XBOX 設定 UI に移動し、リンクされているビジネス パートナーが手順 2 で使用したものと同じであることを確認します。
9. 製品グループ内のすべての項目を、サンドボックスまたは開発者環境で Microsoft Store に再公開します。

​

関連項目