> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# X-Token または OAuth 2.0 を使用したサービスからのユーザー Store ID の要求

> 認証のためにゲーム クライアントを介してトークンを交換せずに、OAuth 2.0 または XBOX X-Token (XSTS) を使用してサービス上でユーザー Store ID を生成します。

この記事では、ゲーム クライアントを通じてアクセス トークンとキーを交換せずに、サービスが直接ユーザー Store ID を生成する方法について説明します。このアプローチは次の場合に役立ちます。

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

ユーザー Store ID の一般的な情報については、[サービス間認証用のユーザー Store ID を要求する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-requesting-userstoreid.md)を参照してください。

## X-Token の要件

このプロセスでは、ユーザー Store ID が表すユーザーを識別するために Delegated Auth X-Token の使用が必要です。

Delegated Auth X-Token とその作成方法の詳細については、「Title service calls to XBOX services」のドキュメントを参照してください。

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

サービスが OAuth を使用してユーザーが Microsoft アカウント (MSA) でサインインする場合、以下が必要です。

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

サービスで OAuth を使用した XBOX services サインインの詳細については、「XBOX services sign-in for title websites」のドキュメントを参照してください。

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

OAuth では、ユーザーの同意を取得し、証明書利用者に対して OAuth 資格情報を X-Token と交換します。その後、[X-Token を使用する場合の手順](#steps-when-using-x-tokens)と同じフローに進みます。

OAuth 資格情報を X-Token と交換する概要フロー:

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

完全な実装の詳細については、「XBOX services sign-in for title websites」のドキュメントを参照してください。

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

証明書利用者向けにユーザーを識別する X-Token を取得したら、その `DelegationToken` クレームを使用して Delegated Auth X-Token を作成します。最初の X-Token は、ゲーム クライアントまたは OAuth 2.0 フローのいずれかから取得できます。

Delegated Auth X-Token を作成する概要フロー:

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

Delegated Auth X-Token の作成方法の完全な実装の詳細については、「Title service calls to XBOX services」のドキュメントを参照してください。

手順 3 で使用する証明書利用者は、ユーザーの User Collections ID を生成するか User Purchase ID を生成するかによって異なります。

| ユーザー Store ID の種類 | Delegated Auth X-Token の証明書利用者 | ユーザー Store ID を作成する URI |
| - | - | - |
| User Collections ID (`UserCollectionsId`) | `http://licensing.xboxlive.com` | `https://collections.mp.microsoft.com/v7.0/beneficiaries/me/keys` |
| User Purchase ID (`UserPurchaseId`) | `http://mp.microsoft.com/` | `https://purchase.mp.microsoft.com/v7.0/users/me/keys` |

## リクエスト

Delegated Auth X-Token を取得したら、呼び出すサービスに対応する URI を使用してユーザー Store ID を要求します。

### リクエスト構文

| メソッド | リクエスト URI |
| - | - |
| `POST` | `collections.mp.microsoft.com/v7.0/beneficiaries/me/keys` |
| `POST` | `purchase.mp.microsoft.com/v7.0/users/me/keys` |

### リクエスト ヘッダー

| ヘッダー | 型 | 説明 |
| - | - | - |
| `Authorization` | `string` | 必須。`XBL3.0 x=[User Hash];[Token]` 形式の Delegated Auth X-Token。 |
| `Host` | `string` | 呼び出す URI のホストと一致する必要があります。 |
| `Content-Length` | `number` | リクエスト本文の長さ。 |
| `Content-Type` | `string` | リクエストとレスポンスの型を指定します。現在サポートされている値は `application/json` のみです。 |

### リクエスト本文

| パラメーター | 型 | 説明 | 必須 |
| - | - | - | - |
| `serviceTicket` | `string` | 呼び出している URI に基づく、サービスの Collections アクセス トークンまたは Purchase アクセス トークン。これらのアクセス トークンの作成については、[異なるアクセス トークンとオーディエンス URI について](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-requesting-userstoreid.md#understanding-the-different-access-tokens-and-audience-uris)を参照してください。 | はい |
| `publisherUserId` | `string` | 独自の追跡のためにユーザー Store ID に記録される任意の値。 | いいえ |

### リクエストの例

```html theme={null}
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"
}
```

## レスポンス

### レスポンス本文

| パラメーター | 型 | 説明 | 必須 |
| - | - | - | - |
| `key` | `string` | Microsoft Store サービスとのサービス間認証に使用できるユーザー Store ID。 | はい |

### レスポンスの例

```html theme={null}
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..."}
```

## 関連項目

[サービスから製品を管理する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-authenticating-service.md)

[Microsoft Store API を使用したサービスの認証](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-authenticating-service.md)

Title service calls to XBOX services

XBOX services sign-in for title websites

[ユーザー Store ID キーを更新する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-renew-userstoreid.md)

[Microsoft.StoreServices ライブラリ](https://github.com/microsoft/Microsoft-Store-Services)

[Microsoft.StoreServices サンプル](https://github.com/microsoft/Microsoft-Store-Services-Sample)


## Related topics

- [サービス間認証用のユーザー Store ID を要求する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-requesting-userstoreid.md)
- [ユーザー Store ID キーを更新する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-renew-userstoreid.md)
- [サービスから消費型製品を管理する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-managing-consumables.md)
- [Microsoft Store API を使用してサービスを認証する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-authenticating-service.md)
- [マルチプレイヤー アクティビティ URI](https://docs.xbox.com/ja-jp/reference/live/rest/uri/multiplayeractivity/atoc-reference-multiplayer-activity.md)