> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在合作伙伴中心配置单点登录

> 在合作伙伴中心配置 XBOX 单点登录，使你的游戏 URL 接收 XSTS 令牌，允许玩家使用其 XBOX 账号访问你的自定义服务。

<Note>本文适用于托管合作伙伴，不适用于 XBOX 创作者计划中的游戏。</Note>

单点登录允许玩家使用其 XBOX 账号登录来登录到你的游戏。
这使得已登录到 XBOX 服务的玩家可以运行应用或游戏，而无需再使用特定于你的服务的其他账号凭据登录一次。

例如，你的游戏可能是一个应用，只要用户在你的服务中拥有有效账号，它就可以让你的服务将视频和音乐等内容流式传输到用户的设备。
如果用户已经登录到其 XBOX 账号，那么他们应该能够进行内容流式传输，而无需每次都登录到你的服务。

如果你的应用向外部服务发送 Kinect 数据，也可以在合作伙伴中心对其进行配置。

如果你的游戏要求用户创建独立于 XBOX 服务的账号，你应当提供一种方式，让用户可以将其 XBOX 账号与你的服务上的账号进行一次性关联。

在配置单点登录时，你可以指定 URL 及其依赖方。
每当你的应用调用任何指定的 URL 时，XBOX 服务将自动附加一个 XBOX 安全令牌服务 (XSTS) 令牌。

接收密钥的服务称为*依赖方*。你必须先配置[依赖方](https://developer.microsoft.com/xboxconfig/relyingparties/index)，然后才能配置单点登录。
每个依赖方配置都会指定 XSTS 令牌中所含的信息，以及依赖方可用于解码 XSTS 令牌的唯一加密密钥。

**添加配置的操作步骤：**

* 在[合作伙伴中心](https://partner.microsoft.com/dashboard)中选择你的游戏。
* 在游戏仪表板菜单中，导航到 **XBOX services** > **Single sign-on**，以显示“XBOX services single sign-on configuration”页面。
* 选择 **New endpoint** 以创建新的单点登录条目。这会在配置列表末尾添加一个新行。
* 在 **Web Service endpoint** 框中，输入你的服务的完全限定域名 (FQDN)。域名还支持顶级通配符域。例如，`.mygame.com` 是受支持的，可匹配所有子域，如 `example.mygame.com` 和 `partner.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** 中的[配置依赖方](/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/web-services/live-web-services)一节。
* 单击 **Save** 按钮以保存更改。
* 将你的游戏发布或重新发布到某个沙盒，以使配置更改生效。

<img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/xbox-services-sso-config.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=f57198b46b0ccfb1a5d4417b8a2bde30" alt="单点登录配置页面的屏幕截图" width="1913" height="960" data-path="images/gdk/services/xbox-services-sso-config.png" />
