ユーザーフロー

1. ユーザーは、ユーザーID認証を設定済みのウェブショップに移動します。
2. ユーザーは、選択した項目の下にある今すぐ購入またはトップバーのログインをクリックします。
3. モーダルウィンドウが開き、ユーザーがIDを入力するか、ソーシャルネットワークを選択するよう要求されます。

4. ユーザーは、ユーザーIDを入力して続行するをクリックするか、ソーシャルネットワークのアイコンをクリックしてソーシャルネットワークを選択し、ソーシャルネットワークのページで認証を完了します。
5. ゲーム内にユーザーが存在するかどうかを確認します。このIDまたはソーシャルアカウントを持つユーザーがゲーム内に存在する場合、そのユーザーはウェブショップで認証されます。それ以外の場合は、エラーメッセージが表示されます。

入手方法

1. アプリケーション側では、ユーザー認証ウェブフック処理を実装してください。

ウェブフックを受信した場合、アプリケーションは以下の処理を行う必要があります：

• ウェブフックで渡されたIDでユーザーを検索します。
• その結果に応じて、以下のいずれかのステータスコードを送信します。
  • 200 HTTP - ユーザーが見つかった場合のウェブフックからの応答を含むコード
  • 404 HTTP - ユーザー IDが見つからない場合のコード
• パーソナライズのためのユーザー属性を送信します。

2. アドミンページでプロジェクトを開きます。
3. サイドバーで「サイトビルダー」と移動します。
4. 「サイトビルダーを開く」をクリックします。
5. 「サイトビルダーを開く」をクリックします。
6. 「ログイン設定」ブロックに移動します。

6. 「ユーザーID」オプションを選択します。

7. ドロップダウンリストで、「新規ログイン」を選択します。

8. ウェブフックを受信するURLを入力します。

9. アプリケーションにすでに接続されているソーシャル ネットワーク経由で認証を設定します（任意）：
   1. アドミンページでプロジェクトを開き、ログインセクションに移動します。
   2. サイドバーで構成をクリックします。
   3. 認証ブロックに移動してソーシャルログインを選択します。

1. 4. ソーシャルネットワークを設定するには、ソーシャルネットワークカードで、タイトルの右にある⚙アイコンをクリックし、接続を選択します。

入手方法

1. サイトのビルダーで、ログイン設定ブロックに移動します。

2. エクソーラログインの認証オプションを選択します。
3. ドロップダウンリストで、新規ログインを選択します。

4. モーダルウィンドウからログインプロジェクトの設定に移動するか、エクソーラログインブロックの認証方式をセットアップするをクリックします。

5. ユーザーデータストレージを接続します。

ユーザーデータの保存方法によって、利用できる製品の機能が異なります（ユーザーデータの保存方法の比較を参照してください）。

エクソーラストレージ

ログイン製品にすべての認証ロジックを処理させたい場合は、エクソーラストレージに接続します。より柔軟な設定が可能になります。

ログインプロジェクトを作成すると、エクソーラストレージがデフォルトで接続され、追加の設定手順は必要ありません。デフォルトのストレージタイプを変更し、エクソーラストレージに再接続する必要がある場合は、次の手順に従います：

1. ナビゲーションページで、ユーザーデータベースブロックに移動してストレージセクションを選択します。
2. エクソーラストレージを選択して変更内容を保存するをクリックします。

PlayFabストレージ

PlayFabの機能を使ってユーザーと連携したい場合は、PlayFabのストレージを接続します。ストレージには以下のユーザーデータが保存されます：

• ユーザー名
• ユーザーのメールアドレス
• ユーザーパスワード
• フォームが設定されている場合は、拡張登録フォームのフィールド

PlayFabストレージでは、以下の機能を利用できます：

• ユーザー登録
• メールアドレスまたはユーザー名とパスワードによる認証
• Twitchによる認証
• ユーザーパスワードのリセット
• ユーザーブロッキング

ストレージを接続するには：

1. ナビゲーションページで、ユーザーデータベースブロックに移動してストレージセクションを選択します。
2. PlayFabを選択します。
3. タイトルIDフィルドには、Firebaseアカウントから同じフィールドの値を入力してください。
4. 変更内容を保存するをクリックします。

Firebaseストレージ

Firebaseの機能を使用してユーザーと連携する場合は、Firebaseストレージを接続します。このストレージには、以下のユーザーデータが保存されます：

• ユーザー名
• ユーザーメールアドレス
• ユーザーパスワード
• フォームが設定されている場合は拡張登録フォームからのフィールド

ストレージを接続するには：

1. ナビゲーションページで、ユーザーデータベースブロックに移動してストレージセクションを選択します。
2. Firebaseを選択します。
3. APIキーフィルドには、Firebaseアカウントから同じフィールドの値を入力してください。
4. 変更内容を保存するをクリックします。

カスタムストレージ

独自の認可システムを使用し、アプリケーション側でユーザーデータを保存する場合は、カスタムストレージに接続します。

カスタムストレージを使用する場合、次の機能にアクセスできます：

• ユーザー登録
• メールアドレスまたはユーザー名とパスワードによる認証
• 電話番号によるパスワードレス認証
• ソーシャルネットワークによる認証
• ユーザーパスワードのリセット

エクソーラログインサーバーと御社のアプリケーション（クライアント）との接続を設定するには：

1. カスタムストレージを接続します。
2. エクソーラログインサーバーからのリクエストの処理を設定します。

カスタムストレージを接続する

1. ナビゲーションページで、ユーザーデータベースブロックに移動してストレージセクションを選択します。
2. カスタムストレージを選択します。
3. APIリクエストの送信先のURLを入力します：
   • ユーザー検証URL
   • 新規ユーザーURL
   • パスワードリセットURL
   • 電話番号によるパスワードレスログインURL
   • ソーシャルログインURL
4. 変更内容を保存するをクリックします。
5. 設定したURLに対して、以下のように応答するAPIを実装します：
   • リクエストに成功した場合のHTTP 200 / HTTP 204。必要であれば、追加のユーザーデータを含むJSONを応答本文に配置することができます。渡されたデータはJWTに書き込まれます（partner_dataパラメータ）。
   • その他、リクエストに失敗した場合のHTTPステータスコード。

エクソーラログインサーバーからのリクエストの処理をセットアップする

Authorization: Bearer <JWT>ヘッダーがあるエクソーラログインサーバーのリクエストはご希望のURLに送信されます。JWTはプロジェクトの秘密鍵で署名されています。

リクエストを処理するには：

1. 受信したJWTを検証します。
2. 検証が成功した場合は、JWTをデコードし、以下の表のクレームが含まれていることを確認します。デコーディングのためのライブラリーを探して利用します。

トークンペイロードの例：

{
  "exp": 1573635020,
  "iat": 1573634600,
  "iss": "https://login.xsolla.com",
  "request_type": "gateway_request",
  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000"
}