DockerSecurityPlayground

Docker Security Playground es una aplicación que te permite:

• Crear escenarios de red y seguridad de red, para entender protocolos de red, reglas y problemas de seguridad instalando DSP en tu PC.
• Aprender técnicas de pruebas de penetración simulando escenarios de laboratorios de vulnerabilidades.
• Gestionar un conjunto de proyectos docker-compose. El objetivo principal de DSP es aprender en pruebas de penetración y seguridad de red, pero su flexibilidad te permite la creación, edición gráfica y gestión (ejecutar/detener) de todos tus laboratorios docker-compose.

Instalación

El flujo de trabajo de instalación recomendado para DSP es usando una máquina virtual Kali:

• Instalar docker y docker-compose
• Instalar la última versión estable de Node.js
• Instalar dsp

Aquí los pasos para instalar DSP en una máquina virtual Kali. Sigue pasos similares para otras distribuciones de Linux, pero asegúrate de instalar todos los requisitos.

1. Instalar los requisitos de DSP:

sudo apt update && sudo apt install -y docker.io docker-compose nodejs npm git

Nota (problema con el keyring de Kali 2025).

Si tienes el siguiente problema durante la instalación:

root@kitploit:~

Fetched 34.0 kB in 1s (58.4 kB/s)
Error: no se pudo obtener http://http.kali.org/kali/dists/kali-rolling/InRelease  Las siguientes firmas no se pudieron verificar porque la clave pública no está disponible: NO_PUBKEY ED65462EC8D5E4C5
Warning: Some index files failed to download. They have been ignored, or old ones used instead.

Necesitas añadir la clave faltante:

root@kitploit:~

wget https://http.kali.org/kali/pool/main/k/kali-archive-keyring/kali-archive-keyring_2025.1_all.deb
sudo dpkg -i kali-archive-keyring_2025.1_all.deb
rm kali-archive-keyring_2025.1_all.deb

2. Habilitar el inicio de Docker al arrancar y configurar tu usuario actual para usar Docker sin sudo:

sudo systemctl enable docker
sudo groupadd docker
sudo usermod -aG docker $USER

3. Cerrar sesión e iniciar sesión (es necesario para permitir que tu usuario actual use Docker sin sudo), y verificar que puedes usar Docker sin sudo:

docker ps

También, verifica que docker compose funcione:

docker compose --version # o docker-compose --version para versiones antiguas

También verifica la instalación de npm y Node.js:

node -v
npm -v

Nota para usuarios de macOS M1

Es posible ejecutar DSP en un host M1 habilitando Rosetta, pero recomiendo crear una máquina virtual Kali con UTM o VMware Fusion, seguir los pasos de instalación anteriores e instalar el paquete binfmt-misc para ejecutar imágenes x86 en arquitectura ARM.

sudo apt install binfmt-support qemu-user-static

Reinicia la máquina.

Luego, usa el contenedor de Tonisiigi para registrar todos los intérpretes para las diferentes arquitecturas:

docker run --privileged --rm tonistiigi/binfmt --install amd64

Verifica que las imágenes de Docker puedan ejecutarse en tu máquina:

docker run --rm -it --platform linux/amd64 ubuntu uname -m

4. Ahora puedes instalar DSP:

git clone https://github.com/DockerSecurityPlayground/DSP.git 
cd DSP 
npm install 

Cuando la instalación se haya completado, puedes iniciar DSP:

npm start

DSP se ejecutará en "http://localhost:18181" .

Nota para usar Wireshark en Kali: sugiero usar el navegador Chromium, ya que el contenedor de Wireshark usa algunos códecs que no son compatibles con Firefox en Kali. Puedes iniciar Chromium simplemente escribiendo "chromium" en la terminal.

El primer paso será instalar todas las carpetas necesarias en la máquina actual.

También puedes automatizar este paso de instalación usando la variable de entorno

export DSP_AUTOINSTALL=1  && npm start

Ejecutar DSP en máquina virtual - exponer en la interfaz 0.0.0.0

Si quieres usar el navegador de tu host, puedes exponer en la interfaz 0.0.0.0. Si quieres exponer en otra interfaz, cambia la variable de entorno DSP_IFACE:

export DSP_IFACE="0.0.0.0"

Ahora puedes usar DSP en la interfaz remota.

Limpiar DSP

Si algo sale mal, puedes restablecer DSP a los valores de fábrica usando el siguiente comando:

npm run uninstall  

Esto eliminará todo, y podrás iniciar DSP desde el paso de instalación.

Repositorio Oficial

DSP_Repo contiene laboratorios oficiales de DSP. Contribuye a DSP creando nuevos laboratorios DSP.

¿Cómo puedo compartir mis laboratorios con el mundo?

Durante la instalación puedes crear un entorno local que no tenga enlace con git, o puedes asociar un repositorio personal a la aplicación. Esto es muy útil si quieres compartir tu trabajo con otras personas.
El repositorio de DSP debe cumplir varios requisitos, por lo que he creado una plantilla base de repositorio DSP que puedes usar para crear tu repositorio personal.
Por lo tanto, la forma más fácil de compartir laboratorios es la siguiente:

1. Haz un fork del proyecto NS-Unina: https://github.com/NS-unina/DSP_Repo.git
2. Durante la instalación, establece el parámetro de directorio de github a tu repositorio bifurcado.
3. ¡Ahora crea tus laboratorios y compártelos!

Es importante que todas las imágenes que uses estén disponibles para otros usuarios, por lo tanto:

• Puedes publicar en Docker Hub para que otros usuarios puedan descargar tus imágenes y usar tus laboratorios.
• Puedes proporcionar archivos Docker dentro del directorio .docker-images, para que los usuarios puedan usar build.sh para construir tus imágenes y usar tu repositorio.

Si necesitas una "forma privada" de compartir laboratorios, debes compartir el repositorio de otras maneras; actualmente no hay soporte para compartir repositorios privados.

En DSP puedes gestionar múltiples repositorios de usuario (pestaña Repositorios).

Características de DSP

• Editor gráfico de docker-compose
• Gestión de imágenes Docker y archivos Dockerfile
• Integración con GIT
• Repositorio DSP con un conjunto de escenarios de seguridad de red

¿Alguna pregunta?

Si tienes un problema, puedes usar la sección de Issues.

Pruebas

Para ejecutar una prueba:

mocha test/<test-nodejs-file.js>   

las pruebas usan el método helper.start() para inicializar el entorno de prueba:

• Se crea una configuración de prueba
• El directorio home se simula, de esta manera es posible usar el directorio interno de dsp para las pruebas.

Solución de problemas

Durante la instalación de DSP

Si tienes el siguiente error durante la instalación:

[2020-12-14T10:18:21.854Z]  INFO: DockerSecurityPlayground/1536 on vagrant: [DOCKER ACTIONS - DOWNLOAD IMAGE]
events.js:174
      throw er; // Unhandled 'error' event
      ^

Error: connect EACCES /var/run/docker.sock
    at PipeConnectWrap.afterConnect [as oncomplete] (net.js:1107:14)
Emitted 'error' event at:
    at Socket.socketErrorListener (_http_client.js:401:9)
    at Socket.emit (events.js:198:13)
    at emitErrorNT (internal/streams/destroy.js:91:8)
    at emitErrorAndCloseNT (internal/streams/destroy.js:59:3)
    at process._tickCallback (internal/process/next_tick.js:63:19)

Verifica dos cosas:

1. Docker está instalado
2. El usuario actual está en el grupo docker

Para probarlo:

docker ps   

NO USES SUDO si estás ejecutando DSP con un usuario normal. Si tienes el siguiente error:

vagrant@vagrant:~/git/DockerSecurityPlayground$ docker ps
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get http://%2Fvar%2Frun%2Fdocker.sock/v1.24/containers/json: dial unix /var/run/docker.sock: connect: permission denied

Necesitas añadir tu usuario al grupo docker: https://docs.docker.com/engine/install/linux-postinstall/

$ sudo groupadd docker
$ sudo usermod -aG docker $USER

Cierra sesión e inicia sesión Ahora necesitas limpiar DSP:

npm run uninstall  

Y ahora todo debería funcionar.

Error en macOS

Error ECONNRESET en macOS:

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

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

En Mac parece que hay algún problema con algún paquete de Node, así que para solucionarlo ejecuta:

MacBook-Pro:DockerSecurityPlayground gaetanoperrone$ npm install [email protected] --save-dev --save-exact

Otra información aquí: http://gitlab.comics.unina.it/NS-Thesis/DockerSecurityPlayground_1/wikis/docker-operation-errors

Cómo contribuir

1. ¡Haz un fork!
2. Crea tu rama de características: git checkout -b my-new-feature
3. Haz commit de tus cambios: git commit -am 'Añadir alguna característica'
4. Sube a la rama: git push origin my-new-feature
5. Envía un pull request, lo revisaremos.

¿Alguna pregunta?

Usa la sección de Issues para preguntar todo lo que quieras.

Enlaces

• 
• https://github.com/NS-unina/DSP_Repo.git : Repositorio creado para el curso de Seguridad de Redes de Simon Pietro Romano en la Universidad de los Estudios de Nápoles, Federico II

Contribuidores

Gracias a Giuseppe Criscuolo y Alessandro Placido Luise por el diseño del logotipo.

Registro de cambios

Ve a CHANGELOG.md para ver todos los cambios de versión.

Citar este trabajo

Si usas Docker Security Playground para tu actividad de investigación, cita el siguiente artículo publicado por el IEEE (Instituto de Ingenieros Eléctricos y Electrónicos) https://ieeexplore.ieee.org/document/8169747

@INPROCEEDINGS{8169747,
  author={Perrone, G. and Romano, S. P.},
  booktitle={2017 Principles, Systems and Applications of IP Telecommunications (IPTComm)}, 
  title={The Docker Security Playground: A hands-on approach to the study of network security}, 
  year={2017},
  volume={},
  number={},
  pages={1-8},
  keywords={Security;Communication networks;Tools;Containers;Virtualization;Standards},
  doi={10.1109/IPTCOMM.2017.8169747}}

Licencia

Este proyecto está bajo la licencia MIT.