Updated documentation.

This commit is contained in:
Jakob Friedl
2025-10-30 18:31:50 +01:00
parent a2db85a237
commit 394c98939e
12 changed files with 75 additions and 3 deletions

BIN
assets/client-1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 107 KiB

BIN
assets/client-2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 116 KiB

BIN
assets/client-3.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 340 KiB

BIN
assets/client-5.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 110 KiB

BIN
assets/client-7.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

BIN
assets/client-8.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 129 KiB

BIN
assets/client-9.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 MiB

BIN
assets/client.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 81 KiB

View File

@@ -1,4 +1,4 @@
# Profiles <!-- omit from toc -->
# Malleable C2 Profiles <!-- omit from toc -->
## Contents <!-- omit from toc -->

View File

@@ -0,0 +1,73 @@
# Operator Client - User Interface <!-- omit from toc -->
## Contents <!-- omit from toc -->
- [General](#general)
- [Listeners](#listeners)
- [Sessions](#sessions)
- [Agent Console](#agent-console)
- [Downloads](#downloads)
- [Screenshots](#screenshots)
- [Eventlog](#eventlog)
## General
Conquest's operator client is developed using a wrapper for the **Dear ImGui** library in Nim. It communicates via WebSocket with the team server to instruct it to perform various actions, such as starting listeners, generating payloads or tasking agents to execute commands. At the same time, it receives data from the team server, such as new agents, command output or files and updates the user interface in real-time. Dear ImGui makes it easy to reorder windows and components for a customizable and flexible user experience.
## Listeners
The **Listeners** view shows a table with all currently active listeners and provides buttons for starting new listeners and for generating `Monarch` payloads. Right-clicking an active listeners opens a context menu that allows the user to stop the listener.
![Listeners View](../assets/client.png)
## Sessions
The **Sessions Table** view, located by default in the top left shows information about agents and the target system they are running on, such as the username, hostname, domain, internal and external IP address, process information and the time since the last heartbeat. By right-clicking the header row, columns can be hidden and shown, as well as reordered and resized.
![Sessions View](../assets/client-1.png)
To interact with an agent, one can either double-click it, or right-click the row and select `Interact`. From this right-click context menu, it is also possible to exit the agent and remove it from the team server database, which is usually done to prevent inactive agents from reappearing after a client restart.
![Session View Context Menu](../assets/client-2.png)
It is also possible to select multiple rows by dragging or holding CTRL/SHIFT and performing actions on all selected rows simultaneously.
## Agent Console
An **Agent Console** is opened in the bottom panel when an agent is interacted with. It features an input field at the bottom where the command can be entered, a large textarea, where output can by selected and copied, as well as a search field for filtering the output.
![Console View](../assets/client-3.png)
![Console Filter](../assets/client-5.png)
Available keyboard shortcuts:
| Shortcut | Action |
| --- | --- |
| CTRL + F | Focuses search input |
| CTRL + A | Highlight all output |
| CTRL + C | Copy selection |
| CTRL + V | Paste clipboard |
## Downloads
The **Downloads** view is hidden by default and can be enabled via the menu bar: `Views -> Loot -> Downloads`. By default, it opens in the bottom panel and displays information about the downloaded files on the left and the contents of the file on the right. The content is fetched from the team server when a loot row is selected for the first time.
![Downloads View](../assets/client-8.png)
Right-clicking a row opens a context menu with two options:
- Download: Download the file to disk
- Remove: Ask the team server to remove the loot item from the database
## Screenshots
Similar to the downloads, the **Screenshots** view is hidden by default and can be enabled by selecting `Views -> Loot -> Screenshots`. A preview of the screenshot is shown directly in the operator client. The ../assets/client can again be downloaded to disk by right-clicking the item and selecting `Download`.
![Screenshots View](../assets/client-9.png)
## Eventlog
The **Eventlog** view is shown by default in the top right and displays general team server events, info messages and errors.
![Eventlog View](../assets/client-7.png)

View File

View File

@@ -6,5 +6,4 @@
4. [Operator Client](./4-CLIENT.md)
5. [Listeners](./5-LISTENER.md)
6. [Monarch Agent](./6-AGENT.md)
7. [Modules and Commands](./7-MODULES.md)
8. [Gallery](./8-GALLERY.md)
7. [Modules and Commands](./7-MODULES.md)