From aefd493520a61feea855251f8b173c0282a75169 Mon Sep 17 00:00:00 2001
From: bwaegeneire <bwaegeneire+gitit@evolix.fr>
Date: Mon, 11 Jan 2021 16:58:02 +0100
Subject: [PATCH] Ajout configuration avec Apache

---
 HowtoGoAccess.md | 36 ++++++++++++++++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/HowtoGoAccess.md b/HowtoGoAccess.md
index 05e02047..a651f758 100644
--- a/HowtoGoAccess.md
+++ b/HowtoGoAccess.md
@@ -61,10 +61,12 @@ Pour avoir un access de 12h à 16h du 1er Fevrier :
 ~~~
 
 # Interface web + WebSocket
+Pour avoir le suivi en temps réel dans un navigateur, il faut servir le fichier HTML généré par Goaccess ainsi que l'exécuter en tant que démon pour recevoir les données en temps réel via sa WebSocket.
 
-Pour avoir le suivi en temps réel dans un navigateur, on peut créer une unité systemd qui lancera GoAccess et sa WebSocket.
+## Systemd
+On peut créer une unité systemd qui lancera GoAccess et sa WebSocket.
 
-`/etc/systemd/system/goaccess.service`.
+`/etc/systemd/system/goaccess.service` :
 
 ~~~
 [Unit]
@@ -86,6 +88,36 @@ WantedBy=default.target
 # systemctl start goaccess
 ~~~
 
+## Apache
+On sert /var/www/goaccess.html via Apache et on proxifie le WebSocket :
+
+~~~
+<VirtualHost *:443>
+        ServerName example.org
+
+        Include /etc/apache2/ssl/example.conf
+        DocumentRoot /var/www/
+
+        # Goaccess
+        <Location "/goaccess.ws/">
+            ProxyPass "ws://localhost:7890/"
+        </Location>
+</VirtualHost>
+~~~
+
+Notez qu'ainsi Apache fait la terminaison SSL sans que Goaccess ai besoin d'accéder aux certificats.
+
+## Goaccess
+
+On indique au client Goaccess (dans le navigateur) d'accéder au WebSocket via l'URL proxifié par Apache. Il est important d'utiliser un nom de domaine et non une adresse IP autrement Apache dirigera la requête vers le Vhost par défaut, ici example.org.
+
+`/etc/goaccess/goaccess.conf` :
+
+~~~
+ws-url wss://example.com:443/goaccess.ws/
+~~~
+
+
 # Erreur
 
 ~~~