静默认证

运行机制

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

交互过程：

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

适用对象

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

如何获取

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

设置静默认证

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

• 通过配置经典登录方案（请参阅下方说明）；
• 通过创建影子登录管理器项目（请参阅如何设置影子登录管理器项目）。

1. 在发布商帐户中打开您的项目，然后前往登录管理器部分。
2. 在经典登录方案面板中单击配置。
3. 前往身份认证区块，然后选择发布平台部分。

4. 要连接发布平台，请单击平台名称旁边的⚙图标，然后选择设置。

5. 在模态窗口中，指定所选平台的参数：
   • Steam：
     • 应用程序ID — 您在该平台帐户中的AppID；
     • 应用程序密钥 — Web API Key。
   • Epic Games：
     • 应用程序ID — 您游戏客户端在该平台上的Client ID；
     • 应用程序密钥 — 您游戏客户端在该平台上的密钥。
   • Xbox Live：
     • 应用程序ID — 您游戏在该平台上的Application ID/Client ID；
     • 应用程序密钥 — 您游戏在该平台上注册时生成的Application Secret。

6. 单击连接。
7. 如需要，对其他发布平台重复步骤4 – 6。

应用程序侧集成

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

• Steam
• Xbox Live
• Epic Games

Steam

1. 获取会话票证。
2. 将其以session_ticket参数的形式传入静默认证请求(JWT或OAuth 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参数传入静默认证请求（JWT或OAuth 2.0）。

Epic Games

1. 从平台获取exchangecode授权代码，该代码在用户完成身份认证后生成。
2. 将收到的exchangecode作为session_ticket参数传入静默认证请求（JWT或OAuth 2.0）。