RedBlueCyberlab

ProjectBrightsun allows for the automatic provisioning of complicated virtual environments through a GUI system. The Project also offers multiple lessoms revolving around the ability to easily generate virtual environments in otder to teach security basics, such as setting up and attacking an Active Directory environment.

Teachers can use ProjectBrightSun to develop lab environments for their students. The students can then re-build the virtual environments easily and quickly if they break something.

Professionals can use ProjectBrightSun to analyze the effects of small changes to an environment on its security. The ability to rapibly deploy and modify virtual environments can be a powerful security tool.

Students can follow ProjectBrightsun's lessons while using our tools to learn more about cybersecurity and prepare themselves for a career in the field.

Getting Started

Required System Specs:

• 16GB+ of RAM
• 60GB+ of free disk space

Prerequisites:

1. Install VirtualBox: https://www.virtualbox.org/wiki/Downloads
   • Version 5.2.8+; Successfully tested on: 5.2.8
2. Install Packer: https://www.packer.io/downloads.html
   • Version 1.2.1+; Successfully tested on: 1.2.1
3. Install Vagrant: https://www.vagrantup.com/downloads.html
   • Version 2.0.2+; Successfully tested on: 2.0.2
4. Install the Vagrant-Reload plugin: vagrant plugin install vagrant-reload
5. Install Git: https://git-scm.com/downloads
6. Install Python 3.4+: https://www.python.org/downloads/release/python-342/
   • Make sure to add Python to the path on Windows machines
7. Install NodeJS: https://nodejs.org/en/download/

Downloads:

• Windows:
• Linux:
• MacOS:

How to build for development:

1. CD to the project directory
2. Run npm init
3. Run npm start. This command is how the application is launched during development.

Development Progress

Project Authors

This project was initially created by Clark Benham, Calvin Krist, Saeed Razavi, and Jake Smith as part of the Synthesis Design II class at the University of Virginia (UVA) for Rodman Engineering Students.

• Calvin Krist (Github, Twitter, LinkedIn)
• Saeed Razavi (Github)
• David Smith (Github, LinkedIn)
• Jake Smith (Github, Twitter, LinkedIn)

Project Contributers

list_of_awesome_contributers

Credit & Acknowledgments

Without these amazing people and tools, we would not have been able to build any of this.

• @clong's Detection Lab
• @joefitzgerald's Packer Windows Templates
• @kaorimatz's Packer Linux Templates
• @hahndorf's Blog post on Installing Windows Features on the Command Line
• @Stuk's JSZip
• @rndme's download
• @mariahamaris for acting as a client to our project team and for her support throughout the project
• @VernMcC for acting as a client to our project team and for his support throughout the project

Technology Stack

• Oracle's VirtualBox: Virtualization software
• HashiCorp's Packer: Automated building of virtual machines
• HashiCorp's Vagrant: Virtual environment management
• Microsoft's Developer Virtual Machines: Source of Windows VMs
• Canonical's Ubuntu: Source of Ubuntu VMs
• Microsoft's Windows Powershell: Scripting language to automate setup of Windows VMs
• Shell Scripts: Scripting language to automate setup of Linux VMs
• work_in_progress

Miscellaneous Notes

• User Story Template: As a __role__ I want __feature__ so that __benefit__