OnionJuggler

Gestionnaire de services onion riche en fonctionnalités pour les systèmes de type UNIX, écrit en shellscript compatible POSIX

OnionJuggler est un ensemble portable de scripts et de documentation à faible prérequis, destiné à aider l'opérateur de service à jongler (gérer) ses onions.

ATTENTION : ne faites pas encore confiance à ce dépôt, sauvegardez vos clés hs dans un autre emplacement. Ce projet n'a pas encore été publié et ne doit être considéré que pour le développement.

Lien rapide vers ce dépôt : git.io/onionjuggler

Table des matières

• Introduction
  • Images
  • Historique
  • Objectif
  • Fonctionnalités
• Prérequis
• Compatibilité
• Instructions
  • Cloner le dépôt
  • Définir des variables personnalisées
  • Configurer l’environnement
  • Utilisation
• Présenté sur
• Contributeurs

Introduction

Images

Historique

Ce projet est né après avoir vu les étonnants scripts CLI Python d'OnionShare, qui permettent des services onion éphémères qui ne touchent jamais au disque et peuvent être exécutés facilement sur Tails ou Whonix. Puis, après avoir vu le script bash pour service onion de RaspiBlitz pour le Raspberry Pi, l'idée de le porter sur n'importe quelle distribution Debian a germé. Au fur et à mesure que l'idée grandissait, l'utilisation de GNU Bash et Linux constituait un point de défaillance unique 1 2, donc rendre le script compatible POSIX pour être compatible avec tout système de type Unix est devenu un objectif définitif.

Objectif

L'objectif de ce projet est de :

• faciliter la gestion des services onion, de l'activation d'un service à l'ajout d'autorisation client, en offrant toutes les capacités de modification manuelle des fichiers, mais avec moins de saisie.
• montrer que la gestion d'un service onion va bien au-delà de l'utilisation d'un serveur web avec vos pages.
• distribution, du niveau du code source (FOSS) à l'effet produit lorsqu'il permet à quiconque d'exécuter le code sur n'importe quel système d'exploitation, shell ou gestionnaire de services. Atténuation d'un point de défaillance unique

Atténuation d'un point de défaillance unique :

• Noyau : de Linux prédominant à BSD et tout autre système de type Unix.
• Shell : de Bash prédominant à tout shell POSIX tel que ksh, (y,d)ash et Zsh (émulant sh).
• Gestionnaire de services : de Systemd prédominant à RC, OpenRC, SysVinit, Runit.

Modifier le fichier de configuration de tor (torrc) n'est pas difficile, mais l'automatisation résout les problèmes de mauvaise configuration et permet :

• moins de temps passé en exécutant une seule commande
• aucune indisponibilité en rejetant les configurations invalides avant de les appliquer
• une uniformité complète
• une interface graphique pour aider les débutants

Fonctionnalités

• Activer un service - Crée le répertoire s'il n'existe pas (HiddenServiceDir), sélectionne la version onion (HiddenServiceVersion), type de socket personnalisé (unix ou tcp), avec autant de ports virtuels que souhaité, ainsi que les cibles (HiddenServicePort).
• Désactiver un service - Supprime la configuration du service du torrc ; le service ne sera plus accessible, mais vous pouvez le réactiver à tout moment. Optionnellement, purger le service, supprimant sa configuration et son répertoire, ce qui supprimera ses clés définitivement.
• Renouveler l'adresse du service - Destiné aux services onion privés ; si vous fuyez son adresse, vous pouvez changer son nom d'hôte ; attention, tous vos clients autorisés seront déconnectés et les clés du service seront définitivement supprimées.
• Credentials - Affiche le nom d'hôte, les clients, le bloc torrc, le nom d'hôte encodé en QR code.
• Authentification onion - Uniquement pour les services onion v3. Cela dépend de la configuration côté client et serveur et fonctionne avec une paire de clés ; le client détient la partie privée (soit générée par lui, plus sûre, soit donnée par l'opérateur du service) et l'opérateur du service onion détient la partie publique. Si l'un des éléments suivants est configuré :
  • Serveur - Génère une paire de clés ou ajoute la partie publique, liste les noms des clients et leurs clés publiques depuis <HiddenServiceDir>/authorized_clients/<client>.auth. Si un client est configuré, le service ne sera pas accessible sans authentification.
  • Client - Génère une paire de clés ou ajoute la partie publique, liste vos <ClientOnionAuthDir>/<SOME_ONION>.auth_private.
• Onion-Location - Pour les services onion publics : vous pouvez rediriger vos utilisateurs du clearnet vers votre service onion grâce à ce guide pour nginx, apache2 et les attributs d'en-tête HTML.
• - Sécurité opérationnelle

Prérequis

• Généraux :

  • Système de type Unix.
  • Privilèges super-utilisateur pour exécuter des commandes en tant que root et utilisateur tor.

• Programmes requis :

  • sh - tout 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) etc.
  • tor >= 0.3.5.7
  • grep >=0.9
  • sed
  • openssl >= 1.1 (Autorisation client - nécessite l'algorithme x25519, donc pas LibreSSL)
  • basez >= 1.6.2 (Autorisation client)
  • git (Construction)
  • dialog/whiptail (TUI)
  • nginx/apache2 (Serveur web)

• Programmes optionnels :

  • (lib)qrencode >= 4.1.1 (Liste)

• Programmes de développement :

  • pandoc (Manuel)
  • shellcheck (Révision)

Compatibilité

Principalement testé sur les systèmes Debian, y compris Whonix.

Cela peut fonctionner sur OpenBSD :

• auth -> si vous compilez basez à partir des sources, car il n'est pas dans les ports.
• web -> nginx ou apache ; la configuration httpd d'OpenBSD était difficile à nettoyer pour supprimer le bloc serveur.

Concernant les autres systèmes d'exploitation, veuillez consulter etc/onionjuggler pour une configuration prédéfinie pour votre système d'exploitation. Ils n'ont pas tous été testés.

Instructions

Cloner le dépôt

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

Configurer l’environnement

Exécutez depuis l'intérieur du dépôt cloné pour créer les répertoires tor, les pages de manuel et copier les scripts dans le PATH :

./configure.sh --install

Définir des variables personnalisées

Vous ne devez pas modifier la configuration par défaut dans /etc/onionjuggler/onionjuggler.conf, car elle sera modifiée à chaque mise à jour. Vos configurations locales doivent se trouver dans /etc/onionjuggler/conf.d/*.conf, et à partir de ce dossier, elles seront analysées dans l'ordre lexical ; la dernière valeur remplacera les valeurs par défaut.

Utilisation

Chaque configuration et script possède sa propre page de manuel et son message d'aide ; c'est le meilleur moyen d'apprendre OnionJuggler entièrement.

Avant d'exécuter un script pour apporter des modifications, il est recommandé de voir quelles options sont configurées. Chaque script a une option --getconf qui affichera la configuration actuelle lue par OnionJuggler :

onionjuggler-cli --getconf

Il est également possible d'obtenir les options de ligne de commande sans apporter de modifications, utile pour vérifier si l'affectation est correcte :

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

Pour utiliser l'interface TUI, exécutez simplement :

onionjuggler-tui

Pour créer un service en CLI :

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

Beaucoup d'autres choses sont possibles, lisez les pages de manuel.

Présenté sur

• TorBox >= v.0.5.0

Contributeurs