OnionJuggler

Gestore di servizi onion ricco di funzionalità per sistemi operativi simili a UNIX, scritto in shellscript conforme a POSIX

OnionJuggler è una raccolta di script e documentazione con requisiti minimi e portabile, progettata per aiutare l'operatore di servizi a gestire (juggling) le proprie onion.

ATTENZIONE: non fidarti ancora di questo repository, esegui il backup delle tue chiavi HS in un'altra posizione. Questo progetto non è stato rilasciato e deve essere considerato solo per lo sviluppo.

Collegamento rapido a questo repository: git.io/onionjuggler

Table of Contents

• Introduzione
  • Immagini
  • Storia
  • Obiettivo
  • Caratteristiche
• Requisiti
• Compatibilità
• Istruzioni
  • Clonare il repository
  • Impostare variabili personalizzate
  • Configurare l'ambiente
  • Utilizzo
• In primo piano su
• Contributori

Introduzione

Immagini

Storia

Questo progetto è stato avviato dopo aver visto gli straordinari script Python CLI di OnionShare, che permettono servizi onion effimeri che non toccano mai il disco e possono essere eseguiti facilmente su Tails o Whonix. Poi, dopo aver visto lo script bash per servizi onion su Raspberry Pi di RaspiBlitz, è nata l'idea di portarlo su qualsiasi distribuzione Debian. Man mano che l'idea cresceva, l'uso di GNU Bash e Linux rappresentava un singolo punto di fallimento 1 2, quindi rendere lo script conforme a POSIX per essere compatibile con qualsiasi sistema Unix-like è diventato un obiettivo definitivo.

Obiettivo

L'obiettivo di questo progetto è:

• facilitare la gestione dei servizi onion, dall'attivazione di un servizio all'aggiunta dell'autorizzazione client, offrendo tutte le funzionalità che si avrebbero modificando manualmente i file, ma con meno digitazione.
• mostrare che la gestione del servizio onion è molto più che usare un server web con le proprie pagine.
• distribuzione, a livello di codice sorgente (FOSS) e per l'effetto che ha quando permette a chiunque di eseguire il codice su qualsiasi sistema operativo, shell o gestore di servizi. Mitigazione da un singolo punto di fallimento.

Mitigazione da un singolo punto di fallimento:

• Kernel dal predominante Linux anche a BSD e qualsiasi altro sistema Unix-like.
• Shell dal predominante Bash anche a qualsiasi shell POSIX come ksh, (y,d)ash e Zsh (emulando sh).
• Gestore di servizi dal predominante Systemd anche a RC, OpenRC, SysVinit, Runit.

Modificare il file di configurazione di tor (torrc) non è difficile, ma l'automazione risolve i problemi di errata configurazione e permette di avere:

• meno tempo speso eseguendo un singolo comando su una riga
• nessun downtime rifiutando configurazioni non valide prima di applicarle
• completa uniformità
• interfaccia grafica per aiutare i principianti

Caratteristiche

• Abilitare servizio - Creare directory se non esiste (HiddenServiceDir), selezionare versione onion (HiddenServiceVersion), tipo di socket personalizzato tra unix o tcp, con tutte le porte virtuali desiderate, e anche i target (HiddenServicePort).
• Disabilitare servizio - Rimuovere la configurazione del servizio da torrc; il servizio non sarà più accessibile, ma puoi riabilitarlo in qualsiasi momento. Opzionalmente, elimina il servizio, cancellando la sua configurazione e directory, il che cancellerà definitivamente le sue chiavi.
• Rinnovare indirizzo del servizio - Focalizzato sui servizi onion privati, se mai si dovesse divulgare il proprio indirizzo, è possibile cambiare il suo hostname; tieni presente che tutti i client autorizzati verranno disconnessi e le chiavi del servizio saranno cancellate definitivamente.
• Credenziali - Mostra hostname, client, blocco torrc, hostname con codice QR.
• Autenticazione onion - Solo per servizi onion v3. Dipende dalla configurazione sia del client che del server e funziona con una coppia di chiavi; il client possiede la parte privata, generata da lui (più sicuro) o fornita dall'operatore del servizio, mentre l'operatore del servizio onion possiede la parte pubblica. Se una qualsiasi di:
  • Server - Generare coppia di chiavi o aggiungere parte pubblica, elencare nomi client e loro chiavi pubbliche da <HiddenServiceDir>/authorized_clients/<client>.auth. Se un qualsiasi client è configurato, il servizio non sarà accessibile senza autenticazione.
  • Client - Generare coppia di chiavi o aggiungere parte pubblica, elencare i tuoi <ClientOnionAuthDir>/<SOME_ONION>.auth_private.
• Onion-Location - Per servizi onion pubblici: puoi reindirizzare i tuoi utenti della rete normale al tuo servizio onion con questa guida per nginx, apache2 e attributi header html.
• - Sicurezza operativa

Requisiti

• Generali:

  • Sistema Unix-like.
  • Privilegi di superutente per richiamare comandi come root e l'utente tor.

• Programmi richiesti:

  • sh - Qualsiasi shell POSIX: 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) ecc.
  • tor >= 0.3.5.7
  • grep >=0.9
  • sed
  • openssl >= 1.1 (Autorizzazione client - richiede l'algoritmo x25519, quindi non può essere LibreSSL)
  • basez >= 1.6.2 (Autorizzazione client)
  • git (Build)
  • dialog/whiptail (TUI)
  • nginx/apache2 (Server web)

• Programmi opzionali:

  • (lib)qrencode >= 4.1.1 (Elenco)

• Programmi di sviluppo:

  • pandoc (Manuale)
  • shellcheck (Revisione)

Compatibilità

Principalmente testato su sistemi Debian, inclusi Whonix.

Può funzionare su OpenBSD:

• auth -> se compili basez dal sorgente, poiché non è nei ports.
• web -> nginx o apache; la configurazione di httpd di OpenBSD era difficile da rimuovere pulitamente il blocco del server.

Per altri sistemi operativi, consultare etc/onionjuggler per configurazioni predefinite per il tuo sistema operativo. Non sono state tutte testate.

Istruzioni

Clonare il repository

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

Configurare l'ambiente

Eseguire dall'interno del repository clonato per creare le directory di tor, creare le pagine man e copiare gli script nel PATH:

./configure.sh --install

Impostare variabili personalizzate

Non dovresti modificare la configurazione predefinita su /etc/onionjuggler/onionjuggler.conf; verrà modificata ad ogni aggiornamento. Le tue configurazioni locali dovrebbero essere in /etc/onionjuggler/conf.d/*.conf, e da questa cartella verranno analizzate in ordine lessicale; l'ultimo valore sostituirà i valori predefiniti.

Utilizzo

Ogni configurazione e script ha la propria pagina man e messaggio di aiuto; è il modo migliore per imparare onionjuggler completamente.

Prima di eseguire qualsiasi script per apportare modifiche, si consiglia di vedere quali opzioni sono configurate. Ogni script ha un'opzione --getconf che stampa la configurazione corrente letta da onionjuggler:

onionjuggler-cli --getconf

È anche possibile ottenere le opzioni della riga di comando senza apportare modifiche, utile per verificare se l'assegnazione è corretta:

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

Per usare la TUI, basta eseguire:

onionjuggler-tui

Per creare un servizio da CLI:

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

Molte altre cose sono possibili, leggi le pagine man.

In primo piano su

• TorBox >= v.0.5.0

Contributori