OnionJuggler

Funktionsreicher Onion-Service-Manager für UNIX-ähnliche Betriebssysteme, geschrieben in POSIX-konformem Shellscript

OnionJuggler ist eine portable Sammlung von Skripten und Dokumentation mit minimalen Anforderungen, die dem Service-Betreiber hilft, seine Zwiebeln zu jonglieren (verwalten).

WARNUNG: «vertraue diesem Repo noch nicht», sichere deine HS-Schlüssel an einem anderen Ort. Dieses Projekt wurde noch nicht veröffentlicht und sollte nur für die Entwicklung betrachtet werden.

Schnelllink zu diesem Repository: git.io/onionjuggler

Inhaltsverzeichnis

• Einführung
  • Bilder
  • Geschichte
  • Ziel
  • Funktionen
• Voraussetzungen
• Kompatibilität
• Anleitung
  • Repository klonen
  • Benutzerdefinierte Variablen setzen
  • Umgebung einrichten
  • Verwendung
• Vorgestellt auf
• Mitwirkende

Einführung

Bilder

Geschichte

Dieses Projekt entstand, nachdem ich die erstaunlichen OnionShare CLI python scripts gesehen hatte, welche ephemere Onion-Dienste ermöglichen, die nie die Festplatte berühren und einfach auf Tails oder Whonix ausgeführt werden können. Nachdem ich dann das RaspiBlitz Onion Service Bash-Script für den Raspberry Pi gesehen hatte, entstand die Idee, es auf jede Debian-Distribution zu portieren. Als die Idee wuchs, stellte die Verwendung von GNU Bash und Linux einen einzelnen Ausfallpunkt dar 1 2, daher war die POSIX-Konformität des Skripts, um mit jedem Unix-ähnlichen System kompatibel zu sein, ein definitives Ziel.

Ziel

Das Ziel dieses Projekts ist:

• Die Verwaltung von Onion-Diensten zu erleichtern, vom Aktivieren eines Dienstes bis zum Hinzufügen einer Client-Autorisierung, wobei die vollen Möglichkeiten der manuellen Dateibearbeitung mit weniger Tipparbeit erhalten bleiben.
• Zu zeigen, dass die Verwaltung des Onion-Dienstes weit mehr umfasst als nur die Verwendung eines Webservers mit Ihren Seiten.
• Verbreitung, von der Quellcode-Ebene (FOSS) bis zur Wirkung, wenn es jedem ermöglicht, den Code auf jedem Betriebssystem, jeder Shell oder jedem Service-Manager auszuführen. Vermeidung eines einzelnen Ausfallpunkts.

Vermeidung eines einzelnen Ausfallpunkts:

• Kernel vom vorherrschenden Linux auch auf BSD und andere Unix-ähnliche Systeme.
• Shell von der vorherrschenden Bash auch auf jede POSIX-Shell wie ksh, (y,d)ash und Zsh (mit sh-Emulation).
• Service-Manager vom vorherrschenden Systemd auch auf RC, OpenRC, SysVinit, Runit.

Die Bearbeitung der Tor-Konfigurationsdatei (torrc) ist nicht schwierig, aber Automatisierung löst das Problem von Fehlkonfigurationen und bietet:

• weniger Zeitaufwand durch die Ausführung eines einzelnen Befehls
• keine Ausfallzeiten durch Zurückweisen ungültiger Konfigurationen, bevor sie angewendet werden
• vollständige Einheitlichkeit
• grafische Oberfläche zur Unterstützung von Einsteigern

Funktionen

• Dienst aktivieren – Verzeichnis erstellen, falls nicht vorhanden (HiddenServiceDir), Zwiebelversion auswählen (HiddenServiceVersion), benutzerdefinierter Socket-Typ (Unix oder TCP) mit beliebig vielen virtuellen Ports sowie Zielen (HiddenServicePort).
• Dienst deaktivieren – Dienstkonfiguration aus der torrc entfernen; der Dienst ist dann nicht mehr erreichbar, kann aber jederzeit wieder aktiviert werden. Optional kann der Dienst bereinigt werden, wobei seine Konfiguration und sein Verzeichnis gelöscht werden, was seine Schlüssel dauerhaft entfernt.
• Dienstadresse erneuern – Fokussiert auf private Onion-Dienste. Falls Sie die Adresse jemals preisgeben, können Sie den Hostnamen ändern. Beachten Sie, dass alle autorisierten Clients getrennt werden und die Dienstschlüssel dauerhaft gelöscht werden.
• Anmeldedaten – Hostname, Clients, torrc-Block, QR-codierter Hostname anzeigen.
• Onion-Authentifizierung – Nur für v3-Onion-Dienste. Dies hängt von der Client- und Server-Konfiguration ab und arbeitet mit einem Schlüsselpaar. Der Client hält den privaten Schlüsselteil (entweder selbst erzeugt – sicherer – oder vom Service-Betreiber bereitgestellt), und der Onion-Dienst-Betreiber hält den öffentlichen Teil. Wenn einer davon
  • Server – Schlüsselpaar erzeugen oder öffentlichen Teil hinzufügen, Client-Namen und ihre öffentlichen Schlüssel aus <HiddenServiceDir>/authorized_clients/<client>.auth auflisten. Wenn ein Client konfiguriert ist, ist der Dienst ohne Authentifizierung nicht erreichbar.
  • Client – Schlüsselpaar erzeugen oder öffentlichen Teil hinzufügen, Ihre <ClientOnionAuthDir>/<SOME_ONION>.auth_private auflisten.
• Onion-Standort – Für öffentliche Onion-Dienste. Sie können Ihre Plainnet-Benutzer mit dieser Anleitung für nginx, apache2 und HTML-Header-Attribute zu Ihrem Onion-Dienst umleiten.
• – Betriebssicherheit

Voraussetzungen

• Allgemein:

  • Unix-ähnliches System.
  • Superuser-Rechte, um Befehle als root und als tor-Benutzer aufzurufen.

• Erforderliche Programme:

  • sh – jede POSIX-Shell: dash 0.5.4+, bash 2.03+, ksh 88+, mksh R28+, yash 2.29+, busybox ash 1.1.3+, zsh 3.1.9+ (zsh --emulate sh) usw.
  • tor >= 0.3.5.7
  • grep >=0.9
  • sed
  • openssl >= 1.1 (Client-Autorisierung – benötigt Algorithmus x25519, daher nicht mit LibreSSL kompatibel)
  • basez >= 1.6.2 (Client-Autorisierung)
  • git (Build)
  • dialog/whiptail (TUI)
  • nginx/apache2 (Webserver)

• Optionale Programme:

  • (lib)qrencode >= 4.1.1 (Auflistung)

• Entwicklungsprogramme:

  • pandoc (Handbuch)
  • shellcheck (Überprüfung)

Kompatibilität

Hauptsächlich auf Debian-Systemen getestet, einschließlich Whonix.

Es kann auf OpenBSD funktionieren –

• auth → wenn Sie basez aus dem Quellcode erstellen, da es nicht in den Ports ist.
• web → nginx oder apache. Die httpd-Konfiguration von OpenBSD war schwierig, den Server-Block sauber zu entfernen.

Bezüglich anderer Betriebssysteme siehe bitte etc/onionjuggler für vorkonfigurierte Einstellungen für Ihr Betriebssystem. Sie wurden nicht alle getestet.

Anleitung

Repository klonen

git clone https://github.com/nyxnor/onionjuggler.git
cd onionjuggler

Umgebung einrichten

Führen Sie innerhalb des geklonten Repositorys Folgendes aus, um die Tor-Verzeichnisse zu erstellen, Handbuchseiten zu generieren und Skripte in den Pfad zu kopieren:

./configure.sh --install

Benutzerdefinierte Variablen setzen

Sie sollten die Standardkonfiguration unter /etc/onionjuggler/onionjuggler.conf nicht ändern, da sie bei jedem Update geändert wird. Ihre lokalen Konfigurationen sollten unter /etc/onionjuggler/conf.d/*.conf abgelegt werden. Aus diesem Ordner werden sie in lexikalischer Reihenfolge ausgewertet, wobei der letzte Wert die Voreinstellungen überschreibt.

Verwendung

Jede Konfiguration und jedes Skript hat eine eigene Handbuchseite und Hilfemeldung; dies ist der beste Weg, um onionjuggler vollständig zu erlernen.

Bevor Sie ein Skript ausführen, um Änderungen vorzunehmen, empfiehlt es sich, die konfigurierten Optionen zu überprüfen. Jedes Skript hat eine --getconf-Option, die die aktuelle, von onionjuggler gelesene Konfiguration ausgibt:

onionjuggler-cli --getconf

Es ist auch möglich, Befehlszeilenoptionen abzurufen, ohne Änderungen vorzunehmen – nützlich, um zu sehen, ob die Zuweisung korrekt ist:

onionjuggler-cli --getopt --service=example --hs-version=3

Zur Verwendung des TUI führen Sie einfach aus:

onionjuggler-tui

So erstellen Sie einen Dienst in der CLI:

onionjuggler-cli --on --service=terminator --socket=tcp --hs-version=3 --port="80:127.0.0.1:80"

Viel mehr ist möglich – lesen Sie die Handbuchseiten.

Vorgestellt auf

• TorBox >= v.0.5.0

Mitwirkende