AWS eventbridge: Clarify EventBridge IAM policy ARN format and authorization wording
Summary
Editorial rewording of the EventBridge IAM access management page, including a clarification that when specifying API destination or connection resources in an IAM policy Resource element you should omit the service-generated identifier and use the documented ARN format, since EventBridge uses the resource ARN for authorization.
Security assessment
The changed line clarifies how IAM policy Resource ARNs must be formatted for EventBridge authorization, which is security-adjacent guidance on access control. It is a wording/grammar clarification rather than a fix for a specific vulnerability, so it is not security_issue_related, but it does document IAM authorization behavior.
Evidence
+For API responses that include an API destination or connection ARN, EventBridge returns an ARN with a service-generated identifier after the resource name. When you specify one of these resources in the `Resource` element of an IAM policy, omit the service-generated identifier. Use the ARN format shown in the preceding table. For API operations that identify the resource by name, an ARN that includes the identifier does not match the resource ARN. EventBridge uses the resource ARN for authorization.
Diff
diff --git a/eventbridge/latest/userguide/eb-manage-iam-access.md b/eventbridge/latest/userguide/eb-manage-iam-access.md index 62f8590..e7e14ee 100644 --- a//eventbridge/latest/userguide/eb-manage-iam-access.md +++ b//eventbridge/latest/userguide/eb-manage-iam-access.md @@ -15 +15 @@ You manage access to EventBridge resources such as [rules](./eb-rules.html) or [ -EventBridge resources and subresources have unique Amazon Resource Names (ARNs) associated with them. You use ARNs in EventBridge to create event patterns. For more information about ARNs, see [Amazon Resource Names (ARN) and AWS Service Namespaces](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the _Amazon Web Services General Reference_. +EventBridge resources and subresources have unique Amazon Resource Names (ARNs). You use ARNs in EventBridge to create event patterns. For more information about ARNs, see [Amazon Resource Names (ARN) and AWS Service Namespaces](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the _Amazon Web Services General Reference_. @@ -38 +38 @@ All EventBridge resources owned by the specified account in the specified Region -For API responses that include an API destination or connection ARN, EventBridge returns an ARN with a service-generated identifier after the resource name. When you specify one of these resources in the `Resource` element of an IAM policy, omit the service-generated identifier and use the ARN format shown in the preceding table. For API operations that identify the resource by name, an ARN that includes the identifier does not match the resource ARN that EventBridge uses for authorization. +For API responses that include an API destination or connection ARN, EventBridge returns an ARN with a service-generated identifier after the resource name. When you specify one of these resources in the `Resource` element of an IAM policy, omit the service-generated identifier. Use the ARN format shown in the preceding table. For API operations that identify the resource by name, an ARN that includes the identifier does not match the resource ARN. EventBridge uses the resource ARN for authorization. @@ -45 +45 @@ The following example shows how to indicate a specific rule (`myRule`) in your s -To specify all rules that belong to a specific account by using the asterisk (*) wildcard as follows. +To specify all rules that belong to a specific account, use the asterisk (*) wildcard as follows: @@ -66 +66 @@ An account owns the resources in the account, no matter who creates the resource - * If you create an user in your account and grant permissions to create EventBridge resources to that user, the user can create EventBridge resources. However, your account, which the user belongs to, owns the EventBridge resources. + * If you create a user in your account and grant permissions to create EventBridge resources to that user, the user can create EventBridge resources. However, your account, which the user belongs to, owns the EventBridge resources. @@ -115 +115 @@ You can create specific IAM policies to restrict the calls and resources that us -When a rule runs in EventBridge, all of the [targets](./eb-targets.html) associated with the rule are invoked, which means invoking the AWS Lambda functions, publishing to the Amazon SNS topics, or relaying the event to the Amazon Kinesis streams. To make API calls on the resources that you own, EventBridge needs the appropriate permission. For Lambda, Amazon SNS, and Amazon SQS resources, EventBridge uses resource-based policies. For Kinesis streams, EventBridge uses IAM roles. +When a rule runs in EventBridge, all of the [targets](./eb-targets.html) associated with the rule are invoked. This means EventBridge invokes the AWS Lambda functions, publishes to the Amazon SNS topics, or relays the event to the Amazon Kinesis streams. To make API calls on the resources that you own, EventBridge needs the appropriate permission. For Lambda, Amazon SNS, and Amazon SQS resources, EventBridge uses resource-based policies. For Kinesis streams, EventBridge uses IAM roles.