DockerSecurityPlayground

Docker Security Playground is an application that allows you to:

Create network and network security scenarios, in order to understand network protocols,
rules, and security issues by installing DSP in your PC.
Learn penetration testing techniques by simulating vulnerability labs scenarios
Manage a set of docker-compose project . Main goal of DSP is to learn in penetration testing and network security, but its flexibility allows you the creation, graphic editing and managment run / stop of all your docker-compose labs.

How To Use

Follow DSP channel to learn how to use DSP. You can also use wiki documentation to understand how you can use DSP.
Follow Installation and Start steps to run DSP.

Installation And Start

Docker-Mode

You can use DSP Image provided at the following link

git clone https://github.com/giper45/dsp-docker-image  
cd dsp-docker-image  
docker-compose up

Normal-Mode

Install DSP Requirements:

Nodejs (v 7 or later)
git
docker
docker-compose
compiler tools (g++, c, c++)

Install node dependencies and run:

npm install

Run:

npm start

To start the application. This will launch a server listening on 8080 (or another if you set have setted ENV variable in index.js file) port of your localhost.

With your favourite browser go to http://localhost:8080. You'll be redirected on installation page, set parameters and click install.

Update the application:

When you update the application it is important to update the npm packages (The application uses mydockerjs, a npm docker API that I am developing during DSP development: https://www.npmjs.com/package/mydockerjs)

npm run update

Official Repository

DSP_Projects contains official DSP labs. Contribute to DSP by creating new DSP Labs

How can I share my labs with the world ?

During the installation you can create a local environment that has not link with git, or you can associate a personal repository the the application. This is very useful if you want to share your work with other people.
DSP Repository must have several requirements, so I have created a base DSP Repo Template that you can use to create your personal repository.
So, the easiest way to share labs is the following:

Fork the DSP_Repo project: https://github.com/giper45/DSP_Repo.git
During the installation set github directory param to your forked repository.
Now create your labs and share it!

It is important that all images that you use should be available to other users, so:

You can publish on docker hub so other users can pull your images in order to use your labs.
You can provide dockerfiles inside the .docker-images directory, so users can use build.sh to build your images and use your repo.

If you need a "private way" to share labs you should share the repository in other ways, at current time there is no support to share private repositories.

In DSP you can manage multiple user repositories (Repositories tab)

DSP Features

Graphic Editor of docker-compose
Docker Image and Dockerfile Management
GIT Integration
DSP Repository with a set of network security scenarios

Troubleshooting during installation

If you have error regarding node-pty module, try to:

Install build-essentials : (In Ubuntu: apt install -y build-essentials)
Use nodejs LTS (note-pty has some isseus, as shown here

Any question ?

If you have a problem you can use Issue section.

Docker Wrapper Image

DSP implements a label convention called DockerWrapperImage that allows you to create images that expose action to execute when a lab is running. Look at the doc

Error Debug

MacOS ECONNRESET error:

events.js:183
      throw er; // Unhandled 'error' event
      ^

Error: read ECONNRESET
    at _errnoException (util.js:992:11)
    at TCP.onread (net.js:618:25)

On Mac it seems that there is some problem with some node package, so in order to solve this run:

MacBook-Pro:DockerSecurityPlayground gaetanoperrone$ npm install ws@3.3.2 --save-dev --save-exact

Other info here: http://gitlab.comics.unina.it/NS-Thesis/DockerSecurityPlayground_1/wikis/docker-operation-errors

Contributing

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request, we'll check

Any Questions?

Use the Issues in order to ask everything you want!.

Relevant DSP Repositories

https://github.com/giper45/DSP_Projects.git : Official DSP Repository
https://github.com/giper45/DSP_Repo.git : DSP Template to create another repository: fork it to start creating your personal remote environment
https://github.com/NS-unina/DSP_Repo.git : Repository created for Network Security Course of Simon Pietro Romano in University of the Study in Naples, Federico II

Contributors

_gx1 🐛 💻 🖋 🎨 📖 🚧 📆	_{Simon Pietro Romano} 🎨 📖 📆	_catuhub 🐛 💻 🎨 📖 🚧 📆	_{Giuseppe Di Terlizzi} 💻	_Alessandro 📖 📹 🖋	_Roberto 💻 🖋 🚇	_the-licato 🚇
_{Gabriele Previtera} 💻 📢