コンテンツにスキップ

始めに

ウェブログイン は、ユーザーがウェブを介してIdPにログインできる機能です。 ウェブログインをサポートするIdPを参照してください。

Web Login APIを使用することで、ユーザーはアプリの代わりに外部ウェブサイト（例：ゲーム開発者が運営するコミュニティサイト）でIdPログインを実装できます。現在、Web Login APIは既存のWeb Login v1とWeb Login v2を統合しています。

Warning
  • Web Login API version v2 and v1を別々に呼び出す方法は現在サポートされていません。継続的なサポートを受けるには、統合されたWeb Login APIを使用する必要があります。
  • 統合されたWeb Login APIはバージョンを区別しません。
Note

WebログインAPIを使用するには、Hiveコンソールで関連する設定を完了する必要があります。詳細については、コンソールガイドの認証 > ログイン設定にあるWebログインをサポートするIdPを参照してください。

ウェブログインAPIの使用方法

「web login AppID」の目的によって、ウェブログインAPIの使用は異なります。

'Web Login AppID'の目的が'コミュニティ'または'ウェブサイト'の場合

Hiveコンソールのアプリセンター > AppID管理 > ウェブログインAppID登録で'Web Login AppID'の目的をコミュニティまたはウェブサイトとして選択すると、ゲーム開発者は以下のようにWeb Login APIを使用します。

  1. ログインページを呼び出す
  2. ユーザー検証およびユーザー情報取得 APIのレスポンス値、特に IdP識別子（idp_index、idp_user_id をユーザーアカウント識別子として使用し、開発者のデータベースに保存します

上記のように使用する理由は、ゲーム内ではなくコミュニティやウェブサイトで最初にIdPにログインすると、ゲームで使用されるユーザー識別子であるPlayerIDが生成されないためです。PlayerIDの代わりにIdP識別子をユーザーアカウント識別子として使用することで、アカウントの競合 を防ぐことができます。

ただし、ユーザーがゲームアプリにアクセスしてログインすると、ゲームユーザー識別子であるPlayerIDが生成されます。したがって、これはユーザーアカウント識別子として使用でき、Verify and User Information Retrieval APIのuser_infoのレスポンス値にあるPlayerIDや、User Information Retrieval by Authentication API APIのレスポンス値にあるPlayerIDと区別されます。

Note

アカウントの競合は、以下のような状況で発生します。

  1. ウェブログインで初期のIdPとPlayerIDを作成するためにログインします
  2. Hive SDKを使用してゲームにログインした後、ゲームプロファイルで追加のIdP統合を接続します
  3. ウェブログインで既にPlayerIDが作成されているため、アカウントの競合が発生し、ユーザーにアカウントを選択するよう促されます

'Web Login AppID'を使用する目的は'Blockchain'のためです

Hiveコンソールで、App Center > AppID Management > Web Login AppID Registrationにおいて「Web Login AppID」の目的として「Blockchain」を選択する際、ゲーム開発者は以下のようにWeb Login APIを使用します。

  1. ログインページ API呼び出し
  2. ログイン検証とユーザー情報取得 API呼び出しとレスポンス値 PlayerID はユーザーアカウントの識別を可能にします（IdP識別子のような別の識別子を取得して管理する必要はありません）

ブロックチェーンの場合、ログインページ APIとログイン検証およびユーザー情報取得 APIを呼び出すことでPlayerIDが生成されるため、コミュニティやウェブサイトのような別のIdP識別子を使用する必要はありません。