静默认证

运行机制

静默认证允许您通过发布平台自动认证用户身份进入您的游戏。目前支持的平台有Steam、Xbox Live和Epic Games。如需支持Stone或Mail.ru平台,请联系您的客户成功经理或发送邮件至csm@xsolla.com

交互过程:

  1. 用户启动游戏。
  2. 游戏通过平台SDK收到平台授权数据。
  3. 游戏生成请求并将其发送给艾克索拉登录管理器服务器以获取JWT。
  4. 艾克索拉登录管理器服务器认证该用户并发送JWT。

注:
如果集成了艾克索拉启动器,请按照说明进行操作来通过平台认证用户。
通过静默认证,您还可以像通过社交网络认证一样收集用户的邮箱地址。要进行该配置,请按照收集邮箱地址和手机号码的说明进行操作。

适用对象

集成了登录管理器并拥有发布平台帐户的合作伙伴。

如何获取

  1. 在发布商帐户中设置静默认证
  2. 在您的应用程序侧完成集成步骤

设置静默认证

在登录管理器产品中,有两种方式可启用静默认证:

注:
对于创建允许用户使用同一帐户在不同平台上进行游戏、跨平台同步物品库等的跨平台帐户,影子登录管理器项目为必需。会为每个托管游戏并因此与用户主帐户关联的发布平台创建一个影子登录管理器项目。详细信息请参阅跨平台帐户

在经典登录方案中,您可以一次性为多个发布平台启用静默认证,但不能创建跨平台帐户。如果用户在一个平台上登录游戏后又在另一个平台上登录了游戏,登录管理器项目会将这两次登录视作两个不同的用户。
要在经典登录方案中启用静默认证:
  1. 发布商帐户中打开您的项目,然后前往登录管理器部分。
  2. 在经典登录方案面板中单击配置
  3. 前往身份认证区块,然后选择发布平台部分。
  1. 要连接发布平台,请单击平台名称旁边的⚙图标,然后选择设置
  1. 在模态窗口中,指定所选平台的参数:
    • Steam:
      • 应用程序ID — 您在该平台帐户中的AppID;
      • 应用程序密钥Web API Key
    • Epic Games:
      • 应用程序ID — 您游戏客户端在该平台上的Client ID;
      • 应用程序密钥 — 您游戏客户端在该平台上的密钥。
    • Xbox Live:
      • 应用程序ID — 您游戏在该平台上的Application ID/Client ID;
      • 应用程序密钥 — 您游戏在该平台上注册时生成的Application Secret。
注:
对于Xbox Live平台可以不必提供设置值。您可以使用艾克索拉拥有的访问密钥来连接Xbox Live,方法是单击平台名称右侧的⚙图标,然后选择连接
  1. 单击连接
  2. 如需要,对其他发布平台重复步骤4 – 6。

应用程序侧集成

请按照托管您应用程序的发布平台的说明进行操作:

Steam

根据用户认证后的平台数据生成会话票证(session_ticket参数):
  1. 获取会话票证
  2. 将其以session_ticket参数的形式传入静默认证请求(JWTOAuth 2.0)。

Xbox Live

  1. 根据用户认证后的平台数据生成一个会话票证(session_ticket参数)。该参数基于<xid>-<uhs>;<XSTSToken>模板生成,其中:
    • <xid> — Xbox User ID
    • <uhs> — user hash
    • <XSTSToken> — Xbox Secure Token Service
  2. session_ticket参数传入静默认证请求(JWTOAuth 2.0)。

Epic Games

  1. 从平台获取exchangecode授权代码,该代码在用户完成身份认证后生成。
  2. 将收到的exchangecode作为session_ticket参数传入静默认证请求(JWTOAuth 2.0)。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
为此页面评分
为此页面评分
我们还有其他可改进之处吗?

不想回答

感谢您的反馈!
上次更新时间: 2024年1月22日

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

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!