通过

在合作伙伴中心设置 API 访问权限

  • 项目

适用于：合作伙伴中心 |由世纪互联运营的合作伙伴中心 |美国政府Microsoft云合作伙伴中心

本文介绍针对合作伙伴中心 SDK 进行开发所需的帐户。 本文还介绍如何在集成沙盒中创建 集成沙盒帐户 和测试。

注释

若要访问 API，租户必须是云解决方案提供商（CSP）租户，并且必须是间接提供商或直接计费合作伙伴。

了解帐户定义

为了帮助你集成和测试 API 集成，合作伙伴中心支持两种类型的帐户。

主要合作伙伴帐户

此帐户是你为真实客户创建真实订单的位置。 如果使用合作伙伴中心 SDK 或合作伙伴仪表板 UI 登录到主帐户时进行任何更改或交易，则会将其视为真实客户的正式订单。 它们反映在发票中，你的公司负责为其付款。

集成沙盒帐户

此帐户用于在广泛部署代码之前测试代码及其与合作伙伴中心 API 的集成。 登录到集成沙盒帐户时所做的更改和交易将显示在发票中，但无需支付发票金额。 发票 PDF 包含免责声明：“请勿支付。 这是沙盒发票，无需执行任何操作。”

  • 集成沙盒帐户和主帐户独立运作。 他们不会共享管理员帐户、用户帐户、客户、订单、订阅或其他数据。
  • 集成沙盒支持的交易涉及有限数量的客户、订单、订阅和许可证等。
  • 集成沙盒帐户仅用于按策略进行集成测试。
  • 默认情况下不存在集成沙盒帐户。 如果计划使用合作伙伴中心 SDK，则必须自行创建一个。

设置帐户

本部分介绍如何为合作伙伴中心 SDK 设置主合作伙伴帐户和集成沙盒帐户。

创建集成沙盒

若要创建集成沙盒，请按照 创建云解决方案提供商（CSP）集成沙盒帐户中的步骤作。

启用 API 访问

设置帐户后，必须先启用 API 访问，然后才能将合作伙伴中心 SDK 与集成沙盒一起使用。 需要为主要合作伙伴帐户和集成沙盒帐户单独启用对 API 的访问权限。

  1. 使用全局管理员帐户登录到 合作伙伴中心，然后选择 设置（齿轮图标）。
  2. 选择 帐户设置，然后 应用管理。
  3. 如果还没有现有应用，请添加新的 Web 应用。 如果你有现有的 Web 应用，请选择 “添加密钥”按钮。
  4. 复制应用注册信息，尤其是创建 Web 应用时 密钥，并将其存储在安全的位置。
  5. 注销合作伙伴仪表板。
  6. 使用集成沙盒帐户重新登录。 重复步骤 2-5，在集成沙盒中启用 API 访问。

编写和测试代码

可以在集成沙盒中编写代码和测试代码。 需要以下信息，以便通过 Microsoft Entra ID 设置合作伙伴中心身份验证。

  • 应用 ID/客户端 ID：在“设置”（齿轮图标）“帐户设置”>>“应用管理”中列为“已注册应用程序的应用 ID”。
  • 密钥：如果已在上一部分创建新的 Web 应用，请使用该密钥。
  • 域：适用于集成沙盒。

运行测试的代码

若要将解决方案与真实客户数据配合使用，必须放弃使用集成沙盒凭据，改用合作伙伴主帐户凭据。

当您准备好在您的主要合作伙伴帐户中使用已测试的代码时，需要一个“Microsoft Entra”安全令牌。 此安全令牌基于 合作伙伴中心 应用、密钥和域（而不是 集成沙盒 应用、密钥和域）。

  1. 按照 合作伙伴中心身份验证 中的步骤，使用主合作伙伴中心凭据获取Microsoft Entra 安全令牌。 （之前已执行了这些步骤，为集成沙盒获取了 Microsoft Entra 安全令牌。）
  2. 将代码中的集成安全令牌替换为合作伙伴主帐户的新安全令牌。

相关内容