ドキュメントに戻る

統合ガイド

認証オプション

ユーザーデータストレージ

セキュリティ

カスタマイゼーション

通信サービスプロバイダー

特徴

ハウツー

拡張機能

法的設定

リファレンス

カスタムストレージ

内容

統合フロー
ユーザー登録
ユーザー名とパスワードによる認証
電話番号経由のパスワードレス認証
ソーシャルネットワーク経由の認証
ユーザーパスワードのリセット

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

ユーザー登録
ユーザー名とパスワード経由の認証
電話番号経由のパスワードレス認証
ソーシャルネットワーク経由の認証
ユーザーパスワード再設定

統合フロー

ログインウィジェットまたはLogin APIコールを使用するアプリケーションをクライアントとして使用できます。クライアントとエクソラログインサーバー間の対話フローは次のとおり：

クライアントはエクソラログインサーバーにリクエストを送信します。リクエストの形式は、JWTおよびPasswordエンドポイントで説明されています。
エクソラログインサーバーがサーバーにリクエストを送信します。指示に従ってリクエストを検証します。
エクソラログインサーバーはサーバーからの応答を処理し、結果をクライアントに返します。
クライアントは応答を処理します。

ユーザー登録

クライアントは、Register new userリクエストをエクソラログインサーバーに送信します。
ログインログインサーバーは、新しいユーザーのURLにリクエストを送信します。応答は、この指示で説明されている形式でなければなりません。

要求の例：

Copy

Full screen

Small screen

http

POST https://your.hostname/your_registration_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "email": "john@gmail.com",
  "password": "123456"
}

curl --request POST \
  --url 'https://your.hostname/your_registration_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","password":"123456"}'

応答の例：

Copy

Full screen

Small screen

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ],
    "your_name1": "your value1",
    "your_name2": "your value2",
    "your_name3": "your value3"
}

emailにフラグが付けられ、未確認の時、ユーザーデータはエクソラデータベースに書き込まれます。ユーザーはアカウント確認メールを受け取ります。
ログインウィジェットを統合している場合、ユーザーは次のメッセージとともにページにリダイレクトされます：{email}に送信した指示に従って、アカウントを確認してください。

ユーザー名とパスワードによる認証

御社のクライアントはAuth by username and password要求をエクソラログインサーバーに送信します。
エクソラログインサーバーは要求をユーザー確認URLに送ります。応答はこの指示で説明されている形式でなければなりません。

要求の例：

Copy

Full screen

Small screen

http

POST https://your.hostname/your_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "email": "john@gmail.com",
  "password": "123456"
}

curl --request POST \
  --url 'https://your.hostname/your_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","password":"123456"}'

応答の例：

Copy

Full screen

Small screen

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ],
    "your_name1": "your value1",
    "your_name2": "your value2",
    "your_name3": "your value3"
}

エクソラログインサーバーはユーザーJWTを生成します。
ユーザーはtokenクエリパラメータのあるlogin_urlにリダイレクトされます。tokenパラメータにはユーザーJWTが含まれます。

エクソラデータベースにユーザーデータが書き込まれていない場合は、新しいユーザーが作成されます。

電話番号経由のパスワードレス認証

クライアントは認証フォームを開き、ユーザーが電話番号を入力できるようにします。
ユーザーは電話番号を入力します。
クライアントはエクソラログインサーバーにStart auth by phone numberリクエストを送信します。
クライアントは、ユーザーが検証コードを入力できるようにフィールドを表示します。
ユーザーは受信した検証コードを入力します。
クライアントはエクソラログインにComplete auth by phone numberリクエストを送信します。
それが最初のユーザ認証である場合、エクソラログインサーバは、電話URL付きのパスワードレスログインにリクエストを送信します。応答は、この説明に記載されている形式でなければなりません。

要求の例：

Copy

Full screen

Small screen

http

POST https://your.hostname/your_phone_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "login": "+12025550140",
  "type": "phone"
}

curl --request POST \
  --url 'https://your.hostname/your_phone_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"login":"+12025550140","type":"phone"}'

応答の例：

Copy

Full screen

Small screen

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ],
    "your_name1": "your value1",
    "your_name2": "your value2",
    "your_name3": "your value3"
}

ソーシャルネットワーク経由の認証

ソーシャルネットワーク経由の認証時にユーザーデータを取得するには、パブリッシャーアカウントのログインプロジェクトの設定（セクションユーザーデータベース > ストレージ > カスタムストレージ）で、ソーシャルログインURLを指定します。ソーシャルネットワークから受信したデータを含むリクエストがこのURLに送信されます。

認証フロー：

クライアントがAuth via social networkリクエストをエクソラログインサーバーに送信します。
ユーザーはソーシャルネットワークにログインします。
エクソラログインサーバーは、ソーシャルネットワークから受信したユーザーデータを処理し、ソーシャルログインURLにリクエストを送信します。応答は、指示で説明されている形式でなければなりません。

リクエストはAuthorization: Bearer <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。必須。
email	string	ユーザーのメールアドレス。
sub	string（UUID）	エクソラログインサーバー側に書き込まれたユーザーID。必須。
username	string	ユーザー名。
provider	string	認証に使用されるソーシャルネットワークの名前。必須。
id	string	ソーシャルネットワークのユーザーID。必須。

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

Copy

Full screen

Small screen

{
  "exp": 1573635020,
  "iat": 1573634600,
  "iss": "https://login.xsolla.com",
  "request_type": "gateway_request",
  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000",
  "sub": "00000000-0000-0000-0000-000000000000",
  "email": "example@test.com",
  "username": "Smith707",
  "provider": "google",
  "id": "123",
}

要求の例：

Copy

Full screen

Small screen

http

POST https://your.hostname/your_social_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{}

curl --request POST \
  --url 'https://your.hostname/your_social_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json'

応答の例：

Copy

Full screen

Small screen

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ],
    "your_name1": "your value1",
    "your_name2": "your value2",
    "your_name3": "your value3"
}

ユーザーパスワードのリセット

クライアントは、Reset passwordリクエストをエクソラログインサーバーに送信します。
エクソラログインサーバーは、ユーザーにパスワードリセットの確認メールを送信します。
電子メールでパスワードのリセットを確認した後、ユーザーは新しいパスワードを入力できるページにリダイレクトされます。
ユーザーは新しいパスワードを入力します。
エクソラログインサーバーは、パスワードリセットURLにリクエストを送信します。応答は、この指示で説明されている形式でなければなりません。

要求の例：

Copy

Full screen

Small screen

http

POST https://your.hostname/your_reset_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "username": "john@gmail.com",
  "fields": {
    "password": "NewPa$$word1"
  }
}

curl --request POST \
  --url 'https://your.hostname/your_reset_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","fields":{"password":"NewPa$$word1"}}'

ご意見ありがとうございました！

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

このページを評価する

答えたくない

ご意見ありがとうございました！

続きを読む

お役立ちリンク

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

最終更新日: 2022年11月14日

誤字脱字などのテキストエラーを見つけましたか？テキストを選択し、Ctrl+Enterを押します。

内容

統合フロー
ユーザー登録
ユーザー名とパスワードによる認証
電話番号経由のパスワードレス認証
ソーシャルネットワーク経由の認証
ユーザーパスワードのリセット

Your browser is not supported. Please try a different browser

ログイン

カスタムストレージ

統合フロー

ユーザー登録

ユーザー名とパスワードによる認証

電話番号経由のパスワードレス認証

ソーシャルネットワーク経由の認証

ユーザーパスワードのリセット

この記事は役に立ちましたか？

このページを評価する

ご意見ありがとうございました！

続きを読む

お役立ちリンク