Skip to main content
本文适用于托管合作伙伴,不适用于 XBOX 创作者计划中的游戏。
单点登录允许玩家使用其 XBOX 账号登录来登录到你的游戏。 这使得已登录到 XBOX 服务的玩家可以运行应用或游戏,而无需再使用特定于你的服务的其他账号凭据登录一次。 例如,你的游戏可能是一个应用,只要用户在你的服务中拥有有效账号,它就可以让你的服务将视频和音乐等内容流式传输到用户的设备。 如果用户已经登录到其 XBOX 账号,那么他们应该能够进行内容流式传输,而无需每次都登录到你的服务。 如果你的应用向外部服务发送 Kinect 数据,也可以在合作伙伴中心对其进行配置。 如果你的游戏要求用户创建独立于 XBOX 服务的账号,你应当提供一种方式,让用户可以将其 XBOX 账号与你的服务上的账号进行一次性关联。 在配置单点登录时,你可以指定 URL 及其依赖方。 每当你的应用调用任何指定的 URL 时,XBOX 服务将自动附加一个 XBOX 安全令牌服务 (XSTS) 令牌。 接收密钥的服务称为依赖方。你必须先配置依赖方,然后才能配置单点登录。 每个依赖方配置都会指定 XSTS 令牌中所含的信息,以及依赖方可用于解码 XSTS 令牌的唯一加密密钥。 添加配置的操作步骤:
  • 合作伙伴中心中选择你的游戏。
  • 在游戏仪表板菜单中,导航到 XBOX services > Single sign-on,以显示“XBOX services single sign-on configuration”页面。
  • 选择 New endpoint 以创建新的单点登录条目。这会在配置列表末尾添加一个新行。
  • Web Service endpoint 框中,输入你的服务的完全限定域名 (FQDN)。域名还支持顶级通配符域。例如,.mygame.com 是受支持的,可匹配所有子域,如 example.mygame.compartner.example.mygame.com。相比之下,service..mygame.com 不受支持,因为通配符不是在顶级指定的。如有需要,可以输入端口号和路径。
  • Relying Party Audience URI 框中,从下拉列表中选择合适的依赖方。依赖方信息指定 XSTS 令牌的编码方式。下拉列表通过先在 Account settings 中定义 URI 来填充。若要定义新的 URI,请选择 Save 按钮下方的“Looking to configure relying parties?”,然后会跳转到 Relying parties 页面。或者,你也可以通过选择 Apps and games > XBOX Live > Relying parties 导航到同一页面。有关详细信息,请参阅 Setting up web services 中的配置依赖方一节。
  • 单击 Save 按钮以保存更改。
  • 将你的游戏发布或重新发布到某个沙盒,以使配置更改生效。
单点登录配置页面的屏幕截图
最后修改于 2026年8月25日