콘텐츠로 이동

엔진 공통

Hive SDK 인증 기능을 사용하기 위해 모든 개발 엔진에서 필요한 설정을 안내합니다.

Hive 콘솔 설정

Hive SDK 인증을 사용하려면, 먼저 Hive 콘솔 앱센터에서 AppID별로 IdP를 위한 설정을 진행해야 합니다.

Note

더 자세한 내용은 인증 v4 IdP 설정을 확인하세요.

hive_config.xml 설정

hive_config.xml 파일에 사용하려는 IdP에 따라 인증 설정을 추가합니다.

Note

hive_config.xml 설정에 관한 자세한 내용은 다음을 참고하세요.

항목 설명
providers 서드 파티 라이브러리에 대한 속성값을 지정합니다.
facebook 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 앱 대시보드에서 확인할 수 있습니다.
google 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를 입력해야 합니다.
wechat providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 WeChat 관련 설정을 추가합니다.
qq 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를 입력해야 합니다. 
<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"/>
    </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 에 설정합니다.

providerx_callbackuri_setting