Setting up agents

In this section, we’ll walk you through the process of connecting your Crabbo agents to the C2 server. The process is straightforward and only requires downloading the agent binary and running it.

Prerequisites

Before connecting the agent to the C2 server, make sure you have completed the following:

  1. C2 Server Running: The Crabbo C2 server should already be up and running. If you haven’t set it up yet, please refer to the C2 Server Setup Guide to get it running first.

  2. Download the Agent: The Crabbo agent can be downloaded from the C2 server or a file server that you have set up. This is the file that will allow the agent to communicate with the C2 server and receive commands.

Steps to Connect the Agent

1. Download the Agent Binary

The first step is to download the Crabbo agent binary. The agent file is usually hosted on the file server or provided by your C2 server, depending on your setup. You can download the agent from the following link (for example):

wget http://<your-file-server>/crabbo_agent

This command will download the crabbo_agent binary to your machine. Make sure to replace <your-file-server> with the actual URL or IP address of your file server.

2. Run the Agent

Once the agent is downloaded and permissions are set, the next step is to launch it. Running the agent requires you to provide the host (IP address or domain name) and the port number of the C2 server.

Use the following command to start the agent:

./crabbo_agent <host> <port>
  • <host>: This is the IP address or domain name of your C2 server (for example, localhost or 192.168.1.100).

  • <port>: This is the port number where the C2 server is listening for incoming agent connections (for example, 8080).

Example:

If your C2 server is running on localhost and listening on port 8080, you would run the following command:

./crabbo_agent localhost 8080

The agent will now attempt to connect to the C2 server. If everything is set up correctly, the agent will establish a connection, and you will start seeing activity in the C2 web UI.

4. Verify the Connection

Once the agent is connected, you can verify that it’s properly communicating with the C2 server by checking the C2 web interface. The agent should appear as a connected device in the "Agents" section of the C2 dashboard. From here, you can begin issuing commands to the agent and monitor its activity.

Troubleshooting

If the agent fails to connect, here are a few things to check:

  • Check the C2 Server: Ensure the C2 server is up and running and that it is listening on the correct port.

  • Network Connectivity: Ensure there are no network issues preventing the agent from reaching the C2 server. This could include firewall rules, incorrect host or IP address, or network isolation.

  • Port Availability: Make sure the specified port is open and not blocked by any firewalls or security groups on the C2 server.

Conclusion

Connecting a Crabbo agent to the C2 server is a simple process involving downloading the agent binary and running it with the appropriate host and port information. Once connected, the agent will be ready to receive commands from the C2 server, allowing you to test and analyze the functionality of your Crabbo setup.

Remember to always conduct testing and analysis in a controlled environment and use Crabbo responsibly for educational purposes.

Last updated