AWS eventbridge: Add per-target IAM/resource-policy permission requirement table
Summary
Replaces a short sentence about target permissions with an expanded explanation plus a table describing the permission model for each EventBridge target type (SQS/SNS/Lambda, CloudWatch Logs, event bus, API Gateway), including the requirement that event bus targets have an IAM role granting `events:PutEvents` and cross-account resource-policy allowance, and links to resource-based policy and role-creation guidance.
Security assessment
The changed line documents IAM/permission requirements for EventBridge targets, most notably the least-privilege `events:PutEvents` role needed for event bus targets and the cross-account resource-policy grant, which is guidance with direct authorization/cross-account-exposure impact. It teaches correct permission configuration rather than fixing a specific vulnerability, so it is security documentation at medium severity.
Evidence
+EventBridge event bus | EventBridge event bus targets must have an IAM role that grants `events:PutEvents` on the target event bus. When the target event bus is in another account, the target bus's resource-based policy must allow the sender account.
Diff
diff --git a/eventbridge/latest/userguide/eb-events-iam-roles.md b/eventbridge/latest/userguide/eb-events-iam-roles.md index f058ef8..6695f96 100644 --- a//eventbridge/latest/userguide/eb-events-iam-roles.md +++ b//eventbridge/latest/userguide/eb-events-iam-roles.md @@ -34 +34,10 @@ EventBridge targets typically require IAM roles that grant permission to EventBr -Amazon SQS, Amazon SNS, and Lambda targets support both IAM execution roles and resource-based policies. CloudWatch Logs and EventBridge bus targets do not use roles, and permissions to EventBridge must be granted via a resource policy. API Gateway targets can use either resource policies or IAM roles. +Configuring the correct permissions for each target type matters: without the appropriate IAM role or resource-based policy, EventBridge cannot invoke the target and event delivery fails. Because the required permission model differs by target type, review the requirements for your target before you create a rule. For step-by-step guidance on creating the resource-based policies that several target types rely on, see [Using resource-based policies for Amazon EventBridge](./eb-use-resource-based.html); to create the IAM roles that EventBridge assumes, see [Creating a Role to Delegate Permissions to an AWS Service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) in the _IAM User Guide_. + +Permission requirements vary by target type: + +EventBridge target permission requirements Target type | Permission requirement +---|--- +Amazon SQS, Amazon SNS, and Lambda | Supports both IAM execution roles and resource-based policies. +CloudWatch Logs | Does not use roles; instead, permissions must be granted with a resource-based policy. +EventBridge event bus | EventBridge event bus targets must have an IAM role that grants `events:PutEvents` on the target event bus. When the target event bus is in another account, the target bus's resource-based policy must allow the sender account. +API Gateway | Can use either resource-based policies or IAM roles.