翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用して SaaS 製品に顧客をオンボーディングする AWS Marketplace
<a name="saas-product-customer-setup"></a>

 Software as a Service (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 つについて説明します。

1. 顧客が AWS Marketplace ウェブサイトの製品ページにアクセスすると、製品をサブスクライブすることを選択します。

1. お客様の AWS アカウント はお客様の製品にサブスクライブされています。つまり、製品から送信されたサブスクリプションレコードと計測レコードは、顧客の AWS 請求書の一部になります。

1. その顧客に対して、その顧客の顧客 ID と販売者の製品コードが含まれている登録トークンが生成されます。

1. 顧客は、ソフトウェアの登録ランディングページにリダイレクトされます。そのページでは、顧客 ID が含まれている登録トークンを受け入れる必要があります。

1. 顧客のブラウザは、ソフトウェアの登録ランディングページ URL に `POST` リクエストを送信します。そのリクエストには、顧客の登録トークンが入っている `POST` パラメータ、`x-amzn-marketplace-token` が 1 つ含まれています。登録ウェブサイトの観点からは、顧客がこのパラメータを持つフォームを送信しました。登録トークンは不透明な文字列です。オファータイプが無料トライアルの場合は、2 つ目のパラメータ、`free-trial` 値を含む `x-amzn-marketplace-offer-type` がリクエストに追加されます。

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 つあり、登録時に割り当てられます。

1.  顧客は、製品でアカウントを作成するか、または既存のアカウントにサインインするように指示されます。
**注記**  
製品内の既存の顧客アカウントを設定またはリンクするためにチームが手動で行う必要がある場合は、お問い合わせフォームを使用して顧客の連絡先情報を収集できます。顧客の連絡先情報を収集し、 AWS アカウント ID と固有の顧客 ID (ステップ 6 で取得) を解決した後、顧客に通知メッセージを表示します。通知には、アカウントの設定中であることを記載し、販売者からの連絡を待つように伝えます。予想される時期と連絡先情報を顧客に伝えます。また、同じ詳細を記載した E メールメッセージを顧客に送信します。

1.  顧客は、その SaaS 製品に固有の認証情報を使用して、販売者のウェブサイトにサインインしています。アカウントのデータベースでは、顧客ごとのエントリを含むことができます。アカウントデータベースには AWS アカウント ID の列が必要です。システム内の他のアカウントが AWS アカウント ID を共有していないことを確認します。

1. 
**重要**  
 AWS Marketplace SaaS 製品の SNS 通知は、Amazon EventBridge 通知に置き換えられています。SNS と統合された既存の SaaS 製品がある場合は、引き続き機能します。新しい出品は、最終的に SNS の代わりに Amazon EventBridge の使用に移行します。詳細については、「[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)」を参照してください。

   EventBridge ルールのターゲットとして Amazon Simple Queue Service (Amazon SQS) を使用して、これらのイベントをキャプチャすることをお勧めします。販売者が `subscribe-success` でサブスクリプション通知を受信すると、その顧客アカウントは計測する準備ができています。このイベントの前に送信したレコードは計測されません。SQS ターゲットで 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>

 販売者は、 からすぐに返された ID AWS またはシステムが署名した AWS アカウント IDs のみを信頼する責任があります。登録トークンは約 1 時間後に期限切れになる可能性があるため、すぐに解決することをお勧めします。登録トークンを解決したら、登録が完了するまで AWS アカウント ID を署名付き属性として顧客のブラウザセッションに保存します。