OAuth 2.0 인증

OAuth 2.0 인증Client-side

get/oauth2/auth

유효한 SSO 세션이 있는지 확인합니다. 인증 코드와 함께 redirect_url 매개 변수에 전달된 URL로 리디렉션합니다.

Request

query Parameters

response_type required	string 성공할 경우 애플리케이션이 인증 코드를 수신할 것으로 예상함을 나타내는 코드로 설정됩니다. Value: "code"
client_id required	integer 애플리케이션 ID입니다. OAuth 2.0 클라이언트 생성하기를 수행한 후에 가져옵니다.
redirect_uri required	string 이 URL은 개발자가 애플리케이션 생성 시 등록한 URL 중 하나와 일치해야 하며 일치하지 않는 경우 인증 서버는 요청을 거부해야 합니다. 이 매개변수를 설정하려면 고객 성공 매니저에게 문의해야 합니다.
scope required	string 요청에 애플리케이션에서 요청한 추가 액세스를 나타내는 하나 이상의 범위 값이 있을 수 있습니다. 인증 서버는 요청된 범위를 사용자에게 표시해야 합니다.
state required	string 상태(state) 매개변수는 애플리케이션에서 요청별 데이터를 저장하고 CSRF 공격을 방지하는 데 사용됩니다. 인증 서버는 수정되지 않은 상태 값을 애플리케이션에 다시 반환해야 합니다. 이러한 매개변수를 사용하는 것이 좋습니다.
audience required	string 대상 그룹(audience) 매개변수에 URL 인코딩 공백(+ 또는%20)으로 구분된 여러 문자열을 포함할 수 있습니다. 대상 그룹 값 자체도 URL로 인코딩되어 있어야 합니다.
popup	boolean Default: false true가 전달되면 메소드는 먼저 위젯으로 리디렉션된 다음 파트너의 콜백으로 리디렉션됩니다. false인 경우 메소드는 파트너의 콜백으로 바로 리디렉션됩니다.
code_challenge	string `code_verifier`(https://datatracker.ietf.org/doc/html/rfc7636#section-4-2)에서 생성된 챌린지입니다.
code_challenge_method	string 챌린지를 생성하는 데 사용되는 메소드입니다. 현재는 `S256` 메서드만 사용하여 `code_challenge`를 생성할 수 있습니다. Value: "S256"
widget_only	boolean 팝업 절차에 대한 서비스 매개 변수입니다. API 동작에 영향을 주지 않습니다.
enable_post_message_login	boolean 팝업 절차에 대한 서비스 매개 변수입니다. API 동작에 영향을 주지 않습니다.
disable_socials	boolean 팝업 절차에 대한 서비스 매개 변수입니다. API 동작에 영향을 주지 않습니다.
fail_auth_url	string If passed then method will redirect on this URL in case of a missing session for authentication and obtaining new session.
disable_passwordless_email	boolean 팝업 절차에 대한 서비스 매개 변수입니다. API 동작에 영향을 주지 않습니다.
disable_passwordless_phone	boolean 팝업 절차에 대한 서비스 매개 변수입니다. API 동작에 영향을 주지 않습니다.
is_xsolla_link	boolean 팝업 절차에 대한 서비스 매개 변수입니다. API 동작에 영향을 주지 않습니다.

Responses

302

리디렉션

400

잘못된 요청

404

찾을 수 없음

418

찻주전자라 커피를 끓일 수 없음

422

처리할 수 없는 엔터티

429

요청이 너무 많음

Request samples

curl --request GET \
  --url 'https://login.xsolla.com/api/oauth2/auth?response_type=SOME_STRING_VALUE&client_id=SOME_INTEGER_VALUE&redirect_uri=SOME_STRING_VALUE&scope=SOME_STRING_VALUE&state=SOME_STRING_VALUE&audience=SOME_STRING_VALUE&popup=false&code_challenge=SOME_STRING_VALUE&code_challenge_method=SOME_STRING_VALUE&widget_only=SOME_BOOLEAN_VALUE&enable_post_message_login=SOME_BOOLEAN_VALUE&disable_socials=SOME_BOOLEAN_VALUE&fail_auth_url=SOME_STRING_VALUE&disable_passwordless_email=SOME_BOOLEAN_VALUE&disable_passwordless_phone=SOME_BOOLEAN_VALUE&is_xsolla_link=SOME_BOOLEAN_VALUE' \
  --header 'accept: application/x-www-form-urlencoded'

Response samples

{"error": {"code": "003-061",
"description": "Object not found.",
"details": { }
}
}