クロスプラットフォームアカウント

どのように動作するか

用語集

アドミンページで次のログインプロジェクトタイプにアクセスできます：

• 標準ログインプロジェクトはメインアカウントを保存するために使用されるログインプロジェクトです。
• シャドウログインプロジェクトはプラットフォームアカウントを格納するために使用されるログインプロジェクトです。

メインアカウントは標準のログインプロジェクトで作成され、プラットフォームアカウントにリンクされているアカウントタイプです。メインアカウントは、異なるプラットフォームでプレーヤーを識別するために使用されます。

プラットフォームアカウントはシャドウログインプロジェクトで作成され、明確な公開プラットフォームに接続されているアカウントタイプです。プラットフォームアカウントを別のプラットフォームアカウントにリンクすることはできません。また、メインアカウントからアカウントのリンクを解除することもできません。

パブリッシングプラットフォームは、ゲーム配信に使用されるゲームプラットフォーム（Steam、PlayStation、Xboxなど）です。

クロスプラットフォームアカウントは、メインアカウントとプラットフォームアカウントがリンクしているアカウントです。

明確なプラットフォームでゲームを行うすべてのユーザーアカウントは、シャドウログインプロジェクトのプラットフォームアカウントに対応している必要があります。たとえば、ユーザーがXboxおよびPlayStationプラットフォームで所有するゲームのアカウントを持っている場合、シャドウログインプロジェクトプラットフォームアカウントは、対応するXboxおよびPlayStationプラットフォームアカウントにリンクする必要があります。

クロスプラットフォームアカウントを使用する

クロスプラットフォームアカウントでは、次のことができます：

• 異なるプラットフォームで1つのゲームアカウントを持っている
• プラットフォームアカウントからソーシャルアカウントの友達リストを取得する

メインアカウントとプラットフォームアカウントがリンクされている場合：

1. ユーザーはプラットフォームで認証します。
2. エクソーラログインサーバーはメインアカウントトークンをユーザーに送信します。
3. エクソーラログインサーバーはメインアカウントユーザーを認証します。

クロスプラットフォームアカウントを使用する場合、トークン内のユーザーIDはメインアカウントIDと同じになります。JWT>subクレームでユーザーIDが見つかります。

アカウントリンキングフロー

1. プレーヤーは初めてゲームコンソールプラットフォームでゲームに参加します。
2. ゲームUIには、プラットフォームアカウントをメインアカウントにリンクすることを提案するメッセージが表示されます。
3. ユーザーがアプリケーションを起動し、メインアカウントを入力します。
4. アプリケーションは、Create code for linking accountsリクエストをエクソーラログインサーバーに送信します。
5. アプリケーションUIは、アカウントをリンクするためのコードをユーザーに表示します。
6. ユーザーはゲームのコンソールバージョンに戻り、コードを入力します。
7. ゲームサーバーは、Link accounts by codeリクエストをエクソーラログインサーバーに送信します。
8. ゲームコンソールに確認メッセージが表示されます。

使用に適した方

ログインを統合済みで、公開プラットフォームアカウントを持っているパートナー。

入手方法

クロスプラットフォームアカウントを統合するには、アドミンページの次のパラメーターが必要です：

• main_project_id-UUID形式の標準ログインプロジェクトのID。例えば：f6c5011a-715e-4e5e-b7b1-a4812d85b8c8。
• shadow_project_id-UUID形式のシャドウログインプロジェクトのID。このプロジェクトはシャドウログインプロジェクトとして使用されます。シャドウログインプロジェクトを作成し、ログインプロジェクト設定でそのプロジェクトにpublisher_project_idを指定します。shadow_project_idは作成されたプロジェクトのID。
• publisher_project_id-プロジェクトのID。パラメータは、プロジェクト設定> 一般設定> プロジェクトIDに表示されます。

shadow_project_idを送信し、publisher_project_idパラメータをカスタマーサクセスマネージャーに送信して、次のOAuth 2.0クライアントパラメータを取得します：

• client_id-OAuth 2.0クライアントID
• client_secret-OAuth 2.0クライアント秘密鍵

クロスプラットフォームアカウントを統合するアルゴリズムは次のとおりです：

1. 次のユーザー認証を実装します：
   1. メインアカウント
   2. プラットフォームアカウント
2. アカウントをリンクします：
   1. リンク用のコードを取得する
   2. アカウントをリンクする

メインアカウントでのユーザーを認証する

プラットフォームアカウントでのユーザーを認証する

Custom ID経由の認証

プラットフォームアカウントを作成するには、ゲームサーバーでAuth by custom IDコールを使用します。このコールに次のデータを渡します：

• publisher_project_idまたはshadow_project_idパラメータ（それらが渡されない場合、エクソーラログインサーバーはエラーを返します）
• サーバートークン
• social_profileパラメータのユーザープラットフォームアカウント情報

この認証コールを使用すると、異なるプラットフォームからユーザーの友達のリストを取得できなくなります。認証に使用できるプラットフォームのリストは制限されていません。

認証フロー：

1. ユーザーがゲームを起動すると、ゲームクライアントは認証リクエストをゲームサーバーに送信します。
2. ゲームサーバーは、既存のユーザーcustom IDを生成または使用します。
3. ゲームサーバーは、Auth by custom IDリクエストをエクソーラログインサーバーに送信し、プラットフォームとその上のユーザー識別子（パラメータplatformとuser_id）を指定します。渡されたカスタムIDを持つユーザーが見つからない場合、新しいユーザーが作成されます。
4. エクソーラログインサーバーは、ゲームサーバーにトークンを送信します。

リクエストの例：

POST https://login.xsolla.com/api/users/login/server_custom_id?publisher_project_id=<publisher_project_id> HTTP/1.1
X-Server-Authorization: <server_token>
Content-Type: application/json

{
  "server_custom_id": "secret_value",
  "social_profile": {
    "platform": "xbox",
    "user_id": "123"
  }
}

curl --request POST \
  --url 'https://login.xsolla.com/api/users/login/server_custom_id?publisher_project_id=publisher_project_id' \
  --header 'content-type: application/json' \
  --header 'x-server-authorization: server_token' \
  --data '{"server_custom_id":"secret_value","social_profile":{"platform":"xbox","user_id":"123"}}'

応答の例：

HTTP/1.1 200 OK
Content-Type: application/json

{
  "token": "<platform_user_token>"
}

サイレント認証

リンキングコードを取得する

リンキングコードを取得するには：

1. Create code for linking accountsコールを利用する。メインアカウントで認証中に受け取ったユーザートークンをこのコールに渡します。
2. 受け取ったコードをユーザーに表示します。

リクエストの例：

POST https://login.xsolla.com/api/users/account/code HTTP/1.1
Authorization: Bearer <main_user_token>

curl --request POST \
  --url https://login.xsolla.com/api/users/account/code \
  --header 'authorization: main_user_token'

応答の例：

HTTP/1.1 200 OK
Content-Type: application/json

{
  "code": "123456"
}

アカウントをリンクする

Link accounts by codeコールを使用して、プラットフォームアカウントをメインアカウントにリンクします。codeパラメータに、ユーザーがコンソールプラットフォームで入力したリンキングコード値をこのコールに渡します。

リクエストの例：

POST https://login.xsolla.com/api/users/account/link HTTP/1.1
X-Server-Authorization: <server_token>
Content-Type: application/json

{
  "code": "123456",
  "platform": "xbox",
  "user_id": "123",
  "publisher_project_id": 44056
}

curl --request POST \
  --url https://login.xsolla.com/api/users/account/link \
  --header 'content-type: application/json' \
  --header 'x-server-authorization: server_token' \
  --data '{"code":"123456","platform":"xbox","publisher_project_id":44056,"user_id":"123"}'

応答の例：

HTTP/1.1 204 No Content