View a markdown version of this page

將您的 SaaS 合約產品與 整合 AWS Marketplace - AWS Marketplace
案例：您的服務會驗證新客戶案例：您的服務處理客戶請求案例：監控使用者訂閱的變更測試您的 SaaS 合約產品整合

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

將您的 SaaS 合約產品與 整合 AWS Marketplace

新 SaaS 產品的整合需求將於 2026 年 6 月 1 日變更

AWS Marketplace 推出並行協議的支援，在相同的協議期間，可在單一 AWS 帳戶上多次購買相同的產品。從 2026 年 6 月 1 日開始，所有新的 SaaS 產品都需要支援更新的整合需求。檢閱並行協議的新整合。

將您的軟體即服務 (SaaS) 合約產品與 整合 AWS Marketplace ，是 中的一個步驟在 中建立 SaaS 產品 AWS Marketplace。若要整合您的軟體即服務 (SaaS) 合約產品與 AWS Marketplace，您必須撰寫程式碼，並示範它可以成功回應數個客戶案例。下列各節說明這些案例、說明如何回應這些案例，並提供測試整合的概觀。

注意

開始之前，請確定您已為其中的軟體即服務 (SaaS) 產品選擇正確的定價模式 AWS Marketplace。如需詳細資訊，請參閱規劃您的 SaaS 產品。

案例：您的服務會驗證新客戶

當客戶訂閱您的產品時，它們會重新導向至您的註冊 URL，這是具有臨時x-amzn-marketplace-token字符的 HTTP POST 請求。以下列方式回應此請求：

  1. 呼叫 中的 ResolveCustomer API 操作，ProductCode以交換 CustomerIdentifier、LicenseArn、 CustomerAWSAccountId和 的字符 AWS Marketplace Metering Service。

  2. 透過呼叫 中的 GetEntitlements API 操作，確認客戶可存取的訂閱和數量 （如適用） AWS Marketplace Entitlement Service。

  3. ProductCode 在您的系統中保留 CustomerIdentifier、LicenseArn、 CustomerAWSAccountId和 以供日後呼叫。存放客戶是否擁有有效的訂閱，以及您需要的客戶相關資訊。

  4. 為了回應請求，您必須顯示使用者的第一次使用體驗 （適用於您的服務）。

案例：您的服務處理客戶請求

當客戶對您的服務提出請求時，您必須以適當的動作或簡訊回應下列案例：

  • 它們在您的系統中沒有客戶 ID。這表示他們尚未訂閱。您應該告訴使用者如何訂閱。

  • 他們有客戶 ID，API GetEntitlements操作會傳回適當的權利。在此案例中，您應該完成請求。

  • 它們確實有客戶 ID，但 GetEntitlements API 操作不會傳回任何權利，或沒有足夠的數量來滿足請求。在此案例中，您必須決定如何處理存取和管理他們的體驗。

案例：監控使用者訂閱的變更

重要

正在以 Amazon EventBridge 通知取代 AWS Marketplace SaaS 產品的 SNS 通知。如果您有與 SNS 整合的現有 SaaS 產品，它們將繼續運作。新的清單最終將轉換為使用 Amazon EventBridge 而非 SNS。如需詳細資訊，請參閱使用 Amazon EventBridge 管理 SaaS 訂閱事件。

將 Amazon Simple Queue Service (Amazon SQS) 佇列設定為 Amazon EventBridge 規則的目標，以接收客戶權利變更的相關事件。當您建立產品時，已提供 Amazon EventBridge 事件組態。如需詳細資訊，請參閱在 中建立 SaaS 產品 AWS Marketplace。透過設定 Amazon EventBridge 規則，您會收到客戶權利變更的相關事件，包括提供或撤銷特定客戶的存取權。

您必須回應的唯一通知是：

  • 授權已更新 Amazon EventBridge 事件 – 客戶權利已變更，您必須呼叫 GetEntitlements API 操作以查看新狀態。更新您的客戶商店，如果適用 （例如，客戶的合約已失效），請遵循關閉客戶資源的實務，並遵循您的保留政策。

注意

如需其他資訊，請參閱 使用 檢查權利 AWS Marketplace Entitlement Service。

測試您的 SaaS 合約產品整合

將 SaaS 合約產品與 整合之後 AWS Marketplace，您必須進行深入測試，以確保整合成功。下列程序概述驗證產品整合的步驟。

注意

使用您自己的帳戶訂閱您的產品，並測試整合是否成功。

啟動產品後，服務必須繼續回應新客戶的這些案例。

  1. 使用允許的帳戶，透過取得您產品的合約來測試客戶體驗。

  2. 帳戶簽訂合約後，請確定帳戶重新導向至註冊 URL，而且重新導向是包含臨時字符的 POST 請求。請確定您的應用程式保留客戶 ID 以供未來通話使用，並正確處理客戶擁有的權利。這會測試 的一部分案例：您的服務會驗證新客戶。

  3. 在上一個步驟中驗證測試帳戶後，將帳戶加入您的應用程式。例如，您可以讓測試客戶填寫表單來建立新的使用者。或者，提供他們存取 SaaS 應用程式的其他後續步驟。這會測試 的一部分案例：您的服務會驗證新客戶。

  4. 如果 GetEntitlements API 操作未傳回任何權利，無論是在加入期間或持續驗證通過時，您的應用程式都必須正確管理無權使用者的存取和體驗。這會測試 案例：您的服務處理客戶請求。

  5. 測試訂閱變更。確認您的應用程式正確處理取消訂閱、成功訂閱和失敗的訂閱案例。這會測試 案例：監控使用者訂閱的變更。

  6. 在您完成所有整合要求並測試解決方案之後，請通知 AWS Marketplace 營運團隊。然後，他們會驗證您已成功呼叫 GetEntitlements API 操作並充分加入新客戶，以測試解決方案。

整合和測試完成後，您可以執行最終審核並在公開上列出您的產品 AWS Marketplace。如需詳細資訊，請參閱在 中建立 SaaS 產品 AWS Marketplace。您也可以填寫退款申請表來取消測試訂閱。如需取消訂閱的詳細資訊，請參閱 請求帳單調整 （退款）。