monkey/docs/content/usage/integrations/aws-security-hub.md

2.5 KiB

title date draft description tags
AWS Security Hub integration 2020-06-28T10:38:12+03:00 false Correlate the Monkey's findings with the native security solutions and benchmark scores.
aws
integration

The Infection Monkey integration with the AWS Security Hub allows anyone to verify and test the resilience of their AWS environment and correlate this information with the native security solutions and benchmark score.

AWS security hub logo

The integration will send all Infection Monkey findings (typically low tens of findings) to the security hub at the end of a Monkey breach simulation.

Setup

If the correct permissions have been set on the AWS IAM role of the Monkey Island machine, then the Island will automatically export its findings to the AWS security hub.

Specific permissions required for security hub

  • "securityhub:UpdateFindings"
  • "securityhub:BatchImportFindings"

Note that the integration is specifically between your Monkey Island and the security hub. The Infection Monkey is an free project and there is no centralised infrastructure.

Enabling finding reception

Before starting the scan, make sure that AWS Security Hub is accepting findings by enabling Infection Monkey integration. Find GuardiCore: AWS Infection Monkey integration on the list and click on Accept findings.

Enabled integration

Integration details

The Infection Monkey reports the following types of issues to the AWS security hub: Software and Configuration Checks/Vulnerabilities/CVE.

Specifically, the Island sends findings for all vulnerabilities it finds along with generic findings on the network (such as segmentation issues). Our normalized severity is 100, while most issues we report range between 1 and 10.

Regions

The Infection Monkey is usable on all public AWS instances.

Example

After setting up a monkey environment in AWS and attaching the correct IAM roles to the monkey island machine, the report findings were exported to the security hub.

  1. Navigate to Findings.
  2. Press on a specific finding to see more details and possible solutions.

AWS Security hub console example