シングルサインオン

どのように動作するか

ユーザー認証用の共通の単一アカウントを持つ複数の接続済みサービスがある場合は、シングルサインオンを使用できます。ゲームのウェブサイトはサービスとして機能します。これにより、ユーザーは資格情報を一度だけ入力できます。その後、接続されているサービスの1つを開くと、ユーザーは既に認証されています。

統合フロー

1. 認証されていないユーザーがサービスの1つを開きます。
2. あなたのクライアントはCheck user authenticationリクエストをエクソーラログインサーバーへ送信して、エラー401が発生します。
3. クライアントは、ユーザーの認証フォーム（ログインウィジェットまたはログインUI）を開きます。
4. ユーザーは、ユーザー名とパスワードまたはソーシャルネットワークを介して認証されます。

5. クライアントは、ログインプロジェクトでユーザーを認証します：
   • APIコールを介してログインを統合する場合、次のリクエストが使用されます：
     • ユーザー名とパスワードによる認証（JWTとOAuth 2.0）。
     • ソーシャルネットワークによる認証（JWTとOAuth 2.0）。
   • OAuth 2.0プロトコルは、ウィジェットを介してログインを統合するときに使用されます。
   ユーザーセッションデータはエクソーラログインサーバーに保存されます。サーバーは、クエリパラメータのcodeがあるredirect_uriを含むlogin_uriを送信します。

6. あなたのクライアントがユーザーをredirect_uriにリダイレクトします。
7. サーバーはGenerate JWTリクエストを送信して、受信したcodeをJWTと交換します。ユーザーはサービスで認証されます。
8. ユーザーが別のサービスを開きます。
9. クライアントはCheck user authenticationリクエストをエクソーラログインに送信し、クエリパラメータのcodeがあるredirect_uriを含むlogin_uriを受け取ります。
10. サーバーはGenerate JWTリクエストを送信して、受信したcodeをJWTと交換します。ユーザーは第二サービスで認証されます。

さまざまのサービスのアクセス権を区別する

使用に適した方

ログインを統合し、エクソーラ、FirebaseまたはPlayFabデータベースを使用しているパートナー。

入手方法

シングルサインオンを接続するには：

1. OAuth 2.0プロトコルを接続する。
2. ユーザーセッションリクエストの取得コールバックを実装する。

OAuth 2.0プロトコルを接続する

ユーザーセッションを取得するための呼び出しリクエスト

サービスを開くときにCheck user authenticationリクエストコールバックを実装します。リクエストは、ユーザーの認証フォームを開く前に実行する必要があります。認証には、ユーザーが認証する正確なサービスのOAuth 2.0クライアントパラメータを使用します。

リクエストの例：

GET https://login.xsolla.com/api/oauth2/sso?client_id=<client_id>&redirect_uri=<redirect_uri>&scope=<scope>&state=<state>&response_type=code HTTP/1.1

curl --request GET \
  --url 'https://login.xsolla.com/api/oauth2/sso?redirect_uri=redirect_uri&response_type=code&state=state&scope=scope&client_id=client_id'

ユーザー認証時の応答例：

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

{
  "login_url": "<redirect_uri>?code=<code>"
}

ユーザーJWTを取得するには：

1. クライアントは、受信したredirect_uriにユーザーをリダイレクトするリクエストを実装して使用します。
2. サーバーは、受信したcodeとgrant_type=authorization_codeを使用してGenerate JWTリクエストを送信して、JWTを取得します。

ユーザーが認証されていない場合の応答例：

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
  "error": {
    "code": "003-040",
    "description": "User is unauthorized."
  }
}