Home

Human Plugin

The human plugin will allow you to build a “human” which will run continuously, performing randomized human-like behaviors on Mac, Linux, or Windows systems. There are several behaviors available within the human plugin that users can perform. In addition, users can edit existing behaviors or add additional behaviors to fit their specific use case.

Behaviors

The behaviors currently available in the Human plugin:

• Download files – randomly download either a Wikipedia page, XKCD comic, or NIST publication to the ~/Downloads directory
• List files in the current directory – perform a basic ls command on Mac/Linux or dir command on Windows
• Create a blank Microsoft Paint file – open Microsoft Paint and save the blank file (Only available for Windows)
• Select a random website and browse – navigate to a random website from a given list on Google Chrome and browse on the site
• Search for something on Google – using Google Chrome, google a random search term from a given list, hover and click the "I'm Feeling Lucky" button, browse the search results, click on a result, and navigate on the website
• Execute custom commands – execute any shell command that the user specifies
• Browse YouTube – using Google Chrome, search for videos on YouTube, select a random result, watch the video, and click on suggested videos
• Create documents using Apache OpenOffice Calc – create and interact with spreadsheets (Only available for Windows. Tested with Apache OpenOffice 4.1.13)
• Create spreadsheets using Apache OpenOffice Writer – create and interact with documents and export PDFs (Only available for Windows. Tested with Apache OpenOffice 4.1.13)

Installation & Setup

1. Ensure that the human plugin is downloaded to the caldera/plugins/human directory.
2. Add "- human" to the list of plugins in the caldera/conf/default.yml and/or caldera/conf/local.yml files.
3. Install the following pre-requisites on the target machine:
   • Python3
   • Google Chrome
   • Python package virtualenv
4. Start the CALDERA server

Building a human

1. Navigate to the Human plugin using the "Plugins" sidebar on the left side of the CALDERA server interface.
2. Enter a name for the human.
3. Select the platform that the human will run on (e.g. MacOS, Linux, or Windows)
4. Select the behaviors that the human will perform. If multiple behaviors are selected, the human will randomly choose of of those behaviors each time it performs a behavior.
5. If you select the "Execute custom commands" behavior, you can add custom commands using the green "Add Command" button. The red "Clear Commands" button will clear any custom commands that have been entered.
6. Select configuration parameters in the "Human behavior configuration" section:
   • Task Sleep Interval – seconds in between each behavior being performed
   • Task Cluster Sleep Interval – seconds in between each cluster of behaviors. This is usually a longer break than the Task Sleep Interval.
   • Tasks per Cluster – number of behaviors that will be performed in each cluster
7. Click "Generate Human" to create the new human.
8. The command to run the human will appear on the right side of the interface. Confirm that the CALDERA Server IP value shows the IP address that the human should use to contact CALDERA server.
9. Copy the human start up command and paste it into the shell on the target system to start a human.