Skip to content

Reverse Shell Listener

This listener provides a simple TCP shell connection for manual use (e.g. with netcat). It is not intended for connections from generated agents.

Plugin ID: shelldot.listener.generic-reverse-tcp

Configuration Reference

Parameter Type Required Default Description
port int Yes - TCP port on which the C2 waits for a shell connection.
inputBufferSize int Yes - Maximum size of the input buffer in bytes.

Configuration Scenarios

Scenario 1 - Basic Reverse Shell

A simple reverse shell listener on port 4444 with a 10 MB input buffer.

1
2
3
4
{
  "port": 4444,
  "inputBufferSize": 10485760
}

Example (POST Request)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
POST /api/v1/listeners HTTP/1.1
Authorization: Bearer {JWT_TOKEN}
Content-Type: application/json

{
  "plugin": "shelldot.listener.generic-reverse-tcp",
  "name": "my-generic-tcp-reverse-listener",
  "configuration": {
    "port": 5555,
    "inputBufferSize": 4000000
  }
}