---
title: AWS CloudTrail
description: ''
slug: /help/docs/integrations/automation-integrations/aws-cloudtrail/
canonical: https://www.sumologic.com/help/docs/integrations/automation-integrations/aws-cloudtrail/
---
import useBaseUrl from '@docusaurus/useBaseUrl';

<img src=/help/img/platform-services/automation-service/app-central/logos/aws.png alt="aws" width="50"/>

***Version: 1.3  
Updated: August 19, 2025***

Interact with AWS CloudTrail through Trails and Events.

## Actions

* **Describe Trails** (*Enrichment*) - Retrieves settings for the trail associated with the current region for an AWS account.
* **Lookup Events** (*Enrichment*) - Looks up management events captured by CloudTrail.
* **Create Trail** (*Enrichment*) - Creates a trail that specifies the settings for delivery of log data to an Amazon S3 bucket.
* **Delete Trail** (*Containment*) - Deletes a trail.
* **Start Logging** (*Enrichment*) - Starts the recording of AWS API calls and log file delivery for a trail.
* **Stop Logging** (*Enrichment*) - Suspends the recording of AWS API calls and log file delivery for the specified trail.
* **Update Trail** (*Enrichment*) - Updates the settings that specify delivery of log files.
* **List Trail** (*Enrichment*) - Lists trails that are in the current account.

## External Libraries

* [AWS CloudTrail](https://github.com/boto/boto3/blob/develop/LICENSE)

## Configure AWS CloudTrail in Automation Service and Cloud SOAR

import IntegrationsAuth from '../../reuse/integrations-authentication.md';
import IntegrationsAuthAWS from '../../reuse/integrations-authentication-aws.md';
import AWSRegions from '../../reuse/automation-service/aws/region.md';
import AWSAccesskey from '../../reuse/automation-service/aws/access-key.md';
import AWSSecret from '../../reuse/automation-service/aws/secret.md';
import AWSIAMRole from '../../reuse/automation-service/aws/iam-role.md';
import IntegrationCertificate from '../../reuse/automation-service/integration-certificate.md';
import IntegrationEngine from '../../reuse/automation-service/integration-engine.md';
import IntegrationLabel from '../../reuse/automation-service/integration-label.md';
import IntegrationProxy from '../../reuse/automation-service/integration-proxy.md';
import IntegrationTimeout from '../../reuse/automation-service/integration-timeout.md';
import IAMConfiguration from '../../reuse/automation-service/aws/iam-configuration.md';

<IntegrationsAuth/>

* <IntegrationLabel/>
* <AWSAccesskey/>
* <AWSSecret/>
* <AWSIAMRole/>
* <AWSRegions/>
* <IntegrationTimeout/>
* <IntegrationCertificate/>
* <IntegrationEngine/>
* <IntegrationProxy/>

<img src=/help/img/platform-services/automation-service/app-central/integrations/aws/aws-cloudtrail-configuration.png style={{border:'1px solid gray'}} alt="AWS CloudTrail configuration" width="400"/>

For information about AWS CloudTrail, see [CloudTrail documentation](https://docs.aws.amazon.com/cloudtrail/).

<IntegrationsAuthAWS/>

### AWS IAM role-based access

<IAMConfiguration/>

## Limitations

Local [Automation Bridge](/docs/platform-services/automation-service/automation-service-bridge/) is not supported in this version.

## Required Permissions
```
  cloudtrail:DescribeTrails
  cloudtrail:LookupEvents
  cloudtrail:CreateTrail
  cloudtrail:DeleteTrail
  cloudtrail:StartLogging
  cloudtrail:StopLogging
  cloudtrail:UpdateTrail
```

## Change Log

| Version | Date | Description |
|:--|:--|:--|
| v1.3 | August 19, 2025 | Added support for IAM role authentication. Users can now authenticate using an AWS IAM Role in addition to access key–based authentication. |
| v1.2 | June 15, 2023 | Updated the integration with Environmental Variables. |
| v1.1 | May 12, 2023 | Refactored the integration. |
| | March 10, 2022 | Updated the logo in AWS CloudTrail integration. |
| | October 1, 2019 | Initial release of the AWS CloudTrail integration. |

## Additional resources

For AWS CloudTrail, Sumo Logic offers the [AWS CloudTrail app](/docs/integrations/cloud-security-monitoring-analytics/aws-cloudtrail/) to visualize your AWS CloudTrail data.