使用 Microsoft Store API 对你的服务进行身份验证

• User Store ID 和 Microsoft Entra ID：将身份验证和结果与登录 Microsoft Store 应用的用户账号关联起来。
• 委派身份验证 X-token：将身份验证和结果与当前正在游玩游戏的用户的 XBOX services 账号关联起来。

​

使用 Microsoft Entra ID 和 User Store ID 进行身份验证

Authorization: Bearer <Entra ID access token>  

  "sbx": "XDKS.1"

  "beneficiaries": [
    {
        "identitytype" : "b2b",
        "identityValue" : "eyJ0eXAiOiJ...",
        "localTicketReference" : "testReference"
    }
  ],

• Microsoft.StoreServices (GitHub)：用于从后端进行身份验证并调用 Microsoft Store 服务的库和源码。
• Microsoft.StoreServices 示例 (GitHub)：演示身份验证、商务集成和退款对账模式的服务示例。
• 为服务到服务身份验证请求 User Store ID
• 续订 User Store ID 密钥
• 从服务管理产品权益

​

调用 Microsoft Store API 的示意图

​

使用 User Store ID 和 Microsoft Entra ID 身份验证查看和管理产品所需的额外配置

​

将产品配置为可通过 Microsoft Entra ID 和 User Store ID 对你的服务可见

1. 在游戏的合作伙伴中心页面上，从左侧面板选择 产品集合和购买 (Product collections and purchases)。
2. 输入你用于对服务进行身份验证的 Microsoft Entra 应用程序的客户端 ID。
3. 选择 保存 按钮。
4. 将游戏产品及其所有附加内容重新发布到你的沙盒或开发环境中的 Microsoft Store。

​

使用委派身份验证 X-token 进行身份验证

Authorization: XBL3.0 x=<user hash>;<X-token>

• Game Service Sample：一个全面的 Web 服务示例，演示对客户端 X-token 的验证与处理、服务到服务身份验证、商务服务等。请从 GDK 下载站点下载最新版本。下载 All Samples 的最新版本。Game Service Samples 位于下载的 .zip 文件中的 samples\Live\GameService 下。
• Xfest 2019 - XSTS Auth and Server to Server made Easy：对 X-token 的概述与说明，以及 Game Service Sample 如何帮助你启动自己的服务到服务身份验证工作。若要下载演讲资料，请在存档站点上选择 GDK Track Downloads。
• XBOX services 身份验证和服务到服务调用：关于身份验证、X-token 以及对 XBOX services 进行服务到服务调用所需的步骤和调用的更详细文档。

​

使用委派身份验证 X-token 查看和管理产品所需的额外配置

​

在合作伙伴中心配置产品和 Web 服务

1. 使用 Web 服务的 Generate Certificate 链接创建 Business Partner 证书。（选择 Developer Settings > XBOX Live > Web Services。）在你的依赖方所绑定的 Web 服务对应的行中选择该链接。
2. 前往 Business Partner 管理 UI（选择 Developer Settings > XBOX Live > Business Partner），复制与你在第 1 步中所使用的 Web 服务相匹配的 Business Partner ID。（示例 Business Partner ID：12345678-9012-3456-7890-123456789012）
3. 在你产品的 Partner Center Overview 页面上，选择 Create a new，然后选择 Product group。
4. 将此产品组分配到某个 Dev Studio，如果你尚未拥有 Dev Studio，请选择 Create a new developer studio。
5. 确保所选 Dev Studio 的 ID 与第 2 步中的 Business Partner ID 匹配。如果 Dev Studio ID (optional) 为空，请将 Business Partner ID 复制进去。如果此字段已有正在使用的值，请改为创建一个新的 Dev Studio，而不要覆盖它，以避免破坏现有的服务到服务产品映射。
6. 在 Dev Studio 配置好与 Business Partner 匹配的 ID 后，返回到你创建的 Product Group。将你的游戏和所有产品添加到 Included in this product group 列表。
7. 选择 Save 完成产品组的创建。
8. 前往你游戏的 XBOX Settings UI，确保关联的 Business Partner 与第 2 步中使用的相同。
9. 将产品组中的所有项目重新发布到沙盒或开发环境中的 Microsoft Store。

​

另请参阅