Skip to content

Configuration

The automation configuration panel is where you set what happens when a test case runs. It consists of:

  • The test case command
  • Input arguments
  • Execution artifacts
  • Optional cleanup commands

Automation Configuration Panel

To open the configuration panel, click the "Configuration" button under Red Team Details:

Automation Configure Button

Command

The command section has a text box where you can enter the commands you want to run. It also has a drop down menu letting you select how you want the commands to run.

Executor Example Notes
CMD cmd.exe /c dir Newlines in the text box are used to separate commands. Each command will be run consecutively with cmd.exe /c.
PowerShell Powershell.exe -File "Testcase Name.ps1" The commands in the command text box will be written to a PowerShell file on disk and then run.
Inline PowerShell Powershell.exe -Command "cd C:\; ls" The commands in the command text box will be passed inline to PowerShell.

Clicking the "Preview" radio button will show you exactly what will be run when the test case executes.

Arguments

The arguments section lets you set input arguments for the test case. This helps you manage repeating or frequently changing data in the commands, such as usernames. You can add a new argument with the "+" button and then set its name and value in the corresponding text boxes. Then in the command text box, use arguments with the format #{name}. Any arguments will be replaced with the values set in the arguments table. You can see how the arguments will be inserted by viewing the command preview.

Command Argument Name Argument Value Resulting Command
dir #{path} path C:\ cmd.exe /c dir C:\

Execution Artifacts

Execution artifacts let you upload files that will be dropped to disk when the test case runs and can be used by commands. More information can be found in the Execution Artifacts section.

Cleanup Commands

Cleanup commands are used to undo any changes the test case made to the target system. They run after the test case command finishes and while the results are logged, they are not used to update any of the Red Team information when logs are uploaded. They otherwise function identically to test case commands.