Teamserver Interface

Documentation for the Teamserver interface used in plugins (extenders) for interacting with the Adaptix C2 server.

Architecture

General Diagram

┌──────────────────────────────────────────────────────────────────────────────────────┐
│                                   ADAPTIX SERVER                                     │
├──────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                      │
│  ┌────────────────────────────────────────────────────────────────────────────────┐  │
│  │                              TEAMSERVER CORE                                   │  │
│  ├────────────────────────────────────────────────────────────────────────────────┤  │
│  │                                                                                │  │
│  │  ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐           │  │
│  │  │   TsConnector   │     │  MessageBroker  │     │   EventManager  │           │  │
│  │  │  (HTTP/WS API)  │────>│  (WebSocket)    │     │   (Pre/Post)    │           │  │
│  │  │   gin-gonic     │     │  broadcast      │     │   Hooks         │           │  │
│  │  └────────┬────────┘     └────────┬────────┘     └────────┬────────┘           │  │
│  │           │                       │                       │                    │  │
│  │           V                       V                       V                    │  │
│  │  ┌────────────────────────────────────────────────────────────────────────┐    │  │
│  │  │                         TEAMSERVER INTERFACE                           │    │  │
│  │  │                                                                        │    │  │
│  │  │   TsAgent*    TsTask*    TsTunnel*    TsTerminal*    TsListener*       │    │  │
│  │  │   TsDownload* TsScreenshot* TsTarget* TsCredential*  TsEndpoint*       │    │  │
│  │  │   TsEventHook* TsExtenderData* TsClientGui* TsPivot* TsService*        │    │  │
│  │  │   TsAxScript*                                                          │    │  │
│  │  │                                                                        │    │  │
│  │  └────────────────────────────────────────────────────────────────────────┘    │  │
│  │           │                       │                       │                    │  │
│  │           V                       V                       V                    │  │
│  │  ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐           │  │
│  │  │   TaskManager   │     │  TunnelManager  │     │      DBMS       │           │  │
│  │  │                 │     │                 │     │    (SQLite)     │           │  │
│  │  │  - Task Queue   │     │  - Tunnels Map  │     │                 │           │  │
│  │  │  - Job Handler  │     │  - Channels Map │     │  - Listeners    │           │  │
│  │  │  - Tunnel Task  │     │  - Buffer Pool  │     │  - Agents       │           │  │
│  │  │  - Browser Task │     │  - Stats        │     │  - Tasks        │           │  │
│  │  └─────────────────┘     └─────────────────┘     │  - Downloads    │           │  │
│  │                                                  │  - Screenshots  │           │  │
│  │  ┌─────────────────┐                             │  - Credentials  │           │  │
│  │  │  ScriptManager  │                             │  - Targets      │           │  │
│  │  │  (AxScript)     │                             │  - Console      │           │  │
│  │  │  - Server hooks │                             │  - Chat         │           │  │
│  │  │  - Commands     │                             └─────────────────┘           │  │
│  │  └─────────────────┘                                                           │  │
│  │                                                                                │  │
│  └────────────────────────────────────────────────────────────────────────────────┘  │
│                                         │                                            │
│                                         V                                            │
│  ┌────────────────────────────────────────────────────────────────────────────────┐  │
│  │                            EXTENDER MANAGER                                    │  │
│  ├────────────────────────────────────────────────────────────────────────────────┤  │
│  │                                                                                │  │
│  │   LoadPlugins() ───┬──> LoadPluginListener() ──> PluginListener Interface      │  │
│  │                    ├──> LoadPluginAgent()    ──> PluginAgent Interface         │  │
│  │                    └──> LoadPluginService()  ──> PluginService Interface       │  │
│  │                                                                                │  │
│  │   ┌─────────────┐       ┌─────────────┐       ┌─────────────┐                  │  │
│  │   │   .so       │       │  config     │       │   .axs      │                  │  │
│  │   │   plugin    │       │  .yaml      │       │   UI file   │                  │  │
│  │   └─────────────┘       └─────────────┘       └─────────────┘                  │  │
│  │                                                                                │  │
│  └────────────────────────────────────────────────────────────────────────────────┘  │
│                                         │                                            │
│                                         V                                            │
│  ┌────────────────────────────────────────────────────────────────────────────────┐  │
│  │                          IN-MEMORY DATA STORES                                 │  │
│  ├────────────────────────────────────────────────────────────────────────────────┤  │
│  │                                                                                │  │
│  │   ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐    │  │
│  │   │  Agents   │  │ Listeners │  │ Downloads │  │ Terminals │  │  Pivots   │    │  │
│  │   │  (Map)    │  │  (Map)    │  │   (Map)   │  │  (Map)    │  │  (Slice)  │    │  │
│  │   └───────────┘  └───────────┘  └───────────┘  └───────────┘  └───────────┘    │  │
│  │                                                                                │  │
│  │   ┌───────────┐  ┌───────────┐                                                 │  │
│  │   │  Builders │  │   OTPs    │                                                 │  │
│  │   │   (Map)   │  │   (Map)   │                                                 │  │
│  │   └───────────┘  └───────────┘                                                 │  │
│  │                                                                                │  │
│  └────────────────────────────────────────────────────────────────────────────────┘  │
│                                                                                      │
└──────────────────────────────────────────────────────────────────────────────────────┘

Teamserver Components

Component	File	Description
TsConnector	connector.go	HTTP/WebSocket server (gin-gonic), routing
MessageBroker	mgr_broker.go	WebSocket client management, broadcast
TaskManager	mgr_task.go	Task queue, task type handlers
TunnelManager	mgr_tunnel.go	SOCKS/PortFwd tunnels, channels, buffer pool
EventManager	eventing/	Pre/Post hooks, async events
DBMS	database/	SQLite, WAL mode, persistent storage
Extender	extender/	.so plugin loading, interface registration
ScriptManager	axscript/	Server-side AxScript engine, hooks and commands

Extender Types

Type	Description	Interface
Listener	Accepts connections from agents, establishes protocol	PluginListener
Agent	Agent logic: generation, parsing, commands	PluginAgent
Service	Service plugins: notifications, integrations	PluginService

---