サイレント認証

どのように動作するか

サイレント認証は、パブリッシングプラットフォームを経由して、ゲーム内のユーザーを自動的に認証することができます。現在、Steam、Xbox Live、Epic Gamesの各プラットフォームに対応しています。StoneまたはMail.ruプラットフォームに関するサポートが必要な場合は、カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。

相互作用のフロー：

1. ユーザーがゲームを起動します。
2. ゲームはプラットフォームSDKを通じてプラットフォームの認証データを受け取ります。
3. ゲームはJWTを取得するためにエクソーラログインサーバーにリクエストを生成して送信します。
4. エクソーラログインサーバーはユーザーを認証し、JWTを送信します。

使用に適した方

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

入手方法

1. アドミンページでサイレント認証を設定します。
2. アプリケーション側で統合のステップを完了します。

サイレント認証のセットアップ

ログイン製品では、サイレント認証を有効にするために2つのアプローチが実装されています：

• クラシックログインオプションの構成（以下の手順を参照してください）；
• シャドウログインプロジェクトの作成（シャドウログインプロジェクトの設定方法を参照してください）。

1. アドミンページでプロジェクトを開き、「ログイン」セクションに移動します。
2. クラシックログインオプションのパネルで「構成する」をクリックします。
3. 「認証」ブロックに移動し、「パブリッシングプラットフォーム」セクションを選択します。

4. パブリッシングプラットフォームを接続するには、その名前の横にある⚙アイコンをクリックし、設定を選択します。

5. モーダルウィンドウで、選択したプラットフォームのパラメータを指定します：
   • Steam:
     • アプリケーションID — プラットフォーム上のアカウントのAppID；
     • アプリケーションの秘密鍵 — Web API キー。
   • Epic Games：
     • アプリケーションID — プラットフォーム上のゲームのクライアントのクライアントID；
     • アプリケーションの秘密鍵 — プラットフォーム上のゲームのクライアントの秘密鍵；
   • Xbox Live：
     • アプリケーションID — プラットフォーム上のゲームのアプリケーションID/クライアントID；
     • アプリケーションの秘密鍵 — ゲームがプラットフォームに登録されたときに生成されたアプリケーションシークレット。

6. 接続するをクリックします。
7. 必要に応じて、他のパブリッシングプラットフォームでも手順4～6を繰り返します。

アプリケーション側の統合

アプリケーションをホストするパブリッシングプラットフォームの手順を使用します：

• Steam
• Xbox Live
• Epic Games

Steam

1. セッションチケットを取得します。
2. それをsession_ticketパラメータとしてサイレント認証リクエスト(JWTまたはOAuth 2.0)に渡します。

Xbox Live

1. ユーザー認証後のプラットフォームデータに基づいてセッションチケット(session_ticketパラメータ)を形成します。パラメータは、以下にある<xid>-<uhs>;<XSTSToken>テンプレートに基づいて形成されます：
   • <xid> — Xbox User ID；
   • <uhs> — user hash；
   • <XSTSToken> — Xbox Secure Token Service。
2. session_ticketパラメータをサイレント認証リクエスト(JWTまたはOAuth 2.0)にを渡します。

Epic Games

1. ユーザー認証後に生成されるプラットフォームからのexchangecode認証コードを取得します。
2. 受け取ったexchangecodeをsession_ticketパラメータとしてサイレント認証リクエスト（JWTまたはOAuth 2.0）に渡します。