[JWT] Silent authentication

Xsolla Developers

또는

관리자 페이지로

[JWT] Silent authentication Client-side

get/social/{cross_social_provider_name}/cross_auth

Steam, Xbox, Epic Games의 사용자 JWT를 프로젝트의 JWT(projectId)로 교환합니다.

사용자를 프로젝트로 리디렉션하는 링크를 받게 됩니다.

묵음인증을 활성화하려면 지침을 사용하여 진행합니다.

Request

path Parameters

cross_social_provider_name

required

string

사용자가 인증한 플랫폼의 이름입니다. steam, xbox, epicgames일 수 있습니다.

query Parameters

projectId required	string <uuid> 게시자 계정의 로그인 프로젝트 ID입니다.
login_url	string URL to redirect the user to after account confirmation, successful authentication, two-factor authentication configuration, or password reset confirmation. Must be identical to the Callback URL specified in the URL block of Publisher Account. For the scenario of a login error, the value should be identical to the the Error callback URL specified in the URL block of Publisher Account. To find the settings, go to Login > your Login project and select the Callback URLs section in the upper block. Required if there are several Callback URLs.
fields	Array of strings non-empty 사용자 또는 소셜 네트워크에서 추가로 요청하고 JWT에 작성해야 하는 매개변수 목록입니다. 매개변수는 쉼표로 구분해야 합니다. `email`이 대표적인 예입니다. `email`이 요청된 상태이며 소셜 네트워크가 `email` 값에 응답하지 않는 경우: 로그인 위젯을 통합한 경우 사용자에게 해당 양식으로 이메일을 입력하라는 메시지가 표시됩니다. 로그인 API를 통합한 경우 사용자는 자신의 인터페이스에 해당하는 양식으로 이메일을 입력해야 합니다. 이 양식의 URL을 고객 성공 매니저에게 전송해야 합니다. 이메일을 입력한 후 사용자는 이메일 확인 메시지를 받습니다. 이메일 확인을 비활성화하려면 고객 성공 매니저에게 문의해야 합니다.
session_ticket	string Session ticket received from the platform encoded according to the Base64 standard.
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'은 기존 값을 활성화 상태로 유지합니다.
app_id	string Your app ID on the platform. Required if the platform where the user is authorized is Steam.
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
deployment_id	string The deployment ID that the client is trying to authenticate with. This will impact interactions with other services that require a deployment. If the deployment is not public, only users who have been entitled will be able to log in. For more information on deployments and deployment IDs see Product, Sandbox, and Deployment IDs. Note: You must use this unique identifier to use the Ecommerce APIs, and to request access tokens used by game clients.

Responses

200

확인

302

리디렉션

400

잘못된 요청

404

찾을 수 없음

422

처리할 수 없는 엔터티

429

요청이 너무 많음

Request samples

curl --request GET \
  --url 'https://login.xsolla.com/api/social/{cross_social_provider_name}/cross_auth?projectId=SOME_STRING_VALUE&login_url=SOME_STRING_VALUE&fields=SOME_ARRAY_VALUE&session_ticket=SOME_STRING_VALUE&payload=SOME_STRING_VALUE&with_logout=0&app_id=SOME_STRING_VALUE&code=SOME_STRING_VALUE&is_redirect=true&no_user_creation=false&deployment_id=SOME_STRING_VALUE'

Response samples

application/json

{"login_url": "string"
}