Receiving events from a SaaS partner with Amazon EventBridge - Amazon EventBridge

Receiving events from a SaaS partner with Amazon EventBridge

To receive events from SaaS partner applications and services, you need a partner event source from the partner. Then you can create a partner event bus and match it to the partner event source.

The following video covers SaaS integrations with EventBridge:

Supported SaaS partner integrations

EventBridge supports the following SaaS partner integrations:

Partner event sources are available in the following Regions.

Code Name

us-east-1

US East (N. Virginia)

us-east-2

US East (Ohio)

us-west-1

US West (N. California)

us-west-2

US West (Oregon)

ca-central-1

Canada (Central)

eu-central-1

Europe (Frankfurt)

eu-central-2

Europe (Zurich)

eu-west-1

Europe (Ireland)

eu-west-2

Europe (London)

eu-west-3

Europe (Paris)

eu-north-1

Europe (Stockholm)

eu-south-1

Europe (Milan)

eu-south-2

Europe (Spain)

af-south-1

Africa (Cape Town)

ap-south-1

Asia Pacific (Mumbai)

ap-south-2

Asia Pacific (Hyderabad)

ap-east-1

Asia Pacific (Hong Kong)

ap-northeast-1

Asia Pacific (Tokyo)

ap-northeast-2

Asia Pacific (Seoul)

ap-northeast-3

Asia Pacific (Osaka)

ap-southeast-1

Asia Pacific (Singapore)

ap-southeast-2

Asia Pacific (Sydney)

ap-southeast-3

Asia Pacific (Jakarta)

ap-southeast-4

Asia Pacific (Melbourne)

cn-north-1

China (Beijing)

cn-northwest-1

China (Ningxia)

me-central-1

Middle East (UAE)

me-south-1

Middle East (Bahrain)

sa-east-1

South America (São Paulo)

il-central-1

Israel (Tel Aviv)

Configuring Amazon EventBridge to receive events from a SaaS integration

  1. Open the Amazon EventBridge console at https://console.aws.amazon.com/events/.

  2. In the navigation pane, choose Partner event sources.

  3. Find the partner that you want and then choose Set up for that partner.

  4. To copy your account ID to the clipboard, choose Copy.

  5. In the navigation pane, choose Partner event sources.

  6. Go to the partner's website and follow the instructions to create a partner event source using your account ID. The event source that you create is available to only your account.

  7. Go back to the EventBridge console and choose Partner event sources in the navigation pane.

  8. Select the button next to the partner event source and then choose Associate with event bus.

    The status of the event source changes from Pending to Active, and the name of the event bus updates to match the partner event source name. You can now start creating rules that match events from the partner event source. For more information, see Creating a rule that matches SaaS partner events.

    Note

    Any events published by a partner to a partner event source that has not been associated with an event bus will be immediately dropped. Those events will not be persisted at rest in EventBridge.

Creating a rule that matches SaaS partner events

  1. Open the Amazon EventBridge console at https://console.aws.amazon.com/events/.

  2. In the navigation pane, choose Rules.

  3. Choose Create rule.

  4. Enter a name and description for the rule.

    A rule can't have the same name as another rule in the same Region and on the same event bus.

  5. For Event bus, choose the event bus that you want to associate with this rule. If you want this rule to match events that come from your account, select AWS default event bus. When an AWS service in your account emits an event, it always goes to your account’s default event bus.

  6. For Rule type, choose Rule with an event pattern.

  7. Choose Next.

  8. For Event source, choose Other.

  9. (Optional) For Sample events, choose the type of event.

  10. For Event pattern, enter a JSON event pattern.

  11. Choose Next.

  12. For Target types, choose AWS service.

  13. For Select a target, choose the AWS service that you want to send information to when EventBridge detects an event that matches the event pattern.

  14. The fields displayed vary depending on the service you choose. Enter information specific to this target type as needed.

  15. For many target types, EventBridge needs permissions to send events to the target. In these cases, EventBridge can create the IAM role needed for your rule to run. Do one of the following:

    • To create an IAM role automatically, choose Create a new role for this specific resource.

    • To use an IAM role that you created earlier, choose Use existing role and select the existing role from the drop-down list.

  16. (Optional) For Additional settings, do the following:

    1. For Maximum age of event, enter a value between one minute (00:01) and 24 hours (24:00).

    2. For Retry attempts, enter a number between 0 and 185.

    3. For Dead-letter queue, choose whether to use a standard Amazon SQS queue as a dead-letter queue. EventBridge sends events that match this rule to the dead-letter queue if they are not successfully delivered to the target. Do one of the following:

      • Choose None to not use a dead-letter queue.

      • Choose Select an Amazon SQS queue in the current AWS account to use as the dead-letter queue and then select the queue to use from the drop-down list.

      • Choose Select an Amazon SQS queue in an other AWS account as a dead-letter queue and then enter the ARN of the queue to use. You must attach a resource-based policy to the queue that grants EventBridge permission to send messages to it. For more information, see Granting permissions to the dead-letter queue.

  17. (Optional) Choose Add another target to add another target for this rule.

  18. Choose Next.

  19. (Optional) Enter one or more tags for the rule. For more information, see Amazon EventBridge tags.

  20. Choose Next.

  21. Review the details of the rule and choose Create rule.