The Atomic GUI

The Atomic GUI aids in the creation of new atomics by providing a web form that can be filled out in order to generate the YAML test definition. This YAML can then by copy and pasted into the YAML for the appropriate Technique Number (e.g. T1003) in order to add a new atomic test. Instructions for using the Atomic GUI are provided below.

Step 1: Start the Atomic GUI

From a PowerShell prompt where the Invoke-AtomicRedTeam module is imported, run the following command to start the Atomic GUI.

Start-AtomicGUI

This will start the Atomic GUI on port 8487 by default and launch a Web Browser with the GUI loaded. The web server is bound to the localhost interface only, it is not accessible from another computer on the network. You can specify a different port number to use with the -Port <portNum> parameter.

The first time you start the GUI, the PowerShell Universal Dashboard will be installed if needed.

You can stop the server from running with the Stop-AtomicGUI command

Steps 2 & 3: Fill In the Form and Generate the YAML

Use the provided web form to define the new atomic. Any optional components can be left blank if you don't intend to use them. Once you've filled out the form, click the Generate Test Definition YAML button.

Steps 4: Adjust Indentation

YAML uses the indentation level of each line of text to determent which elements belong to which parent elements. Therefore it is important that the indentation of your YAML file match the indentation of the parent YAML file you will be adding your generated YAML to.

Use the left and right arrow buttons to increase and decrease the indentation as needed.

Steps 5 & 6: Copy YAML & Paste into Parent Technique YAML File