Xsolla-logo

암묵인증

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입니다. 게시자 계정URL 블록에서 지정한 콜백 URL과 동일해야 합니다. 이를 확인하려면 로그인 > 내 로그인 프로젝트로 이동한 후 탐색 페이지의 상단 블록에서 콜백 URL 섹션을 선택합니다. 필수는 콜백 URL이 여러 개인 경우입니다.

fields
Array of strings non-empty

사용자 또는 소셜 네트워크에서 추가로 요청하고 JWT에 작성해야 하는 매개변수 목록입니다. 매개변수는 쉼표로 구분해야 합니다. email이 대표적인 예입니다.

email이 요청된 상태이며 소셜 네트워크가 email 값에 응답하지 않는 경우:

  • 로그인 위젯을 통합한 경우 사용자에게 해당 양식으로 이메일을 입력하라는 메시지가 표시됩니다.
  • 로그인 API를 통합한 경우 사용자는 자신의 인터페이스에 해당하는 양식으로 이메일을 입력해야 합니다. 이 양식의 URL을 계정 관리자에게 전송해야 합니다.

이메일을 입력한 후 사용자는 이메일 확인 메시지를 받습니다. 이메일 확인을 비활성화하려면 계정 관리자에게 문의해야 합니다.

app_id
string

플랫폼의 앱 ID입니다.

payload
string

사용자 정의 데이터입니다. 사용자 JWTpayload 클레임에서 매개변수의 값이 반환됩니다.

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이 응답 본문에 있습니다.
Responses
200

확인

302

리디렉션

400

잘못된 요청

404

찾을 수 없음

422

처리할 수 없는 엔터티

429

요청이 너무 많음

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