@turbot/aws-cloudtrail
The aws-cloudtrail mod contains resource, control and policy definitions for AWS CloudTrail service.
Resource Types
Resource types covered by this mod:
Permissions
Taking a look at permissions and associated grant levels for each permission for CloudTrail:
Permission | Grant Level | Help |
---|---|---|
cloudtrail:AddTags | Operator | |
cloudtrail:CreateTrail | Admin | |
cloudtrail:DeleteTrail | Admin | |
cloudtrail:DescribeTrails | Metadata | |
cloudtrail:GetEventSelectors | Metadata | |
cloudtrail:GetInsightSelectors | Metadata | |
cloudtrail:GetTrail | Metadata | |
cloudtrail:GetTrailStatus | Metadata | |
cloudtrail:ListPublicKeys | Metadata | |
cloudtrail:ListTags | Metadata | |
cloudtrail:ListTrails | Metadata | |
cloudtrail:LookupEvents | Metadata | CloudTrail events do not contain any data just information about the API call. |
cloudtrail:PutEventSelectors | Admin | |
cloudtrail:PutInsightSelectors | Admin | |
cloudtrail:RemoveTags | Operator | |
cloudtrail:StartLogging | Operator | |
cloudtrail:StopLogging | Operator | |
cloudtrail:UpdateTrail | Admin | |
kms:ListAliases | Metadata | For console access per http://docs.aws.amazon.com/awscloudtrail/latest/userguide/grant-custom-permissions-for-cloudtrail-users.html |
s3:GetBucketLocation | Metadata | For console access per http://docs.aws.amazon.com/awscloudtrail/latest/userguide/grant-custom-permissions-for-cloudtrail-users.html |
s3:ListAllMyBuckets | Metadata | For console access per http://docs.aws.amazon.com/awscloudtrail/latest/userguide/grant-custom-permissions-for-cloudtrail-users.html |
Learn More About Guardrails
- Setting Policies Tutorial
- Mods Overview
- Policies Overview
- Resources Overview
- Common Policies and Controls
Recommended Version
Version
5.10.0
Released On
Aug 31, 2023
Depends On
Resource Types
Control Types
- AWS > CloudTrail > Shadow Trail > CMDB
- AWS > CloudTrail > Shadow Trail > Discovery
- AWS > CloudTrail > Trail > Active
- AWS > CloudTrail > Trail > Approved
- AWS > CloudTrail > Trail > CMDB
- AWS > CloudTrail > Trail > Configured
- AWS > CloudTrail > Trail > Discovery
- AWS > CloudTrail > Trail > Encryption at Rest
- AWS > CloudTrail > Trail > Log File Validation
- AWS > CloudTrail > Trail > Tags
- AWS > CloudTrail > Trail > Trail Status
- AWS > CloudTrail > Trail > Usage
Policy Types
- AWS > CloudTrail > API Enabled
- AWS > CloudTrail > Approved Regions [Default]
- AWS > CloudTrail > Enabled
- AWS > CloudTrail > Permissions
- AWS > CloudTrail > Permissions > Levels
- AWS > CloudTrail > Permissions > Levels > Modifiers
- AWS > CloudTrail > Permissions > Lockdown
- AWS > CloudTrail > Permissions > Lockdown > API Boundary
- AWS > CloudTrail > Regions
- AWS > CloudTrail > Shadow Trail > CMDB
- AWS > CloudTrail > Shadow Trail > Regions
- AWS > CloudTrail > Tags Template [Default]
- AWS > CloudTrail > Trail > Active
- AWS > CloudTrail > Trail > Active > Age
- AWS > CloudTrail > Trail > Active > Budget
- AWS > CloudTrail > Trail > Active > Last Modified
- AWS > CloudTrail > Trail > Approved
- AWS > CloudTrail > Trail > Approved > Budget
- AWS > CloudTrail > Trail > Approved > Custom
- AWS > CloudTrail > Trail > Approved > Regions
- AWS > CloudTrail > Trail > Approved > Usage
- AWS > CloudTrail > Trail > CMDB
- AWS > CloudTrail > Trail > Configured
- AWS > CloudTrail > Trail > Configured > Claim Precedence
- AWS > CloudTrail > Trail > Configured > Source
- AWS > CloudTrail > Trail > Encryption at Rest
- AWS > CloudTrail > Trail > Encryption at Rest > Customer Managed Key
- AWS > CloudTrail > Trail > Log File Validation
- AWS > CloudTrail > Trail > Regions
- AWS > CloudTrail > Trail > Tags
- AWS > CloudTrail > Trail > Tags > Template
- AWS > CloudTrail > Trail > Trail Status
- AWS > CloudTrail > Trail > Usage
- AWS > CloudTrail > Trail > Usage > Limit
- AWS > Turbot > Event Handlers > Events > Rules > Custom Event Patterns > CloudTrail
- AWS > Turbot > Permissions > Compiled > API Boundary > @turbot/aws-cloudtrail
- AWS > Turbot > Permissions > Compiled > Levels > @turbot/aws-cloudtrail
- AWS > Turbot > Permissions > Compiled > Service Permissions > @turbot/aws-cloudtrail
Release Notes
5.10.0 (2023-08-31)
What's new?
- Rebranded to a Turbot Guardrails Mod. To maintain compatibility, none of the existing resource types, control types or policy types have changed, your existing configurations and settings will continue to work as before.
Bug fixes
- We've updated the runtime of the lambda functions to Node 18. You wouldn't notice any difference and things will continue to work smoothly and consistently as before.
5.9.0 (2023-05-31)
What's new?
- Resource's metadata will now also include
createdBy
details in Guardrails CMDB. - README.md file is now available for users to check details about the resource types and service permissions that the mod covers.
5.8.3 (2023-01-18)
Bug fixes
- The
AWS > CloudTrail > Trail > Encryption at Rest
control would sometimes go into an error state for unencrypted trails if theAWS > CloudTrail > Trail > Encryption at Rest
policy was set toEnforce: Encryption at Rest > Customer Managed Key
. This is fixed and the control will now work correctly as expected.
5.8.2 (2023-01-18)
Bug fixes
- The
AWS > CloudTrail > Trail > Encryption at Rest
control would go into anInvalid
state if theAWS > CloudTrail > Trail > Encryption at Rest
policy was set toCheck: Customer managed key
and the CMK used to encrypt the trail was a cross-account key and was not available in Guardrails CMDB. This is fixed and the control will now move toOK
state instead for such cases.
5.8.1 (2022-08-04)
Bug fixes
- The
AWS > CloudTrail > Trail > Encryption at Rest
control would sometimes move to an error state incorrectly when theAWS > CloudTrail > Trail > Encryption at Rest
policy was set toCheck: Customer managed key
and the KMS Key used to encrypt the trail was not present in Guardrails CMDB. This is fixed and the control will now move to an Invalid state instead for such cases.
5.8.0 (2022-06-17)
Resource Types
Added
- AWS > CloudTrail > Shadow Trail
Control Types
Added
- AWS > CloudTrail > Shadow Trail > CMDB
- AWS > CloudTrail > Shadow Trail > Discovery
Policy Types
Added
- AWS > CloudTrail > Shadow Trail > CMDB
- AWS > CloudTrail > Shadow Trail > Regions
5.7.1 (2022-03-31)
Bug fixes
- The
LatestDeliveryTime
attribute will now store the actual timestamp of the latest delivery time instead of<dynamic>
in a trail's CMDB data.
5.7.0 (2022-02-16)
What's new?
- Users can now create their own custom checks against resource attributes in the Approved control using the
Approved > Custom
policy. These custom checks would be a part of the evaluation of the Approved control. Custom messages can also be added which are then displayed in the control details table. See Custom Checks for more information.
Bug fixes
- We've improved the process of deleting resources from Guardrails if their CMDB policy was set to
Enforce: Disabled
. The CMDB controls will now not look to resolve credentials via Guardrails IAM role while deleting resources from Guardrails. This will allow the CMDB controls to process resource deletions from Guardrails more reliably than before.
Policy Types
Added
- AWS > CloudTrail > Trail > Approved > Custom
5.6.1 (2022-01-27)
Bug fixes
- We've made a few improvements in the GraphQL query for
AWS > CloudTrail > Trail > Encryption At Rest
control. You won't notice any difference, but things should run lighter and quicker than before.
5.6.0 (2022-01-07)
What's new?
AWS/CloudTrail/Admin
AWS/CloudTrail/Metadata
now include permissions for Insight Selectors.
5.5.2 (2020-12-28)
Bug fixes
- Certain trail properties like
LatestNotificationTime
andLatestNotificationAttemptTime
have now been madedynamic
to avoid unnecessary notifications in the activity tab.
5.5.1 (2020-12-17)
Bug fixes
- Controls run faster now when in the
tbd
andskipped
states thanks to the new Turbot Precheck feature (not to be confused with TSA PreCheck). With Turbot Precheck, controls avoid running GraphQL input queries when intbd
andskipped
, resulting in faster and lighter control runs.
5.5.0 (2020-11-05)
What's new?
- The
AWS > CloudTrail > Trail > Approved
control can now be used to stop unapproved trails, suspending the recording of AWS API calls and log file delivery. To use this new feature, you can set theAWS > CloudTrail > Trail > Approved
policy toEnforce: Stop unapproved
orEnforce: Stop unapproved if new
.
Action Types
Added
- AWS > CloudTrail > Trail > Stop
5.4.2 (2020-10-08)
Bug fixes
- We’ve fixed an issue for trails where the
CloudWatchLogsRoleArn
,CloudWatchLogsLogGroupArn
andLatestCloudWatchLogsDeliveryTime
properties were not updating correctly after a trail’s CloudWatch logs configuration was modified.
5.4.1 (2020-09-21)
Bug fixes
- We've made some improvements to our real-time event handling that reduces the risk of creating resources in CMDB with malformed AKAs. There's no noticeable difference, but things should run more reliably now.
5.4.0 (2020-09-01)
What's new?
- Discovery controls now have their own control category,
CMDB > Discovery
, to allow for easier filtering separately from other CMDB controls. - We've renamed the service's default regions policy from
Regions [Default]
toRegions
to be consistent with our other regions policies.
5.3.4 (2020-08-11)
Bug fixes
- In various Active controls, we were outputting log messages that did not properly show how many days were left until we'd delete the inactive resources (we were still deleting them after the correct number of days). These log messages have been fixed and now contain the correct number of days.
5.3.3 (2020-07-03)
Bug fixes
- Sometimes when updating CMDB for resources with tags that have empty string values, e.g.,
[{Key: "Empty", Value: ""}, {Key: "Turbot is great", Value: "true"}]
, we would not store all of the tags correctly. This has been fixed and now all tags are accounted for.
5.3.2 (2020-05-26)
Policy Types
Renamed
- AWS > CloudTrail > Trail > Configured > Precedence to AWS > CloudTrail > Trail > Configured > Claim Precedence
5.3.1 (2020-05-15)
Bug fixes
- Links to documentation in the descriptions for several controls and policies were broken. These links have now been fixed.