Web-ssh - Historique des versions

Jpinon : /* 2. Script de lancement */

2025-10-30T15:08:59Z

2. Script de lancement

← Version précédente		Version du 30 octobre 2025 à 15:08
Ligne 5 :		Ligne 5 :
	== 1. Installation dans un environnement virtuel ==		== 1. Installation dans un environnement virtuel ==

	EN général je travaille avec un user dédié, ici ce serait webssh ou un user d'administration admin.		En général je travaille avec un user dédié, ici ce serait webssh ou un user d'administration admin.
	Dans la suite on considère admin.		Dans la suite on considère admin.

			ON doit utiliser un environnement virtuel python. [[Environnements virtuels Python\|Un page existe ici pour cela]]. Ici je ne décris pas le mécanisme lui-même.

	Créer un environnement Python dédié :		Créer un environnement Python dédié :

Jpinon le 27 septembre 2025 à 21:58

2025-09-27T21:58:49Z

@@ Ligne 88 : / Ligne 88 : @@
 == Provisioning OTP ==
 === Script de génération ===
-Utiliser un script Python nommé build-otp-key.py :
+Utiliser un script Python nommé build-otp-key.py :<syntaxhighlight lang="python3">
 * Génère une clé TOTP unique
-* Affiche le QR code dans le terminal
+* Affiche le QR code dans le terminal (ce QR code sera utile pour initialiser l'application sur le téléphone de type google authentification)
 * Enregistre la clé dans un fichier JSON structuré par hôte/utilisateur
@@ Ligne 102 : / Ligne 138 : @@
 <syntaxhighlight lang="json">
+{
-   "main-host": {
+   "host1": {
-     "admin": "JBSWY3DPEHPK3PXP"
+     "web-admin": "JBSWY3DPEHPK3PXP"
    },
-   "database": {
+   "host2": {
      "admin": "KRSW4ZDFEHPK3ABC"
+   }
@@ Ligne 143 : / Ligne 179 : @@
 * journalctl -u webssh -n 50
 * Activer logging.DEBUG dans main.py

Jpinon : /* Configuration OTP sur WebSSH */

2025-09-27T21:48:52Z

Configuration OTP sur WebSSH

@@ Ligne 82 : / Ligne 82 : @@
 == Prérequis ==
 * WebSSH installé et fonctionnel
-* Python 3.11+ avec les modules `pyotp`, `qrcode`, `argparse`
+* Python 3.11+ avec les modules pyotp, qrcode, argparse
-* Accès au fichier `totp_secrets.json` dans le bon répertoire
+* Accès au fichier totp_secrets.json dans le bon répertoire
 * Serveur SSH distant accessible et configuré avec shell interactif
 == Provisioning OTP ==
 === Script de génération ===
-Utiliser un script Python nommé `build-otp-key.py` :
+Utiliser un script Python nommé build-otp-key.py :
 * Génère une clé TOTP unique
@@ Ligne 95 : / Ligne 95 : @@
 Exemple d’appel :
-```bash
+<syntaxhighlight lang="bash">
 python3 build-otp-key.py --host main-host --user admin --write

Jpinon le 27 septembre 2025 à 21:45

2025-09-27T21:45:21Z

← Version précédente		Version du 27 septembre 2025 à 21:45
Ligne 73 :		Ligne 73 :

	L’interface WebSSH est maintenant accessible via <code>https://monserveur/webssh/</code>. L’authentification SSH reste gérée par WebSSH. Une protection Apache (BasicAuth, IP, etc.) peut être ajoutée en amont si nécessaire.		L’interface WebSSH est maintenant accessible via <code>https://monserveur/webssh/</code>. L’authentification SSH reste gérée par WebSSH. Une protection Apache (BasicAuth, IP, etc.) peut être ajoutée en amont si nécessaire.


			= Configuration OTP sur WebSSH =

			== Objectif ==
			Configurer une authentification TOTP (Time-based One-Time Password) sur WebSSH, par couple hôte/utilisateur, avec provisioning via QR code et vérification côté serveur.

			== Prérequis ==
			* WebSSH installé et fonctionnel
			* Python 3.11+ avec les modules `pyotp`, `qrcode`, `argparse`
			* Accès au fichier `totp_secrets.json` dans le bon répertoire
			* Serveur SSH distant accessible et configuré avec shell interactif

			== Provisioning OTP ==
			=== Script de génération ===
			Utiliser un script Python nommé `build-otp-key.py` :

			* Génère une clé TOTP unique
			* Affiche le QR code dans le terminal
			* Enregistre la clé dans un fichier JSON structuré par hôte/utilisateur

			Exemple d’appel :
			```bash
			python3 build-otp-key.py --host main-host --user admin --write

Jpinon : /* 4. Configuration Apache en reverse proxy */

2025-09-26T23:43:54Z

4. Configuration Apache en reverse proxy

← Version précédente		Version du 26 septembre 2025 à 23:43
Ligne 33 :		Ligne 33 :
	== 3. Lancer WebSSH en tant que service ==		== 3. Lancer WebSSH en tant que service ==

	Voir [[~~Créer~~ un service systemd personnalisé]] pour créer un fichier <code>webssh.service</code> et activer le démarrage automatique.		Voir [[Deamon avec systemd\|créer un service systemd personnalisé]] pour créer un fichier <code>webssh.service</code> et activer le démarrage automatique.

	== 4. Configuration Apache en reverse proxy ==		== 4. Configuration Apache en reverse proxy ==
Ligne 50 :		Ligne 50 :
	# Support WebSocket		# Support WebSocket
	ProxyPassMatch ^/webssh/ws$ ws://localhost:8888/ws		ProxyPassMatch ^/webssh/ws$ ws://localhost:8888/ws

			# Support WebSocket via mod_rewrite
			RewriteEngine On
			RewriteCond %{REQUEST_URI} ^/webssh/ws$
			RewriteCond %{QUERY_STRING} (.*)
			RewriteRule ^/webssh/ws$ ws://localhost:8888/ws?%1 [P,L]
	</syntaxhighlight>		</syntaxhighlight>

Jpinon : Page créée avec « = Installer WebSSH avec reverse proxy Apache = Cette page décrit comment installer WebSSH dans un environnement isolé, le lancer en tant que service systemd, et le rendre accessible via Apache en HTTPS avec prise en charge des WebSocket. == 1. Installation dans un environnement virtuel == EN général je travaille avec un user dédié, ici ce serait webssh ou un user d'administration admin. Dans la suite on considère admin. Créer un environnement Python... »

2025-09-26T23:40:53Z

Page créée avec « = Installer WebSSH avec reverse proxy Apache = Cette page décrit comment installer WebSSH dans un environnement isolé, le lancer en tant que service systemd, et le rendre accessible via Apache en HTTPS avec prise en charge des WebSocket. == 1. Installation dans un environnement virtuel == EN général je travaille avec un user dédié, ici ce serait webssh ou un user d'administration admin. Dans la suite on considère admin. Créer un environnement Python... »

Nouvelle page

= Installer WebSSH avec reverse proxy Apache =

Cette page décrit comment installer WebSSH dans un environnement isolé, le lancer en tant que service systemd, et le rendre accessible via Apache en HTTPS avec prise en charge des WebSocket.

== 1. Installation dans un environnement virtuel ==

EN général je travaille avec un user dédié, ici ce serait webssh ou un user d'administration admin.
Dans la suite on considère admin.

Créer un environnement Python dédié :

<syntaxhighlight lang="bash">
python3 -m venv ~/sources/webssh-env
source ~/sources/webssh-env/bin/activate
pip install webssh
</syntaxhighlight>

== 2. Script de lancement ==

Créer un script <code>start-webssh.sh</code> :

<syntaxhighlight lang="bash">
#!/bin/bash
source /home/admin/sources/webssh-env/bin/activate
exec wssh --address=127.0.0.1 --port=8888
</syntaxhighlight>

Rendre le script exécutable :
<syntaxhighlight lang="bash">
chmod +x ~/sources/webssh-env/start-webssh.sh
</syntaxhighlight>

== 3. Lancer WebSSH en tant que service ==

Voir [[Créer un service systemd personnalisé]] pour créer un fichier <code>webssh.service</code> et activer le démarrage automatique.

== 4. Configuration Apache en reverse proxy ==

Dans la section HTTPS du VirtualHost :

<syntaxhighlight lang="apache">
Define WebSshURL "/webssh/"

<Location ${WebSshURL}>
ProxyPreserveHost On
ProxyPass http://localhost:8888/
ProxyPassReverse http://localhost:8888/
</Location>

# Support WebSocket
ProxyPassMatch ^/webssh/ws$ ws://localhost:8888/ws
</syntaxhighlight>

Modules requis :
<syntaxhighlight lang="bash">
sudo a2enmod proxy
sudo a2enmod proxy_http
sudo a2enmod proxy_wstunnel
</syntaxhighlight>

Redémarrer Apache :
<syntaxhighlight lang="bash">
sudo systemctl restart apache2
</syntaxhighlight>

== 5. Accès sécurisé ==

L’interface WebSSH est maintenant accessible via <code>https://monserveur/webssh/</code>. L’authentification SSH reste gérée par WebSSH. Une protection Apache (BasicAuth, IP, etc.) peut être ajoutée en amont si nécessaire.

Web-ssh - Historique des versions

Jpinon : /* 2. Script de lancement */

Jpinon le 27 septembre 2025 à 21:58

Jpinon : /* Configuration OTP sur WebSSH */

Jpinon le 27 septembre 2025 à 21:45

Jpinon : /* 4. Configuration Apache en reverse proxy */

Jpinon : /* 2. Script de lancement */

Jpinon : /* Configuration OTP sur WebSSH */

Jpinon : /* 4. Configuration Apache en reverse proxy */