Skip to content

Commit

Permalink
updating how-it-works features security services cloudtrail section
Browse files Browse the repository at this point in the history
  • Loading branch information
exequielrafaela committed Jul 9, 2022
1 parent bb90be9 commit 970c259
Showing 1 changed file with 36 additions and 27 deletions.
63 changes: 36 additions & 27 deletions docs/how-it-works/features/security/audit-cloudtrail.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,41 @@
# Audit | CloudTrail

AWS CloudTrail monitors and records account activity across your AWS infrastructure, giving you control over storage, analysis, and remediation actions.
## Feature Overview

AWS CloudTrail monitors and records account activity across your AWS infrastructure,
giving you control over storage, analysis, and remediation actions.

![Cloudtrail Diagram](../../../assets/images/diagrams/aws-cloudtrail.svg)

!!! note ":bookmark_tabs: [Leverage Reference Architecture | Security Audit](https://github.com/binbashar/le-tf-infra-aws/tree/master/apps-prd/us-east-1/security-audit)"

**CloudTrail module**. Key elements:

* Destination bucket
* KMS Key to files encrypt files
* Include global services
* Enable multi-regional trail


**S3 Bucket Module**. Key elements:
!!! info "AWS CloudTrail overview"
This service will be configured to enable auditing of all AWS services in all accounts.
Once enabled, as show in the below presented figure CloudTrail will deliver all events
from all accounts to the Security account in order to have a centralized way to audit
operations on AWS resources.
Audit events will be available from CloudTrail for 90 days but a longer retention
time will be available through a centralized S3 bucket.

* Lifecycle rule
* Expiration

**KMS Key Module**. Key elements:

* Deletion Window
* Policy
*Grant permission to the rest of the accounts to use the key*

# Read More

* :cloud: [AWS Cloudtrail Overview](https://aws.amazon.com/cloudtrail/)
* :notebook: [Security Pillar - AWS Well-Architected Framework](https://docs.aws.amazon.com/wellarchitected/latest/security-pillar/welcome.html)
![Cloudtrail Diagram](../../../assets/images/diagrams/aws-cloudtrail.svg)
<figcaption style="font-size:15px">
<b>Figure:</b> AWS CloudTrail components architecture diagram (just as reference).
(Source: Binbash Leverage diagrams, accessed July 6th 2022).
</figcaption>

!!! example "![leverage-tf](../../../assets/images/logos/terraform.png "Terraform"){: style="width:25px"} IaC Terraform Codebase <>"
- [x] `binbash-management` account | Audit: Cloudtrail
- **Code:** [management/us-east-1/security-audit](https://github.com/binbashar/le-tf-infra-aws/tree/master/management/us-east-1/security-audit)
- [x] `binbash-security` account | Audit: Cloudtrail & S3 Bucket
- **Code:** [security/us-east-1/security-audit](https://github.com/binbashar/le-tf-infra-aws/tree/master/security/us-east-1/security-audit)
- [x] `binbash-shared` account | Audit: Cloudtrail
- **Code:** [shared/us-east-1/security-audit](https://github.com/binbashar/le-tf-infra-aws/tree/master/shared/us-east-1/security-audit)
- [x] `binbash-apps-devstg` account | Audit: Cloudtrail
- **Code:** [apps-devstg/us-east-1/security-audit](https://github.com/binbashar/le-tf-infra-aws/tree/master/apps-devstg/us-east-1/security-audit)
- [x] `binbash-apps-prd` account | Audit: Cloudtrail
- **Code:** [apps-prd/us-east-1/security-audit](https://github.com/binbashar/le-tf-infra-aws/tree/master/apps-prd/us-east-1/security-audit)
- [x] `binbash-network` account | Audit: Cloudtrail
- **Code:** [network/us-east-1/security-audit](https://github.com/binbashar/le-tf-infra-aws/tree/master/network/us-east-1/security-audit)

## Read more

!!! info "AWS reference links"
Consider the following AWS official links as reference:

* :orange_book: [AWS Cloudtrail Overview](https://aws.amazon.com/cloudtrail/)

0 comments on commit 970c259

Please sign in to comment.