Xsolla-logo

사용자 정의 ID로 인증

post/users/login/server_custom_id

특정 사용자 정의 ID로 사용자를 인증합니다. 사용자가 없으면 사용자를 생성합니다.

SecurityServer
Request
query Parameters
projectId
string <uuid>

게시자 계정의 로그인 프로젝트 ID입니다. 이 항목을 지정하지 않으면 지정한 publisher_project_id 매개변수에 섀도우 로그인을 사용하게 됩니다.

섀도우 로그인 ID는 이 호출에 전달할 필요가 없습니다.

payload
string

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

publisher_project_id
integer

요청한 게시자 계정의 프로젝트 ID입니다.

이 항목을 지정하고 project_id 매개변수를 지정하지 않으면 서비스가 project_id에 연결됩니다. project_idpublisher_project_id에 연결하려면 고객 성공 매니저에게 문의해야 합니다.

with_logout
string
Default: "0"

기존 사용자 JWT 값을 비활성화하고 이 호출로 생성한 값을 활성화할지 여부를 표시합니다. 사용 가능한 값:

  • '1'은 기존 값을 비활성화하고 새 값을 활성화합니다.
  • '0'은 기존 값을 활성화 상태로 유지합니다.
Request Body schema: application/json
server_custom_id
required
string <= 256 characters

서버에서 사용자 정의 ID를 생성합니다(엑솔라 로그인 사용자 ID가 아님). 비밀 키에 있어야 합니다.

Array of objects

옵션 매개변수입니다. 인증에 저장될 사용자의 사용자 정의 특성을 포함합니다.

Array
key
required
string
value
required
any
attr_type
required
string
Enum: "client" "server"
permission
required
string
Enum: "public" "private"
read_only
boolean
object

사용자와 연결해야 하는 소셜 프로필입니다.

user_id
required
string

소셜 서비스 공급자의 사용자 ID입니다.

platform
required
string

소셜 서비스 공급자의 이름입니다.

Responses
200

확인

400

잘못된 요청

401

인증되지 않음

404

찾을 수 없음

422

처리할 수 없는 엔터티

429

요청이 너무 많음

Request samples
application/json
{
  • "attributes": [
    ],
  • "server_custom_id": "1234567890asdfghjkl",
  • "social_profile": {
    }
}
Response samples
application/json
{
  • "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6IiIsImV4cCI6MTY1MzEyMzk5MCwiZ3JvdXBzIjpbXSwiaWF0IjoxNjUzMDM3NTkwLCJpc3MiOiJodHRwczovL2xvZ2luLnhzb2xsYS5jb20iLCJwdWJsaXNoZXJfaWQiOjMsInNlcnZlcl9jdXN0b21faWQiOiJteS1jdXN0b20taWQtbm90LWxpbmtlZCIsInN1YiI6IjI0MTBkNmMzLWFhZDEtNGY0OS04ODNlLTQ2Y2FkM2ZiMmJjMiIsInR5cGUiOiJzZXJ2ZXJfY3VzdG9tX2lkIiwidXNlcm5hbWUiOm51bGwsInhzb2xsYV9sb2dpbl9hY2Nlc3Nfa2V5IjoiSFhzTVZSWmRtd2tuZXNZMG1pNEpUMVhJUm43bVM4ZU5oc1FxaTU4bmtCayIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiMTM3NTkyM2ItODdmMy00YTIwLWFjMmItZDBhMjg3MzBlNDIwIn0.D8dFMN5Bmgnpejq1EhZUZQP_D5iFhpO_RXnVyE03qUI"
}