Skip to content
Snippets Groups Projects
Commit 6c239d4e authored by Attila Farkas's avatar Attila Farkas
Browse files

Merge branch 'master' into '58-support-windows-boxes'

# Conflicts:
#   requirements.txt
parents c65ee01b cf32cffb
No related branches found
No related tags found
1 merge request!22Resolve "Support Windows boxes"
# Image with everything needed to run Cyber Sandbox Creator.
image: ilyavarne/virtualbox-vagrant-ansible-python:debian
image: registry.gitlab.ics.muni.cz:443/muni-kypo-csc/cyber-sandbox-creator:debian
# Make sure that VirtualBox kernel modules are loaded and install Python dependencies.
before_script:
......@@ -29,7 +29,6 @@ original:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
debian-stretch:
......@@ -40,7 +39,6 @@ debian-stretch:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
debian9:
......@@ -51,7 +49,6 @@ debian9:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
ubuntu:
......@@ -62,7 +59,6 @@ ubuntu:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
kali:
......@@ -79,7 +75,6 @@ kali:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
1-router-1-network-1-host:
......@@ -90,7 +85,6 @@ kali:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
1-router-2-networks-2-hosts:
......@@ -101,7 +95,6 @@ kali:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
1-router-2-networks-2-hosts-ubuntu:
......@@ -112,7 +105,6 @@ kali:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
1-router-2-networks-2-hosts-kali:
......@@ -129,7 +121,6 @@ kali:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
2-routers-2-networks-2-hosts:
......@@ -140,7 +131,6 @@ kali:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
2-routers-4-networks-4-hosts:
......@@ -151,7 +141,6 @@ kali:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
3-routers-5-networks-5-hosts-br:
......@@ -162,7 +151,6 @@ kali:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
3-routers-5-networks-5-hosts-br-ansloc:
......@@ -173,5 +161,4 @@ kali:
when: always
# only run for commits to master branch and merge requests
only:
- master
- merge_requests
\ No newline at end of file
# Cyber Sandbox Creator
Cyber Sandbox Creator is a tool, which can generate portable input files for building lightweight virtual environments using Vagrant and Ansible from a simple YAML definition of topology. The combination of these three tools makes possible to build virtual machines connected with virtual networks even on a desktop computer.
Cyber Sandbox Creator is a tool that can generate portable input files for building lightweight virtual environments using Vagrant and Ansible from a simple YAML definition of topology. The combination of these three tools makes it possible to build virtual machines connected with virtual networks even on a desktop computer.
![usage](doc/sandbox_creator_general.svg "Usage")
## Installation
---
**Note: This is just a quick guide how to install and generate files with Cyber Sandbox Creator. For full description of how to prepare the host device to run the generated environments and how to build the virtual machines, check our [wiki page](https://gitlab.ics.muni.cz/muni-kypo-csc/cyber-sandbox-creator/-/wikis/Installation-and-Usage).**
**Note:** This is just a quick guide how to install and generate files with this tool. For full description of how to prepare the host device to be able run the generated environments and how to build the virtual machines check our [wiki page](https://gitlab.ics.muni.cz/muni-kypo-csc/cyber-sandbox-creator/-/wikis/Installation-and-Usage).
**The latest stable release is available in [Releases](https://gitlab.ics.muni.cz/muni-kypo-csc/cyber-sandbox-creator/-/releases).**
## Installation
### Linux (Ubuntu/Debian)
......@@ -23,43 +27,62 @@ Cyber Sandbox Creator is a tool, which can generate portable input files for bui
2. Install [git](https://git-scm.com/downloads).
3. Clone the project with `git clone https://gitlab.ics.muni.cz/cs4eu/sandbox-creator.git` to an arbitrary folder.
4. Navigate to the project folder (`cd sandbox-creator`).
5. Install Python dependencies using the command `python -m pip install -r .\requirements.txt`.
5. Install Python dependencies using the command `python -m pip install -r requirements.txt`.
## Usage
### Linux (Ubuntu/Debian)
1. After the installation simply run the command `$ python3 create.py topology.yml` to generate files.
1. After the installation, simply run the command `$ python3 create.py topology.yml` to generate intermediate definition files.
2. Navigate to the newly created directory `sandbox` and run `$ vagrant up` to build the virtual environment.
3. The built environment can be deleted using the command `$ vagrant destroy -f`.
### Windows 10
1. Generate files using the command `python create.py --ansible_local topology.yml`.
2. Navigate to the newly created folder `sandbox` and run the command `vagrant up` to build the virtual environment.
2. Navigate to the newly created directory `sandbox` and run `vagrant up` to build the virtual environment.
3. The built environment can be deleted using the command `vagrant destroy -f`.
## License
This project is licensed under the [MIT License](LICENSE).
## Credits
**Cybersecurity Laboratory**\
**[Cybersecurity Laboratory](https://kypo.fi.muni.cz)**\
**Faculty of Informatics**\
**Masaryk University**
**Project lead**: Jan Vykopal
**Lead developer**: Attila Farkas
**Developer**: Jana Ziková
**Technology lead**: Daniel Tovarňák (KYPO cyber range platform)
**Contributors**:
**Supervisor**: Jan Vykopal
- Valdemar Švábenský - user testing
- Daniel Tovarňák (KYPO Cyber Range Platform) - technical advisor
- Kamil Andoniadis (KYPO Cyber Range Platform)
**Contributors**:
**Student contributors:** all students who use the tool for their thesis projects or training
### Acknowledgements
<table>
<tr>
<td>![EU](doc/EU.jpg "EU emblem")</td>
<td>
This software and accompanying documentation is part of a [project](https://cybersec4europe.eu) that has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement No. 830929.
</td>
</tr>
<tr>
<td>![TACR](doc/TACR.png "TACR logo")</td>
<td>This software was developed with the support of the Technology Agency of the Czech Republic (TA ČR) from the National Centres of Competence programme (project identification TN01000077 – [National Centre of Competence in Cybersecurity](https://nc3.cz/)).
</td>
</tr>
</table>
- Valdemar Švábenský
- Kamil Andoniadis (KYPO cyber range platform)
**Student contributors:** Michal Staník, Zdeněk Vydra, Adam Skrášek
## License
This project is licensed under the MIT License - see the LICENSE file for details.
doc/EU.jpg

13.9 KiB

doc/TACR.png

4.96 KiB

Jinja2>=2.10
PyYAML>=3.12
netaddr>=0.7
Jinja2>=2.10.1
PyYAML>=5.3.1
# Vagrantfile generated by Sandbox Creator.
# Generated by Cyber Sandbox Creator
# https://gitlab.ics.muni.cz/muni-kypo-csc/cyber-sandbox-creator
#
# -*- mode: ruby -*-
# vi: set ft=ruby :
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment