콘텐츠로 이동

IdP별 키 입력

Hive SDK 인증 기능을 사용하려면 모든 개발 엔진에서 각 IdP(인증 제공자)가 제공하는 키 값이 필요합니다. 이 문서는 각 IdP 콘솔에서 발급받은 키 값을 Hive 콘솔과 hive_config.xml 파일에 입력하는 방법을 안내합니다.

개요

어떤 IdP를 사용하려면 IdP 콘솔에서 발급한 키 값을 가져와, Hive 콘솔 또는 hive_config.xml 파일(또는 양쪽 모두)에 입력해야 합니다. 예를 들어 개발사가 Windows 환경에서 사용자에게 Google과 Apple 로그인을 제공하려면, Google 콘솔과 Apple 콘솔에서 발급한 키 값을 각각 가져와서 Hive 콘솔과 hive_config.xml 파일 모두에 키를 각각 입력해야 합니다. IdP, OS별로 키 값을 입력하는 위치는 아래 내용을 참고하세요.


  • hive_config.xml
    • 사용하려는 IdP 콘솔에서 가져온 키 값을 hive_config.xml 파일에 입력
    • Unity 또는 Unreal Engine 환경에서는 Config Editor에서 입력 가능
  • Hive 콘솔
    • 사용하려는 IdP 콘솔에서 가져온 키 값을 Hive 콘솔에 입력
  • Hive 콘솔, hive_config.xml
    • Hive 콘솔과 hive_config.xml 양쪽 모두에 키 값 입력 필요
  • 설정 제외
    • Hive 콘솔과 hive_config.xml 양쪽 모두에 키 값 입력 필요 없음
  • 미지원
    • 지원하지 않는 IdP


IdP / OS Android iOS Windows macOS 웹로그인
Google Play로 로그인 Hive 콘솔,
hive_config.xml		 미지원 미지원 미지원 미지원
Hive 로그인 설정 제외 설정 제외 설정 제외 설정 제외 Hive 콘솔
Facebook으로 로그인 hive_config.xml hive_config.xml Hive 콘솔,
hive_config.xml		 Hive 콘솔 Hive 콘솔
Guest로 로그인 설정 제외 설정 제외 미지원 미지원 미지원
Apple로 로그인 Hive 콘솔,
hive_config.xml		 hive_config.xml Hive 콘솔,
hive_config.xml		 Hive 콘솔 Hive 콘솔
Google로 로그인 hive_config.xml hive_config.xml Hive 콘솔,
hive_config.xml		 Hive 콘솔 Hive 콘솔
QQ로 로그인 hive_config.xml hive_config.xml 미지원 미지원 미지원
VK로 로그인 strings.xml hive_config.xml 미지원 미지원 미지원
WeChat으로 로그인 hive_config.xml hive_config.xml 미지원 미지원 미지원
LINE으로 로그인 hive_config.xml hive_config.xml 미지원 미지원 미지원
Weverse로 로그인 hive_config.xml hive_config.xml hive_config.xml 미지원 미지원
HUAWEI ID로 로그인 Hive 콘솔 미지원 미지원 미지원 미지원
Steam으로 로그인 Hive 콘솔,
hive_config.xml		 Hive 콘솔,
hive_config.xml		 Hive 콘솔,
hive_config.xml		 Hive 콘솔 미지원
X로 로그인 hive_config.xml hive_config.xml hive_config.xml 미지원 미지원
Telegram으로 로그인 Hive 콘솔,
hive_config.xml		 Hive 콘솔,
hive_config.xml		 hive_config.xml 미지원 미지원

Hive 콘솔에 입력

게임에서 로그인 기능을 제공할 때 노출할 IdP와 노출 순서를 정해야합니다. 이를 위해 Hive 콘솔에서 AppID별로 로그인 종류 선택, 로그인 순서 변경, 인증 키를 Hive 콘솔에 등록을 순서대로 진행합니다.

보안 키 발급

서비스간 인증 보안 강화를 위해 Hive 콘솔 > 보안 키 설정에서 보안 키를 반드시 발급받아야 합니다.

Warning

보안 키를 발급받지 않으면, 앱 사용자는 앱에서 로그인할 수 없습니다.

hive_config.xml에 입력

사용할 IdP 콘솔에서 키 값을 받아 hive_config.xml 파일에 입력합니다. 다음은 모든 IdP를 사용할 경우를 가정한 예시 코드입니다.

<properties>

    <providers>
        <!-- Google Play로 로그인 (Google Play Games) -->
        <googleplaygames playAppId="123456789012" serverClientId="123456789012-abc.apps.googleusercontent.com" />

        <!-- Facebook으로 로그인 (Facebook) -->
        <!-- 아래 Facebook 코드는 Hive SDK에서 자동으로 설정하는 email 권한, public_profile 권한 외에 다른 권한들(예를 들면 user_friends, user_gender)이 추가로 필요할 때 이를 위해 설정하는 예시입니다.-->
        <!-- 실제로 hive_config.xml을 사용할 때에는, 게임사가 필요로 하는 권한만을 <permission> 요소로 삽입해야 합니다. -->
        <facebook>
            <permissions>
                <permission name="user_friends" />
                <permission name="user_gender" />
            </permissions>
        </facebook>

        <!-- Apple로 로그인 (Sign in with Apple) -->
        <signinwithapple serviceid="com.sample.your" />

        <!-- Google로 로그인 (Google Sign-In) -->
        <google playAppId="123456789012" serverClientId="123456789012-abc.apps.googleusercontent.com" />

        <!-- QQ로 로그인 -->
        <qq id="1234567890" />

        <!-- WeChat으로 로그인 -->
        <wechat id="wx12345cf6c789c0f1" secret="abcdefg" paymentKey="abc123def456xyz789"/>

        <!-- LINE으로 로그인 -->
        <line channelId="1234567890" />

        <!-- Weverse로 로그인 -->
        <weverse clientId="abcdefg" />

        <!-- Steam으로 로그인 -->
        <steam realm="https://your-app.com"/>

        <!-- X로 로그인 -->
        <x clientId="ABCDEFG"/>

        <!-- Telegram으로 로그인 (Telegram) -->
        <telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
    </providers>

</properties>

<properties>

    <providers>
        <!-- Facebook으로 로그인 (Facebook) -->
        <!-- 아래 Facebook 코드는 Hive SDK에서 자동으로 설정하는 email 권한, public_profile 권한 외에 다른 권한들(예를 들면 user_friends, user_gender)이 추가로 필요할 때 이를 위해 설정하는 예시입니다.-->
        <!-- 실제로 hive_config.xml을 사용할 때에는, 게임사가 필요로 하는 권한만을 <permission> 요소로 삽입해야 합니다. -->
        <facebook>
            <permissions>
                <permission name="user_friends" />
                <permission name="user_gender" />
            </permissions>
        </facebook>

        <!-- Apple로 로그인 (Sign in with Apple) -->
        <signinwithapple serviceid="com.sample.your" />

        <!-- Google로 로그인 (Google Sign-In) -->    
        <google serverClientId="123456789012-abc.apps.googleusercontent.com"  reversedClientId="com.googleusercontent.apps.123456789012-abc" />

        <!-- QQ로 로그인 -->
        <qq id="1234567890" />

        <!-- VK로 로그인 -->
        <vk id="1234567" /> 

        <!-- WeChat으로 로그인 -->
        <wechat id="wx12345cf6c789c0f1" secret="abcdefg" />

        <!-- LINE으로 로그인 -->
        <line channelId="1234567890" />

        <!-- Weverse로 로그인 -->
        <weverse clientId="abcdefg" />

        <!-- Steam으로 로그인 -->
        <steam realm="https://your-app.com"/>

        <!-- X로 로그인 -->
        <x clientId="ABCDEFG"/>

        <!-- Telegram으로 로그인 -->
        <telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
    </providers>

</properties>

<properties>

    <providers>
        <!-- Facebook으로 로그인 (Facebook) -->
        <!-- 아래 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>

        <!-- Apple로 로그인 (Sign in with Apple) -->
        <signinwithapple serviceid="com.sample.your" />

        <!-- Google로 로그인 (Google Sign-In) -->    
        <google serverClientId="123456789012-abc.apps.googleusercontent.com"  deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />

        <!-- Weverse로 로그인 -->
        <weverse clientId="abcdefg" />

        <!-- Steam으로 로그인 -->
        <steam realm="https://your-app.com"/>

        <!-- X로 로그인 -->
        <x clientId="ABCDEFG"/>

        <!-- Telegram으로 로그인 -->
        <telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
    </providers>

</properties>
Note

Unreal Engine 또는 Unity 사용 시 hive_config.xml 파일을 직접 생성, 편집하지 않고 Config Editor(Unity, Unreal)로 키 값을 입력할 수 있습니다.


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

Google Play로 로그인(Google Play Games)

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Google Play로 로그인 (Google Play Games) -->
        <googleplaygames playAppId="123456789012" serverClientId="123456789012-abc.apps.googleusercontent.com" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

playAppId (Android)

Google Cloud 콘솔에서 발급받은 Android 유형의 클라이언트 ID를 설정합니다.



serverClientId (Android)

Google Cloud 콘솔에서 발급받은 웹 애플리케이션 클라이언트 ID를 설정합니다.



Facebook으로 로그인

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Facebook으로 로그인 (Facebook) -->
        <!-- 아래 Facebook 코드는 Hive SDK에서 자동으로 설정하는 email 권한, public_profile 권한 외에 다른 권한들(예를 들면 user_friends, user_gender)이 추가로 필요할 때 이를 위해 설정하는 예시입니다.-->
        <!-- 실제로 hive_config.xml을 사용할 때에는, 게임사가 필요로 하는 권한만을 <permission> 요소로 삽입해야 합니다. -->
        <facebook>
            <permissions>
                <permission name="user_friends" />
                <permission name="user_gender" />
            </permissions>
        </facebook>
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Facebook으로 로그인 (Facebook) -->
        <!-- 아래 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>
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

id (Windows)

Hive v4 Unity Windows 사용 시 Facebook 로그인 기능 사용을 위한 앱 ID입니다. 앱 ID는 앱 설정을 수정한 후 Meta 앱 대시보드에서 확인 가능합니다.

permission (Android, iOS, Windows)

Facebook SDK를 사용할 때 Hive에서 기본으로 설정하는 email 권한(Facebook 계정 이메일 주소 접근)과 public_profile(Facebook 공개 프로필 접근) 권한 외에 추가 권한이 필요하다면, Facebook 콘솔에서 해당 권한을 요청한 후 permission에 권한을 설정합니다. Hive에서 Facebook 로그인 시 permissions에 설정된 권한을 포함하여 로그인 요청합니다.


Apple로 로그인(Sign in with Apple)

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Apple로 로그인 (Sign in with Apple) -->    
        <signinwithapple serviceid="com.sample.your" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

serviceid (Android, iOS, Windows)

Apple 개발자 센터에서 발급받은 Services ID를 설정합니다. 설정 시 Android 및 Windows에서 Apple 계정으로 로그인할 수 있습니다.

Google로 로그인(Google Sign-In)

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Google로 로그인 (Google Sign-In) -->    
        <google playAppId="123456789012" serverClientId="123456789012-abc.apps.googleusercontent.com" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Google로 로그인 (Google Sign-In) -->    
        <google serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Google로 로그인 (Google Sign-In) -->    
        <google serverClientId="123456789012-abc.apps.googleusercontent.com" deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

playAppId (Android)

Google Cloud 콘솔에서 발급받은 Android 유형 클라이언트 ID를 설정합니다.



serverClientId (Android, iOS, Windows)

Google Cloud 콘솔에서 발급받은 웹 애플리케이션 클라이언트 ID를 설정합니다.



reversedClientId (iOS)

Google Cloud 콘솔에서 발급받은 역순 클라이언트 ID를 설정합니다. iOS용 Google 로그인 설명 페이지에서 역순 클라이언트 ID를 참고하세요.

deviceFlowClientId (Windows)

Google Cloud 콘솔에서 발급받은 클라이언트 유형의 클라이언트 ID를 설정합니다.



QQ로 로그인

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- QQ로 로그인 -->    
        <qq id="1234567890" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

id (Android, iOS)

QQ 서비스(connect.qq.com)에 게임 앱 등록 요청을 통해 발급받은 QQ APP ID를 설정합니다. 앱 등록 시 중국 내국인이 요청해야 하는 등 심사 특이사항이 있습니다.

VK로 로그인

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- VK로 로그인 -->    
        <vk id="1234567" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>
Warning

VK IdP가 제공하는 로그인 방식이 변경됨에 따라 2024년 6월 이후 VK 콘솔에서 신규 앱 설정을 등록한 경우, Hive SDK에서 제공하는 VK 로그인을 사용할 수 없습니다. 변경된 로그인 방식은 2025년 4~5월 중 Hive SDK v4 25.2.0 이상에서 지원할 예정입니다.

id (iOS)

VK 서비스 페이지에서 발급받은 VK ID를 설정합니다.

WeChat으로 로그인

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- WeChat으로 로그인 -->    
        <wechat id="wx12345cf6c789c0f1" secret="abcdefg" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

id (Android, iOS)

Wechat 콘솔에 있는 게임 앱 식별자인 APP ID를 설정합니다.


secret (Android, iOS)

Wechat 콘솔에서 확인할 수 있는 AppSecret을 설정합니다.


LINE으로 로그인

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- LINE으로 로그인 -->    
        <line channelId="1234567890" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

channelId (Android, iOS)

Line 콘솔에서 Providers 항목 내 Basic settings에서 확인할 수 있는 Channel ID를 설정합니다.


Weverse로 로그인

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Weverse로 로그인 -->    
        <weverse clientId="abcdefg" isTest="false" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Weverse로 로그인 -->    
        <weverse clientId="abcdefg" />
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

clientId (Android, iOS, Windows)

Weverse 로그인을 위한 고유 식별자 Client ID를 설정합니다. Weverse의 Client ID의 경우 Weverse 담당자 문의를 통해 발급해야 합니다.

isTest (Android, iOS)

Weverse의 테스트 서버에 접속할지 여부를 설정합니다.

  • true: Weverse 테스트 서버에 접속합니다. 개발 시 Weverse 담당자 논의 후 사용 바랍니다.
  • false: Weverse 상용 서버에 접속합니다.

Steam으로 로그인

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Steam으로 로그인 -->    
        <steam realm="https://your-app.com"/>
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

realm (Android, iOS, Windows)

Steam OpenID 인증에서 realm 정보로 사용하는 게임 개발팀 소유의 도메인을 설정합니다. 로그인을 요청하는 서비스의 도메인(예: https://your-app.com)을 입력합니다. 설정한 값은 Steam 로그인 페이지에도 표시됩니다. 기본값은 https://withhive.com입니다. 반드시 유효한 도메인을 입력해야 하며, 유효하지 않을 경우 로그인이 진행되지 않을 수 있습니다.

X로 로그인

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- X로 로그인 -->    
        <x clientId="ABCDEFG"/>
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

clientId (Android, iOS, Windows)

X 콘솔(X Developer Portal)의 OAuth 2.0 Client ID를 설정합니다.


Telegram으로 로그인

다음 예시를 참고해 hive_config.xml 파일 providers 태그에 값을 입력합니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 인증 설정: START -->
    <providers>
        <!-- Telegram로 로그인 -->    
        <telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
    </providers>
    <!-- Hive SDK 인증 설정: END -->
</properties>

botId (Android, iOS, Windows)

Telegram 로그인 서비스를 위한 botId를 설정합니다. botId를 얻으려면 Telegram 공식문서 또는 Hive 인증 Idp Telegram 로그인을 위한 봇 설정을 참고하세요. botId는 Telegram 로그인 사용 시 필수 값입니다.

botDomain (Android, iOS, Windows)

Telegram 로그인 서비스를 위한 botDomain을 설정합니다. botDomain을 얻으려면 Telegram 공식문서 또는 Hive 인증 Idp Telegram 로그인을 위한 봇 설정을 참고하세요. botDomain을 입력하지 않으면 기본값인 https://auth.qpyou.cn으로 설정됩니다. 이 도메인 주소는 Telegram 로그인 화면에 노출됩니다.