Skip to content

Commit

Permalink
Docs: Add explanation for running on AWS EC2 instances
Browse files Browse the repository at this point in the history
  • Loading branch information
ilija-lazoroski committed Aug 13, 2024
1 parent f06da2a commit a6292e8
Show file tree
Hide file tree
Showing 2 changed files with 47 additions and 0 deletions.
47 changes: 47 additions & 0 deletions docs/content/features/run_on_aws.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
title: "Infection Monkey AWS Execution"
draft: false
description: "Run Infection Monkey on AWS EC2 instances"
tags: ["aws", "ec2", "ssm", "agent", "run"]
pre: "<i class='fa-brands fa-aws'></i> "
---

## Description

The Infection Monkey can run on AWS EC2 instances using the
[AWS Systems Manager (SSM) Agent](
https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent.html).
Each EC2 instance has an SSM Agent installed for updating, managing, and
configuring the instance. It executes requests received from
the [AWS Systems Manager](
https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html),
and uses the [Amazon Message Delivery Service](
https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonmessagedeliveryservice.html)
to report back status and execution details.

Infection Monkey AWS Execution lets you run Infection Monkey Agent on your
chosen EC2 instances without the requirement of manual installation, enabling
the simulation of various attack scenarios across your AWS infrastructure.

## Prerequisites

In order to ensure that Infection Monkey can be executed on EC2 instance,
the SSM Agent must be present on the target instance. The list of AWS AMIs
that come with the SSM Agent pre-installed can be found [here](
https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html).
Additionally, the instance must have the necessary IAM roles to allow the SSM
Agent to execute commands.

## Running Infection Monkey on AWS EC2 Instances

The Monkey Island can be deployed on any EC2 instance with
[supproted Operating System](
../../reference/system-requirements/#supported-operating-systems) or using
[Infection Monkey AMI](https://aws.amazon.com/marketplace/pp/prodview-b3oqimxzrd762).
When deployed the Monkey Island will automatically detect running on AWS instance
and offer the option to deploy the Monkey Agent on EC2 instances with
SSM Agent installed on them.

![Running a Monkey on EC2 Instance](
/images/island/integrations/aws/run_on_aws_ec2.png "Running a Monkey on EC2
Instance")
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit a6292e8

Please sign in to comment.