翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
SaaS の顧客のオンボーディング
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、および対応する製品コードについて解決する必要があります。コード例については、ResolveCustomer コード例 を参照してください。
注記
登録トークンは特定のサブスクリプション顧客向けに解決され、生成された各トークンの有効期限は 4 時間です。呼び出し元が同じトークンを使用して API を呼び出している限り、トークンの有効期限が切れるまで同じ応答値を返し続けます。
新しい購入者を受け入れるための SaaS 製品の設定
新しい顧客を受け入れ、適切に計測するために SaaS ソフトウェアを正しく設定する責任を負います。次のプロセスでは、新規顧客のソフトウェアへのアクセスを特定、実装、計測するための推奨方法の 1 つについて説明します。
-
顧客が AWS Marketplace ウェブサイトの製品ページにアクセスすると、製品をサブスクライブすることを選択します。
-
顧客の AWS アカウント が製品のサブスクライブされています。つまり、製品から送信されたサブスクリプションレコードと計測レコードは、顧客の AWS 請求書の一部になります。
-
その顧客に対して、その顧客の顧客 ID と販売者の製品コードが含まれている登録トークンが生成されます。
-
顧客は、ソフトウェアの登録ランディングページにリダイレクトされます。そのページでは、顧客 ID が含まれている登録トークンを受け入れる必要があります。
-
顧客のブラウザは、ソフトウェアの登録ランディングページ URL に
POSTリクエストを送信します。そのリクエストには、顧客の登録トークンが入っているPOSTパラメータ、x-amzn-marketplace-tokenが 1 つ含まれています。登録ウェブサイトの観点からは、顧客がこのパラメータを持つフォームを送信しました。登録トークンは不透明な文字列です。オファータイプが無料トライアルの場合は、2 つ目のパラメータ、free-trial値を含むx-amzn-marketplace-offer-typeがリクエストに追加されます。 -
この登録トークンを顧客識別子、顧客 AWS アカウント ID、製品コードと引き換えるには、ウェブサイトが AWS Marketplace Metering Service ResolveCustomerで を呼び出す必要があります。顧客識別子は顧客の AWS アカウント ID ではありませんが、製品間で共通なので、顧客レコードの一部として内部ソースに保存する必要があります。製品コードは、 AWS が提供する SaaS 製品の一意の文字列です。各 AWS 製品には一意の製品コードが 1 つあり、登録時に割り当てられます。
注記
ResolveCustomer呼び出しの例については、「ResolveCustomer コード例」を参照してください。 -
顧客は、製品でアカウントを作成するか、または既存のアカウントにサインインするように指示されます。
注記
製品内の既存の顧客アカウントを設定またはリンクするためにチームが手動で行う必要がある場合は、お問い合わせフォームを使用して顧客の連絡先情報を収集できます。連絡先情報を収集し、 AWS Marketplace 固有の顧客 ID (ステップ 6 で取得) を解決したら、顧客に通知メッセージを表示します。通知には、アカウントの設定中であることを記載し、販売者からの連絡を待つように伝えます。予想される時期と連絡先情報を顧客に伝えます。また、同じ詳細を記載した E メールメッセージを顧客に送信します。
-
顧客は、その SaaS 製品に固有の認証情報を使用して、販売者のウェブサイトにサインインしています。アカウントのデータベースでは、顧客ごとのエントリを含むことができます。アカウントデータベースには、ステップ 6 で取得した AWS 顧客識別子を入力する顧客識別子の列が必要です。販売者のシステム内の他のアカウントでこの顧客 ID が共有されていないことを確認します。を通じて複数の製品をサブスクライブするお客様の場合 AWS Marketplace、お客様識別子は変わりません。各サブスクリプションには一意の製品コードがあります。
-
販売者登録プロセス中に、顧客が製品をサブスクライブした、またはサブスクリプションを解除したときに通知する、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 Queue Service デベロッパーガイド」の「ステップ 2: Amazon SQS キューにメッセージを送信する許可を Amazon SNS トピックに付与する」を参照してください。注記
subscribe-success通知を受信しない限り、製品サブスクリプションをアクティブ化しないでください。 -
販売者は、販売者のデータベースに保存されている顧客 ID を使用して、AWS Marketplace Metering Service を通じて使用量を計測し、 AWS Marketplace Entitlement Serviceを通じて使用権限をチェックします。
セキュリティと注文
販売者は、 からすぐに返された顧客識別子、 AWS またはシステムが署名した顧客識別子のみを信頼する責任があります。登録トークンは約 1 時間後に期限切れになる可能性があるため、すぐに解決することをお勧めします。登録トークンを解決したら、登録が完了するまで、顧客のブラウザセッションで署名済みの属性として顧客 ID を保存します。
