Running

MaCySTe allows you to leverage every feature provided by the framework by issuing make commands.

Quickstart

Run make check pull up run-bc

Checking is your machine meets prerequisites

Run make check

$ make check
Found command cat
Found command envsubst
Found command flatpak-builder
Found command flatpak
Found command ip
Found command podman
Found command python3
Found command sysctl
Found command tee
Found command xdg-open
Podman version 4.3.1 is ok
Python version 3.11.1 (main, Dec  7 2022, 00:00:00) [GCC 12.2.1 20221121 (Red Hat 12.2.1-4)] is ok

Starting

After you built the images and flatpaks

Run make up and then start the simulator

Starting the simulator

Run make run-bc

Opening the GUI

Run make open-home

Stopping

Run make down

Restart a single service

Run make restart-service SERVICE=<service_name> where <service_name> is the name of the folder inside of the scenarios base directory.

Building

Everything

Run make build

Equivalent to building containers and flatpaks.

Containers

Run make build-containers

Flatpaks

Run make build-flatpaks

Pulling pre-made images

If you want to use our pre-made images run make pull, to use pre-made flatpak, the file src/flatpaks/bridgecommand/it.csec.Bridgecommand.flatpak

Available scenarios

MaCySTe by default shipping with the core scenario but it also bundles 3 additional scenarios which can be selected by altering the SCENARIO_NAME variable.

NameDescription
coreThe base scenario
attackerThe base scenario, augmented with the attacker addon
siemThe base scenario, augmented with the SIEM addon
attacker_siemThe base scenario, augmented with the attacker addon and SIEM addon

Changing options

The options file can be found in src/settings.Makefile settings can be either changed in the file or overriden during the make invocation like so: <make command> <setting key>=<setting value>

Available settings

NameDescriptionDefault
SCENARIO_NAMEScenario to instantiatebase
BC_HEADLESSWhenever to enable the render-less mode for BridgeCommandempty
BC_SCENARIOScenario to load in BridgeCommandGenoa