72 lines
2.5 KiB
Nim
72 lines
2.5 KiB
Nim
import terminal, strformat
|
|
import ../[types, globals, utils]
|
|
import ../db/database
|
|
|
|
|
|
#[
|
|
Agent management mode
|
|
These console commands allow dealing with agents from the Conquest framework's prompt interface
|
|
]#
|
|
proc agentUsage*(cq: Conquest) =
|
|
cq.writeLine("""Manage, build and interact with agents.
|
|
|
|
Usage:
|
|
agent [options] COMMAND
|
|
|
|
Commands:
|
|
|
|
list List all agents.
|
|
build Build an agent to connect to an active listener.
|
|
interact Interact with an active agent.
|
|
|
|
Options:
|
|
-h, --help""")
|
|
|
|
proc agentList*(cq: Conquest, args: varargs[string]) =
|
|
let agents = cq.dbGetAllAgents()
|
|
cq.drawTable(agents)
|
|
|
|
proc agentBuild*(cq: Conquest, args: varargs[string]) =
|
|
discard
|
|
|
|
# Switch to interact mode
|
|
proc agentInteract*(cq: Conquest, args: varargs[string]) =
|
|
|
|
cq.setIndicator("[AGENT] (username@hostname)> ")
|
|
cq.setStatusBar(@[("mode", "interact"), ("listeners", "X"), ("agents", "4")])
|
|
|
|
var command: string = cq.readLine()
|
|
|
|
discard
|
|
|
|
#[
|
|
Agent API
|
|
Functions relevant for dealing with the agent API, such as registering new agents, querying tasks and posting results
|
|
]#
|
|
proc register*(agent: Agent): bool =
|
|
|
|
# The following line is required to be able to use the `cq` global variable for console output
|
|
{.cast(gcsafe).}:
|
|
|
|
# Check if listener that is requested exists
|
|
# TODO: Verify that the listener accessed is also the listener specified in the URL
|
|
# This can be achieved by extracting the port number from the `Host` header and matching it to the one queried from the database
|
|
if not cq.listenerExists(agent.listener):
|
|
cq.writeLine(fgRed, styleBright, fmt"[-] Agent from {agent.ip} attempted to register to non-existent listener: {agent.listener}.", "\n")
|
|
return false
|
|
|
|
# Store agent in database
|
|
if not cq.dbStoreAgent(agent):
|
|
cq.writeLine(fgRed, styleBright, fmt"[-] Failed to insert agent {agent.name} into database.", "\n")
|
|
return false
|
|
|
|
cq.add(agent.name, agent)
|
|
cq.writeLine(fgYellow, styleBright, fmt"[{agent.firstCheckin}] ", resetStyle, "Agent ", fgYellow, styleBright, agent.name, resetStyle, " connected to listener ", fgGreen, styleBright, agent.listener, resetStyle, ": ", fgYellow, styleBright, fmt"{agent.username}@{agent.hostname}", "\n")
|
|
|
|
return true
|
|
#[
|
|
Agent interaction mode
|
|
When interacting with a agent, the following functions are called:
|
|
- addTask, to add a new tasks to the agents task queue
|
|
- getTaskResult, get the result for the task from the agent
|
|
]# |