SaaS 客户载入 - AWS Marketplace
配置您的 SaaS 产品以接受新买家

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

SaaS 客户载入

通过软件即服务 (SaaS) 订阅和 SaaS 合同，您的客户可以通过您的环境订阅您的产品， AWS Marketplace 但在您的 AWS 环境中访问产品。订阅产品后，您的客户会被定向到您作为 SaaS 产品的一部分创建和管理的网站，以注册其账户和配置产品。

创建您的 SaaS 产品列表时，您需要提供指向注册登录页面 URL。在客户订阅后，我们使用该 URL 将客户重定向到您的注册登录页面。在软件的注册登录页面上，您可以收集为客户创建账户所需的任何信息。如果您打算通过电子邮件与客户联系以获得使用情况通知，我们建议您收集客户的电子邮件地址。

注册登录页面必须能够识别并接受表单数据中的x-amzn-marketplace-token AWS Marketplace 令牌以及客户的标识符进行计费。然后，它应将该代币值传递给 AWS Marketplace Metering Service ，以解析唯一的客户标识符、客户 AWS 账户 ID 和相应的产品代码。有关代码示例，请参阅 ResolveCustomer 代码示例。

注意

注册令牌解析给特定的订阅客户，每个生成的令牌都在 4 小时后过期。只要调用者使用相同的令牌调用 API，它就会一直返回相同的响应值，直到令牌过期。

配置您的 SaaS 产品以接受新买家

您负责正确地配置 SaaS 软件以接受新客户并对他们进行适当的计量。以下过程概述了一种用于标识、实施和计量新客户对软件的访问的推荐方法：

  1. 当客户在 AWS Marketplace 网站上访问您的产品页面时，他们会选择订阅您的产品。

  2. 客户 AWS 账户 已订阅您的产品。这意味着从您的产品发送的订阅和计量记录将成为客户 AWS 账单的一部分。

  3. 为客户生成一个注册令牌，其中包含其客户标识符和您的产品代码。

  4. 客户将被重定向到软件的注册登录页面。本页面必须能够接受具有客户标识符的令牌。

  5. 客户的浏览器向您的软件的注册登录页面 URL 发送 POST 请求。该请求包含一个 POST 参数 x-amzn-marketplace-token，其中包含客户的注册令牌。从注册网站的角度来看，客户已使用此参数提交表单。注册令牌是一个不透明的字符串。如果优惠类型为免费试用，则将在请求中添加第二个参数，即值为 free-trial 的 x-amzn-marketplace-offer-type。

  6. 要使用此注册令牌兑换客户识别码、客户 AWS 账户 ID 和产品代码，您的网站必须致电 ResolveCustomerAWS Marketplace 计量服务。客户标识符不是客户 AWS 账户 ID，但它在产品之间是通用的，应作为客户记录的一部分保存到内部来源。产品代码是 AWS 提供给您的SaaS产品的唯一字符串。每种 AWS 产品都有一个唯一的产品代码，该代码是在注册时分配给您的。

    注意

    要查看 ResolveCustomer 调用示例，请参阅 ResolveCustomer 代码示例。

  7. 指示客户在产品中创建账户或登录现有账户。

    注意

    如果在您的产品中设置或关联现有客户账户需要您的团队手动操作，则可以使用“联系我们”表单来收集客户的联系信息。收集他们的联系信息并解析其 AWS Marketplace 唯一客户标识符（如步骤 6 所获得的）后，向客户显示一条通知消息。在通知中，说明他们的账户正在设置中，并要求他们等待您与他们联系。向客户提供预期的周转时间和您的联系信息。还要向客户发送一封包含相同详细信息的电子邮件。

  8. 客户现在已使用特定于该 SaaS 产品的凭证登录您的网站。在您的账户数据库中，对于每个客户可能都有一个条目。您的账户数据库中必须有一列 AWS 客户标识符，您可以使用在步骤 6 中获得的客户标识符填充该列。验证您的系统中没有任何其他账户共享此客户标识符。对于通过订阅多个产品的客户 AWS Marketplace，客户标识符将保持不变，每次订阅都有一个唯一的产品代码。

  9. 在卖家注册过程中，您订阅 Amazon SNS 主题，用于在客户订阅或取消订阅您的产品时通知您。以下是 JSON 格式的 Amazon SNS 通知，用于告知您买家的操作：

    • 权利通知 - 对于定价模式中包含合同的产品，当买家创建新合同、升级合同、续订合同或合同到期时，您会收到通知。您的账户数据库必须有额外的一列来表示订阅状态。有关更多信息，请参阅 Amazon SNS 主题：aws-mp-entitlement-notification。

    • 订阅通知 - 对于任何定价模式的产品，包括合同和订阅，当买家订阅或取消订阅产品时，您会收到通知。有关更多信息，请参阅 Amazon SNS 主题：aws-mp-subscription-notification。

    建议您使用 Amazon Simple Queue Service (Amazon SQS) 来捕获这些消息。您在收到带有 subscribe-success 的订阅通知后，客户账户已准备就绪，可以计量了。系统不会计量您在此通知前发送的记录。有关如何执行此操作的信息，请参阅《Amazon Simple Notification Service 开发人员指南》中的步骤 2：授予 Amazon SNS 主题向 Amazon SQS 队列发送消息的权限。

    注意

    除非您收到 subscribe-success 通知，否则请勿激活产品订阅。

  10. 可以使用存储在数据库中的客户标识符通过 AWS Marketplace Metering Service 对用量计量或通过 AWS Marketplace Entitlement Service检查权利。

安全性和订购

作为卖家，您有责任仅信任立即返回的客户识别码 AWS 或您的系统已签名的客户识别码。我们建议您立即解析注册令牌，因为它可能会在约 1 个小时后过期。解析注册令牌后，将客户标识符作为签名的属性存储在客户的浏览器会话中，直到注册完成。