コンテンツにスキップ

すべてのエンジン

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

Hive コンソール設定

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

hive_config.xml の設定

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

Note

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

アイテム 説明
プロバイダー サードパーティライブラリのプロパティ値を指定します。
facebook 認証に使用されるFacebook関連の設定を定義するプロバイダー要素に属する要素です。 デフォルトのメール権限(Facebookアカウントのメールアドレスへのアクセス)およびpublic_profile(Facebookの公開プロフィールへのアクセス)を超える追加の権限が必要な場合は、Hive SDKを使用してFacebook SDKを使用する際に、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クライアント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開発者ポータルに設定されたコールバックURIは、以下に示すようにHive SDKによって事前に定義された形式を必要とします。

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

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

providerx_callbackuri_setting


認証 IdP Telegram ログイン用のボットの設定

認証においてTelegramログインサービスを提供するには、専用のボットが必要です。

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

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