有关 SaaS 履行 API 的常见问题

本文介绍了Microsoft商业市场的一些集成要求,使 Azure 客户能够订阅 SaaS 产品/服务。

发现体验

发布 SaaS 产品/服务后,Azure 用户可以在 Azure 市场中发现它。 客户可以根据产品类型(SaaS)筛选产品/服务,并发现他们感兴趣的 SaaS 服务。

购买体验

用户对特定 SaaS 服务感兴趣后,用户可以从 Azure 市场订阅它。

Azure 用户订阅 Azure 市场中 SaaS 产品/服务意味着什么?

这意味着用户可以查看与 SaaS 服务关联的使用条款和隐私声明,并同意根据你(SaaS 产品/服务的发布者)在Microsoft发票上设置的计费条款付费。 用户可以在 Azure 中使用其现有付款配置文件来支付 SaaS 服务消耗费用。

这种能力在几种方面是有益的。 现在,客户可以使用 Microsoft Cloud Platform 作为受信任的源在一个位置发现和订阅,而无需审查它打算使用的每个独立软件供应商 (ISV) 软件。 此外,客户可以使用其现有的付款配置文件,而无需单独支付每个 ISV 软件。

订阅产品/服务时,用户是否自动收费?

订阅 SaaS 产品/服务时,用户同意通过 Microsoft 平台支付 SaaS 服务的消耗费用。 但是,仅当使用产品/服务时,费用才会开始。 用户必须转到 SaaS 产品/服务并确认帐户创建以开始使用产品/服务。 然后,你将通知Microsoft开始为此客户 SaaS 订阅计费。

用户订阅 SaaS 产品/服务时如何通知你?

订阅产品/服务后,Azure 用户可以在 Azure 中发现和管理其所有产品/服务。 默认情况下,新订阅的 SaaS 产品/服务的状态显示为 预配、履行挂起。 在此状态下,系统会提示 Azure 用户执行 配置帐户的操作,以便在 Azure 门户中浏览到其 SaaS 订阅管理体验。

当用户选择 配置帐户时,会重定向到 SaaS 服务网站。 发布者在发布产品/服务时配置了 URL。 此页面称为发布者的登陆页面。 Azure 用户基于其在 Azure 中的现有Microsoft Entra 凭据登录到 SaaS 登陆页面。

重要

必须使用由 策略指示的Microsoft Entra ID、单一登录(SSO)登录购买用户。 从 Microsoft 图形 API 检索到的用户资源上的 mail 属性提供 MSA Microsoft Entra ID 和 userPrincipalName 的联系信息。 对于Microsoft Entra ID,“mail”字段可能为空,并且用户可能没有记录电子邮件。 如果是这样,我们建议你检测并请求联系人电子邮件。 这是在客户载入流程期间或之后获取联系客户的唯一机会。

将 Azure 用户重定向到登陆页时,会将令牌添加到查询 URL。 此令牌生存期较短,有效期为 24 小时。 然后,可以检测此令牌是否存在,并调用Microsoft API 以获取与令牌关联的更多上下文。

客户订阅流

有关在 SaaS 产品/服务生命周期中处理事务处理方案的 API 协定的详细信息,请参阅 SaaS 履行 API

如何知道用户在 Azure 中订阅的 SaaS 产品/服务?

Resolve API 的响应包括与 SaaS 订阅关联的套餐和计划信息。

Azure 用户如何更改与此 Azure 订阅关联的计划?

  • Azure 用户可以直接在 SaaS 体验中或通过 Microsoft 平台更改与 SaaS 订阅关联的计划。

  • 可以在计费周期中随时完成转换。 系统会提示你确认任何转换,这在确认后会生效。

  • 预付费计划(每月)费率按比例计算。 下一张发票中将按最高转换时间发出的任何超额收费。 将根据新计划发出新的超额。

注意

如果不想支持特定转换路径,则可以阻止降级。

当 Azure 客户在 SaaS 体验中更改计划时,下面的顺序将捕获流:

客户计划更改流

当 Azure 客户在 Microsoft 的在线商店中更改计划时,以下序列将捕获流:

客户在线商店计划更改流

Azure 用户如何取消订阅与 Azure 订阅关联的计划?

Azure 用户可以直接从 SaaS 体验中或通过 Microsoft 平台取消订阅购买的 SaaS 产品/服务。 用户取消订阅后,将不再从下一个计费周期收取费用。

当 Azure 客户取消订阅 SaaS 体验中的 SaaS 产品/服务时,下面的顺序将捕获流:

客户取消订阅 SaaS 体验

当 Azure 用户取消订阅Microsoft的在线商店时,以下序列将捕获流:

客户取消订阅Microsoft的在线商店

管理体验

ISV 可以管理其客户的 SaaS 订阅和更改计划。

若要使计划成功转换为同一产品/服务中的不同计划,应遵循以下所有要求:否则,更改计划 SaaS 履行 API 调用可能无法正常工作:

  • 目标计划应处于活动状态。
  • 应在客户的区域中支持目标计划。
  • 如果目标计划是专用计划,则应将客户的 tenantID 添加到合作伙伴中心的计划中,并在尝试更改计划之前重新发布。
  • 如果目标计划是专用市场的一部分,则在更改计划完成之前,客户应在专用市场中允许列出计划。
  • 对于 EA 客户,如果启用了 BYOL 设置(这意味着他们只能购买免费资源),则目标计划不应是付费计划。

如何为 Entra 应用创建服务主体?

Entra 应用服务主体是为 SaaS 产品/服务创建的 Entra 应用注册实例。 必须在合作伙伴中心技术配置中使用的同一租户中创建此应用服务主体。 这些步骤可以帮助你确定服务主体是否已创建,如果不创建,则如何创建服务主体。

步骤 1:标识应用注册。

  1. 导航到合作伙伴中心中的每个 SaaS 产品/服务。

  2. 导航到其“技术配置页”并记录“Entra 应用程序 ID”的值:

    合作伙伴中心技术配置页Microsoft屏幕截图。

步骤 2:确定服务主体是否已创建。

选项 1:使用 Azure 门户

  1. 导航到 Azure 门户应用注册 页,找到包含从合作伙伴中心复制的 ID 的应用注册。

    提示

    如果不是第一个创建应用注册的应用程序,可能需要切换到“所有应用程序”而不是“拥有的应用程序”。

    提示

    如果应用注册名称是使用 SaaS 加速器部署脚本创建的,则应用注册名称以“AutomateAppReg”结尾。

  2. 打开“应用注册”页。 如果看到具有应用注册名称的链接(而不是“创建服务主体”链接,如下一屏幕截图所示),则表示已创建服务主体。

    “应用注册”页的屏幕截图。

选项 2:使用 Azure CLI

az ad sp list --filter "appId eq '<Your-App-ID>'"

如果创建了服务主体,你将 accountEnabled为 true(如下图所示)。

Azure 命令行接口的屏幕截图,其中显示了服务主体创建的结果。

az ad sp list了解有关此服务主体 列表 命令的详细信息。

步骤 3:创建和关联服务主体

选项 1:使用 Azure 门户

  1. 导航到 Azure 门户应用注册 页,找到包含从合作伙伴中心复制的 ID 的应用注册。

    提示

    如果不是第一个创建应用注册的应用程序,可能需要切换到“所有应用程序”而不是“拥有的应用程序”。

    提示

    如果应用注册名称是使用 SaaS 加速器部署脚本创建的,则应用注册名称以“AutomateAppReg”结尾。

  2. 打开“应用注册”页,然后选择“创建服务主体”链接(如以下屏幕截图所示)。

    “应用注册”页的屏幕截图,其中已调用“创建服务主体”链接。

选项 2:使用 Azure CLI

az ad sp create --id <app_id>

如果创建了服务主体,你将看到 accountEnabledtrue(如下图所示)。

命令行界面的屏幕截图,其中显示了已创建服务主体。

详细了解此服务主体 az ad sp create创建 命令。