ユーザーデータストレージを接続する

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

エクソーラストレージ

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

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

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"
}

続きを読む