Dockersecurityplayground - A Microservices-Based Framework For The Written Report Of Network Safety Together With Penetration Exam Techniques

Docker Security Playground is an application that allows y'all to:

• Create network too network safety scenarios, inwards social club to sympathise network protocols,
  rules, too safety issues past times installing DSP inwards your PC.
• Learn penetration testing techniques past times simulating vulnerability labs scenarios
• Manage a laid of docker-compose project . Main destination of DSP is to larn inwards penetration testing too network security, merely its flexibility allows y'all the creation, graphic editing too managment run / stop of all your docker-compose labs. For to a greater extent than information await at the Labs Managment page.

DSP Features

• Graphic Editor of docker-compose
• Docker Image Management
• GIT Integration
• DSP Repository amongst a laid of network sescurity scenarios

How tin flame I share my labs amongst the world ?
During the installation y'all tin flame create a local surround that has non link amongst git, or y'all tin flame associate a personal repository the the application. This is really useful if y'all desire to portion your piece of work amongst other people.
DSP Repository must convey several requirements, too then I convey created a base of operations DSP Repo Template that y'all tin flame piece of work to create your personal repository.
So, the easiest agency to portion labs is the following:

1. Fork the DSP_Repo project: https://github.com/giper45/DSP_Repo.git
2. During the installation laid github directory param to your forked repository.
3. Now create your labs too portion it!

It is of import that all images that y'all piece of work should endure available to other users, so:

• You tin flame let on on docker hub too then other users tin flame describe your images inwards social club to piece of work your labs.
• You tin flame render dockerfiles within the .docker-images directory, too then users tin flame piece of work build.sh to prepare your images too piece of work your repo.

If y'all ask a "private way" to portion labs y'all should portion the repository inwards other ways, at electrical flow fourth dimension at that spot is no back upward to portion individual repositories.
In DSP y'all tin flame create produce multiple user repositories (Repositories tab)

Prerequisites

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

Installation
Install prerequisites too run:

npm install

Troubleshooting during installation
If y'all convey mistake regarding node-pty module, endeavour to:

• Install build-essentials : (In Ubuntu: apt install -y build-essentials)
• Use nodejs LTS (note-pty has to a greater extent than or less isseus, equally shown here

Update the application:
When y'all update the application it is of import 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

Start
Run

npm starting fourth dimension  

To starting fourth dimension the application. This volition launch a server listening on 8080 (or to a greater extent than or less other if y'all laid convey setted ENV variable inwards index.js file) port of your localhost.
Go to y'all favourite browser too digit localhost:8080. You'll endure redirected on installation page, laid parameters too click install.

Documentation
For documentation most DSP usage acquire to Wiki page:

• Main Page: http://gitlab.comics.unina.it/NS-Thesis/DockerSecurityPlayground_1/wikis/home
• User Guidehttp://gitlab.comics.unina.it/NS-Thesis/DockerSecurityPlayground_1/wikis/user_guide
• Docker Wrapper Image: http://gitlab.comics.unina.it/NS-Thesis/DockerSecurityPlayground_1/wikis/dsp_wrapper_image

It is a lilliputian outdated, I volition update it equally possible !

Docker Wrapper Image
DSP implements a label convention called DockerWrapperImage that allows y'all to create images that expose activity to execute when a lab is running. Look at the doc

Error Debug
MacOS ECONNRESET error:

events.js:183       throw er; // Unhandled 'error' consequence       ^  Error: read ECONNRESET     at _errnoException (util.js:992:11)     at TCP.onread (net.js:618:25)

On Mac it seems that at that spot is to a greater extent than or less work amongst to a greater extent than or less node package, too then inwards social club to solve this run:

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

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

Contributing

1. Fork it!
2. Create your characteristic branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add to a greater extent than or less feature'
4. Push to the branch: git force root my-new-feature
5. Submit a describe request, we'll check

Any Questions?
Use the Issues inwards social club to inquire everything y'all want!.

Links

• DSP Vagrant Box used inwards Blackhat Session
• Blackhat scenario inwards Gitlab

Relevant DSP Repositories

• https://github.com/giper45/DSP_Projects.git : Official DSP Repository
• https://github.com/giper45/DSP_Repo.git : DSP Template to create to a greater extent than or less other repository: fork it to starting fourth dimension creating your personal remote environment
• https://github.com/NS-unina/DSP_Repo.git : Repository created for Network Security Course of Simon Pietro Romano inwards University of the Study inwards Naples, Federico II

Contributors

• Technical support: Gaetano Perrone, Francesco Caturano
• Documentation support Gaetano Perrone, Francesco Caturano
• Application design: Gaetano Perrone, Simon Pietro Romano
• Application development: Gaetano Perrone, Francesco Caturano
• Docker wrapper picture development: Gaetano Perrone, Francesco Caturano

Thanks to Giuseppe Criscuolo for the logo design

Changelog
Got to CHANGELOG.md to come across al the version changes.

Download DockerSecurityPlayground