AWS Security ChangesHomeSearch

AWS eventbridge: CloudTrail logging docs for Custom Event Bus APIs and PutResourcePolicy

Service: eventbridge · 2026-10-10 · Documentation medium

File: eventbridge/latest/userguide/logging-using-cloudtrail.md · Type: logging

Summary

Adds documentation that Custom Event Bus API calls are recorded under the eventsv2.amazonaws.com event source, plus a full example CloudTrail PutResourcePolicy event showing the resource policy document, caller identity, and TLS details.

Security assessment

The change documents CloudTrail audit coverage for the new Custom Event Bus management APIs and shows that PutResourcePolicy calls (resource policies controlling cross-account access) are captured with requestParameters, principal identity, and TLS details, improving detection/auditing rather than fixing a specific vulnerability.

Evidence

+CloudTrail records Custom Event Bus API calls with the event source `eventsv2.amazonaws.com`. `PutEvents` and `PutRawEvents` publish events to a bus. Every other Custom Event Bus API operation is a management event.

Diff

diff --git a/eventbridge/latest/userguide/logging-using-cloudtrail.md b/eventbridge/latest/userguide/logging-using-cloudtrail.md
index 7d7783a..3c480c9 100644
--- a//eventbridge/latest/userguide/logging-using-cloudtrail.md
+++ b//eventbridge/latest/userguide/logging-using-cloudtrail.md
@@ -49,0 +50,4 @@ All Amazon EventBridge API operations except [PutEvents](https://docs.aws.amazon
+CloudTrail records Custom Event Bus API calls with the event source `eventsv2.amazonaws.com`. `PutEvents` and `PutRawEvents` publish events to a bus. Every other Custom Event Bus API operation is a management event.
+
+For a complete list of Custom Event Bus API operations, see [Actions](https://docs.aws.amazon.com/eventbridgev2/latest/APIReference/API_Operations.html) in the _Custom Event Bus API Reference_.
+
@@ -178,0 +183,62 @@ The following example shows a CloudTrail event that demonstrates the `PutRule` o
+In a successful Custom Event Bus `PutResourcePolicy` call, the `requestParameters` field holds the policy document as the caller submitted it. The following example shows a CloudTrail event for such a call:
+    
+    
+    {
+      "eventVersion": "1.11",
+      "userIdentity": {
+        "type": "AssumedRole",
+        "principalId": "AROA3XFRBF23EXAMPLE:johndoe-session",
+        "arn": "arn:aws:sts::111122223333:assumed-role/MyRole/johndoe-session",
+        "accountId": "111122223333",
+        "accessKeyId": "ASIAIOSFODNN7EXAMPLE",
+        "sessionContext": {
+          "sessionIssuer": {
+            "type": "Role",
+            "principalId": "AROA3XFRBF23EXAMPLE",
+            "arn": "arn:aws:iam::111122223333:role/MyRole",
+            "accountId": "111122223333",
+            "userName": "MyRole"
+          },
+          "attributes": {
+            "creationDate": "2026-09-28T16:13:38Z",
+            "mfaAuthenticated": "false"
+          }
+        }
+      },
+      "eventTime": "2026-09-28T16:13:43Z",
+      "eventSource": "eventsv2.amazonaws.com",
+      "eventName": "PutResourcePolicy",
+      "awsRegion": "us-east-1",
+      "sourceIPAddress": "192.0.2.1",
+      "userAgent": "aws-cli/2.37.3",
+      "requestParameters": {
+        "resourceArn": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef",
+        "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"AllowPartnerAccountToSubscribe\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":[\"events:CreateSubscriber\",\"events:DescribeEventBus\"],\"Resource\":\"arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef\"}]}",
+        "policyName": "default"
+      },
+      "responseElements": {
+        "resourceArn": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef",
+        "policyName": "default",
+        "revisionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa"
+      },
+      "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb",
+      "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEccccc",
+      "readOnly": false,
+      "resources": [
+        {
+          "accountId": "111122223333",
+          "type": "AWS::EventsV2::EventBus",
+          "ARN": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef"
+        }
+      ],
+      "eventType": "AwsApiCall",
+      "managementEvent": true,
+      "recipientAccountId": "111122223333",
+      "eventCategory": "Management",
+      "tlsDetails": {
+        "tlsVersion": "TLSv1.3",
+        "cipherSuite": "TLS_AES_128_GCM_SHA256",
+        "clientProvidedHostHeader": "111122223333.eventsv2.us-east-1.amazonaws.com"
+      }
+    }
+