X-Token または OAuth 2.0 を使用したユーザー Store ID の要求

• フロー内にゲーム クライアントが存在しないエクスペリエンス
• ユーザーの XBOX アカウントを、そのユーザーの独自のサービス アカウントにリンクする
• クライアント/サービス間およびサービス間呼び出しに XBOX Security Tokens (XSTS または X-Token) 認証を既に使用しているゲームおよびサービス

​

X-Token の要件

​

ユーザー Store ID を生成するための OAuth 2.0 の要件

• OAuth 資格情報を X-Token と交換する必要があるため、ユーザーは Microsoft アカウントに紐付けられた XBOX ID を持っている必要があります。
• 要求する OAuth スコープには、このフローに対する適切なユーザー同意と必要な X-Token を取得できるように xboxlive.signin と xboxlive.offline_access の両方を含める必要があります。

​

OAuth 2.0 資格情報を使用する場合の手順

1. OAuth 2.0 認証コードを取得する
2. 認証コードを RPS トークン (Microsoft アカウント アクセス トークンとも呼ばれる) と交換する
3. RPS トークンを XBOX ユーザー トークンと交換する
4. 独自の証明書利用者に対して XBOX ユーザー トークンを X-Token と交換する
5. X-Token を使用する場合の手順で X-Token を使用する

​

X-Token を使用する場合の手順

1. ユーザーの X-Token から DelegationToken クレーム (dlt) を抽出します。
2. ビジネス パートナー証明書を使用して XSAS サービスからサービス トークンを取得します。
3. DelegationToken、サービス トークン、および対象の証明書利用者 (表を参照) を Delegated Auth X-Token と交換します。

​

リクエスト

​

リクエスト構文

​

リクエスト ヘッダー

​

リクエスト本文

​

リクエストの例

POST https://collections.mp.microsoft.com/v7.0/beneficiaries/me/keys HTTP/1.1
Authorization: XBL3.0 x=13178812777611882182;eyJ...
Content-Length: 1352
Content-Type: application/json;
Host: collections.mp.microsoft.com
 
{
    "serviceTicket": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIn...",
    "publisherUserId": "CustomPublisherUserId"
}

​

レスポンス

​

レスポンス本文

​

レスポンスの例

HTTP/1.1 200 OK
Date: Wed, 23 Mar 2022 23:06:25 GMT
Content-Type: application/json; 
Content-Length: 1716
MS-CorrelationId: dd5be303-f9a0-408a-bd01-e8c63afa721a
MS-RequestId: 0b9c8e5e-dfdd-4cf8-bfbe-93a5be3a7f48
MS-CV: rqFUH3gA+UOmTyXe.0

{"key":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjY..."}

​

関連項目