-
Notifications
You must be signed in to change notification settings - Fork 788
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Docs: Add explanation for running on AWS EC2 instances
- Loading branch information
1 parent
f06da2a
commit a6292e8
Showing
2 changed files
with
47 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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.