PurpleSharp
purplesharp.com
- Free plan
- Windows
- Self-hosted
What PurpleSharp is
PurpleSharp is a free, open-source C# tool for simulating adversary activity in Windows Active Directory environments. Its simulations generate telemetry that detection teams can use to develop analytics, check detection resilience, find visibility gaps, and identify logging pipeline issues. Documentation describes 47 MITRE ATT&CK techniques across the attack life cycle, including execution, persistence, privilege escalation, credential access, lateral movement, discovery, and defense evasion. JSON playbooks can combine techniques and specify variations or technique-level parameters. Local runs use an interactive session after the assembly is copied to the host. Remote runs use Windows SMB and RPC and require administrative credentials on the target, plus network connectivity to TCP ports 445 and 135. Scout tasks can retrieve audit policy, event subscription and PowerShell logging settings, processes, and services. PurpleSharp can export supported techniques to an ATT&CK Navigator layer or import a layer into a JSON playbook. It is self-hosted for Windows, requires .NET Framework 4.5, and is licensed under BSD 3-Clause. Documentation identifies August 2021 v1.3 as the latest release.
Who it suits
PurpleSharp is for detection teams working in Windows Active Directory environments who need to generate attack telemetry and validate analytics. Remote simulations suit teams able to provide target administrative credentials and required network access.
Good to know, and what to watch
- Supports 47 MITRE ATT&CK techniques.
- JSON playbooks support multi-technique simulations.
- Scout tasks retrieve logging settings and system details.
- Can exchange layers with ATT&CK Navigator.
- Free and open-source under BSD 3-Clause.
- Remote runs require target administrative credentials.
- Remote runs require SMB and RPC network access.
- Requires .NET Framework 4.5.
- Latest documented release is August 2021 v1.3.
The verdict
PurpleSharp offers a focused way to generate Windows Active Directory attack telemetry, with playbooks and ATT&CK Navigator support. Its remote requirements and listed release age are important considerations for teams evaluating deployment.
What the maker publishes
- Attack Range
- The demos page includes an item titled “Attack Range + PurpleSharp Integration.” source
- ATT&CK coverage
- The documentation says PurpleSharp supports 47 unique MITRE ATT&CK techniques across the attack life cycle. source
- ATT&CK Navigator integration
- PurpleSharp can export an ATT&CK Navigator layer of supported techniques and import a layer file to create a JSON simulation playbook. source
- Build and download
- The quick start says PurpleSharp can be built with Visual Studio Community 2019 or 2020 and links to a latest-release binary. source
- Cleanup
- PurpleSharp normally removes artifacts created by certain techniques after a simulation, while its no-cleanup option skips that cleanup phase. source
- Cleanup behavior
- PurpleSharp normally deletes artifacts created by certain techniques after a simulation; the /nocleanup option skips cleanup for the relevant technique. source
- Integration
- PurpleSharp integrates with MITRE ATT&CK Navigator to export a layer of supported techniques or import a layer into a JSON simulation playbook. source
- License
- The GitHub README says the project is licensed under the BSD 3-Clause License. source
- Local deployment
- Local simulations run through an interactive session, and the documentation says the requirement is to copy the PurpleSharp assembly to the host. source
- Playbooks
- JSON playbooks can define multi-technique simulations, variations, and technique-specific parameters. source
- Purpose
- PurpleSharp is an open-source C# adversary simulation tool for Windows Active Directory environments. source
- Reconnaissance
- Scout tasks can retrieve remote audit policy, Windows Event Subscription settings, PowerShell logging settings, running processes, and running services. source
- Release currency
- The documentation identifies the August 2021 release as the latest version, and GitHub lists that release as v1.3. source
- Remote deployment
- Remote simulations use native Windows SMB and RPC features to reach remote hosts. source
- Remote requirements
- Remote simulation requires administrative credentials on the target and network connectivity to SMB TCP port 445 and RPC TCP port 135. source
- Requirements
- The maker's GitHub README says .NET Framework 4.5 is required and that the project can be built with Visual Studio Community 2019 or 2020. source
- Support
- The documentation thanks the community as a source of ideas and feedback and names Mauricio Velazco as an author. source
- Use cases
- It generates attack telemetry to help detection teams build and test analytics, validate detection resiliency, find visibility gaps, and identify event logging pipeline issues. source
Checked against the maker's pages on 7 Oct 2026.