シャドウログインプロジェクトをセットアップする方法

1. シャドウログインプロジェクトがまだ作成されていない場合は、作成します（統合ガイドのステップ1～5を参照してください）。
2. アドミンページでシャドウログインプロジェクトをセットアップします。
3. アプリケーション側でソリューションを統合します。

アドミンページでのセットアップ

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

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

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

6. 接続するをクリックします。
7. コールバックURLタブに移動して、以下のパラメータを指定します：
   • コールバックURL — ユーザーが認証、メールアドレスの確認、またはパスワードのリセットに成功した後にリダイレクトされるアプリケーション内のURLまたはパスです。有効なURLは複数指定可能です。
   • エラーコールバックURL — 認証エラーの際にユーザーがリダイレクトされるアプリケーション内のURLまたはパスです。値が指定されない場合、コールバックURLの値が使用されます。

8. 変更内容を保存するをクリックします。

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

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

• 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）に渡します。