IdP별 추가 설정

SDK 인증 기능을 사용할 때 모든 개발 엔진에서 필요한 기타 설정을 안내합니다.

인증 IdP Google Play 연동 시 리디렉션 URI 설정¶

Google Play(Google Play Games) IdP를 연동하려면 Google Cloud 콘솔에서 웹 애플리케이션 클라이언트 ID(serverClientId) > **승인된 리디렉션 URI**에 해당하는 인증 서버 URI를 등록해야 합니다.

**승인된 리디렉션 URI**에 등록하는 URI 목록은 아래와 같습니다.

모바일 및 PC 공통

인증 IdP X 연동 시 Callback URI 설정¶

X(구 Twitter) IdP 연동 시 X Developer Portal에 설정하며, 아래와 같이 사전에 정의된 형식이어야 합니다.

모바일: hive.x.{appId}://hive.providerx
- 예시: hive.x.com.example.myapp://hive.providerx
PC
- REAL: https://authcp.qpyou.cn/view/idp/callback
- SANDBOX: https://sandbox-authcp.qpyou.cn/view/idp/callback
Steam Deck: https://www.withhive.com

Callback URI는 아래와 같이 X Developer Portal에서 생성한 프로젝트의 User authentication settings > App info 에 설정합니다.

인증 IdP Telegram 로그인을 위한 봇 설정¶

인증에서 Telegram으로 로그인하기 서비스를 제공하려면 전용 봇이 필요합니다.

아래 순서대로 봇을 생성하고 botId와 botDomain을 획득하세요. 보다 자세한 내용은 Telegram 공식 문서에서 확인할 수 있습니다.

텔레그램에서 '@BotFather'를 검색하여 공식 인증마크가 달린 채팅방에 접속합니다.
하단의 시작(Start)을 누르고, 채팅창에 /newbot 명령어를 입력합니다. BotFather의 안내에 따라 'name'과 'username'을 입력하면 인증 토큰을 받을 수 있습니다. 이때 username은 변경이 불가능하므로 신중히 기입해야 합니다. 획득한 토큰 문자열 중 콜론(':') 앞쪽의 숫자는 botId에 해당하며, 토큰은 추후 하이브 콘솔에 입력해야 하는 값이므로 함께 저장하세요.
채팅창에 /setDomain 명령어를 입력합니다. 로그인 화면에 노출할 도메인 주소를 설정할 수 있습니다. 입력값은 botDomain으로 사용합니다.
획득한 botId와 botDomain을 hive_config.xml에 입력합니다. Unity를 사용하는 경우 hive_config.xml 설정을 참고하여 간편하게 추가할 수 있습니다.

인증 IdP LINE 연동 시 Callback URI 설정¶

PC
- REAL: https://authcp.qpyou.cn/view/idp/connect
- SANDBOX: https://sandbox-authcp.qpyou.cn/view/idp/connect

Callback URI는 아래와 같이 LINE Developers Console에서 생성한 프로젝트의 LINE Login > Use LINE Login in your web app 에 설정합니다.

VK IdP 권한 부여 > 추가 로그인 설정¶

아래와 같이 Odnoklassniki를 통한 승인과 메일을 통한 승인(mail.ru)은 지원하지 않습니다.

인증 IdP animate Games Online 연동 시 Callback URL / Redirect URI 설정¶

animate Games Online 로그인은 OAuth 2.0 Authorization Code + PKCE 방식으로 동작합니다. 로그인 콜백이 정상적으로 처리되려면 animate Games Online 개발자 대시보드에서 앱의 Callback URL과 Redirect URI를 등록해야 합니다.

Redirect URI는 <packageName>://store-login-callback 형식입니다. <packageName>은 앱의 패키지명으로 대체합니다.

예시: com.com2us.hivesdk.android.ago://store-login-callback

Callback URL은 animate Games Online 대시보드에 등록한 값과 앱 설정이 일치해야 합니다.

Redirect URI는 아래와 같이 animate Games Online 개발자 대시보드에서 생성한 앱의 설정 화면에 등록합니다.