Amazon Web Services (AWS) | Dropzone AI Documentation
Amazon Web Services (AWS)
The Dropzone AI platform integrates with Amazon Web Services (AWS) APIs for ingesting alerts (AWS GuardDuty) and enriching investigations with data from AWS such as CloudWatch.
Dropzone creates a separate IAM role for each customer. This document describes how to enable the Dropzone role to access your AWS environment and configure the Dropzone platform.
Integration Overview
To enable these integrations you will perform the following actions:
Enable Cross-Account Access
- Create an IAM role in your account(s)
- Attach policies to the role
Enable the Dropzone Data Source
Enable the Dropzone Alert Source
The Dropzone platform has a dedicated IAM role for your organization. You enable cross-account access for this IAM to gain access to specific roles within your AWS accounts.
These instructions will work for any account, but you may have different methods for applying them, for example if you are using Control Tower or deploying changes via Infrastructure as Code.
You must complete these steps for all AWS accounts you wish accessible by Dropzone.
Enable Cross-Account Access
You need to enable Dropzone to access your AWS environments for it to pull alerts and run investigations. There are several ways you can achieve this:
| Toolset | Documentation | Description |
|---|---|---|
| Set up roles via the Management Console | documentation | Set up roles and create policies in the AWS Console. Several manual steps, highly documented |
| Set up Role Chaining | documentation | Use a central Hub role to access multiple accounts via a consistent role pattern |
| Use AWS CloudFormation | documentation | Set up roles by running Dropzone's CFTs and copy/pasting in a small number of values |
| Use Infrastructure-as-Code / CLI / etc | see your provider's information | You can create your own IaC by looking at the role and policy information in the management console documentation. Dropzone does not provide any pre-canned IaC code at this time. |
The following policies are required for full Dropzone functionality:
AWSCloudTrail_ReadOnlyAccessAmazonEC2ReadOnlyAccessAmazonGuardDutyReadOnlyAccessAmazonRoute53ReadOnlyAccessAmazonS3OutpostsReadOnlyAccessAmazonS3ReadOnlyAccessAmazonSSMReadOnlyAccessIAMReadOnlyAccess
Be sure to use one of the above options to enable the cross-account access before moving on to enabling the integrations.
Enable Amazon Web Services
The Alert source integration allows Dropzone AI to pull alerts from AWS GuardDuty for investigation.
You'll need the following information:
Default Region: The AWS region you run most of your services in
Role ARNs: The ARNs of the AWS roles you created in your accounts
Navigate to your Dropzone AI tenant home page e.g. https:// mycompany.dropzone.app
In the bottom left hand corner, click Settings > Integrations
Click "Available"
In the Search bar, search AWS, then click "Configure"
Under the Alert Source heading, enter an AWS region into the "Default Region" field, such as "us-west-1"
This should be the region that the majority of your monitored resources live in.
Unless using role chaining, leave the Hub Role ARN field blank.
Under "Role ARNs," click "Add Item," then input the role ARNs that you created earlier. Input each role ARN individually.
Under "Minimum Severity Level," select the minimum alert severity level you want Dropzone to investigate alerts for.
If you wish to allow Dropzone to investigate alerts that have been archived, check the box next to "Include Archived Alerts."
If you wish, you may exclude AWS GuardDuty alerts by finding type. To do so, under the AWS "GuardDuty Alert Exclusions" section, click "Add Item." Then input the alert type you wish to exclude in the form of a string.
Input your desired poll interval and poll lookback.
If you wish to further filter alerts using the Python CEL package, check the box labeled "Use advanced filtering."
Input your CEL expression, then select whether to include or exclude alerts matching that filter. Add each filter individually using the "Add Item" button.
Contact your Dropzone AI support representative for more information about this feature.
Click "Test & Save" to finish.
If you have any errors engage your Dropzone AI support representative.