Process Explorer fixed

This commit is contained in:
marcos.luna
2025-10-29 12:51:37 +01:00
parent b194f13cf6
commit aeb74259c7
7 changed files with 342 additions and 22 deletions
+81
View File
@@ -82,6 +82,87 @@ The agent will be cross-compiled for Windows using MinGW in a Docker container.
---
## 🔨 Customizing Cazalla
If you've forked Cazalla or made local changes and want to use your customized version, you need to configure Mythic to use local builds instead of remote images.
### Making Changes Work
By default, Mythic may use pre-built remote images for faster deployment. However, if you've made local changes to the agent code, translator, or any Python files, you need to configure Mythic to use your local build context.
#### Configure Build Variables
After installing Cazalla, Mythic will add these variables to your `~/Mythic/.env` file:
```bash
# Use local build context instead of remote image
CAZALLA_USE_BUILD_CONTEXT="true"
# Use direct mount instead of Docker volume (recommended for development)
CAZALLA_USE_VOLUME="false"
# Optional: Remote image URL (only used if USE_BUILD_CONTEXT is false)
CAZALLA_REMOTE_IMAGE="ghcr.io/your-org/cazalla:v1.0.0"
```
#### Variables Explanation
- **`CAZALLA_USE_BUILD_CONTEXT`**:
- Set to `"true"` to build from your local `Dockerfile` and include your local changes
- Set to `"false"` (default) to use the pre-built remote image
- **Important**: You must set this to `"true"` if you've modified any files!
- **`CAZALLA_USE_VOLUME`**:
- Set to `"false"` (default) to mount the local folder directly into the container
- Set to `"true"` to use a Docker volume instead
- Direct mount is better for development as changes are immediately visible
- **`CAZALLA_REMOTE_IMAGE`** (optional):
- Specifies a pre-built remote image URL
- Only used when `CAZALLA_USE_BUILD_CONTEXT="false"`
#### Apply Changes
After modifying these variables, rebuild the container:
```bash
cd ~/Mythic
sudo ./mythic-cli build cazalla
```
#### Verifying Your Changes
1. Make your code changes
2. Set `CAZALLA_USE_BUILD_CONTEXT="true"` in `~/Mythic/.env`
3. Run `sudo ./mythic-cli build cazalla`
4. Check logs: `sudo docker logs cazalla_translator`
If changes still don't appear:
- Verify the `Dockerfile` copies your modified files (see line 39: `COPY ./ /Mythic/cazalla/`)
- Check that file paths in the Dockerfile match your directory structure
- Ensure you're editing files in the correct location (inside `Payload_Type/cazalla/`)
#### Example: Customizing Agent Code
```bash
# 1. Edit agent C code
vim Payload_Type/cazalla/cazalla/agent_code/cazalla/comandos.c
# 2. Ensure build context is enabled
echo 'CAZALLA_USE_BUILD_CONTEXT="true"' >> ~/Mythic/.env
# 3. Rebuild the container
cd ~/Mythic
sudo ./mythic-cli build cazalla
# 4. Rebuild a payload from the UI
# Your changes will now be included in the compiled agent
```
For more information, see the [Mythic documentation on customizing public agents](https://docs.mythic-c2.net/customizing/customizing-public-agent).
---
## 🛠️ Supported Commands
### File System Operations