AWS CloudTrail AWS-cloudtrail

8 operations, identified by eventName in the audit log.

eventNameDescription
_catch_allCatch-all entry for AWS-cloudtrail rules that match the service but not a specific eventName.
CreateTrailCreates a CloudTrail trail that delivers log files recording API activity in the account to the specified Amazon S3 bucket.
DeleteTrailDeletes a CloudTrail trail, permanently stopping the delivery of log files for that trail to its configured S3 bucket.
DescribeTrailsReturns metadata about one or more CloudTrail trails in the current region, including their ARNs, S3 destinations, and configuration settings.
LookupEventsSearches CloudTrail management event records in the current region for events matching specified attribute filters such as event name, resource type, or username.
StopLoggingSuspends CloudTrail logging for a trail, halting the delivery of new log files while preserving the trail configuration.
UpdateTrailUpdates the settings of an existing CloudTrail trail, such as its S3 bucket, SNS topic, or log file validation configuration.
PutEventSelectorsConfigures event selectors for a trail to specify which management and data events CloudTrail logs.

_catch_all: AWS-cloudtrail (catch-all)

#
Service
AWS-cloudtrail

Description

Catch-all entry for AWS-cloudtrail rules that match the service but not a specific eventName.

Fields #

NameDescription
eventNameThe name of the API action that was called.
eventSourceThe AWS service endpoint that received the request (e.g. iam.amazonaws.com).
eventTypeCloudTrail event category: AwsApiCall, AwsConsoleSignIn, AwsConsoleAction, AwsServiceEvent, or AwsVpceEvents.
userIdentityThe IAM entity that made the request (type, principalId, arn, accountId, sessionContext).
sourceIPAddressIP address of the caller, or the AWS service principal for service-initiated calls.
awsRegionAWS Region the request was made to.
requestParametersParameters sent with the request. Shape is action-specific; null when none.
responseElementsResponse elements. Shape is action-specific; null for reads or when absent.
errorCodeAWS service error code when the request failed. Absent on success.
errorMessageDescription of the error when errorCode is present.

CreateTrail

#
Service
AWS-cloudtrail

Description

Creates a CloudTrail trail that delivers log files recording API activity in the account to the specified Amazon S3 bucket.

Fields #

NameDescription
eventNameThe name of the API action that was called.
eventSourceThe AWS service endpoint that received the request (e.g. iam.amazonaws.com).
eventTypeCloudTrail event category: AwsApiCall, AwsConsoleSignIn, AwsConsoleAction, AwsServiceEvent, or AwsVpceEvents.
userIdentityThe IAM entity that made the request (type, principalId, arn, accountId, sessionContext).
sourceIPAddressIP address of the caller, or the AWS service principal for service-initiated calls.
awsRegionAWS Region the request was made to.
requestParametersParameters sent with the request. Shape is action-specific; null when none.
responseElementsResponse elements. Shape is action-specific; null for reads or when absent.
errorCodeAWS service error code when the request failed. Absent on success.
errorMessageDescription of the error when errorCode is present.

Common Indicators #

Field/value combinations most frequently checked by detection rules targeting this event, derived from cross-vendor predicate analysis.

FieldKindValueRulesVendors
Provider_Nameeqcloudtrail.amazonaws.com1 ruleelastic

Detection Rules #

View all rules referencing this event →

Elastic #

  • AWS CloudTrail Log Created source low: Detects creation of a new AWS CloudTrail trail via CreateTrail API. While legitimate during onboarding or auditing improvements, adversaries can create trails that write to attacker-controlled destinations, limit regions, or otherwise subvert monitoring objectives. New trails should be validated for destination ownership, encryption, multi-region coverage, and organizational scope.

DeleteTrail

#
Service
AWS-cloudtrail

Description

Deletes a CloudTrail trail, permanently stopping the delivery of log files for that trail to its configured S3 bucket.

Fields #

NameDescription
eventNameThe name of the API action that was called.
eventSourceThe AWS service endpoint that received the request (e.g. iam.amazonaws.com).
eventTypeCloudTrail event category: AwsApiCall, AwsConsoleSignIn, AwsConsoleAction, AwsServiceEvent, or AwsVpceEvents.
userIdentityThe IAM entity that made the request (type, principalId, arn, accountId, sessionContext).
sourceIPAddressIP address of the caller, or the AWS service principal for service-initiated calls.
awsRegionAWS Region the request was made to.
requestParametersParameters sent with the request. Shape is action-specific; null when none.
responseElementsResponse elements. Shape is action-specific; null for reads or when absent.
errorCodeAWS service error code when the request failed. Absent on success.
errorMessageDescription of the error when errorCode is present.

Common Indicators #

Field/value combinations most frequently checked by detection rules targeting this event, derived from cross-vendor predicate analysis.

FieldKindValueRulesVendors
aws::eventNameeqDeleteTrail4 rulessigma, splunk
aws::eventNameeqStopLogging1 rulesigma, splunk
aws::eventNameeqUpdateTrail1 rulekusto, sigma, splunk
aws::eventSourceeqcloudtrail.amazonaws.com4 rulessigma, splunk
Provider_Nameeqcloudtrail.amazonaws.com1 ruleelastic
aws::errorCodeeqAccessDenied1 ruleelastic, panther, sigma, splunk
aws::errorCodeeqsuccess1 rulesplunk
userAgentneconsole.amazonaws.com1 rulesplunk

Detection Rules #

View all rules referencing this event →

Sigma #

Elastic #

  • AWS CloudTrail Log Deleted source medium: Detects deletion of an AWS CloudTrail trail via DeleteTrail API. Removing trails is a high-risk action that destroys an audit control plane and is frequently paired with other destructive or stealthy operations. Validate immediately and restore compliant logging.

Splunk #

  • AWS Defense Evasion Delete Cloudtrail source: The following analytic detects the deletion of AWS CloudTrail logs by identifying DeleteTrail events within CloudTrail logs. This detection leverages CloudTrail data to monitor for successful DeleteTrail actions, excluding those…

YARA-L #

DescribeTrails

#
Service
AWS-cloudtrail

Description

Returns metadata about one or more CloudTrail trails in the current region, including their ARNs, S3 destinations, and configuration settings.

Fields #

NameDescription
eventNameThe name of the API action that was called.
eventSourceThe AWS service endpoint that received the request (e.g. iam.amazonaws.com).
eventTypeCloudTrail event category: AwsApiCall, AwsConsoleSignIn, AwsConsoleAction, AwsServiceEvent, or AwsVpceEvents.
userIdentityThe IAM entity that made the request (type, principalId, arn, accountId, sessionContext).
sourceIPAddressIP address of the caller, or the AWS service principal for service-initiated calls.
awsRegionAWS Region the request was made to.
requestParametersParameters sent with the request. Shape is action-specific; null when none.
responseElementsResponse elements. Shape is action-specific; null for reads or when absent.
errorCodeAWS service error code when the request failed. Absent on success.
errorMessageDescription of the error when errorCode is present.

LookupEvents

#
Service
AWS-cloudtrail

Description

Searches CloudTrail management event records in the current region for events matching specified attribute filters such as event name, resource type, or username.

Fields #

NameDescription
eventNameThe name of the API action that was called.
eventSourceThe AWS service endpoint that received the request (e.g. iam.amazonaws.com).
eventTypeCloudTrail event category: AwsApiCall, AwsConsoleSignIn, AwsConsoleAction, AwsServiceEvent, or AwsVpceEvents.
userIdentityThe IAM entity that made the request (type, principalId, arn, accountId, sessionContext).
sourceIPAddressIP address of the caller, or the AWS service principal for service-initiated calls.
awsRegionAWS Region the request was made to.
requestParametersParameters sent with the request. Shape is action-specific; null when none.
responseElementsResponse elements. Shape is action-specific; null for reads or when absent.
errorCodeAWS service error code when the request failed. Absent on success.
errorMessageDescription of the error when errorCode is present.

StopLogging

#
Service
AWS-cloudtrail

Description

Suspends CloudTrail logging for a trail, halting the delivery of new log files while preserving the trail configuration.

Fields #

NameDescription
eventNameThe name of the API action that was called.
eventSourceThe AWS service endpoint that received the request (e.g. iam.amazonaws.com).
eventTypeCloudTrail event category: AwsApiCall, AwsConsoleSignIn, AwsConsoleAction, AwsServiceEvent, or AwsVpceEvents.
userIdentityThe IAM entity that made the request (type, principalId, arn, accountId, sessionContext).
sourceIPAddressIP address of the caller, or the AWS service principal for service-initiated calls.
awsRegionAWS Region the request was made to.
requestParametersParameters sent with the request. Shape is action-specific; null when none.
responseElementsResponse elements. Shape is action-specific; null for reads or when absent.
errorCodeAWS service error code when the request failed. Absent on success.
errorMessageDescription of the error when errorCode is present.

Common Indicators #

Field/value combinations most frequently checked by detection rules targeting this event, derived from cross-vendor predicate analysis.

FieldKindValueRulesVendors
aws::eventNameeqStopLogging4 rulessigma, splunk
aws::eventNameeqDeleteTrail1 rulesigma, splunk
aws::eventNameeqUpdateTrail1 rulekusto, sigma, splunk
aws::eventSourceeqcloudtrail.amazonaws.com4 rulessigma, splunk
Provider_Nameeqcloudtrail.amazonaws.com1 ruleelastic
aws::errorCodeeqAccessDenied1 ruleelastic, panther, sigma, splunk
aws::errorCodeeqsuccess1 rulesplunk
userAgentneconsole.amazonaws.com1 rulesplunk

Detection Rules #

View all rules referencing this event →

Sigma #

Elastic #

  • AWS CloudTrail Log Suspended source medium: Detects Cloudtrail logging suspension via StopLogging API. Stopping CloudTrail eliminates forward audit visibility and is a classic defense evasion step before sensitive changes or data theft. Investigate immediately and determine what occurred during the logging gap.

Splunk #

  • AWS Defense Evasion Stop Logging Cloudtrail source: The following analytic detects StopLogging events in AWS CloudTrail logs. It leverages CloudTrail event data to identify when logging is intentionally stopped, excluding console-based actions and focusing on successful attempts. This…

YARA-L #

UpdateTrail

#
Service
AWS-cloudtrail

Description

Updates the settings of an existing CloudTrail trail, such as its S3 bucket, SNS topic, or log file validation configuration.

Fields #

NameDescription
eventNameThe name of the API action that was called.
eventSourceThe AWS service endpoint that received the request (e.g. iam.amazonaws.com).
eventTypeCloudTrail event category: AwsApiCall, AwsConsoleSignIn, AwsConsoleAction, AwsServiceEvent, or AwsVpceEvents.
userIdentityThe IAM entity that made the request (type, principalId, arn, accountId, sessionContext).
sourceIPAddressIP address of the caller, or the AWS service principal for service-initiated calls.
awsRegionAWS Region the request was made to.
requestParametersParameters sent with the request. Shape is action-specific; null when none.
responseElementsResponse elements. Shape is action-specific; null for reads or when absent.
errorCodeAWS service error code when the request failed. Absent on success.
errorMessageDescription of the error when errorCode is present.

Common Indicators #

Field/value combinations most frequently checked by detection rules targeting this event, derived from cross-vendor predicate analysis.

FieldKindValueRulesVendors
aws::eventNameeqUpdateTrail4 ruleskusto, sigma, splunk
aws::eventNameeqDeleteTrail1 rulesigma, splunk
aws::eventNameeqStopLogging1 rulesigma, splunk
aws::eventSourceeqcloudtrail.amazonaws.com4 rulessigma, splunk
Provider_Nameeqcloudtrail.amazonaws.com1 ruleelastic
aws::errorCodeeqAccessDenied1 ruleelastic, panther, sigma, splunk
aws::errorCodeeqsuccess1 rulesplunk
userAgentneconsole.amazonaws.com1 rulesplunk

Detection Rules #

View all rules referencing this event →

Sigma #

  • Attempt To Modify CloudTrail Log Settings source medium: An attacker may have attempted to modify CloudTrail log settings for anti-forensics but it was denied due to a lack of permissions. An attacker can use the update-trail command to disable multi-region logging, so their attacks do not get logged to the other regions. Ex: aws cloudtrail update-trail --name [my-trail] --no-is-multi-region-trail --no-include-global-service-events The attacker may also modify the settings so that the logs get encrypted with a key the attacker only has to prevent reading of the logs. The attacker may also redirect the logs to a S3 bucket they control.
  • CloudTrail Log Settings Modified source high: An attacker may have attempted to modify CloudTrail log settings for anti-forensics but it was denied due to a lack of permissions. An attacker can use the update-trail command to disable multi-region logging, so their attacks do not get logged to the other regions. Ex: aws cloudtrail update-trail --name [my-trail] --no-is-multi-region-trail --no-include-global-service-events The attacker may also modify the settings so that the logs get encrypted with a key the attacker only has to prevent reading of the logs. The attacker may also redirect the logs to a S3 bucket they control.
  • AWS CloudTrail Important Change source medium: Detects disabling, deleting and updating of a Trail↳ also matches DeleteTrail, StopLogging

Elastic #

  • AWS CloudTrail Log Updated source low: Detects updates to an existing CloudTrail trail via UpdateTrail API which may reduce visibility, change destinations, or weaken integrity (e.g., removing global events, moving the S3 destination, or disabling validation). Adversaries can modify trails to evade detection while maintaining a semblance of logging. Validate any configuration change against approved baselines.

Splunk #

  • AWS Defense Evasion Update Cloudtrail source: The following analytic detects UpdateTrail events in AWS CloudTrail logs. It identifies attempts to modify CloudTrail settings, potentially to evade logging. The detection leverages CloudTrail logs, focusing on UpdateTrail events where…

YARA-L #

PutEventSelectors

#
Service
AWS-cloudtrail

Description

Configures event selectors for a trail to specify which management and data events CloudTrail logs.

Fields #

NameDescription
eventNameThe name of the API action that was called.
eventSourceThe AWS service endpoint that received the request (e.g. iam.amazonaws.com).
eventTypeCloudTrail event category: AwsApiCall, AwsConsoleSignIn, AwsConsoleAction, AwsServiceEvent, or AwsVpceEvents.
userIdentityThe IAM entity that made the request (type, principalId, arn, accountId, sessionContext).
sourceIPAddressIP address of the caller, or the AWS service principal for service-initiated calls.
awsRegionAWS Region the request was made to.
requestParametersParameters sent with the request. Shape is action-specific; null when none.
responseElementsResponse elements. Shape is action-specific; null for reads or when absent.
errorCodeAWS service error code when the request failed. Absent on success.
errorMessageDescription of the error when errorCode is present.

Detection Rules #

View all rules referencing this event →

YARA-L #