コンテンツにスキップ

すべてのエンジン

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

このコールバックURIはX Developer Portalで作成したプロジェクトの**ユーザー認証設定 / アプリ情報**に設定します。

providerx_callbackuri_setting