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

The If omitted column describes hand-written JSON sent directly to the API. The plugin's named default example explicitly supplies port 4444 and a 10 MiB inputBufferSize (10485760).

Parameter Type Required If omitted Description
port int Yes Invalid TCP port (1-65535) on which the C2 waits for a shell connection.
inputBufferSize int No 0 (effective 1 KiB) Maximum input buffer size in bytes. The runtime buffer starts at 1 KiB and grows only while it is below this cap, so configure at least 1024 when growth is required. An omitted value does not inherit the named example's 10 MiB value.

Configuration Scenarios

Scenario 1 - Basic Reverse Shell

A simple reverse shell listener on port 4444 with a 10 MiB 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
  }
}