Product logo
DocsBlogPricing

@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:

PermissionGrant LevelHelp
cloudtrail:AddTagsOperator
cloudtrail:CreateTrailAdmin
cloudtrail:DeleteTrailAdmin
cloudtrail:DescribeTrailsMetadata
cloudtrail:GetEventSelectorsMetadata
cloudtrail:GetInsightSelectorsMetadata
cloudtrail:GetTrailMetadata
cloudtrail:GetTrailStatusMetadata
cloudtrail:ListPublicKeysMetadata
cloudtrail:ListTagsMetadata
cloudtrail:ListTrailsMetadata
cloudtrail:LookupEventsMetadataCloudTrail events do not contain any data just information about the API call.
cloudtrail:PutEventSelectorsAdmin
cloudtrail:PutInsightSelectorsAdmin
cloudtrail:RemoveTagsOperator
cloudtrail:StartLoggingOperator
cloudtrail:StopLoggingOperator
cloudtrail:UpdateTrailAdmin
kms:ListAliasesMetadataFor console access per http://docs.aws.amazon.com/awscloudtrail/latest/userguide/grant-custom-permissions-for-cloudtrail-users.html
s3:GetBucketLocationMetadataFor console access per http://docs.aws.amazon.com/awscloudtrail/latest/userguide/grant-custom-permissions-for-cloudtrail-users.html
s3:ListAllMyBucketsMetadataFor console access per http://docs.aws.amazon.com/awscloudtrail/latest/userguide/grant-custom-permissions-for-cloudtrail-users.html

Learn More About Guardrails

Version
5.10.0
Released On
Aug 31, 2023
Depends On

Resource Types

Control Types

Policy Types

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 the AWS > CloudTrail > Trail > Encryption at Rest policy was set to Enforce: 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 an Invalid state if the AWS > CloudTrail > Trail > Encryption at Rest policy was set to Check: 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 to OK 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 the AWS > CloudTrail > Trail > Encryption at Rest policy was set to Check: 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 and LatestNotificationAttemptTime have now been made dynamic to avoid unnecessary notifications in the activity tab.

5.5.1 (2020-12-17)

Bug fixes

  • Controls run faster now when in the tbd and skipped 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 in tbd and skipped, 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 the AWS > CloudTrail > Trail > Approved policy to Enforce: Stop unapproved or Enforce: 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 and LatestCloudWatchLogsDeliveryTime 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] to Regions 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.