整合您的 SaaS 合約產品

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

注意

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

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

當客戶訂閱您的產品時，他們會重新導向至您的註冊 URL，這是一個含有暫時x-amzn-marketplace-token權杖的 HTTP POST 要求。以下列方式回應此要求：

1. 將權杖交換為CustomerIdentifierCustomerAWSAccountId、，並ProductCode呼叫中的 ResolveCustomer API 作業 AWS Marketplace Metering Service。

2. 呼叫中的 GetEntitlements API 作業，以驗證客戶可存取的訂閱和數量 (如果適用) AWS Marketplace Entitlement Service。

3. 堅持 CustomerIdentifierCustomerAWSAccountId, 和ProductCode在您的系統中用於 future 的呼叫。存儲客戶是否擁有有效的訂閱，以及您需要的有關客戶的任何信息。

4. 作為對請求的回應，您必須顯示用戶的第一次使用體驗（如果您的服務適用）。

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

當客戶向您的服務提出要求時，您必須使用適當的動作或訊息回應下列案例：

• 他們在您的系統中沒有客戶 ID。這意味著他們尚未訂閱。你應該告訴用戶如何訂閱。

• 他們具有客戶 ID，且 GetEntitlements API 作業會傳回適當的權益。在這個案例中，您應該滿足要求。

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

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

設定 Amazon Simple Queue Service (Amazon SQS) 佇列，並訂閱您產品的 Amazon SNS 主題。您的 SNS 主題資訊已包含在您建立產品時從 AWS Marketplace 營運團隊收到的電子郵件訊息中。如需詳細資訊，請參閱 建立 SaaS 產品。透過訂閱 SNS 主題，您會收到有關客戶權益變更的通知，包括為特定客戶提供或撤銷存取權。

注意

一個 SNS 主題 Amazon 資源名稱（ARN）看起來像arn:aws:sns:us-east-1:<account id>:aws-mp-entitlement-notification-<product code>。

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

• entitlement-updated— 客戶權益已變更，您必須呼叫 GetEntitlements API 作業以查看新狀態。更新您的客戶商店，如果適用 (例如，客戶的合約已失效)，請遵循您關閉客戶資源的做法，並遵守您的保留政策。

注意

如需其他資訊，請參閱 檢查權利。

測試您的 SaaS 合約產品整合

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

注意

使用您自己的帳戶訂閱您的產品，並測試整合是否成功。價格可以暫時降低，以便您可以測試購買流程，而不會在這些帳戶中產生高額費用。如需暫時降低價格或允許其他測試帳戶存取您產品的詳細資訊，請聯絡我們。

產品推出後，服務必須繼續為新客戶回應這些案例。

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

2. 帳戶具有合同後，請確保帳戶重定向到註冊 URL，並且重定向是包含臨時令牌的 POST 請求。確保您的應用程式持續保留客戶 ID 以供 future 通話使用，並正確處理客戶擁有的權利。這測試的一部分案例：您的服務會驗證新客戶.

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

4. 如果 GetEntitlements API 作業 (無論是在上線期間或進行中的驗證通行證中) 都沒有傳回任何權利，您的應用程式必須正確管理無權使用者的存取權和體驗。這個測試案例：您的服務會處理客戶要求。

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

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

整合和測試完成後，您可以進行最後審核，並在公眾上架您的產品 AWS Marketplace。如需詳細資訊，請參閱 建立 SaaS 產品。您也可以透過填寫退款申請表來取消您的測試訂閱。如需取消訂閱的詳細資訊，請參閱AWS Marketplace 產品退款流程。