コンテンツにスキップ

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 Web Login
Google Playでログイン Hive コンソール,
hive_config.xml		 サポートされていません サポートされていません サポートされていません サポートされていません
Hive ログイン 設定を除外 設定を除外 設定を除外 設定を除外 Hive コンソール
Facebookでログイン hive_config.xml hive_config.xml Hive コンソール,
hive_config.xml		 Hive コンソール Hive コンソール
ゲストとしてログイン 設定を除外 設定を除外 サポートされていません サポートされていません サポートされていません
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とその公開順序を決定する必要があります。これを行うために、各AppIDについて、Hiveコンソールでログインタイプの選択、ログイン順序の変更、および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>

        <!-- Sign in with Apple -->
        <signinwithapple serviceid="com.sample.your" />

        <!-- Googleでログイン (Googleサインイン) -->
        <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" />

        <!-- Log in with 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>

        <!-- Sign in with Apple -->
        <signinwithapple serviceid="com.sample.your" />

        <!-- Googleでログイン (Googleサインイン) -->    
        <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>

        <!-- Sign in with Apple -->
        <signinwithapple serviceid="com.sample.your" />

        <!-- Googleでログイン (Googleサインイン) -->    
        <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）を使用してキー値を入力できます。


以下の指示に従って、使用したいIdPに応じてhive_config.xmlファイルに認証設定を追加してください。

Google Playでログイン (Google Playゲーム)

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDK共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Google Play でログイン (Google Play ゲーム) -->
        <googleplaygames playAppId="123456789012" serverClientId="123456789012-abc.apps.googleusercontent.com" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

Playappid (Android)

Google Cloud Consoleから発行されたAndroidタイプのクライアントIDを設定します。



サーバークライアントID (Android)

Google Cloud Consoleから取得したWeb Application Client IDを設定します。



Facebookでログイン

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDK共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <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 認証設定: 終了 -->
</properties>

<properties>
    <!-- Hive SDK共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <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 認証設定: 終了 -->
</properties>

ID (Windows)

これは、Windows上でHive v4 Unityを使用する際にFacebookログイン機能を使用するためのアプリIDです。アプリ設定を変更した後、MetaアプリダッシュボードでアプリIDを確認できます。アプリIDはここにあります。

許可 (Android, iOS, Windows)

Facebook SDKを使用する場合、Hive によって設定されたデフォルトのメール権限（Facebookアカウントのメールアドレスへのアクセス）およびpublic_profile（Facebookの公開プロフィールへのアクセス）を超える追加の権限が必要な場合は、Facebookコンソールから必要な権限をリクエストし、権限フィールドに権限を設定できます。Hive でFacebookでログインする際、ログインリクエストには権限フィールドに設定された権限が含まれます。


Appleでサインイン

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDKの共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Appleでサインイン -->    
        <signinwithapple serviceid="com.sample.your" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

サービスID (Android, iOS, Windows)

Apple Developer Centerによって発行されたサービスIDを設定します。設定が完了すると、AndroidおよびWindowsでAppleアカウントでログインできます。

Googleでサインイン

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDKの共通設定は省略されています -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Google でログイン (Google サインイン) -->    
        <google playAppId="123456789012" serverClientId="123456789012-abc.apps.googleusercontent.com" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

<properties>
    <!-- Hive SDK共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Google でログイン (Google サインイン) -->    
        <google serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

<properties>
    <!-- Hive SDK共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Google でログイン (Google サインイン) -->    
        <google serverClientId="123456789012-abc.apps.googleusercontent.com" deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

Playappid (Android)

Google Cloud Consoleから発行されたAndroidタイプのクライアントIDを設定します。



サーバークライアントID (Android, iOS, Windows)

Google Cloud Consoleから発行されたウェブアプリケーションクライアントIDを設定します。



Reversedclientid (iOS)

Google Cloudコンソールから発行されたリバースクライアントIDを設定してください。詳細は、iOS向けGoogleサインインのドキュメントページのリバースクライアントIDを参照してください。

Deviceflowclientid (Windows)

Google Cloud Consoleから発行されたクライアントタイプのクライアントIDを設定します。



QQでログイン

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDK共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- QQでログイン -->    
        <qq id="1234567890" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

ID (Android, iOS)

QQ APP IDをQQサービスのゲームアプリ登録リクエスト (connect.qq.com)を通じて発行されたものに設定します。アプリを登録する際には、中国市民によって要求される特定の審査要件があります。

VKでログイン

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDKの共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- VKでログイン -->    
        <vk id="1234567" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>
Warning

VK IdPによって提供されるログイン方法が変更されました。したがって、2024年6月以降にVKコンソールで新しいアプリ設定を登録すると、Hive SDKによって提供されるVKログインを使用できなくなります。変更されたログイン方法は、2025年4月から5月頃にHive SDK v4 25.2.0以上でサポートされる予定です。

ID (iOS)

VK IDをVKサービスページから発行してください。

WeChatでログイン

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDKの共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- WeChatでログイン -->    
        <wechat id="wx12345cf6c789c0f1" secret="abcdefg" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

ID (Android, iOS)

Wechatコンソールでゲームアプリの識別子APP IDを設定します。


シークレット (Android, iOS)

Wechat consoleで確認できるAppSecretを設定してください。


LINEでログイン

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDK共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- LINEでログイン -->    
        <line channelId="1234567890" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

チャンネルID (Android, iOS)

Line consoleのプロバイダーセクションの基本設定にあるチャンネルIDを設定します。


Weverseでログインする

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDKの共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Weverseでログイン -->    
        <weverse clientId="abcdefg" isTest="false" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

<properties>
    <!-- Hive SDK共通設定は省略されています -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Weverseでログイン -->    
        <weverse clientId="abcdefg" />
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

クライアントID (Android, iOS, Windows)

Weverseログインのためのユニークな識別子であるクライアントIDを設定します。WeverseのクライアントIDは、Weverseの連絡先を通じて発行される必要があります。

Istest (Android, iOS)

Weverseテストサーバーに接続するかどうかを設定します。

  • true: Weverseテストサーバーに接続します。開発中にWeverse担当者と相談の上、使用してください。
  • false: Weverse本番サーバーに接続します。

Steamでログイン

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDKの共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Steamでログイン -->    
        <steam realm="https://your-app.com"/>
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

Realm (Android、iOS、Windows)

realm情報を使用するゲーム開発チームが所有するドメインを設定します。Steam OpenID認証を使用します。ログインを要求するサービスのドメインを入力してください（例：https://your-app.com）。設定した値は、Steamのログインページにも表示されます。デフォルトはhttps://withhive.comです。有効なドメインを入力する必要があり、無効な場合はログインが進行しない可能性があります。

xでログイン

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDKの共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Xでログイン -->    
        <x clientId="ABCDEFG"/>
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

クライアントID (Android, iOS, Windows)

X コンソール (X 開発者ポータル) の OAuth 2.0 クライアント ID を設定します。


テレグラムでログインする

hive_config.xmlファイルのprovidersタグに値を入力するには、以下の例を参照してください。

<properties>
    <!-- Hive SDKの共通設定は省略されました -->

    <!-- Hive SDK 認証設定: 開始 -->
    <providers>
        <!-- Telegramでログイン -->    
        <telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
    </providers>
    <!-- Hive SDK 認証設定: 終了 -->
</properties>

ボットID (Android, iOS, Windows)

TelegramログインサービスのためにbotIdを設定します。botIdを取得するには、Telegram公式ドキュメントまたはHive 認証IdpボットのTelegramログイン設定を参照してください。botIdはTelegramログインを使用する際に必要な値です。

ボットドメイン (Android, iOS, Windows)

TelegramログインサービスのためにbotDomainを設定します。botDomainを取得するには、Telegram公式ドキュメントまたはHive 認証IdpボットのTelegramログイン設定を参照してください。botDomainを入力しない場合、デフォルト値https://auth.qpyou.cnが設定されます。このドメインアドレスはTelegramログイン画面に表示されます。