コンテンツにスキップ

すべてのエンジン

これは、Hive SDK認証機能を使用するために、すべての開発エンジンで必要な設定に関するガイダンスを提供します。

Hive コンソール設定

Hive SDK 認証を使用するには、まず Hive コンソール認証の各 AppID に対して IdP 設定 を構成する必要があります。

hive_config.xml の設定

hive_config.xmlファイルに、使用したいIdPに応じて認証設定を追加します。

Note

hive_config.xmlの設定に関する詳細については、以下を参照してください

アイテム 説明
プロバイダー サードパーティライブラリのプロパティ値を指定します。
Facebook 認証に使用されるFacebook関連の設定を定義するプロバイダー要素に属する要素です。 Hive SDKを使用してFacebook SDKを使用する際に、デフォルトのメール権限(Facebookアカウントのメールアドレスへのアクセス)とpublic_profile(Facebook公開プロフィールへのアクセス)を超える追加の権限が必要な場合は、Facebookコンソールでこれらの権限をリクエストし、hive_config.xmlに要素として追加する必要があります。 Hive SDK v4 Unity Windowsを使用してFacebookログインを実装するには、この要素内にid属性を追加し、属性値としてアプリIDを入力する必要があります。アプリを作成した後、MetaアプリダッシュボードでアプリIDを見つけることができます
Google 認証に使用されるGoogle関連の設定を追加するプロバイダー要素に属する要素です。 デスクトップでGoogleログインを実装するには、この要素内にclientId属性を追加し、Google Cloud Consoleから発行されたクライアントIDを属性値として入力する必要があります。 Steam Deck(Hive SDK v4 Unity Windows 22.0.0以上)でGoogleログインを実装するには、この要素内にdeviceFlowClientId属性を追加し、Google Cloud Consoleから発行されたクライアントIDを属性値として入力する必要があります。
WeChat プロバイダー要素で、v4での認証に使用されるWeChat関連の設定を追加します。
QQ プロバイダー要素で、v4での認証に使用されるQQ関連の設定を追加します。
VK プロバイダー要素で、v4での認証に使用されるVK関連の設定を追加します。
LINE プロバイダー要素で、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 Developer Centerから発行されたサービス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要素に属し、Authentication 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を統合する際のコールバックURIの設定

Xとの認証統合時に、X Developer Portalに設定されたコールバックURIは、以下に示すようにHive SDKによって事前に定義された形式を必要とします。

hive.x.{appId}://hive.providerx
例: hive.x.com.example.myapp://hive.providerx

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

providerx_callbackuri_setting


認証 IdP テレグラムログイン用のボットの設定

認証にテレグラムログインサービスを提供するには、専用のボットが必要です。

次の手順でボットを作成し、botIdbotDomainを取得してください。 詳細については、Telegram公式ドキュメントを参照してください。

  1. Telegramで「@BotFather」を検索し、公式認証マークのあるチャットルームにアクセスします。
  2. 下部の「開始」をクリックし、チャットウィンドウに/newbotコマンドを入力します。BotFatherの指示に従って「name」と「username」を入力することで、認証トークンを受け取ることができます。この時、ユーザー名は変更できないため、慎重に入力する必要があります。取得したトークン文字列のコロン(':')の前の数字はbotIdに対応します。このトークンは後でHiveコンソールに入力する必要があるため、一緒に保存してください。
  3. チャットウィンドウに/setDomainコマンドを入力します。ログイン画面に表示されるドメインアドレスを設定できます。入力値はbotDomainとして使用されます。
  4. 取得したbotIdbotDomainをhive_config.xmlに入力します。Unityを使用している場合は、hive_config.xmlの設定を参照することで簡単に追加できます。