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

# 透過 將客戶加入您的 SaaS 產品 AWS Marketplace
<a name="saas-product-customer-setup"></a>

 透過軟體即服務 (SaaS) 訂閱和 SaaS 合約，您的客戶可以透過 訂閱您的產品， AWS Marketplace 但存取您 AWS 環境中的產品。訂閱產品後，您的客戶會被導向至您建立和管理做為 SaaS 產品一部分的網站，以註冊其帳戶並設定產品。

建立 SaaS 產品清單時，您會提供註冊登陸頁面的 URL。我們會在客戶訂閱後，使用該 URL 將客戶重新導向至您的註冊登陸頁面。在軟體的註冊登陸頁面上，您可以收集為客戶建立 帳戶所需的資訊。如果您打算透過電子郵件聯絡客戶以取得用量通知，建議您收集客戶的電子郵件地址。

註冊登陸頁面必須能夠識別和接受來自 的表單資料中的`x-amzn-marketplace-token`字符， AWS Marketplace 以及客戶的帳單識別符。然後，它應該將該字符值傳遞給 ， AWS Marketplace Metering Service 以解析唯一客戶 AWS 帳戶 ID、客戶識別符 （對於新實作或更新整合時，請改用客戶 AWS 帳戶 ID) 和對應的產品代碼。如需程式碼範例，請參閱「[`ResolveCustomer` 程式碼範例](saas-code-examples.md#saas-resolvecustomer-example)」。

**注意**  
註冊字符會解析給特定訂閱的客戶，而且每個產生的字符都有 4 小時的過期時段。只要呼叫者呼叫具有相同字符的 API，就會繼續傳回相同的回應值，直到字符過期為止。

## 設定您的 SaaS 產品以接受新買方
<a name="configuring-your-saas-application-to-accept-new-customers"></a>

您有責任正確設定 SaaS 軟體，以接受新客戶並適當計量新客戶。下列程序概述了識別、實作和計量新客戶存取軟體的一種建議方法：

1. 當客戶造訪您 AWS Marketplace 網站上的產品頁面時，他們選擇訂閱您的產品。

1. 客戶的 AWS 帳戶 已訂閱您的 產品。這表示從您的產品傳送的訂閱和計量記錄會成為客戶 AWS 帳單的一部分。

1. 系統會為客戶產生註冊字符，其中包含其 AWS 帳戶 ID、客戶識別符和您的產品代碼。

1. 客戶會重新導向至軟體的註冊登陸頁面。此頁面必須能夠接受具有客戶識別符的字符。

1. 客戶的瀏覽器會將`POST`請求傳送至軟體的註冊登陸頁面 URL。請求包含一個`POST`參數 `x-amzn-marketplace-token`，其中包含客戶的註冊字符。從註冊網站的觀點來看，客戶已提交具有此參數的表單。註冊字符是不透明字串。如果優惠類型是免費試用，則第二個參數`x-amzn-marketplace-offer-type`的值為 `free-trial`，將會新增至請求。

1. 若要將此註冊字符兌換為客戶 AWS 帳戶 ID、客戶識別符和產品代碼，您的網站必須在 AWS Marketplace Metering Service 上呼叫 [ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)。如需 `ResolveCustomer` 呼叫的範例，請參閱 [`ResolveCustomer` 程式碼範例](saas-code-examples.md#saas-resolvecustomer-example)。客戶識別符不是客戶的 AWS 帳戶 ID，但產品之間是通用的，應該儲存到內部來源做為客戶記錄的一部分。產品程式碼是 AWS 提供給您的 SaaS 產品的唯一字串。每個 AWS 產品都有一個唯一的產品代碼，會在註冊期間指派給您。

1.  指示客戶在您的產品中建立帳戶或登入現有帳戶。
**注意**  
如果設定或連結到您產品中的現有客戶帳戶需要您的團隊手動程序，您可以使用聯絡我們表單來收集客戶的聯絡資訊。在收集他們的聯絡資訊並解析他們的 AWS 帳戶 ID 和唯一的客戶識別符 （如步驟 6 中所取得） 之後，顯示客戶的通知訊息。在通知中，說明他們的帳戶正在進行設定，並要求他們等待您聯絡他們。提供客戶預期的周轉時間和您的聯絡資訊。同時傳送具有相同詳細資訊的電子郵件訊息給客戶。

1.  客戶現在已使用該 SaaS 產品特定的登入資料登入您的網站。在您的帳戶資料庫中，您可以為每個客戶有一個項目。您的帳戶資料庫必須具有 AWS 帳戶 ID 的資料欄。驗證系統中沒有其他帳戶共用 AWS 帳戶 ID。

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

   在賣方註冊程序期間，您可以將 Amazon EventBridge 規則設定為接收事件，在客戶訂閱或取消訂閱您的產品時通知您。以下是 JSON 格式的 Amazon EventBridge 事件，可通知您客戶動作：
   + 權利通知 – 對於具有包含合約定價模型的產品，當買方建立新合約、升級合約、續約合約或合約過期時，您會收到通知。您的帳戶資料庫必須具有訂閱狀態的額外資料欄。如需詳細資訊，請參閱[使用 Amazon EventBridge 管理 SaaS 訂閱事件](saas-eventbridge-integration.md)。
   + 訂閱通知 – 對於具有任何定價模式的產品，包括合約和訂閱，當買方訂閱或取消訂閱產品時，您會收到通知。如需詳細資訊，請參閱[使用 Amazon EventBridge 管理 SaaS 訂閱事件](saas-eventbridge-integration.md)。

   我們建議您使用 Amazon Simple Queue Service (Amazon SQS) 做為 EventBridge 規則的目標，以擷取這些事件。收到 的訂閱通知後`subscribe-success`，客戶帳戶已準備好進行計量。系統不會計量您在此事件之前傳送的記錄。如需如何使用 SQS 目標設定 EventBridge 規則的詳細資訊，請參閱《[Amazon EventBridge 使用者指南》中的 Amazon SQS 目標](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html#eb-targets-sqs)。 * EventBridge *
**注意**  
除非您收到`subscribe-success`通知，否則請勿啟用產品訂閱。

1.  使用存放在資料庫中的 AWS 帳戶 ID，透過 AWS Marketplace Metering Service 來計量用量，或透過 檢查權利 AWS Marketplace Entitlement Service。

## 安全性和訂購
<a name="security-and-ordering"></a>

 身為賣方，您有責任信任從 或系統簽署 AWS 的 AWS 帳戶 IDs。我們建議您立即解析註冊字符，因為它可能會在大約一小時後過期。解析註冊字符之後，請將 AWS 帳戶 ID 儲存為客戶瀏覽器工作階段上已簽章的屬性，直到註冊完成為止。