通过深度链接设置身份认证

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

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

用户流程

在移动应用中

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

2. 用户点击通过游戏登录的按钮。
3. 用户被跳转到游戏，并在那里自动以授权用户的身份跳转到网页商城。

在桌面版本中

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

2. 用户有移动设备扫描二维码，然后网页商城即在其移动设备上打开。
3. 游戏的移动版本在用户移动设备上打开。
4. 用户自动以授权用户的身份跳转到移动设备上的网页商城。

服务交互过程

如何设置

游戏侧

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

• gamename — 应在移动设备上打开的用于用户认证的游戏的名称。
• authorize — 游戏打开后应执行的操作名称示例。请使用与应用操作系统中的操作一致的操作名称。

<key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>gamename</string>
      </array>
    </dict>
  </array>

在Android应用中注册URL机制的示例：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="gamename" android:host="authorize" />
</intent-filter>

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

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

curl --location 'https://sb-user-id-service.xsolla.com/api/v1/user-id' \
--header 'Content-Type: application/json' \
--data '{
 "loginId": "000001aa-001a-0ab0-00001-01a01a01a01a",
 "webhookUrl": "https://nowebhook.com",
 "settings": {
   "projectId": 123456,
   "merchantId": 123456
 },
 "user": {
   "id": "123",
   "name": "a-user-name"
 }
}'

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

3. 添加一个包含授权成功通知（可选）。
4. 实现使用获得的用户令牌在浏览器中打开网页商城。

创建对已授权用户在浏览器中打开网页商城的URL示例：

• https:​//example.com/?token={token}（如使用自定义域名）
• https:​//example.xsollasitebuilder.com/?token={token}（如使用艾克索拉域名）

在建站器中

1. 在发布商帐户中打开项目。
2. 在侧边栏中单击建站器。
3. 在包含通过用户ID进行认证的网页商城网站所在卡片上单击配置。
4. 前往登录设置，然后选择用户ID部分。
5. 将深度链接授权开关设置为开。

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

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

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