AWS marketplace documentation change
Summary
Updated notification system documentation from SNS to EventBridge, added migration notice and EventBridge integration details
Security assessment
The change transitions notification mechanisms from SNS to EventBridge but does not indicate any security vulnerability being addressed. It focuses on service migration rather than security improvements.
Diff
diff --git a/marketplace/latest/userguide/saas-product-customer-setup.md b/marketplace/latest/userguide/saas-product-customer-setup.md index 425eaa347..1b76ad13d 100644 --- a//marketplace/latest/userguide/saas-product-customer-setup.md +++ b//marketplace/latest/userguide/saas-product-customer-setup.md @@ -43 +43 @@ If setting up or linking to an existing customer account in your product require - 9. During your seller registration process, you subscribe to Amazon SNS topics that notify you when customers subscribe or unsubscribe to your product. These are Amazon SNS notifications in JSON format that inform you of customer actions: + 9. ###### Important @@ -45 +45 @@ If setting up or linking to an existing customer account in your product require - * Entitlement notification – For products with pricing models that include a contract, you are notified when buyers create a new contract, upgrade it, renew it, or it expires. Your accounts database must have an extra column for the subscription state. For more information, see [Amazon SNS topic: aws-mp-entitlement-notification](./saas-notification.html#saas-sns-message-body). +SNS notifications for AWS Marketplace SaaS products are being replaced with Amazon EventBridge notifications. If you have existing SaaS products integrated with SNS, they will continue to function. New listings will eventually transition to using Amazon EventBridge instead of SNS. For more information, see [Managing SaaS subscription events with Amazon EventBridge](./saas-eventbridge-integration.html). @@ -47 +47 @@ If setting up or linking to an existing customer account in your product require - * Subscription notification – For products with any pricing model, including contracts and subscriptions, you are notified when a buyer subscribes or unsubscribes to a product. For more information, see [Amazon SNS topic: aws-mp-subscription-notification](./saas-notification.html#saas-sns-subscription-message-body). +During your seller registration process, you configure Amazon EventBridge rules to receive events that notify you when customers subscribe or unsubscribe to your product. These are Amazon EventBridge events in JSON format that inform you of customer actions: @@ -49 +49,5 @@ If setting up or linking to an existing customer account in your product require -We recommend that you use Amazon Simple Queue Service (Amazon SQS) to capture these messages. After you receive a subscription notification with `subscribe-success`, the customer account is ready for metering. Records that you send before this notification aren't metered. For information about how to do this, see [Step 2: Give permission to the Amazon SNS topic to send messages to the Amazon SQS queue](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html#SendMessageToSQS.sqs.permissions) in the _Amazon Simple Notification Service Developer Guide_. + * Entitlement notification – For products with pricing models that include a contract, you are notified when buyers create a new contract, upgrade it, renew it, or it expires. Your accounts database must have an extra column for the subscription state. For more information, see [Managing SaaS subscription events with Amazon EventBridge](./saas-eventbridge-integration.html). + + * Subscription notification – For products with any pricing model, including contracts and subscriptions, you are notified when a buyer subscribes or unsubscribes to a product. For more information, see [Managing SaaS subscription events with Amazon EventBridge](./saas-eventbridge-integration.html). + +We recommend that you use Amazon Simple Queue Service (Amazon SQS) as a target for your EventBridge rules to capture these events. After you receive a subscription notification with `subscribe-success`, the customer account is ready for metering. Records that you send before this event aren't metered. For information about how to set up EventBridge rules with SQS targets, see [Amazon SQS targets](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html#eb-targets-sqs) in the _Amazon EventBridge User Guide_.