<!-- Copyright (c) 2026 defconxt. All rights reserved. -->
<!-- Licensed under AGPL-3.0 — see LICENSE file for details. -->
<!-- NERF is a trademark of defconxt. -->
---
name: deploying-covenant-framework
description: >-
  Deploy Covenant C2 framework for .NET-based adversary simulation including Grunt listeners, launcher generation, and task execution through the web interface.
domain: cybersecurity
subdomain: c2-frameworks
tags:
  - covenant
  - grunt
  - dotnet
  - adversary-simulation
version: "1.0"
author: defconxt
license: AGPL-3.0
metadata:
  mitre-attack: ["T1059.001"]
  frameworks: ["MITRE ATT&CK"]
  tools: ["covenant", "dotnet", "docker"]
---

# Deploying Covenant Framework

## Overview

Deploy Covenant C2 framework for .NET-based adversary simulation including Grunt listeners, launcher generation, and task execution through the web interface.

## Prerequisites

| Tool / Requirement | Details |
|---|---|
| `covenant` | Security tooling |
| `dotnet` | Security tooling |
| `docker` | Security tooling |
| Covenant installation, .NET SDK, Docker (optional), target Windows environment | Environment requirement |

## Quick Reference

```bash
# Quick start commands
node scripts/agent.js --help
docker run -d -p 7443:7443 -p 80:80 -p 443:443 covenant
```

## Workflow

### Step 1: Deploy Covenant

```bash
docker run -d -p 7443:7443 -p 80:80 -p 443:443 covenant
```

### Step 2: Configure Listener

```bash
node scripts/agent.js configure --listener https --port 443
```

### Step 3: Generate Launcher

```bash
node scripts/agent.js launcher --type powershell --listener https
```

## Detection

```yaml
title: Covenant Framework Detection
id: 14464a5e-c19f-4435-b748-79a1f58fa051
status: experimental
description: Detects suspicious activity related to deploying covenant framework techniques in c2 frameworks context
logsource:
  category: network_connection
  product: windows
detection:
  selection:
    DestinationPort: 443
    Initiated: "true"
  condition: selection
level: high
tags:
  - attack.t1059.001
  - attack.command_and_control
falsepositives:
  - Authorized penetration testing tools during scheduled assessments
```


**Detection Opportunities**

| Indicator | Source | Detection Logic |
|---|---|---|
| Covenant Framework Detection | windows/network_connection | Sigma rule (high) |
| ATT&CK Coverage | MITRE ATT&CK | T1059.001 |

## Verification

- **Verify deployment**: `node scripts/agent.js verify --component server`
- **Confirm listener**: `node scripts/agent.js verify --component listener`

## References

- MITRE ATT&CK: T1059.001
- Frameworks: MITRE ATT&CK
- Tools: covenant, dotnet, docker
