用户流程

1. 用户前往已设置用户ID认证的Web商店。
2. 用户在选中的商品下方点击立即购买或在顶部栏中点击登录。
3. 随后将打开一个模态窗口，要求用户输入其ID或选择一个社交网络。

4. 用户输入其用户ID并点击继续，或点击社交网络图标选择一个社交网络并在社交网络页面上完成身份认证。
5. 系统检查用户是否在游戏中存在。如游戏中存在该ID或社交网络帐户的用户，则用户被授权进入Web商店。否则将显示一条错误消息。

如何获取

1. 在您的应用程序侧，实现对用户验证Webhook的处理。

收到Webhook后，应用程序应执行以下操作：

• 根据Webhook中传入的ID搜索用户。
• 根据结果发送以下状态代码之一：
  • 如找到了该用户，发送200 HTTP代码和Webhook回应
  • 如未找到该用户，发送404 HTTP代码
  如要进行个性化，
• 发送用户属性。

2. 在发布商帐户中，前往建站器部分。
3. 在网站栏中单击打开建站器。
4. 前往登录管理器设置区块。

5. 选择用户ID选项。

6. 在下拉列表中，选择新建登录管理器。

7. 输入接收Webhook的URL。

8. 设置通过应用程序连接的社交网络进行认证（可选）：
   1. 在发布商帐户中打开您的项目，然后前往登录管理器部分。
   2. 在网站栏中单击配置。
   3. 前往身份认证区块，然后选择社交网络登录。

1. 4. 要设置社交网络，请前往社交网络版块，单击标题右侧的⚙图标，然后选择连接。

如何获取

1. 在网站的建站器中，前往登录管理器设置区块。

2. 选择艾克索拉登录管理器授权方式。
3. 在下拉菜单列表中，选择新建登录管理器。

4. 从模态窗口中前往登录管理器项目设置，或在艾克索拉登录管理器区块中单击设置认证方法。

5. 连接用户数据存储。

根据用户数据的存储方式不同，可用的产品功能也不同（请参阅用户数据存储方式比较）。

艾克索拉存储

如希望登录管理器产品处理所有认证逻辑，请连接艾克索拉存储。您将可以使用更多灵活的设置。

创建登录管理器项目时，默认会连接艾克索拉存储，无需额外配置步骤。如更改了默认存储类型后需要重新连接艾克索拉存储，请执行以下步骤：

1. 在导航页上，前往用户数据库区块，然后选择存储部分。
2. 选择艾克索拉存储，然后单击保存更改。

PlayFab存储

如果要使用PlayFab功能与用户交互，请连接PlayFab存储。它存储以下用户数据：

• 用户名
• 用户邮箱地址
• 用户密码
• 更详细注册表单的字段（如事先进行了设置）

使用PlayFab可实现以下功能：

• 用户注册
• 通过邮箱地址或用户名和密码进行认证
• 通过Twitch进行认证
• 用户密码重置
• 用户拦截

要连接该存储：

1. 在导航页上，前往用户数据库区块，然后选择存储部分。
2. 选择PlayFab。
3. 在游戏ID字段，输入PlayFab帐户中同一字段的值。
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状态代码指示失败的请求。

设置对来自艾克索拉登录管理器服务器的请求进行处理

艾克索拉登录管理器服务器请求发送至在发布商帐户中指定的URL，且包含Authorization: Bearer <JWT>头。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"
}