엔진 공통
Hive SDK 인증 기능을 사용하기 위해 모든 개발 엔진에서 필요한 설정을 안내합니다.
Hive 콘솔 설정¶
Hive SDK 인증을 사용하려면, 먼저 Hive 콘솔 인증에서 AppID별로 IdP를 위한 설정을 진행해야 합니다.
hive_config.xml 설정¶
hive_config.xml 파일에 사용하려는 IdP에 따라 인증 설정을 추가합니다.
Note
hive_config.xml 설정에 관한 자세한 내용은 다음을 참고하세요.
항목 | 설명 |
---|---|
providers | 서드 파티 라이브러리에 대한 속성값을 지정합니다. |
providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Facebook 관련 설정을 정의합니다. Facebook SDK를 사용할 때 Hive SDK에서 기본으로 설정하는 email 권한(Facebook 계정 이메일 주소 접근)과 public_profile(Facebook 공개 프로필 접근) 권한 외에 추가 권한이 필요하다면, Facebook 콘솔에서 해당 권한을 요청한 후 hive_config.xml 에 요소로 추가해야 합니다. Hive SDK v4 Unity Windows 사용 시 Facebook 로그인을 구현하려면, 이 요소 내에 id 속성을 추가하고 속성값으로 앱 ID를 입력해야 합니다. 앱 ID는 앱을 만든 후에 Meta 앱 대시보드에서 확인할 수 있습니다. | |
providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Google 관련 설정을 추가합니다. 데스크톱에서 Google 로그인을 구현하려면, 이 요소 내에 clientId 속성을 추가하고 속성값으로 Google Cloud Console에서 발급받은 Client ID를 입력해야 합니다. Steam Deck에서 Google 로그인을 구현하려면(Hive SDK v4 Unity Windows 22.0.0 이상), 이 요소 내에 deviceFlowClientId 속성을 추가하고 속성값으로 Google Cloud Console에서 발급받은 Client ID를 입력해야 합니다. | |
providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 WeChat 관련 설정을 추가합니다. | |
providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 QQ 관련 설정을 추가합니다. | |
vk | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 VK 관련 설정을 추가합니다. |
line | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 LINE 관련 설정을 추가합니다. |
weverse | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Weverse 관련 설정을 추가합니다. |
signinwithapple | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Sign-in-with-Apple 관련 설정을 추가합니다. (Android, Windows에서 Apple 계정으로 로그인할 때 사용합니다.) (+4.15.6) Android, Windows에서 Sign-in-with-Apple 로그인을 구현하려면, 이 요소 내에 serviceid 속성을 추가하고 속성값으로 Apple 개발자 센터에서 발급받은 Services ID를 입력해야 합니다. |
steam | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Steam 관련 설정을 추가합니다. (Android, iOS에서 Steam 계정으로 로그인할 때 사용합니다.) Android, iOS에서 Steam 로그인을 구현하려면, 이 요소 내에 realm 속성을 추가하고 속성값으로 Realm를 입력해야 합니다. - 로그인을 요청하는 서비스의 도메인(예: https://your-app.com)을 입력하세요. 설정된 값은 Steam 로그인 페이지에도 표시됩니다. (기본 값: https://withhive.com) - 반드시 유효한 도메인을 입력해주세요. 유효하지 않은 도메인 설정 시, 정상적인 요청이 진행되지 않을 수 있습니다. |
x | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 X 관련 설정을 추가합니다. 이 요소 내에 clientId 속성을 추가하고 속성값으로 X Developer Portal에서 만든 프로젝트의 OAuth 2.0 Client ID를 입력해야 합니다. |
telegram | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Telegram 관련 설정을 추가합니다. 이 요소 내에 botId 와 botDomain 속성을 추가합니다. 각 속성은 Telegram의 @BotFather를 통해 만든 커스텀 봇의 botId 와 botDomain 입니다. botId 는 필수이며 botDomain 은 설정하지 않으면 기본값 'https://auth.qpyou.cn' 으로 설정됩니다. 이 도메인 주소는 Telegram 로그인 화면에 노출됩니다. |
<properties>
<providers>
<!-- 아래 Facebook 코드는 Hive SDK에서 자동으로 설정하는 email 권한, public_profile 권한 외에 다른 권한들(예를 들면 user_friends, user_gender)이 추가로 필요할 때 이를 위해 설정하는 예시입니다.-->
<!-- 실제로 hive_config.xml을 사용할 때에는, 게임사가 필요로 하는 권한만을 <permission> 요소로 삽입해야 합니다. -->
<facebook id="1809615065921877">
<permissions>
<permission name="user_friends" />
<permission name="user_gender" />
</permissions>
</facebook>
<google playAppId="123456789012" clientId="123456789012-abc.apps.googleusercontent.com" serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
<googleplaygames playAppId="123456789012" clientId="123456789012-abc.apps.googleusercontent.com" serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" />
<qq id="1234567890" />
<vk id="1234567" />
<wechat id="wx12345cf6c789c0f1" secret="abcdefg" univeralLink="https://your.sample.com/"/>
<line channelId="1234567890" />
<weverse clientId="abcdefg" />
<!-- (Android Only) 애플 개발자 계정에서 설정한 서비스 id를 serviceid로 설정 -->
<signinwithapple serviceid="com.sample.your" />
<!-- (Android&iOS) Steam 로그인 서비스 범위 설정. (기본 값: https://withhive.com) -->
<steam realm="https://your-app.com"/>
<x clientId="ABCDEFG"/>
<telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
</providers>
</properties>
인증 Idp X 연동 시 Callback URI 설정¶
인증에서 X로 연동을 할때 X Developer Portal에 설정하는 Callback URI는 Hive SDK와 사전에 정의된 형식이 필요한데 아래와 같습니다.
hive.x.{appId}://hive.providerx
예시: hive.x.com.example.myapp://hive.providerx
이 Callback URI는 X Developer Portal에서 생성한 프로젝트의 User authentication settings / App info 에 설정합니다.
인증 IdP Telegram 로그인을 위한 봇 설정¶
인증에서 Telegram으로 로그인하기 서비스를 제공하려면 전용 봇이 필요합니다.
아래의 순서대로 봇을 생성하고 botId와 botDomain을 획득하세요. 보다 자세한 내용은 Telegram 공식문서에서 확인할 수 있습니다.
- 텔레그램에서 '@BotFather'를 검색하여 공식 인증마크가 달린 채팅방에 접속합니다.
- 하단의 시작(Start)을 누르고, 채팅창에
/newbot
명령어를 입력합니다. BotFather의 안내에 따라 'name'과 'username'을 입력면 인증 토큰을 받을 수 있습니다. 이때 username은 변경이 불가능하므로 신중히 기입해야 합니다. 획득한 토큰 문자열 중 콜론(':') 앞쪽의 숫자는 botId에 해당하며, 토큰은 추후 Hive 콘솔에 입력해야 하는 값이므로 함께 저장하세요. - 채팅창에
/setDomain
명령어를 입력합니다. 로그인 화면에 노출할 도메인 주소를 설정할 수 있습니다. 입력값은 botDomain으로 사용합니다. - 획득한 botId와 botDomain을 hive_config.xml에 입력합니다. Unity 를 사용하는 경우 hive_config.xml 설정을 참고하여 간편하게 추가할 수 있습니다.