AWS eventbridge: Clarify eventBusInvocation condition key for cross-Region targets
Summary
Documents that the events:eventBusInvocation condition key is true only when the rule and target event bus are in the same Region, and that for cross-Region targets the key is false, so aws:SourceArn with the source rule ARN should be used to allow only forwarded events. Also fixes a typo ('when when' -> 'when').
Security assessment
The change documents an authorization-relevant condition key behavior and explicitly recommends using aws:SourceArn to restrict which events are forwarded across Regions, which is access-control guidance for event bus policies. It is best-practice documentation rather than a fix for a specific disclosed vulnerability.
Evidence
+events:eventBusInvocation | `"events:eventBusInvocation":"`boolean`"` For `boolean`, use true when a rule sends an event to a target that is an event bus in another account. Use false when a `PutEvents` API call is used. This key is true only when the rule and the target event bus are in the same Region. For a cross-Region target, the key is false, so use `aws:SourceArn` with the source rule ARN to allow only forwarded events. | eventBusInvocation, Null
Diff
diff --git a/eventbridge/latest/userguide/eb-use-conditions.md b/eventbridge/latest/userguide/eb-use-conditions.md index b5bd929..f3d873d 100644 --- a//eventbridge/latest/userguide/eb-use-conditions.md +++ b//eventbridge/latest/userguide/eb-use-conditions.md @@ -38 +38 @@ events: detail.userIdentity.principalId | `"events:detail.userIdentity.principa -events:eventBusInvocation | `"events:eventBusInvocation":"`boolean`"` For `boolean`, use true when a rule sends an event to a target that is an event bus in another account. Use false when when a `PutEvents` API call is used. | eventBusInvocation, Null +events:eventBusInvocation | `"events:eventBusInvocation":"`boolean`"` For `boolean`, use true when a rule sends an event to a target that is an event bus in another account. Use false when a `PutEvents` API call is used. This key is true only when the rule and the target event bus are in the same Region. For a cross-Region target, the key is false, so use `aws:SourceArn` with the source rule ARN to allow only forwarded events. | eventBusInvocation, Null @@ -107 +107 @@ JSON -The `eventBusInvocation` indicates whether the invocation originates from a cross-account target or a `PutEvents` API request. The value is **true** when the invocation results from a rule that include a cross-account target, such as when the target is an event bus in another account. The value is **false** when the invocation results from a `PutEvents` API request. The following example indicates an invocation from a cross-account target. +The `eventBusInvocation` indicates whether the invocation originates from a cross-account target or a `PutEvents` API request. The value is **true** when the invocation results from a rule that includes a cross-account target, such as when the target is an event bus in another account. The value is **false** when the invocation results from a `PutEvents` API request. This key is **true** only when the rule and the target event bus are in the same Region. For a cross-Region target, the key is **false**. In that case, use `aws:SourceArn` with the source rule ARN to allow only forwarded events. The following example indicates an invocation from a cross-account, same-Region target: