ユーザーデータストレージを接続する
ユーザーデータの保存方法によって、利用できる製品の機能が異なります(ユーザーデータの保存方法の比較を参照してください)。
エクソーラストレージ
ログイン製品にすべての認証ロジックを処理させたい場合は、エクソーラストレージに接続します。より柔軟な設定が可能になります。
ログインプロジェクトを作成すると、エクソーラストレージがデフォルトで接続され、追加の設定手順は必要ありません。デフォルトのストレージタイプを変更し、エクソーラストレージに再接続する必要がある場合は、次の手順に従います:
- 「ユーザーデータベース」ブロックに移動して「ストレージ」セクションを選択します。
- 「エクソーラストレージ」を選択して「変更内容を保存する」をクリックします。
PlayFabストレージ
PlayFabの機能を使ってユーザーと連携したい場合は、PlayFabのストレージを接続します。ストレージには以下のユーザーデータが保存されます:
- ユーザー名
- ユーザーのメールアドレス
- ユーザーパスワード
- フォームが設定されている場合は、拡張登録フォームのフィールド
PlayFabストレージでは、以下の機能を利用できます:
- ユーザー登録
- メールアドレスまたはユーザー名とパスワードによる認証
- Twitchによる認証
- ユーザーパスワードのリセット
- ユーザーブロッキング
ストレージを接続するには:
- 「ユーザーデータベース」ブロックに移動して「ストレージ」セクションを選択します。
- 「PlayFab」を選択します。
- 「タイトルID」フィルドには、Firebaseアカウントから同じフィールドの値を入力してください。
- 「変更内容を保存する」をクリックします。
お知らせ
ユーザー情報はすべてエクソーラ側で保管されます。ユーザーパスワードは、PlayFabのみで検証されます。
Firebaseストレージ
Firebaseの機能を使用してユーザーと連携する場合は、Firebaseストレージを接続します。このストレージには、以下のユーザーデータが保存されます:
- ユーザー名
- ユーザーメールアドレス
- ユーザーパスワード
- フォームが設定されている場合は拡張登録フォームからのフィールド
- 「ユーザーデータベース」ブロックに移動して「ストレージ」セクションを選択します。
- 「Firebase」を選択します。
- 「APIキー」フィルドには、Firebaseアカウントから同じフィールドの値を入力してください。
- 「変更内容を保存する」をクリックします。
お知らせ
すべてのユーザー情報はJSON形式で保存され、接続されたすべてのクライアントでリアルタイムに更新されます。
カスタムストレージ
独自の認可システムを使用し、アプリケーション側でユーザーデータを保存する場合は、カスタムストレージに接続します。
カスタムストレージを使用する場合、次の機能にアクセスできます:
- ユーザー登録
- メールアドレスまたはユーザー名とパスワードによる認証
- 電話番号によるパスワードレス認証
- ソーシャルネットワークによる認証
- ユーザーパスワードのリセット
お知らせ
カスタムストレージは、JWT標準ベースの認証をサポートしています。
お知らせ
ユーザー情報はすべてエクソーラ側で保管されます。ユーザーパスワードは、カスタムストレージのみで検証されます。
カスタムストレージを接続する
- 「ユーザーデータベース」ブロックに移動して「ストレージ」セクションを選択します。
- 「カスタムストレージ」を選択します。
- APIリクエストの送信先のURLを入力します:
- 「変更内容を保存する」をクリックします。
- 設定したURLに対して、以下のように応答するAPIを実装します:
- リクエストに成功した場合のHTTP 200 / HTTP 204。必要であれば、追加のユーザーデータを含むJSONを応答本文に配置することができます。渡されたデータはJWTに書き込まれます(
partner_data
パラメータ)。 - その他、リクエストに失敗した場合のHTTPステータスコード。
- リクエストに成功した場合のHTTP 200 / HTTP 204。必要であれば、追加のユーザーデータを含むJSONを応答本文に配置することができます。渡されたデータはJWTに書き込まれます(
お知らせ
- データベースのユーザーIDを含んだJWTが必要な場合は、カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。
- 電話番号を使用したパスワードレス認証が正しく動作するためには、APIの応答にクライアントのユーザーIDと一致す
account_id
パラメータが含まれている必要があります。
エクソーラログインサーバーからのリクエストの処理をセットアップする
Authorization: Bearer <JWT>
ヘッダーがあるエクソーラログインサーバーのリクエストはご希望のURLに送信されます。JWTはプロジェクトの秘密鍵で署名されています。
リクエストを処理するには:
- 受信したJWTを検証します。
- 検証が成功した場合は、JWTをデコードし、以下の表のクレームが含まれていることを確認します。デコーディングのためのライブラリーを探して利用します。
クレーム | 種類 | 説明 |
---|---|---|
exp | Unix Timestamp | JWTの有効期限の日時。JWTの存続時間は7分です。 |
iat | Unix Timestamp | JWTが発行された日時。 |
iss | string | JWTに署名したサービスhttps://login.xsolla.com 。 |
request_type | string | 定数:gateway_request 。 |
xsolla_login_project_id | string(UUID) | アドミンページの御社のログインプロジェクトID。 |
social_access_token | string(UUID) | ユーザーが認証されたソーシャルネットワークのアクセストークン。このクレームの送信を有効にするには、カスタマーサクセスマネージャーに連絡するか、csm@xsolla.comに電子メールを送信してください。 |
Copy
- json
{
"exp": 1573635020,
"iat": 1573634600,
"iss": "https://login.xsolla.com",
"request_type": "gateway_request",
"xsolla_login_project_id": "00000000-0000-0000-0000-000000000000"
}
この記事は役に立ちましたか?
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。続きを読む
最終更新日: 2023年10月10日誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。