すべてのエンジン
これは、Hive SDK認証機能を使用するために、すべての開発エンジンで必要な設定に関するガイダンスを提供します。
Hive コンソール設定¶
Hive SDK 認証を使用するには、まず Hive コンソール認証の各 AppID に対して IdP 設定 を構成する必要があります。
hive_config.xml の設定¶
hive_config.xmlファイルに、使用したいIdPに応じて認証設定を追加します。
Note
hive_config.xmlの設定に関する詳細については、以下を参照してください。
アイテム | 説明 |
---|---|
プロバイダー | サードパーティライブラリのプロパティ値を指定します。 |
認証に使用される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ログインを実装するには、この要素内にclientId 属性を追加し、Google Cloud Consoleから発行されたクライアントIDを属性値として入力する必要があります。 Steam Deck(Hive SDK v4 Unity Windows 22.0.0以上)でGoogleログインを実装するには、この要素内にdeviceFlowClientId 属性を追加し、Google Cloud Consoleから発行されたクライアントIDを属性値として入力する必要があります。 | |
プロバイダー要素で、v4での認証に使用されるWeChat関連の設定を追加します。 | |
プロバイダー要素で、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で作成されたプロジェクトの**ユーザー認証設定 / アプリ情報**に設定されています。
認証 IdP テレグラムログイン用のボットの設定¶
認証にテレグラムログインサービスを提供するには、専用のボットが必要です。
次の手順でボットを作成し、botIdとbotDomainを取得してください。 詳細については、Telegram公式ドキュメントを参照してください。
- Telegramで「@BotFather」を検索し、公式認証マークのあるチャットルームにアクセスします。
- 下部の「開始」をクリックし、チャットウィンドウに
/newbot
コマンドを入力します。BotFatherの指示に従って「name」と「username」を入力することで、認証トークンを受け取ることができます。この時、ユーザー名は変更できないため、慎重に入力する必要があります。取得したトークン文字列のコロン(':')の前の数字はbotIdに対応します。このトークンは後でHiveコンソールに入力する必要があるため、一緒に保存してください。 - チャットウィンドウに
/setDomain
コマンドを入力します。ログイン画面に表示されるドメインアドレスを設定できます。入力値はbotDomainとして使用されます。 - 取得したbotIdとbotDomainをhive_config.xmlに入力します。Unityを使用している場合は、hive_config.xmlの設定を参照することで簡単に追加できます。