设置用户认证

用户流程

1. 用户使用配置的用户ID认证前往网页商城。
2. 用户通过以下方式之一授权进入网页商城：
   • 用户在快速登录区块输入其ID并点击登录按钮。
   • 用户点击所选商品的购买按钮或页首栏中的登录按钮：
     1. 一个用于输入用户ID或使用社交网络登录的模态窗口将打开。
     2. 用户输入其ID并点击继续，或点击社交网络图标选择一个社交网络并在社交网络页面上完成身份认证。

3. 系统检查用户在游戏中是否存在。如游戏中存在该ID或该社交帐户的用户，用户即在网页商城中完成授权，否则将显示错误消息。

如何获取

1. 在您的应用程序侧，实现对用户验证Webhook的处理。 收到Webhook后，应用程序应执行以下操作：
   • 根据Webhook中传入的ID搜索用户。
   • 根据结果发送以下状态代码之一：
     • 如找到了该用户，发送200 HTTP代码和Webhook回应
     • 如未找到该用户，发送404 HTTP代码
     如要进行个性化，
   • 发送用户属性。

4. 如果您的网站包含多个页面，请选择需要编辑的页面：
   1. 单击建站器顶部的当前页面标题。
   2. 从下拉列表中选择目标页面。
5. 前往登录设置区块。

6. 选择用户ID选项。

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

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

深度链接是一种特殊的URL，不仅可以将用户跳转至应用程序或网站的主页面，还可以直接将其跳转至特定的区段、页面或操作。

深度链接可用作用户ID登录时的额外身份认证方式。如果游戏安装在用户移动设备上，将通过深度链接跳转到游戏获取一个授权令牌。

用户流程

在移动应用中

1. 网页商城中的未授权用户点击登录按钮或购买按钮。随后将打开一个用于输入用户ID或通过移动游戏登录的模态窗口。

2. 用户点击通过手机游戏登录按钮。
3. 用户将被跳转至游戏，然后自动以授权用户身份返回网页商城。

在桌面版本中

1. 网页商城中的未授权用户点击登录按钮或购买按钮。随后将打开一个用于输入用户ID或使用二维码登录游戏移动版本的模态窗口。

2. 用户使用移动设备扫描二维码。
3. 网页商城在用户的移动设备上打开。
4. 用户自动跳转至游戏，然后以已认证用户身份返回网页商城。

服务交互过程

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant U as 用户
    participant WS as 网页商城
    participant B as 浏览器
    participant MOS as 移动操作系统
    participant G as 游戏
    participant LA as 登录管理器API
    U->>WS: 点击按钮通过移动端游戏登录
    activate WS
    WS->>B: 通过深度链接跳转用户
    activate B
    B->>MOS: 系统调用：打开移动端游戏
    activate MOS
    MOS->>G: 打开移动端游戏
    activate G
    G->>LA: 生成授权令牌
    activate LA
    LA-->>G: 返回授权令牌
    deactivate LA
    G->>MOS: 系统调用：打开浏览器（URL含令牌）
    deactivate G
    MOS-->>B: 打开浏览器（URL含令牌）
    deactivate MOS
    B-->>WS: 打开已授权用户的网页商城页面
    deactivate B
    WS-->>U: 页眉显示用户名
    deactivate WS

如何设置

游戏侧

1. 在游戏的移动应用设置中，注册一个URL机制来通过深度链接打开游戏：
   • Android应用 — AndroidManifest.xml文件中。
   • iOS应用 — Info.plist文件中。

注册机制后，用户通过游戏认证进入网页商城时，游戏应在指定地址打开。

通过注册的URL机制打开游戏的链接示例：

scheme://authorize?operationPayload=<VALUE>，其中：
• scheme — 游戏的唯一标识符，用于自定义URL机制启动应用并导航至指定操作。
• authorize — 游戏打开后执行的操作名称示例。请使用与应用程序操作系统中一致的操作名称。
• operationPayload=<VALUE> — 包含身份认证时生成令牌所需信息的参数。该值为艾克索拉生成的Base64编码数据。

示例：

• 在iOS应用程序中注册URL机制
• 在Android应用程序中注册URL机制

Copy

Full screen

Small screen

• xml

 1<key>CFBundleURLTypes</key>
 2  <array>
 3    <dict>
 4      <key>CFBundleTypeRole</key>
 5      <string>Editor</string>
 6      <key>CFBundleURLSchemes</key>
 7      <array>
 8        <string>scheme</string>
 9      </array>
10    </dict>
11  </array>

Copy

Full screen

Small screen

• xml

1<intent-filter>
2    <action android:name="android.intent.action.VIEW" />
3    <category android:name="android.intent.category.DEFAULT" />
4    <category android:name="android.intent.category.BROWSABLE" />
5    <data android:scheme="scheme" android:host="authorize" />
6</intent-filter>

2. 实现使用游戏中的用户ID生成JWT格式授权令牌。

使用curl调用用户令牌生成API方法的示例：

 1curl -X 'POST' \
 2'https://sb-user-id-service.xsolla.com/api/v1/user-id/token' \
 3-H 'accept: /' \
 4-H 'Content-Type: application/json' \
 5-d '{
 6 "loginId": "000001aa-001a-0ab0-00001-01a01a01a01a",
 7 "settings": {
 8   "projectId": 123456,
 9   "merchantId": 123456
10 },
11 "user": {
12   "id": "123",
13   "country": "US"
14 }
15 "operationPayload": "kosarb2NyrtIWaegJAH1f6P7XrBYPXYDya5coc_ZzcfiS_5o4QTUAL-CcGRC_Kv4CAtg"
16}'

您将获得类似于{token="JWT_TOKEN"}的响应。

3. 添加显示授权成功通知的弹窗（可选）。

4. 实现使用获得的用户令牌在浏览器中打开网页商城。

在浏览器中为已授权用户打开网页商城的URL示例：
• https:​//example.com/?token={token}（使用自定义域名时）
• https:​//example.xsolla.site/?token={token}（使用艾克索拉域名时）

其中{token}为用户的授权令牌。

在建站器中

2. 在包含通过用户ID进行认证的网页商城网站所在卡片上单击配置。
3. 前往登录设置，然后选择用户ID部分。
4. 启用深度链接授权开关。

5. 在深度链接URL字段，输入用于用户身份认证的链接。

6. 如在网站上使用快速登录区块：
   1. 前往快速登录区块。
   2. 在布局部分，启用二维码开关。

7. 要检查身份认证，请单击预览。
8. 要发布网站，请单击发布。

深度链接是一种特殊的URL，不仅可以将用户跳转至应用程序或网站的主页面，还可以直接将其跳转至特定的区段、页面或操作。

深度链接允许用户一键通过游戏认证进入网页商城，而无需使用用户ID或艾克索拉登录管理器经历身份认证过程。

如果游戏安装在用户移动设备上，将通过深度链接跳转到游戏获取一个授权令牌。

当深度链接作为主要身份认证方式时，用户可以保存支付详情。这是通过用户ID加深度链接进行身份认证所无法实现的功能。该情况中，深度链接仅加快身份认证速度，不提供额外功能。

用户流程

在移动应用中

1. 网页商城中的未授权用户点击登录按钮或购买按钮。随后将打开一个用于通过移动游戏登录的模态窗口。

2. 用户点击通过手机游戏登录按钮。
3. 用户将被跳转至游戏，然后自动以授权用户身份返回网页商城。

在桌面版本中

1. 网页商城中的未授权用户点击登录按钮或购买按钮。随后将打开一个使用二维码登录游戏移动版本的模态窗口。

2. 用户使用移动设备扫描二维码。
3. 网页商城在用户的移动设备上打开。
4. 用户自动跳转至游戏，然后以已认证用户身份返回网页商城。

服务交互过程

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant U as 用户
    participant WS as 网页商城
    participant B as 浏览器
    participant MOS as 移动操作系统
    participant G as 游戏
    participant LA as 登录管理器API
    U->>WS: 点击按钮通过移动端游戏登录
    activate WS
    WS->>B: 通过深度链接跳转用户
    activate B
    B->>MOS: 系统调用：打开移动端游戏
    activate MOS
    MOS->>G: 打开移动端游戏
    activate G
    G->>LA: 生成授权令牌
    activate LA
    LA-->>G: 返回授权令牌
    deactivate LA
    G->>MOS: 系统调用：打开浏览器（URL含令牌）
    deactivate G
    MOS-->>B: 打开浏览器（URL含令牌）
    deactivate MOS
    B-->>WS: 打开已授权用户的网页商城页面
    deactivate B
    WS-->>U: 页眉显示用户名
    deactivate WS

如何设置

游戏侧

1. 在游戏的移动应用设置中，注册一个URL机制来通过深度链接打开游戏：
   • Android应用 — AndroidManifest.xml文件中。
   • iOS应用 — Info.plist文件中。

注册机制后，用户通过游戏认证进入网页商城时，游戏应在指定地址打开。

通过注册的URL机制打开游戏的链接示例：

scheme://authorize?operationPayload=<VALUE>，其中：
• scheme — 游戏的唯一标识符，用于自定义URL机制启动应用并导航至指定操作。
• authorize — 游戏打开后执行的操作名称示例。请使用与应用程序操作系统中一致的操作名称。
• operationPayload=<VALUE> — 包含身份认证时生成令牌所需信息的参数。该值为艾克索拉生成的Base64编码数据。

示例：

• 在iOS应用程序中注册URL机制
• 在Android应用程序中注册URL机制

Copy

Full screen

Small screen

• xml

 1<key>CFBundleURLTypes</key>
 2  <array>
 3    <dict>
 4      <key>CFBundleTypeRole</key>
 5      <string>Editor</string>
 6      <key>CFBundleURLSchemes</key>
 7      <array>
 8        <string>scheme</string>
 9      </array>
10    </dict>
11  </array>

Copy

Full screen

Small screen

• xml

1<intent-filter>
2    <action android:name="android.intent.action.VIEW" />
3    <category android:name="android.intent.category.DEFAULT" />
4    <category android:name="android.intent.category.BROWSABLE" />
5    <data android:scheme="scheme" android:host="authorize" />
6</intent-filter>

2. 实现使用游戏中的用户ID生成JWT格式授权令牌。

使用curl调用用户令牌生成API方法的示例：

 1curl -X 'POST' \
 2'https://sb-user-id-service.xsolla.com/api/v1/user-id/token' \
 3-H 'Accept: /' \
 4-H 'Content-Type: application/json' \
 5-d '{
 6 "loginId": "string",
 7 "settings": {
 8   "projectId": 0,
 9   "merchantId": 0
10 },
11 "user": {
12   "id": "string",
13   "country": "string",
14   "name": "string",
15   "picture": "string"
16 },
17 "operationPayload": "eyJ4c29sbGF1aWQiOiIzNzE5Nzc5NjU1MDE2Nzc2MzcifQ%3D%3D"
18}'

您将获得类似于{token="JWT_TOKEN"}的响应。

3. 添加显示授权成功通知的弹窗（可选）。

4. 实现使用获得的用户令牌在浏览器中打开网页商城。

在浏览器中为已授权用户打开网页商城的URL示例：
• https:​//example.com/?token={token}（使用自定义域名时）
• https:​//example.xsolla.site/?token={token}（使用艾克索拉域名时）

其中{token}为用户的授权令牌。

在建站器中

3. 前往登录设置，然后选择深度链接部分。

4. 在深度链接URL字段，输入用于用户身份认证的链接。

5. 如在网站上使用快速登录区块：
   1. 前往快速登录区块。
   2. 在区块设置中，调整二维码登录按钮的显示样式。

6. 要检查身份认证，请单击预览。
7. 要发布网站，请单击发布。

用户流程

1. 用户访问已配置艾克索拉登录管理器身份认证的网充商店。
2. 用户点击所选商品的购买按钮、顶部栏中的登录按钮，或Fast Login区块中的登录按钮
3. 系统打开包含授权方式的模态弹层。
4. 用户继续完成授权，并根据需要填写补充信息。
5. 系统检查该用户是否存在于游戏中。如果存在，用户即可在网充商店完成身份认证；否则，系统会显示错误消息。

如何设置

2. 在已配置艾克索拉登录管理器身份认证的网充商店网站卡片上，点击**•••图标，然后选择Configure**。
3. 点击Go to Builder，滚动到Login settings区块。

4. 选择Xsolla Login授权方式。

5. 在Xsolla Login选项中，从下拉列表中选择一个身份认证选项：
   • 如果项目中已配置艾克索拉登录管理器，请选择现有选项
   • 如果网充商店尚未配置身份认证选项，请选择New Login

首次预览或发布网站时，网充商店的预览URL和域名会自动添加到身份认证选项设置中的Callback URL字段。用户会在以下情况下被重定向到这些URL：

• 身份认证成功后
• 完成邮箱验证后
• 完成密码重置后
• 身份认证失败时

更改网充商店域名后，这些URL会自动更新。

6. 设置用户可用于登录网充商店的社交网络（可选）。详细信息请参阅社交网络登录文档。

7. 如果不想在艾克索拉侧存储用户数据，可以连接其他存储（可选）。详细信息请参阅连接用户数据存储文档。

可用功能取决于所选存储。详细信息请参阅用户数据存储方式比较文档。

用户流程

1. 用户首次访问配置了使用关联用户ID进行身份认证的网页商城。
2. 用户点击所选商品的购买按钮、页首栏中的登录按钮或快速登录区块中的登录按钮。
3. 随后将打开一个模态窗口，其中包含在艾克索拉登录管理器中设置的身份认证方式。
4. 用户进行授权，如有必要输入其他数据。

5. 通过艾克索拉登录管理器成功授权后，打开用于关联游戏用户ID的模态窗口。

6. 系统检查用户是否存在。如果游戏中存在指定ID的用户，则用户在网页商城中获得授权。否则显示错误消息。

如何获取

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

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

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

4. 如果您的网站包含多个页面，请选择需要编辑的页面：
   1. 单击建站器顶部的当前页面标题。
   2. 从下拉列表中选择目标页面。
5. 前往登录设置区块。

6. 选择使用关联用户ID登录选项。
7. 在下拉列表中，选择新建登录管理器或已创建的项目。
8. 输入接收Webhook的URL。