AWS WAF

1 About the Device
2 Device Information
3 Collection Method
4 Device Configuration
5 Integration parameters

About the Device

AWS WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to an Amazon API Gateway API, Amazon CloudFront or an Application Load Balancer. AWS WAF also lets you control access to your content.

Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, API Gateway, CloudFront or an Application Load Balancer responds to requests either with the requested content or with an HTTP 403 status code (Forbidden).

Device Information

Entity	Particulars

Entity	Particulars
Vendor Name	Amazon Web Services
Product Name	Web Application Firewall
Type of Device	Cloud

Collection Method

Log Type	Ingestion label	Preferred Logging Protocol - Format	Log Collection Method	Data Source

Log Type	Ingestion label	Preferred Logging Protocol - Format	Log Collection Method	Data Source
AWS WAF	AWS_WAF	Cloud Storage - JSON	C2C - Storage	https://cloud.google.com/chronicle/docs/reference/feed-management-api#amazon_s3 https://cloud.google.com/chronicle/docs/reference/feed-management-api#amazon_sqs

Device Configuration

Prerequisite:

S3 bucket is created. Please refer the following page to create a S3 bucket.https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html

To enable logging for a Web ACL to S3 Bucket

Log in to AWS console and search for WAF & Shield and click WAF & Shield.

Click on Web ACLs.

Choose Web ACL for which you want to enable logging.

Navigate to Logging and metrics.

Click Enable to enable logging.

Select S3 bucket under Logging destination

Select S3 bucket name under Amazon S3 bucket which we have created in prerequisite.
Click Save

If you would like to use SQS, please follow below steps:

Follow all steps provided above to store logs in S3 bucket
Create SQS and attach it with S3. Please refer

Important Links:

For more details on how to get required credentials for integration parameters please refer:
Please refer below page to check required IAM user and KMS Key policies for S3, SQS and KMS:
Below are the URL details which we need to allow for connectivity (Please identify URLs by referring AWS document according to your services and regions):
- IAM: For any logging source IAM URL should be allowed:
- S3: For S3 or SQS logging source, S3 URL should be allowed:
- SQS: For SQS logging source, SQS URL should be allowed:

Integration parameters

S3:

Property	Default Value	Description

Property	Default Value	Description
REGION	N/A	Select the region of your S3 bucket
S3 URI	N/A	The S3 URI to ingest. (It will be a combination of S3 bucket name and prefix. Example: - S3://<S3 bucket name>/<prefix>)
URI IS A	N/A	The type of file indicated by the URI. Valid values are: `FILES`: The URI points to a single file which will be ingested with each execution of the feed. `FOLDERS`: The URI points to a directory. All files contained within the directory will be ingested with each execution of the feed. `FOLDERS_RECURSIVE`: The URI points to a directory. All files and directories contained within the indicated directory will be ingested, including all files and directories within those directories, and so on.
SOURCE DELETION OPTION	N/A	Whether to delete source files after they have been transferred to Chronicle. This reduces storage costs. Valid values are: `SOURCE_DELETION_NEVER`: Never delete files from the source. `SOURCE_DELETION_ON_SUCCESS`:Delete files and empty directories from the source after successful ingestion. `SOURCE_DELETION_ON_SUCCESS_FILES_ONLY`:Delete files from the source after successful ingestion.
ACCESS KEY ID	N/A	This is the 20 character ID associated with your Amazon IAM account.
SECRET ACCESS KEY	N/A	This is the 40 character access key associated with your Amazon IAM account.

SQS:

Property	Default Value	Description

Property	Default Value	Description
REGION	N/A	Select the region of your S3 bucket
QUEUE NAME	N/A	The SQS queue name.
ACCOUNT NUMBER	N/A	The account number for the SQS queue and S3 bucket.
QUEUE ACCESS KEY ID	N/A	This is the 20 character ID associated with your Amazon IAM account.
QUEUE SECRET ACCESS KEY	N/A	This is the 40 character access key associated with your Amazon IAM account.
SOURCE DELETION OPTION	N/A	Whether to delete source files after they have been transferred to Chronicle. This reduces storage costs. Valid values are: `SOURCE_DELETION_NEVER`: Never delete files from the source. `SOURCE_DELETION_ON_SUCCESS`:Delete files and empty directories from the source after successful ingestion. `SOURCE_DELETION_ON_SUCCESS_FILES_ONLY`:Delete files from the source after successful ingestion.