This article contains links to all the ways you can connect your new or existing AWS CloudTrail to the Expel Workbench.
This article was accurate at the time of writing, but changes happen. If you find the instructions are outdated, leave a description in the comment field below and let us know!
You can onboard new CloudTrails in one of two ways:
If you want Expel to create new CloudTrails on your behalf, use our AWS Onboarding Wizard in Workbench.
Creating duplicate CloudTrails can result in additional AWS costs. Do not use the wizard if you want to connect an existing CloudTrail.
Our wizard supports creating new CloudTrails using:
CloudFormation Templates: You can use AWS CloudFormation templates to perform the necessary configuration for an individual account or organization. If you’re onboarding an AWS organization, it creates a CloudFormation StackSet to configure the permissions on each account within the organization. It can even automatically run on accounts you create in the future under the organization. Don’t worry, we won’t run anything in your AWS account. We instead populate CloudFormation with the right steps; you review it and decide to execute.
Terraform: We present an open source, fully transparent Terraform module which creates necessary AWS resources used to securely transfer CloudTrail logs to Workbench. All of the resources that we allocate are listed here: https://registry.terraform.io/modules/expel-io/cloudtrail/aws/latest?tab=resources. By default, all methods of communication between these resources and AWS and Workbench are secured by encryption. All means of data storage (S3) follow AWS best practices—access logging enabled, bucket versioning enabled, zero public access.
If you want to manually create and connect a new CloudTrail, use these instructions: AWS CloudTrail - New CloudTrail setup for Expel.
To onboard an existing CloudTrail, the instructions vary depending upon your use of AWS Control Tower:
If your installation uses Control Tower, follow these instructions: AWS CloudTrail - Existing CloudTrail with Control Tower setup for Workbench.
If your installation does NOT use Control Tower, you can either:
Select the Terraform method in our AWS onboarding wizard or
Follow these manual instructions: AWS CloudTrail - Existing CloudTrail setup for Workbench.
Our Product team is currently developing a procedure for onboarding an existing CloudTrail using the AWS wizard. We will update this article when the procedure is ready.