AWS eventbridge: Reworded EventBridge IAM role and policy guidance
Summary
Editorial rewrite of the EventBridge IAM roles page: clarifies that custom IAM policies are attached to users/groups needing permissions, that target roles grant EventBridge permission to invoke targets, that the console creates roles with well-scoped permissions, and that each target type uses a different permission model. Also moves the example user policy text to the end of the tagging section. No new permissions, statements, or policy examples were added or changed.
Security assessment
The change is purely editorial but continues to document IAM least-privilege practice for EventBridge (custom policies scoped to needed permissions, well-scoped target roles, resource-based policies per target type). No specific vulnerability, CVE, or incident is referenced, and no policy statements or permission scopes were altered, so it is security-adjacent documentation only.
Evidence
+You can also create your own custom IAM policies for EventBridge actions and resources. Attach these policies to the IAM users or groups that need the permissions.
Diff
diff --git a/eventbridge/latest/userguide/eb-events-iam-roles.md b/eventbridge/latest/userguide/eb-events-iam-roles.md index 6695f96..70e5920 100644 --- a//eventbridge/latest/userguide/eb-events-iam-roles.md +++ b//eventbridge/latest/userguide/eb-events-iam-roles.md @@ -28 +28 @@ To relay events to targets, EventBridge needs an IAM role. -You can also create your own custom IAM policies to allow permissions for EventBridge actions and resources. You can attach these custom policies to the IAM users or groups that require those permissions. For more information about IAM policies, see [Overview of IAM Policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) in the _IAM User Guide_. For more information about managing and creating custom IAM policies, see [Managing IAM Policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingPolicies.html) in the _IAM User Guide_. +You can also create your own custom IAM policies for EventBridge actions and resources. Attach these policies to the IAM users or groups that need the permissions. For more information about IAM policies, see [Overview of IAM Policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) in the _IAM User Guide_. To learn how to create and manage custom policies, see [Managing IAM Policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingPolicies.html) in the _IAM User Guide_. @@ -32 +32 @@ You can also create your own custom IAM policies to allow permissions for EventB -EventBridge targets typically require IAM roles that grant permission to EventBridge to invoke the target. The following are some examples for various AWS services and targets. For others, use the EventBridge console to create a Rule and create a new Role which will be created with a policy with well-scoped permissions preconfigured. +EventBridge targets typically require IAM roles that grant EventBridge permission to invoke the target. The following sections give examples for several AWS services and targets. For other targets, use the EventBridge console to create a rule. The console creates a new role for you, with a policy that has well-scoped permissions already configured. @@ -34 +34 @@ EventBridge targets typically require IAM roles that grant permission to EventBr -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_. +Set the correct permissions for each target type. Without the appropriate IAM role or resource-based policy, EventBridge cannot invoke the target, and event delivery fails. Each target type uses a different permission model. Review the requirements for your target before you create a rule. Several target types rely on resource-based policies. To create these policies, 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_. @@ -47 +47 @@ API Gateway | Can use either resource-based policies or IAM roles. -If the target is an API destination, the role that you specify must include a policy with the following statement: +If the target is an API destination, the role you specify must include a policy with the following statement: @@ -73 +73 @@ If the target is a Kinesis stream, the role used to send event data to that targ -If the target is Systems Manager run command, and you specify one or more `InstanceIds` values for the command, the role that you specify must include a policy with the following statement: +If the target is Systems Manager run command, and you specify one or more `InstanceIds` values for the command, the role you specify must include a policy with the following statement: @@ -126 +126 @@ The role must also include the following statement to grant access to the System -If the target is an AWS Step Functions state machine, the role that you specify must include a policy with the following: +If the target is an AWS Step Functions state machine, the role you specify must include a policy with the following: @@ -139 +139 @@ If the target is an AWS Step Functions state machine, the role that you specify -If the target is an Amazon ECS task, the role that you specify must include the following policy. +If the target is an Amazon ECS task, the role you specify must include the following policy. @@ -235,2 +234,0 @@ JSON -The following example shows a user policy that grant permissions for EventBridge actions. This policy works when you use the EventBridge API, AWS SDKs, or the AWS CLI. - @@ -239 +237,3 @@ You can grant users access to specific EventBridge rules while preventing them f -You can grant an IAM policy to a user to allow access to only the rules with a particular tag. You choose which rules to grant access to by tagging them with that particular tag. For example, the following policy grants a user access to rules with the value of `Prod` for the tag key `Stack`. +You can attach an IAM policy to a user to allow access to only the rules with a particular tag. You choose which rules to grant access to by tagging them with that particular tag. For example, the following policy grants a user access to rules with the value of `Prod` for the tag key `Stack`. + +The following example shows a user policy that grants permissions for EventBridge actions. This policy works when you use the EventBridge API, AWS SDKs, or the AWS CLI.