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

工作原理

您可以通过艾克索拉ID添加用户身份认证。艾克索拉ID是共享身份平台,可支持用户在艾克索拉产品之间无缝访问。

注:
可用的身份认证方式取决于您的项目设置。仅当艾克索拉钱包认证已禁用时,才能使用艾克索拉ID(新项目默认禁用艾克索拉钱包认证)。禁用后,艾克索拉钱包认证将被永久移除。如需重新启用,请联系您的客户成功经理或发送邮件至[email protected]。
注:
上图展示了登录管理器小组件的一种显示效果。您可以自定义小组件。

您可以实现以下任一用户场景:

  • 点击登录小组件中的Log in with Xsolla按钮后,在模态弹层中打开艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在模态弹层中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到发布商帐户中Callback URL字段指定的URL。
  • 点击登录小组件中的Log in with Xsolla按钮后,跳转到艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在当前窗口中打开。
    3. 用户在艾克索拉ID完成认证过程。
    4. 系统将用户重定向到发布商帐户中Callback URL字段指定URL对应的页面。
  • 用户点击网站上的按钮后,在弹窗中打开艾克索拉ID身份认证页面:

    1. 用户点击网站上的按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在弹窗中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到发布商帐户中Callback URL字段指定URL对应的页面。

您可以实现以下任一用户场景:

  • 点击登录小组件中的Log in with Xsolla按钮后,在模态弹层中打开艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在模态弹层中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到帐户中Callback URL字段指定的URL。
  • 点击登录小组件中的Log in with Xsolla按钮后,跳转到艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在当前窗口中打开。
    3. 用户在艾克索拉ID完成认证过程。
    4. 系统将用户重定向到帐户中Callback URL字段指定URL对应的页面。
  • 用户点击网站上的按钮后,在弹窗中打开艾克索拉ID身份认证页面:

    1. 用户点击网站上的按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在弹窗中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到帐户中Callback URL字段指定URL对应的页面。

您可以实现以下任一用户场景:

  • 点击登录小组件中的Log in with Xsolla按钮后,在模态弹层中打开艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在模态弹层中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到帐户中Callback URL字段指定的URL。
  • 点击登录小组件中的Log in with Xsolla按钮后,跳转到艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在当前窗口中打开。
    3. 用户在艾克索拉ID完成认证过程。
    4. 系统将用户重定向到帐户中Callback URL字段指定URL对应的页面。
  • 用户点击网站上的按钮后,在弹窗中打开艾克索拉ID身份认证页面:

    1. 用户点击网站上的按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在弹窗中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到帐户中Callback URL字段指定URL对应的页面。

您可以实现以下任一用户场景:

  • 点击登录小组件中的Log in with Xsolla按钮后,在模态弹层中打开艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在模态弹层中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到帐户中Callback URL字段指定的URL。
  • 点击登录小组件中的Log in with Xsolla按钮后,跳转到艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在当前窗口中打开。
    3. 用户在艾克索拉ID完成认证过程。
    4. 系统将用户重定向到帐户中Callback URL字段指定URL对应的页面。
  • 用户点击网站上的按钮后,在弹窗中打开艾克索拉ID身份认证页面:

    1. 用户点击网站上的按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在弹窗中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到帐户中Callback URL字段指定URL对应的页面。

您可以实现以下任一用户场景:

  • 点击登录小组件中的Log in with Xsolla按钮后,在模态弹层中打开艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在模态弹层中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到帐户中Callback URL字段指定的URL。
  • 点击登录小组件中的Log in with Xsolla按钮后,跳转到艾克索拉ID身份认证页面:

    1. 用户点击登录小组件中的Log in with Xsolla按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在当前窗口中打开。
    3. 用户在艾克索拉ID完成认证过程。
    4. 系统将用户重定向到帐户中Callback URL字段指定URL对应的页面。
  • 用户点击网站上的按钮后,在弹窗中打开艾克索拉ID身份认证页面:

    1. 用户点击网站上的按钮。
    2. 系统将用户重定向到艾克索拉ID身份认证页面,该页面在弹窗中打开。
    3. 用户在艾克索拉ID身份认证页面完成身份认证。
    4. 系统将用户重定向到帐户中Callback URL字段指定URL对应的页面。

如何设置

如需通过艾克索拉ID集成社交网络登录,请按以下步骤操作:

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

集成登录小组件

将艾克索拉登录管理器小组件添加到您的应用程序中。该小组件提供即连即用的用户身份认证界面。

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

  1. 在发布商帐户中打开您的项目,前往Players > Login部分。
在帐户中打开项目,前往Players > Login部分。
  1. 在帐户中打开项目,前往Players > Login部分。
  1. 在帐户中打开项目,前往Players > Login部分。
  1. 在帐户中打开项目,前往Other tools > Login部分。
  1. 在登录管理器项目窗格中,点击Configure。

  2. 前往Authentication区块,然后选择Social login。

  3. 从社交网络列表中选择Xsolla。

  1. 点击 ⚙ 图标,然后选择Connect。

  2. 设置以下任一用户场景:

当前窗口身份认证

如需在用户点击登录管理器小组件中的Log in with Xsolla按钮后,将用户跳转到艾克索拉ID身份认证页面,请按以下步骤操作:

  1. 前往Authentication部分,点击Callback URLs。
  2. 在Callback URL字段中,输入用户完成身份认证后要跳转到的URL。
  3. 在登录小组件代码的callbackUrl参数中,传入用户完成身份认证后要跳转到的URL。

小组件代码示例:

Copy
Full screen
Small screen
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. 确保已在Callback URL部分添加以下URL:https://login.xsolla.com/api/social/oauth2/callback。
  3. 在登录小组件代码中,通过babkaLoginPopup参数传入true,并通过callbackUrl参数传入用户完成身份认证后要跳转到的URL。

小组件代码示例:

Copy
Full screen
Small screen
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});
  1. 将用于打开艾克索拉ID身份认证页面的按钮添加到您的网站。

Log in with Xsolla按钮代码示例:

Copy
Full screen
Small screen
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. 在Callback URL字段中,输入用户完成身份认证后要跳转到的URL。
  3. 在登录小组件代码中,通过babkaLoginFlow参数传入popup,并通过callbackUrl参数传入用户完成身份认证后要跳转到的URL。

小组件代码示例:

Copy
Full screen
Small screen
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. 在发布商帐户中打开您的项目,前往Players > Login部分。
在帐户中打开项目,前往Players > Login部分。
  1. 在帐户中打开项目,前往Players > Login部分。
  1. 在帐户中打开项目,前往Players > Login部分。
  1. 在帐户中打开项目,前往Other tools > Login部分。
  1. 在登录管理器项目窗格中,点击Configure。
  2. 前往Authentication区块,然后选择Social login。
  3. 打开Embed social network JWT token开关。
  4. 点击Save changes。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2026年10月7日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!
无法发送您的反馈
请稍后重试或发送邮件至[email protected]与我们联系。