Xsolla-logo
  • 문서화
  • 계정 생성

암묵인증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"
}