VECTR is a tool that facilitates tracking of your red and blue team testing activities to measure detection and prevention capabilities across different attack scenarios. VECTR provides the ability to create assessment groups, which consist of a collection of Campaigns and supporting Test Cases to simulate adversary threats. Campaigns can be broad and span activities across the kill chain, from initial compromise to privilege escalation and lateral movement and so on, or can be narrow in scope to focus on specific detection layers, tools, and infrastructure. VECTR is designed to promote full transparency between offense and defense, encourage training between team members, and improve detection & prevention success rates across the environment.

VECTR is focused on common indicators of attack and behaviors that may be carried out by any number of threat actor groups, with varying objectives and levels of sophistication. VECTR can also be used to replicate the step-by-step TTPs associated with specific groups and malware campaigns, however its primary purpose is to replicate attacker behaviors that span multiple threat actor groups and malware campaigns, past, present and future. VECTR is meant to be used over time with targeted campaigns, iteration, and measurable enhancements to both red team skills and blue team detection capabilities. Ultimately the goal of VECTR is to make a network resilient to all but the most sophisticated adversaries and insider attacks.

Getting Started

Hardware Requirements

  • Internet access to GitHub and DockerHub
  • 2+ cores recommended
  • minimum 4gb ram
  • 100+Gb free space

If using AWS, t3a.medium or equivalent instance type recommended

Linux Distribution-specific Dependency Installation Instructions

Ubuntu Dependency Installation

CentOS/RHEL Dependency Installation

Linux Mint Dependency Installation

General Notes

This guide was written with the above Operating Systems in mind. Installs on other Operating systems are not supported.

VECTR is a large web application and associated ecosystem. For easiest installation the VECTR machine requires GitHub/DockerHub internet access for Docker containers to update, and to download files from the VECTR GitHub as needed. The configuration should be entirely contained within the .env file and deployed by the containers themselves.

VECTR Installation Instructions

Clone the VECTR git repository into a folder where VECTR will live. This is a permanent directory where the application files will live.

Recommendation:

/opt/vectr

Download