パブリッシングプラットフォーム経由のサイレント認証
サイレント認証により、ユーザーは資格情報を再度入力しなくてもアプリケーションにログインできます。このタイプの認証では、エクソーラログインサーバーは、ユーザーがアプリケーションの公開プラットフォームで提供した資格情報を使用します。
お知らせ
サイレント認証は現在、Steam、Xbox Live、Epic Gamesの各プラットフォームでサポートされています。StoneやMail.ruプラットフォームへのサポートが必要な場合は、カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。
- プラットフォーム開発者アカウントにアプリケーションを設定します。
- アドミンページでサイレント認証を設定します。
- アプリケーション側で統合手順を完了させます。
サイレント認証をセットアップ
ログイン製品では、サイレント認証を有効にするために2つのアプローチが実装されています:
- クラシックログインオプションの構成(以下の手順を参照してください);
- シャドウログインプロジェクトの作成(シャドウログインプロジェクトの設定方法を参照してください)。
お知らせ
シャドウログインプロジェクトは、ユーザーが同じアカウントで異なるプラットフォームでプレイしたり、プラットフォーム間でインベントリーを同期させるなど、クロスプラットフォームアカウントを作成するために必要なものです。シャドウログインプロジェクトは、ゲームをホストするパブリッシングプラットフォームごとに作成され、ユーザーのメインアカウントに結びつけられます。詳しくはクロスプラットフォームアカウントをご覧ください。クラシックログインのオプションでは、複数のパブリッシングプラットフォームのサイレント認証を一度に有効にすることができますが、クロスプラットフォームアカウントの作成は不可能です。ユーザーがあるプラットフォームでゲームにログインした後、別のプラットフォームでログインした場合、ログイン製品はこれらのログインを2人の異なるユーザーと見なします。
- アドミンページでプロジェクトを開き、「ログイン」セクションに移動します。
- クラシックログインオプションのパネルで「構成する」をクリックします。
- 「認証」ブロックに移動し、「パブリッシングプラットフォーム」セクションを選択します。
- パブリッシングプラットフォームを接続するには、その名前の横にある⚙アイコンをクリックし、設定を選択します。
- モーダルウィンドウで、選択したプラットフォームのパラメータを指定します:
- Steam:
- アプリケーションID — プラットフォーム上のアカウントのAppID;
- アプリケーションの秘密鍵 — Web API キー。
- Epic Games:
- アプリケーションID — プラットフォーム上のゲームのクライアントのクライアントID;
- アプリケーションの秘密鍵 — プラットフォーム上のゲームのクライアントの秘密鍵;
- Xbox Live:
- アプリケーションID — プラットフォーム上のゲームのアプリケーションID/クライアントID;
- アプリケーションの秘密鍵 — ゲームがプラットフォームに登録されたときに生成されたアプリケーションシークレット。
- Steam:
お知らせ
Xbox Liveプラットフォームでは、設定値を提供する必要はありません。エクソーラが所有するアクセスキーでXbox Liveに接続することができます。これを行うには、プラットフォーム名の右側にある⚙アイコンをクリックし、接続するを選択します。
- 接続するをクリックします。
- 必要に応じて、他のパブリッシングプラットフォームでも手順4~6を繰り返します。
アプリケーション側で統合する
- パブリッシングプラットフォームSDKをアプリケーションに統合します。
- セッションチケットの取得ロジックを実装します:
- Steamの場合、セッションチケットを入手します。
- Xbox Liveの場合、ユーザー認証後にプラットフォームデータを元にセッションチケットを形成します。パラメータは
<xid>-<uhs>;<XSTSToken>
テンプレートに基づいて形成されて、それで:<xid>
— XboxユーザーID<uhs>
— ユーザーハッシュ<XSTSToken>
— Xboxセキュアトークン サービス
- Epic Gamesの場合は、ユーザー認証後に生成され、セッションチケットとして使用される認証コード(
exchange code )をプラットフォームから取得します。
- SDKのメソッドを使用して、ユーザー認証ロジックを実装します:
SilentAuth
— 公開プラットフォームからのセッションチケットをJSON Web Token(JWT)に交換し、ユーザーを認証します。OAuthLogout
— アクティブなユーザーセッションを終了します。
SDK参照ドキュメンテーション
SDKメソッドとそのパラメータの詳細については、こちらをご覧ください。
お知らせ
Steamによるサイレント認証は、デモプロジェクトに実装されています。例として
SteamAuth.cs
クラスを使用することができます。デモプロジェクトを認証システムの初期バージョンとして使用する場合、Steam経由のサイレント認証を設定するには、Steam経由のネイティブ認証の設定方法ガイドに従って設定します。この記事は役に立ちましたか?
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。お役立ちリンク
最終更新日: 2024年1月22日誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。