Xsolla-logo

サイレント認証

get/social/{cross_social_provider_name}/cross_auth

Steam、Xbox、Stone、またはEpic GamesのユーザーJWTをプロジェクト(projectId)内のJWTと交換します。

ユーザーをプロジェクトにリダイレクトするためのリンクが表示されます。

サイレント認証を有効にするには、この説明をご利用ください。

Request
path Parameters
cross_social_provider_name
required
string

ユーザーが認証したプラットフォーム名。以下の値を指定できます:steamxboxepicgames

query Parameters
projectId
required
string <uuid>

パブリッシャーアカウントからのログインプロジェクトID。

login_url
string

アカウント確認、認証成功、二要素認証設定、またはパスワードリセット確認後にユーザーをリダイレクトするためのURL。パブリッシャーアカウントURLブロックに指定されているコールバックURLと同一である必要があります。これを見つけるには、ログイン > あなたのログインプロジェクトに移動して、ナビゲーションページの上部ブロックにある Callback URLs セクションを選択します。複数のコールバックURLがある場合は、必須です。

fields
Array of strings non-empty

ユーザーまたはソーシャルネットワークから追加で要求され、JWTに書き込まれる必要があるパラメータのリスト。パラメータはカンマで区切る必要があります。例えば、email

emailを要求し、ソーシャルネットワークからemail値で応答がなかった時:

  • ログインウィジェットを統合した場合、対応するフォームにメールアドレスを入力するよう要求されます。
  • Login APIを導入した場合、ユーザーには、独自のインターフェースの対応するフォームにメールアドレスを入力するよう求める必要があります。このフォームのURLをカスタマーサクセスマネージャーに送信してください。

メールアドレスが入力された後、ユーザーはメールアドレス確認メッセージを受け取ります。メール確認を無効にする場合は、カスタマーサクセスマネージャーまでお問い合わせください。

app_id
string

プラットフォームのアプリID。

payload
string

Your custom data. The value of the parameter will be returned in the payload claim of the user JWT. Recommended maximum length less than 500 characters. Note, that this parameter is only available if you use a custom user data storage.

with_logout
string
Default: "0"

既存のユーザーJWT値を非アクティブ化し、このコールによって生成されたものをアクティブ化するかどうかを示します。次の値を指定できます。

  • 1 は、既存の値を非アクティブ化し、新しい値をアクティブ化します。
  • 0 は、既存の値をアクティブ化したままにします。
session_ticket
string

プラットフォームから受け取ったセッションチケット。

code
string

プラットフォームから受け取ったコード。

is_redirect
boolean
Default: true

エクソラログインサーバーがどのように応答すべきかを示します。以下の値を設定した場合:

  • true値の場合、エクソラログインサーバーは302応答コードを返します。 ユーザーJWTを使用したユーザーリダイレクトのURLは、Locationヘッダーに含まれます。
  • false値の場合、エクソラログインサーバーは200応答コードを返します。 ユーザーJWTを使用したユーザーリダイレクトのURLは、応答の本文に含まれます。
no_user_creation
boolean
Default: false

Do not create new user if they not exist yet. Existing users will be authorized as usual

Responses
200

OK

302

リダイレクション

400

無効なリクエスト

404

見つかりません

422

処理不可能なエンティティー

429

リクエストの回数が多すぎます

Request samples
Response samples
application/json
{
  • "login_url": "string"
}