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

1. クライアントはエクソーラログインに送信します。リクエストのフォーマットについては認証方法で説明されています。
2. エクソーラログインサーバーはあなたのサーバーにウェブフックを送信します。ヘッダーには“request_type”: “gateway_token”パラメータを持つサーバーJWTが含まれます。トークン検証をセットアップすｒには、説明に従ってください。ユーザー識別データの一部は、ウェブフックの本文で渡されます。
3. ウェブフックの受信を確認するには、サーバーは以下を返す必要があります：
   • 応答が成功した場合は200、201、または204 HTTPコード。
   • 指定されたユーザーが見つからなかった場合、または無効な署名が渡された場合は、問題の説明を含む400 HTTPコード。サーバー上で、一時的な問題が発生した場合、ウェブフックハンドラーは5xxHTTPコードを返すこともあります。
4. エクソーラログインサーバーはサーバーから応答を処理し、認証トークンをクライアントに返します。
5. クライアントは応答を処理します。

ユーザー識別後にユーザー情報をJWTに追加したい場合は、レスポンスボディに任意のパラメータセットを含むJSONオブジェクトを返してください。このオブジェクトは、JWTのpartner_dataフィールドに保存されます。

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

1. クライアントはエクソーラログインに送信します。リクエストのフォーマットについては認証方法で説明されています。
2. エクソーラログインサーバーはあなたのサーバーにウェブフックを送信します。ヘッダーには“request_type”: “gateway_token”パラメータを持つサーバーJWTが含まれます。トークン検証をセットアップすｒには、説明に従ってください。ユーザー識別データの一部は、ウェブフックの本文で渡されます。
3. ウェブフックの受信を確認するには、サーバーは以下を返す必要があります：
   • 応答が成功した場合は200、201、または204 HTTPコード。
   • 指定されたユーザーが見つからなかった場合、または無効な署名が渡された場合は、問題の説明を含む400 HTTPコード。サーバー上で、一時的な問題が発生した場合、ウェブフックハンドラーは5xxHTTPコードを返すこともあります。

5. エクソーラログインサーバーは、あなたのサーバーからの応答を処理し、クライアントに認証トークンを返します。
6. クライアントは、エクソーラログインサーバーにJWTを生成するPOSTリクエストを送信します。リクエスト本文には、以下の必須パラメータを含める必要があります：
   • grant_type — JWTグラントタイプで、authorization_codeの値を渡します。
   • client_id — OAuth 2.0クライアントID。
   • client_secret — OAuth 2.0クライアントシークレットID。機密認証タイプに必要です。
   • code — 認証コード。
7. エクソーラログインサーバーは、アクセストークンとリフレッシュトークンのペアをクライアントに返します。
8. クライアントは応答を処理します。
9. アクセストークンの有効期限が切れると、クライアントはエクソーラログインサーバーにJWTを生成する POSTリクエストを送信します。リクエスト本文には、以下の必須パラメータを含める必要があります：
   • grant_type — JWTグラントタイプで、refresh_tokenの値を渡します。
   • client_id — OAuth 2.0クライアントID。
   • refresh_token — ユーザー認証リクエストへの応答で受け取ったリフレッシュトークン。

JWTでユーザーを識別したり、トークンをリフレッシュする際に、ユーザー情報をJWTに追加できます。応答本文で任意のパラメータを含むJSONオブジェクトを返すことで、このオブジェクトはJWTのpartner_dataフィールドに保存されます。

1. クライアントは、Register new user POSTリクエストをエクソーラログインサーバーに送信します。リクエストには、以下の必須パラメータを含める必要があります：
   • projectIdクエリパラメータ — パブリッシャーアカウントのログインプロジェクトのID。
   • 本文パラメータ：
     • username — ユーザー名。許可される長さ：3～255文字。
     • password — ユーザーのパスワード。許可される長さ：6～100文字。
     • email — ユーザーのメールアドレス。許可される長さ：１～255文字。
2. エクソーラログインサーバーは、「新規ユーザー検URL」にウェブフックを送信します。応答は、このインタラクションフローで説明されている形式である必要があります。応答では、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。レスポンスで提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。

ウェブフックの例：

1POST https://your.hostname/your_registration_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"j.smith@email.com",
7  "password":"123456",
8  "username":"j.smith@email.com"
9}

1curl --request POST \
2  --url 'https://your.hostname/your_registration_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

3. emailにフラグが付けられ、未確認の時、ユーザーデータはエクソーラデータベースに書き込まれます。ユーザーはアカウント確認メールを受け取ります。
4. ログインウィジェットを統合している場合、ユーザーは次のメッセージとともにページにリダイレクトされます：{email}に送信した指示に従って、アカウントを確認してください。
5. ユーザー登録に失敗した場合、認証ウィジェットに表示されるエラーメッセージを提供することができます。これを行うには、ユーザ作成リクエストの応答で、以下の詳細を持つerrorオブジェクトを渡します：
   • codeパラメータで、エラーコード（例：011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを提供します。

エラーメッセージを持つオブジェクトの例：

1{
2  "error": {
3    "code": "011-002",
4    "description": "<string>"
5  }
6}

1. クライアントは、Register new user POSTリクエストをエクソーラログインサーバーに送信します。リクエストには以下の必須パラメータを含める必要があります：
   • クエリパラメータ：
     • response_type — JWTグラントタイプでは、codeの値を渡します。
     • client_id — OAuth 2.0クライアントID。
     • state — 追加のユーザー認証に使用される値です。CSRF攻撃を防ぐために必要です。応答で返されます。許容される長さは1〜8文字です。
   • 本文パラメータ：
     • username — ユーザー名。許可される長さ：3～255文字。
     • password — ユーザーのパスワード。許可される長さ：6～100文字。
     • email — ユーザーのメールアドレス。許可される長さ：１～255文字。
2. エクソーラログインサーバーは、「新規ユーザー検URL」にウェブフックを送信します。応答は、このインタラクションフローで説明されている形式である必要があります。応答では、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。レスポンスで提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。

ウェブフックの例：

1POST https://your.hostname/your_registration_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"j.smith@email.com",
7  "password":"123456",
8  "username":"j.smith@email.com"
9}

1curl --request POST \
2  --url 'https://your.hostname/your_registration_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

3. emailにフラグが付けられ、未確認の時、ユーザーデータはエクソーラデータベースに書き込まれます。ユーザーはアカウント確認メールを受け取ります。
4. ログインウィジェットを統合している場合、ユーザーは次のメッセージとともにページにリダイレクトされます：{email}に送信した指示に従って、アカウントを確認してください。
5. ユーザー登録に失敗した場合、認証ウィジェットに表示されるエラーメッセージを提供することができます。これを行うには、ユーザ作成リクエストの応答で、以下の詳細を持つerrorオブジェクトを渡します：
   • codeパラメータで、エラーコード（例：011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを提供します。

エラーメッセージを持つオブジェクトの例：

1{
2  "error": {
3    "code": "011-002",
4    "description": "<string>"
5  }
6}

1. クライアントは、Auth by username and password POSTリクエストをエクソーラログインサーバーに送信します。リクエストには、以下の必須パラメータを含める必要があります：
   • projectIdクエリパラメータ — パブリッシャーアカウントのログインプロジェクトのID。
   • 本文パラメータ：
     • username — ユーザー名。許可される長さ：3～255文字。
     • password — ユーザーのパスワード。許可される長さ：6～100文字。
2. エクソーラログインサーバーは、「ユーザー検証URL」にウェブフックを送信します。応答は、このインタラクションフローで説明されている形式である必要があります。応答では、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。レスポンスで提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。

ユーザー検証URLウェブフックの例：

1POST https://your.hostname/your_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"j.smith@email.com",
7  "password":"123456",
8  "username":"j.smith@email.com"
9}

1curl --request POST \
2  --url 'https://your.hostname/your_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

3. ユーザー認証が失敗した場合、認証ウィジェットに表示するエラーメッセージを提供できます。これを行うには、ユーザー作成リクエストの応答で、以下の詳細情報を含むerrorオブジェクトを渡します：
   • codeパラメータには、エラーコード（例えば、011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを入力します。
4. エクソーラログインサーバーはユーザーJWTを生成します。
5. ユーザーは、tokenクエリパラメータを使用してlogin_urlにリダイレクトされます。このtokenパラメータには、ユーザーJWTが含まれています。

1. クライアントは、Auth by username and password POSTリクエストをエクソーラログインサーバーに送信します。リクエストには以下の必須パラメータを含める必要があります：
   • クエリパラメータ：
     • response_type — JWTグラントタイプでは、codeの値を渡します。
     • client_id — OAuth 2.0クライアントID。
     • state — 追加のユーザー認証に使用される値です。CSRF攻撃を防ぐために必要です。応答で返されます。許容される長さは1〜8文字です。
   • 本文パラメータ：
     • username — ユーザー名。許可される長さ：3～255文字。
     • password — ユーザーのパスワード。許可される長さ：6～100文字。
2. エクソーラログインサーバーは、新規ユーザー検URLにウェブフックを送信します。応答は、このインタラクションフローで説明されている形式である必要があります。応答では、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。レスポンスで提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。

ユーザー検証URLウェブフックの例：

1POST https://your.hostname/your_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"j.smith@email.com",
7  "password":"123456",
8  "username":"j.smith@email.com"
9}

1curl --request POST \
2  --url 'https://your.hostname/your_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

3. ユーザー認証が失敗した場合、認証ウィジェットに表示するエラーメッセージを提供できます。これを行うには、ユーザー作成リクエストの応答で、以下の詳細情報を含むerrorオブジェクトを渡します：
   • codeパラメータには、エラーコード（例えば、011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを入力します。
4. エクソーラログインサーバーはユーザーJWTを生成します。
5. ユーザーは、tokenクエリパラメータを使用してlogin_urlにリダイレクトされます。このtokenパラメータには、ユーザーJWTが含まれています。

1. クライアントは認証フォームを開き、ユーザーが電話番号を入力できるようにします。
2. ユーザーは自分の電話番号を入力します。
3. クライアントは、エクソーラログインサーバーにStart auth by phone number POSTリクエストを送信します。リクエストには以下の必須パラメータを含める必要があります：
   • projectIdクエリパラメータ — パブリッシャーアカウントのログインプロジェクトのID。
   • phone_number本文パラメータ — ユーザーの電話番号。
4. クライアントは、ユーザーが検証コードを入力するためのフィールドを表示します。
5. ユーザーは受信した検証コードを入力します。

6. クライアントは、エクソーラサーバーにComplete auth by phone number POSTリクエストを送信します。リクエストには以下の必須パラメータを含める必要があります：
   • projectIdクエリパラメータ — パブリッシャーアカウントのログインプロジェクトのID。
   • 本文パラメータ：
     • code — 確認コード。
     • phone_number — ユーザーの電話番号。
     • operation_id — 確認コードID。
7. 初回ユーザー認証の場合、エクソーラログインサーバーはパスワードレスログインURLにウェブフックを送信します。レスポンスは、このインタラクションフローで説明されている形式である必要があります。応答では、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。応答で提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。
8. ユーザー認証が失敗した場合、認証ウィジェットに表示するエラーメッセージを提供できます。これを行うには、ユーザー作成リクエストへのレスポンスで、以下の詳細を含むerrorオブジェクトを渡します。
   • codeパラメータには、エラーコード（例：011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを入力します。

ウェブフックの例：

1POST https://your.hostname/your_phone_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "login": "+12025550140",
7  "type": "phone"
8}

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

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

1. クライアントは認証フォームを開き、ユーザーが電話番号を入力できるようにします。
2. ユーザーは自分の電話番号を入力します。
3. クライアントは、エクソーラログインサーバーにStart auth by phone number POSTリクエストを送信します。リクエストには以下の必須パラメータを含める必要があります：
   • クエリパラメータ：
     • response_type — JWTグラントタイプでは、codeの値を渡します。
     • client_id — OAuth 2.0クライアントID。
     • state — 追加のユーザー認証に使用される値です。CSRF攻撃を防ぐために必要です。レスポンスで返されます。許容される長さは1〜8文字です。
   • phone_number本文パラメータ — ユーザーの電話番号。
4. クライアントは、ユーザーが検証コードを入力するためのフィールドを表示します。
5. ユーザーは受信した検証コードを入力します。

6. クライアントは、エクソーラサーバーにComplete auth by phone number POSTリクエストを送信します。リクエストには以下の必須パラメータを含める必要があります：
   • client_idクエリパラメータ — OAuth 2.0クライアントID。
   • 本文パラメータ：
     • code — 確認コード。
     • phone_number — ユーザーの電話番号。
     • operation_id — 確認コードID。
7. 初回ユーザー認証の場合、エクソーラログインサーバーはパスワードレスログインURLにウェブフックを送信します。レスポンスは、このインタラクションフローで説明されている形式である必要があります。応答では、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。応答で提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。
8. ユーザー認証が失敗した場合、認証ウィジェットに表示するエラーメッセージを提供できます。これを行うには、ユーザー作成リクエストへのレスポンスで、以下の詳細を含むerrorオブジェクトを渡します。
   • codeパラメータには、エラーコード（例：011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを入力します。

ウェブフックの例：

1POST https://your.hostname/your_phone_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "login": "+12025550140",
7  "type": "phone"
8}

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

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

1. クライアントは認証フォームを開き、ユーザーがメールアドレスを入力できるようにします。
2. ユーザーは自分のメールアドレスを入力します。
3. クライアントは、エクソーラログインサーバーにStart auth by email POSTリクエストを送信します。リクエストには以下の必須パラメータを含める必要があります：
   • projectIdクエリパラメータ — パブリッシャーアカウントのログインプロジェクトのID。
   • email本文パラメータ — ユーザーのメールアドレス。
4. クライアントは、ユーザーが検証コードを入力するためのフィールドを表示します。
5. ユーザーは受信した検証コードを入力します。

6. クライアントは、エクソーラサーバーにComplete auth by email POSTリクエストを送信します。リクエストには以下の必須パラメータを含める必要があります：
   • projectIdクエリパラメータ — パブリッシャーアカウントのログインプロジェクトのID。
   • 本文パラメータ：
     • code — 確認コード。
     • email — ユーザーのメールアドレス。
     • operation_id — 確認コードID。
7. 初回ユーザー認証の場合、エクソーラログインサーバーはパスワードレスログインURLにウェブフックを送信します。レスポンスは、このインタラクションフローで説明されている形式である必要があります。応答では、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。応答で提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。
8. ユーザー認証が失敗した場合、認証ウィジェットに表示するエラーメッセージを提供できます。これを行うには、ユーザー作成リクエストへのレスポンスで、以下の詳細を含むerrorオブジェクトを渡します。
   • codeパラメータには、エラーコード（例：011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを入力します。

ウェブフックの例：

1POST https://your.hostname/your_email_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email": "user@mail.com",
7  "type": "email"
8}

1curl --request POST \
2  --url 'https://your.hostname/your_email_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email": "user@mail.com","type": "email"}'

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

1. クライアントが認証フォームを開き、ユーザーがメールアドレスを入力できるようにします。
2. ユーザーがメールアドレスを入力します。
3. クライアントがエクソーラログインサーバーにStart auth by email POSTリクエストを送信します。このリクエストには、以下の必須パラメータを含める必要があります：
   • クエリパラメータ：
     • response_type — JWTグラントタイプで、codeの値を渡します。
     • client_id— OAuth 2.0クライアントID。
     • state — 追加のユーザー認証に使用される値です。CSRF攻撃を防ぐために必要です。応答で返されます。許容される長さは1〜8文字です。
   • email本文パラメータ — ユーザーのメールアドレス。
4. クライアントがユーザーに検証コードを入力するためのフィールドを表示します。
5. ユーザーが受け取った認証コードを入力します。

6. クライアントは、エクソーラサーバーにComplete auth by email POSTリクエストを送信します。リクエストには以下の必須パラメータを含める必要があります：
   • client_idクエリパラメータ — OAuth 2.0クライアントID。
   • 本文パラメータ：
     • code — 確認コード。
     • email — ユーザーのメールアドレス。
     • operation_id — 確認コードID。
7. 初回ユーザー認証の場合、エクソーラログインサーバーはパスワードレスログインURLにウェブフックを送信します。レスポンスは、このインタラクションフローで説明されている形式である必要があります。応答では、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。応答で提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。
8. ユーザー認証が失敗した場合、認証ウィジェットに表示するエラーメッセージを提供できます。これを行うには、ユーザー作成リクエストへのレスポンスで、以下の詳細を含むerrorオブジェクトを渡します。
   • codeパラメータには、エラーコード（例：011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを入力します。

ウェブフックの例：

1POST https://your.hostname/your_email_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email": "user@mail.com",
7  "type": "email"
8}

1curl --request POST \
2  --url 'https://your.hostname/your_email_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email": "user@mail.com","type": "email"}'

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

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

認証フロー：

1. クライアントは、エクソーラログインサーバーにAuth via social network POSTリクエストを送信します。リクエストには以下の必須パラメータを含める必要があります：
   • projectIdクエリパラメータ — パブリッシャーアカウントのログインプロジェクトのID。
   • provider_nameパスパラメータ — パブリッシャーアカウントでログインに接続されているソーシャルネットワークの名前。指定可能な値：amazon、apple、xsolla、baidu、battlenet、discord、epicgames、facebook、github、google、kakao、linkedin、mailru、microsoft、msn、naver、ok、paypal、qq、reddit、steam、twitch、twitter、vimeo、vk、wechat、weibo、xbox、yahoo、yandex、youtube。
2. ユーザーはソーシャルネットワークにログインします。
3. エクソーラログインサーバーは、ソーシャルネットワークから受信したユーザーデータを処理し、ソーシャルログインURLにウェブフックを送信します。応答は、このインタラクションフローで説明されている形式である必要があります。レスポンスでは、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。レスポンスで提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。

ユーザーデータは、一時的なゲートウェイトークン（“request_type”: “gateway_token”を持つサーバートークン）としてAuthorizationヘッダーに渡されます。

ゲートウェイトークンの主なフィールド：

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

 1{
 2  "exp": 1573635020,
 3  "iat": 1573634600,
 4  "iss": "https://login.xsolla.com",
 5  "request_type": "gateway_request",
 6  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000",
 7  "sub": "00000000-0000-0000-0000-000000000000",
 8  "email": "example@test.com",
 9  "username": "Smith707",
10  "provider": "google",
11  "id": "123",
12}

ソーシャルログイン URLウェブフックの例：

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

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

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

4. ユーザー認証が失敗した場合、認証ウィジェットに表示するエラーメッセージを提供できます。これを行うには、ユーザー作成リクエストの応答で、以下の詳細情報を含むerrorオブジェクトを渡します：
   • codeパラメータには、エラーコード（例えば、011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを入力します。

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

認証フロー：

1. クライアントは、エクソーラログインサーバーにAuth via social network POSTリクエストを送信します。リクエストには、以下の必須パラメータを含める必要があります：
   • クエリパラメータ：
     • response_type — JWTグラントタイプで、codeの値を渡します。
     • client_id — OAuth 2.0クライアントID。
     • state — 追加のユーザー認証に使用される値です。CSRF攻撃を防ぐために必要です。応答で返されます。許容される長さは1〜8文字です。
   • provider_nameパスパラメータ — パブリッシャーアカウントでログインに接続されているソーシャルネットワークの名前。指定可能な値：amazon、apple、xsolla、baidu、battlenet、discord、epicgames、facebook、github、google、kakao、linkedin、mailru、microsoft、msn、naver、ok、paypal、qq、reddit、steam、twitch、twitter、vimeo、vk、wechat、weibo、xbox、yahoo、yandex、youtube。
2. ユーザーはソーシャルネットワークにログインします。
3. エクソーラログインサーバーは、ソーシャルネットワークから受信したユーザーデータを処理し、ソーシャルログインURLにウェブフックを送信します。応答は、このインタラクションフローで説明されている形式である必要があります。レスポンスでは、ユーザー属性のリストや必要なJSONオブジェクトを指定できます。レスポンスで提供するJSONオブジェクトは、ユーザーのJWTのpartner_dataフィールドに記録されます。

ユーザーデータは、一時的なゲートウェイトークン（“request_type”: “gateway_token”を持つサーバートークン）としてAuthorizationヘッダーに渡されます。

ゲートウェイトークンの主なフィールド：

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

 1{
 2  "exp": 1573635020,
 3  "iat": 1573634600,
 4  "iss": "https://login.xsolla.com",
 5  "request_type": "gateway_request",
 6  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000",
 7  "sub": "00000000-0000-0000-0000-000000000000",
 8  "email": "example@test.com",
 9  "username": "Smith707",
10  "provider": "google",
11  "id": "123",
12}

ソーシャルログイン URLウェブフックの例：

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

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

ユーザー属性を含むウェブフックへの応答の例：

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

JSONオブジェクトを使用したウェブフックへの応答の例：

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

4. ユーザー認証が失敗した場合、認証ウィジェットに表示するエラーメッセージを提供できます。これを行うには、ユーザー作成リクエストの応答で、以下の詳細情報を含むerrorオブジェクトを渡します：
   • codeパラメータには、エラーコード（例えば、011-002）を指定します。
   • descriptionパラメータには、エラーメッセージのテキストを入力します。