DockerSecurityPlayground

Docker Security Playground ist eine Anwendung, die Folgendes ermöglicht:

• Erstellung von Netzwerk- und Netzwerksicherheitsszenarien, um Netzwerkprotokolle, Regeln und Sicherheitsprobleme zu verstehen, indem DSP auf Ihrem PC installiert wird.
• Erlernen von Penetration Testing Techniken durch Simulation von Schwachstellen-Labs.
• Verwaltung einer Reihe von Docker-Compose-Projekten. Das Hauptziel von DSP ist das Lernen im Bereich Penetration Testing und Netzwerksicherheit, aber seine Flexibilität erlaubt die Erstellung, grafische Bearbeitung und Verwaltung (Starten/Stoppen) aller Ihrer Docker-Compose-Labs.

Installation

Der empfohlene Installationsablauf für DSP ist die Verwendung einer Kali-VM:

• Installieren Sie Docker und Docker-Compose
• Installieren Sie die neueste stabile Node.js-Version
• Installieren Sie DSP

Hier die Schritte zur Installation von DSP auf einer Kali-VM. Befolgen Sie ähnliche Schritte für andere Linux-Distributionen, stellen Sie jedoch sicher, dass alle Anforderungen installiert sind.

1. Installieren Sie die DSP-Anforderungen:

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

Hinweis (Kali-Keyring-Problem 2025).

Falls während der Installation folgendes Problem auftritt:

root@kitploit:~

Fetched 34.0 kB in 1s (58.4 kB/s)
Warning: Failed to fetch http://http.kali.org/kali/dists/kali-rolling/InRelease  The following signatures couldn't be verified because the public key is not available: NO_PUBKEY ED65462EC8D5E4C5
Warning: Some index files failed to download. They have been ignored, or old ones used instead.

Fügen Sie den fehlenden Schlüssel hinzu:

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. Aktivieren Sie den Docker-Start beim Booten und konfigurieren Sie Ihren aktuellen Benutzer, um Docker ohne sudo zu verwenden:

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

3. Melden Sie sich ab und wieder an (erforderlich, damit Ihr aktueller Benutzer Docker ohne sudo verwenden kann) und überprüfen Sie, dass Sie Docker ohne sudo nutzen können:

docker ps

Überprüfen Sie auch, ob Docker Compose funktioniert:

docker compose --version # oder docker-compose --version für ältere Versionen

Überprüfen Sie außerdem die npm- und Node.js-Installation:

node -v
npm -v

Hinweis für macOS M1-Benutzer

Es ist möglich, DSP auf einem M1-Host mit Rosetta auszuführen, aber ich empfehle dringend, eine Kali-VM mit UTM oder VMware Fusion zu erstellen, die vorherigen Installationsschritte zu befolgen und das Paket binfmt-misc zu installieren, um x86-Images auf der ARM-Architektur auszuführen.

sudo apt install binfmt-support qemu-user-static

Starten Sie die Maschine neu.

Verwenden Sie dann den Tonisiigi-Container, um alle Interpreter für die verschiedenen Architekturen zu registrieren:

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

Überprüfen Sie, ob Docker-Images auf Ihrer Maschine laufen:

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

4. Jetzt können Sie DSP installieren:

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

Wenn die Installation abgeschlossen ist, können Sie DSP starten:

npm start

DSP wird unter „http://localhost:18181" laufen.

Hinweis zur Verwendung von Wireshark auf Kali: Ich empfehle die Verwendung des Chromium-Browsers, da der Wireshark-Container einige Codecs verwendet, die von Firefox auf Kali nicht unterstützt werden. Sie können Chromium starten, indem Sie einfach „chromium" im Terminal eingeben.

Der erste Schritt wird sein, alle erforderlichen Ordner auf der aktuellen Maschine zu installieren.

Sie können diesen Installationsschritt auch automatisieren, indem Sie die Umgebungsvariable verwenden:

export DSP_AUTOINSTALL=1 && npm start

DSP in einer virtuellen Maschine ausführen – auf 0.0.0.0-Schnittstelle verfügbar machen

Wenn Sie Ihren Host-Browser verwenden möchten, können Sie DSP auf der 0.0.0.0-Schnittstelle verfügbar machen. Wenn Sie eine andere Schnittstelle verwenden möchten, ändern Sie die Umgebungsvariable DSP_IFACE:

export DSP_IFACE="0.0.0.0"

Jetzt können Sie DSP über eine entfernte Schnittstelle nutzen.

DSP zurücksetzen

Wenn etwas schiefgeht, können Sie DSP mit dem folgenden Befehl auf die Werkseinstellungen zurücksetzen:

npm run uninstall

Dies löscht alles und Sie können DSP ab dem Installationsschritt erneut starten.

Offizielles Repository

DSP_Repo enthält offizielle DSP-Labs. Tragen Sie zu DSP bei, indem Sie neue DSP-Labs erstellen.

Wie kann ich meine Labs mit der Welt teilen?

Während der Installation können Sie eine lokale Umgebung erstellen, die keine Verbindung zu Git hat, oder Sie können ein persönliches Repository mit der Anwendung verknüpfen. Dies ist sehr nützlich, wenn Sie Ihre Arbeit mit anderen teilen möchten. Ein DSP-Repository muss bestimmte Anforderungen erfüllen. Daher habe ich eine DSP-Repository-Vorlage erstellt, die Sie verwenden können, um Ihr persönliches Repository zu erstellen. Der einfachste Weg, Labs zu teilen, ist daher der folgende:

1. Forken Sie das NS-Unina-Projekt: https://github.com/NS-unina/DSP_Repo.git
2. Setzen Sie während der Installation den Parameter für das GitHub-Verzeichnis auf Ihr geforktes Repository.
3. Jetzt können Sie Ihre Labs erstellen und teilen!

Es ist wichtig, dass alle von Ihnen verwendeten Images für andere Benutzer verfügbar sind. Daher:

• Sie können Images auf Docker Hub veröffentlichen, sodass andere Benutzer Ihre Images pullen können, um Ihre Labs zu nutzen.
• Sie können Dockerfiles im .docker-images-Verzeichnis bereitstellen, sodass Benutzer build.sh verwenden können, um Ihre Images zu bauen und Ihr Repository zu nutzen.

Wenn Sie eine „private Möglichkeit" zum Teilen von Labs benötigen, sollten Sie das Repository auf andere Weise teilen. Derzeit wird das Teilen privater Repositories nicht unterstützt.

In DSP können Sie mehrere Benutzer-Repositories verwalten (Tab „Repositories").

DSP-Funktionen

• Grafischer Editor für Docker-Compose
• Verwaltung von Docker-Images und Dockerfiles
• Git-Integration
• DSP-Repository mit einer Reihe von Netzwerksicherheitsszenarien

Fragen?

Wenn Sie ein Problem haben, nutzen Sie den Issue-Bereich.

Tests

Um einen Test auszuführen:

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

Tests verwenden die Methode helper.start(), um die Testumgebung zu initialisieren:

• Es wird eine Testkonfiguration erstellt.
• Das Home-Verzeichnis wird gemockt, sodass das interne DSP-Verzeichnis für Tests verwendet werden kann.

Fehlerbehebung

Während der DSP-Installation

Falls während der Installation folgender Fehler auftritt:

[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)

Überprüfen Sie zwei Dinge:

1. Docker ist installiert.
2. Der aktuelle Benutzer befindet sich in der Gruppe docker.

Testen Sie es mit:

docker ps

VERWENDEN SIE KEIN SUDO, wenn Sie DSP mit einem normalen Benutzer ausführen. Falls folgender Fehler auftritt:

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

Müssen Sie Ihren Benutzer zur Gruppe docker hinzufügen: https://docs.docker.com/engine/install/linux-postinstall/

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

Melden Sie sich ab und wieder an. Setzen Sie nun DSP zurück:

npm run uninstall

Danach sollte alles funktionieren.

macOS-Fehler

MacOS ECONNRESET-Fehler:

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

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

Auf dem Mac scheint es ein Problem mit einem Node-Paket zu geben. Führen Sie Folgendes aus, um das Problem zu beheben:

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

Weitere Informationen hier: http://gitlab.comics.unina.it/NS-Thesis/DockerSecurityPlayground_1/wikis/docker-operation-errors

Mitwirken

1. Forken Sie das Repository!
2. Erstellen Sie einen Feature-Branch: git checkout -b my-new-feature
3. Committen Sie Ihre Änderungen: git commit -am 'Add some feature'
4. Pushen Sie den Branch: git push origin my-new-feature
5. Reichen Sie einen Pull-Request ein, wir prüfen ihn.

Fragen?

Nutzen Sie die Issues , um alles zu fragen, was Sie möchten!

Links

• 
• https://github.com/NS-unina/DSP_Repo.git : Repository erstellt für den Netzwerksicherheitskurs von Simon Pietro Romano an der Universität Federico II in Neapel.

Mitwirkende

Dank an Giuseppe Criscuolo und Alessandro Placido Luise für das Logo-Design.

Änderungsprotokoll

Gehen Sie zu CHANGELOG.md, um alle Versionsänderungen zu sehen.

Diese Arbeit zitieren

Wenn Sie Docker Security Playground für Ihre Forschungstätigkeit verwenden, zitieren Sie das folgende, von der IEEE (Institute of Electrical and Electronics Engineers) veröffentlichte Paper: 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}}

Lizenz

Dieses Projekt steht unter der MIT-Lizenz.