Automated Emulation is a simple terraform template creating a customizable and automated Breach and Attack Simulation lab. It automically builds the following resources hosted in AWS:
- One Linux server deploying Caldera, Prelude Operator Headless, and VECTR
- One Windows Client (Windows Server 2022) auto-configured for Caldera agent deployment, Prelude pneuma, and other Red And Blue tools
See the Features and Capabilities section for more details.
Key Differences
This lab differs from other popular Cyber Ranges
in its design and philosophy. No secondary tools like Ansible are necessary. Feel free to use them if you like. But they aren’t required for configuration management.
Instead of using 3rd party configuration management tools, this lab uses terraform providers (AWS SDK) and builtin AWS features (user data
).
You don’t have to rely on a secondary agent or deal with outdated libraries or networking issues with agentless push or updating a secondary tool that causes issues over time.
This increases stability, consistency, and speed
for building and configuring cloud resources. Use terraform, bash, and powershell to build and configure.
A small user-data script is pushed into the system and runs. Individual configuration management scripts are uploaded to an S3 bucket.
The master script instructs the system which smaller scripts to run which builds the system. With good documentation, the location of these scripts should make it easy to add and customize.
See the Features and Capabilities section for more details.
Requirements And Setup
Tested With:
- Mac OS 13.4
- terraform 1.5.7
Clone This Repository:
git clone https://github.com/iknowjason/AutomatedEmulation
Credentials Setup
Generate an IAM programmatic access key that has permissions to build resources in your AWS account. Setup your .env to load these environment variables. You can also use the direnv tool to hook into your shell and populate the .envrc. Should look something like this in your .env or .envrc:
export AWS_ACCESS_KEY_ID="VALUE"
export AWS_SECRET_ACCESS_KEY="VALUE"
Build And Destroy Resources
Run Terraform Init
Change into the AutomatedEmulation working directory and type:
terraform init
Run Terraform Plan Or Apply
terraform apply -auto-approve
or
terraform plan -out=run.plan
terraform apply run.plan
Destroy Resources
terraform destroy -auto-approve
View Terraform Created Resources
The lab has been created with important terraform outputs showing services, endpoints, IP addresses, and credentials. To view them:
terraform output