如何通过艾克索拉ID集成用户认证

工作原理

您可以通过艾克索拉ID添加用户认证，这是一个共享身份平台，提供跨艾克索拉产品的无缝访问。

您可以实现以下用户场景之一：

• 通过点击登录小组件中的 Log in with Xsolla 按钮，在模态窗口中打开艾克索拉ID认证页面：

  1. 用户点击登录小组件中的 Log in with Xsolla 按钮。
  2. 用户被重定向到在模态窗口中打开的艾克索拉ID认证页面。
  3. 用户在艾克索拉ID认证页面完成认证过程。
  4. 用户被重定向到 发布商帐户 中 回调URL 字段指定的URL。

• 通过点击登录小组件中的 Log in with Xsolla 按钮，重定向到艾克索拉ID认证页面：

  1. 用户点击登录小组件中的 Log in with Xsolla 按钮。
  2. 用户被重定向到在同一窗口中打开的艾克索拉ID认证页面。
  3. 用户在艾克索拉ID完成认证过程。
  4. 用户被重定向到 发布商帐户 中 回调URL 字段指定的页面。

• 通过点击您网站上的按钮，在弹窗中重定向到艾克索拉ID认证页面：

  1. 用户点击您网站上的按钮。
  2. 用户被重定向到在弹窗中打开的艾克索拉ID认证页面。
  3. 用户在艾克索拉ID认证页面完成认证过程。
  4. 用户被重定向到 发布商帐户 中 回调URL 字段指定的页面。

如何获取

要通过艾克索拉ID集成社交网络登录：

1. 集成登录小组件。
2. 启用艾克索拉作为社交网络。
3. 实现用户授权令牌的获取。

登录小组件的集成

将艾克索拉登录小组件添加到您的应用程序中——它提供了一个现成的用户认证界面。

启用艾克索拉作为社交网络

1. 在发布商帐户的项目中，进入 玩家 > 登录 部分。

2. 点击登录管理器项目面板中的 Configure。

3. 进入 Authentication 区块并选择 社交网络登录。

4. 从社交网络列表中选择 艾克索拉。

5. 点击 ⚙ 图标并选择 Connect。

6. 设置其中一个用户场景：

   • 同窗口认证
   • 弹窗认证
   • 模态窗口认证

同窗口认证

要在用户点击登录小组件中的 Log in with Xsolla 按钮后，将其重定向到艾克索拉ID认证页面：

1. 进入 Authentication 部分并点击 Callback URLs。
2. 在 回调URL 字段中，输入认证后要重定向用户的URL。
3. 在登录小组件的代码中，将要重定向用户的URL传递到 callbackUrl 参数中。

小组件代码示例：

1import { Widget } from '@xsolla/login-sdk';
2const xl = new Widget({
3  projectId: '[Login ID]',
4  preferredLocale: 'en_US',
5  callbackUrl: '[Your Callback URL]',
6});

弹窗认证

要在用户点击您网站上的按钮后，将其重定向到艾克索拉ID认证页面的弹窗中：

1. 在导航页面，进入 Authentication 部分并点击 Callback URLs。
2. 确保在 回调URL 部分添加了以下URL：https://login.xsolla.com/api/social/oauth2/callback。
3. 在登录小组件代码中，将 babkaLoginPopup 参数的值传递为 true，并在 callbackUrl 参数中传递认证后要重定向用户的URL。

小组件代码示例：

1import { Widget } from '@xsolla/login-sdk';
2const xl = new Widget({
3  projectId: '[Login ID]',
4  preferredLocale: 'en_US',
5  babkaLoginPopup: true,
6  callbackUrl: '[Your Callback URL]',
7});

4. 将打开艾克索拉ID认证页面的按钮添加到您的网站。

Log in with Xsolla 按钮代码示例：

1<div id="xl_auth"></div>
2<button onclick="xl.open()">Log in with Xsolla</button>

模态窗口认证

要在用户点击登录小组件中的 Log in with Xsolla 按钮后，将其重定向到艾克索拉ID认证页面的模态窗口中：

1. 进入 Authentication 部分并点击 Callback URLs。
2. 在 回调URL 字段中，输入认证后要重定向用户的URL。
3. 在登录小组件的代码中，将 babkaLoginFlow 参数的值传递为 popup，并在 callbackUrl 参数中传递认证后要重定向用户的URL。

小组件代码示例：

1import { Widget } from '@xsolla/login-sdk';
2const xl = new Widget({
3  projectId: '[Login ID]',
4  preferredLocale: 'en_US',
5  babkaLoginFlow: "popup",
6  callbackUrl: '[Your Callback URL]',
7});

获取用户授权令牌

在艾克索拉ID端完成授权后，用户将被重定向到 callbackUrl 参数中指定的URL。用户授权令牌会在 token 参数中传递。

要将艾克索拉ID OAuth JWT令牌嵌入艾克索拉登录JWT令牌中：

1. 在发布商帐户的项目中，进入 玩家 > 登录 部分。
2. 点击登录管理器项目面板中的 Configure。
3. 进入 Authentication 区块并选择 社交网络登录。
4. 打开 嵌入社交网络JWT令牌 开关。
5. 点击 保存更改。