This guide tells you how to configure AWS (CloudTrail) collection protocol which collects events from Amazon Web Services (AWS) CloudTrail.
How AWS Collection Works
The Log Collector service collects events from Amazon Web Services (AWS) CloudTrail. CloudTrail records AWS API calls for an account. The events contain the identity of the API caller, the time of the API call, the source IP address of the API caller, the request parameters, and the response elements returned by the AWS service. The AWS API call history provided by CloudTrail events enables security analysis, resource change tracking, and compliance auditing. CloudTrail uses Amazon S3 for log file storage and delivery. Security Analytics copies the log files from the cloud (S3 bucket), and sends the events contained in the files to the Log Collector.
Deployment Scenario
The following figure illustrates how you deploy the AWS (CloudTrail) Collection Protocol in Security Analytics.
Procedures
Configure AWS (CloudTrail) Collection Protocol in Security Analytics
You configure the Log Collector to use AWS (CloudTrail) collection for an event source in the event Source tab of the Log Collector parameter view. The following figure the basic workflow for configuring an event source for AWS (CloudTrail) Collection in Security Analytics. Please refer to:
- Step 1. Configure AWS (CloudTrail) Event Sources in Security Analytics for step-by-step instructions on how to configure events sources in Security Analytics that use the AWS Collection protocol.
- References - AWS (CloudTrail) Collection Configuration Parameters for a detailed description of each AWS (CloudTrail) Collection Protocol parameter.
In the Security Analytics menu, select Administration > Services.
Select a Log Collection service.
Click
under Actions and select View > Config to display the Log Collection configuration parameter tabs.
Select Plugins as the collection protocol and select Config.
Click
and select cloudtrail as the event source category.
The event source category is part of the content you downloaded from LIVE.
Select the AWS (CloudTrail) category and click
.
Specify the basic parameters required for the AWS (CloudTrail) event source.
Click
and specify additional parameters that enhance how the AWS (CloudTrail) protocol handles event collection for the event source.
Configure Event Sources to Use AWS (CloudTrail) Collection Protocol
You need to configure each event source that uses the AWS (CloudTrail) Collection protocol to communicate with Security Analytics (see Step 2. Configure AWS (CloudTrail) Event Sources to Send Events to Security Analytics).