AWS GuardDuty Integration

AWS GuardDuty is a threat detection service that continuously monitors your AWS accounts and workloads for malicious activity and delivers detailed security findings for visibility and remediation.

In iLert
Go to the "Alert sources" tab and click "Create new alert source"
Enter a name and select your desired escalation policy.   
Select "AWS GuardDuty" as the Integration Type and click Save.
On the next page, an AWS GuardDuty URL is generated. You will need the URL for the webhook configuration
In AWS Dashboard
Use the search bar and select Simple Notification Service (SNS). Select Topics and click Create Topic in the SNS Dashboard.
Input a Topic name and Display name and Create topic. After the topic has been created, Select Subscriptions in the left hand menu and click Create Subscription.
Select HTTPS Protocol and put the URL that was received from iLert side into the Endpoint field, keep the Enable raw message delivery checkbox unchecked and Create Subscription.
The subscription would be confirmed automatically on iLert side, but make sure the Subscription ID is not in PendingConfirmation state.
Search and select the Amazon GuardDuty console in the Service Search. Search for GuardDuty click Enable GuardDuty if this is the first time enabling Amazon GuardDuty.
If the GuardDuty is enabled, CloudWatch Event Rules can be configured to send alerts to iLert and please navigate to the CloudWatch console.
To create a rule, select Rules under Events and then click Create Rules. Select GuardDuty as the Service Name and then choose GuardDuty Finding as the Event Type.
Click Add a target and select SNS topic, select Your Topic Name that has been created earlier and then click Configure Details.
Assign a Name like ilert-incidents and click Create Rule.
In order to test this, go back to the Amazon GuardDuty console and generate sample findings, to create event in iLert.
Select Settings, then select Generate Sample Findings and then click Findings in the left navigation bar.
The sample findings should have been generated, and it will create the event in the iLert automatically.

Integrations - Previous

AWS Budget Integration

Next - Integrations

AWS Lambda Integration

Last modified 3mo ago

Copy link

Edit on GitHub

Contents

In iLert

In AWS Dashboard