Add HTTPS warnings for Push notifications

This commit is contained in:
2026-04-23 14:46:58 +02:00
parent bb697750b7
commit 5f41744d93
2 changed files with 12 additions and 10 deletions
+4
View File
@@ -38,6 +38,8 @@ The ecosystem consists of three main parts:
* Run: `python3 app.py` * Run: `python3 app.py`
#### 🔑 Generating VAPID Keys (Push Notifications) #### 🔑 Generating VAPID Keys (Push Notifications)
> ⚠️ **IMPORTANT:** Web Push Notifications strictly require the dashboard to be accessed via a secure **HTTPS** connection (or localhost). Modern browsers will block push features over standard HTTP.
To enable Web Push Notifications, you must generate a unique VAPID key pair for your server. To enable Web Push Notifications, you must generate a unique VAPID key pair for your server.
1. Go to a free online generator like [vapidkeys.com](https://vapidkeys.com/). 1. Go to a free online generator like [vapidkeys.com](https://vapidkeys.com/).
2. Generate the keys. 2. Generate the keys.
@@ -100,6 +102,8 @@ L'ecosistema si compone di tre parti principali:
* Avvia: `python3 app.py` * Avvia: `python3 app.py`
#### 🔑 Generare le chiavi VAPID (Notifiche Push) #### 🔑 Generare le chiavi VAPID (Notifiche Push)
> ⚠️ **IMPORTANTE:** Le Notifiche Push Web richiedono tassativamente che la dashboard sia accessibile tramite una connessione sicura **HTTPS** (o localhost). I browser mobili e desktop bloccano le notifiche su connessioni HTTP non protette.
Per abilitare le Notifiche Push, devi generare una coppia di chiavi VAPID univoca per il tuo server. Per abilitare le Notifiche Push, devi generare una coppia di chiavi VAPID univoca per il tuo server.
1. Vai su un generatore online gratuito come [vapidkeys.com](https://vapidkeys.com/). 1. Vai su un generatore online gratuito come [vapidkeys.com](https://vapidkeys.com/).
2. Genera la coppia di chiavi. 2. Genera la coppia di chiavi.
+8 -10
View File
@@ -4,14 +4,12 @@
This guide describes the steps to install the Central This guide describes the steps to install the Central
Dashboard and the Remote Agents on MMDVM nodes. Dashboard and the Remote Agents on MMDVM nodes.
------------------------------------------------------------ ------------------------------------------------------------
1. PRE-REQUISITES 1. PRE-REQUISITES
------------------------------------------------------------ ------------------------------------------------------------
Ensure Python 3 is installed on all systems. Ensure Python 3 is installed on all systems.
The necessary dependencies are listed in the The necessary dependencies are listed in the
'requirements.txt' file. 'requirements.txt' file.
Install dependencies: Install dependencies:
pip install -r requirements.txt pip install -r requirements.txt
@@ -19,7 +17,6 @@ Install dependencies:
2. SERVER SETUP (CENTRAL HUB) 2. SERVER SETUP (CENTRAL HUB)
------------------------------------------------------------ ------------------------------------------------------------
The server handles the web interface and user permissions. The server handles the web interface and user permissions.
Steps: Steps:
1. Configure 'config.json' using 'config.example.json' as a template. 1. Configure 'config.json' using 'config.example.json' as a template.
2. Enter MQTT credentials and VAPID keys. 2. Enter MQTT credentials and VAPID keys.
@@ -32,6 +29,10 @@ Steps:
------------------------------------------------------------ ------------------------------------------------------------
Required to enable browser and mobile notifications. Required to enable browser and mobile notifications.
⚠️ WARNING: Web Push Notifications strictly require the
dashboard to be accessed via a secure HTTPS connection
(or localhost). They will NOT work over standard HTTP.
1. Go to https://vapidkeys.com/ and generate the keys. 1. Go to https://vapidkeys.com/ and generate the keys.
2. Copy 'Public Key' and 'Private Key' into 'config.json'. 2. Copy 'Public Key' and 'Private Key' into 'config.json'.
3. Set 'vapid_claim_email' (e.g., "mailto:your@email.com"). 3. Set 'vapid_claim_email' (e.g., "mailto:your@email.com").
@@ -40,7 +41,6 @@ Required to enable browser and mobile notifications.
4. AGENT SETUP (REMOTE NODES) 4. AGENT SETUP (REMOTE NODES)
------------------------------------------------------------ ------------------------------------------------------------
To be installed on each Raspberry Pi / MMDVM Node. To be installed on each Raspberry Pi / MMDVM Node.
1. Copy 'system_monitor.py' and 'node_config.json' to 1. Copy 'system_monitor.py' and 'node_config.json' to
'/opt/node_agent/'. '/opt/node_agent/'.
2. Edit 'node_config.json' with a unique 'client_id'. 2. Edit 'node_config.json' with a unique 'client_id'.
@@ -50,7 +50,6 @@ To be installed on each Raspberry Pi / MMDVM Node.
5. RUNNING AS A SERVICE (SYSTEMD) 5. RUNNING AS A SERVICE (SYSTEMD)
------------------------------------------------------------ ------------------------------------------------------------
For auto-start and process monitoring. For auto-start and process monitoring.
Configuration: Configuration:
1. Copy .service files to '/etc/systemd/system/': 1. Copy .service files to '/etc/systemd/system/':
- Server: sudo cp fleet-console.service /etc/systemd/system/ - Server: sudo cp fleet-console.service /etc/systemd/system/
@@ -69,14 +68,12 @@ Configuration:
Questa guida descrive i passaggi per installare la Dashboard Questa guida descrive i passaggi per installare la Dashboard
Centrale e gli Agenti Remoti sui nodi MMDVM. Centrale e gli Agenti Remoti sui nodi MMDVM.
------------------------------------------------------------ ------------------------------------------------------------
1. REQUISITI PRELIMINARI 1. REQUISITI PRELIMINARI
------------------------------------------------------------ ------------------------------------------------------------
Assicurarsi di avere Python 3 installato su tutti i sistemi. Assicurarsi di avere Python 3 installato su tutti i sistemi.
Le dipendenze necessarie sono elencate nel file Le dipendenze necessarie sono elencate nel file
'requirements.txt'. 'requirements.txt'.
Installazione dipendenze: Installazione dipendenze:
pip install -r requirements.txt pip install -r requirements.txt
@@ -84,7 +81,6 @@ Installazione dipendenze:
2. SETUP DEL SERVER (HUB CENTRALE) 2. SETUP DEL SERVER (HUB CENTRALE)
------------------------------------------------------------ ------------------------------------------------------------
Il server gestisce l'interfaccia web e i permessi. Il server gestisce l'interfaccia web e i permessi.
Passaggi: Passaggi:
1. Configura 'config.json' partendo da 'config.example.json'. 1. Configura 'config.json' partendo da 'config.example.json'.
2. Inserisci le credenziali MQTT e le chiavi VAPID. 2. Inserisci le credenziali MQTT e le chiavi VAPID.
@@ -97,6 +93,10 @@ Passaggi:
------------------------------------------------------------ ------------------------------------------------------------
Necessarie per abilitare le notifiche su browser e mobile. Necessarie per abilitare le notifiche su browser e mobile.
⚠️ ATTENZIONE: Le notifiche push richiedono tassativamente
che la dashboard sia accessibile tramite una connessione
sicura HTTPS. I browser bloccano la funzione su HTTP normale.
1. Vai su https://vapidkeys.com/ e genera le chiavi. 1. Vai su https://vapidkeys.com/ e genera le chiavi.
2. Copia 'Public Key' e 'Private Key' nel 'config.json'. 2. Copia 'Public Key' e 'Private Key' nel 'config.json'.
3. Imposta 'vapid_claim_email' (es. "mailto:tua@email.com"). 3. Imposta 'vapid_claim_email' (es. "mailto:tua@email.com").
@@ -105,7 +105,6 @@ Necessarie per abilitare le notifiche su browser e mobile.
4. SETUP DELL'AGENTE (NODI REMOTI) 4. SETUP DELL'AGENTE (NODI REMOTI)
------------------------------------------------------------ ------------------------------------------------------------
Da installare su ogni Raspberry Pi / Nodo MMDVM. Da installare su ogni Raspberry Pi / Nodo MMDVM.
1. Copia 'system_monitor.py' e 'node_config.json' in 1. Copia 'system_monitor.py' e 'node_config.json' in
'/opt/node_agent/'. '/opt/node_agent/'.
2. Modifica 'node_config.json' con il 'client_id' univoco. 2. Modifica 'node_config.json' con il 'client_id' univoco.
@@ -115,7 +114,6 @@ Da installare su ogni Raspberry Pi / Nodo MMDVM.
5. ESECUZIONE COME SERVIZIO (SYSTEMD) 5. ESECUZIONE COME SERVIZIO (SYSTEMD)
------------------------------------------------------------ ------------------------------------------------------------
Per l'avvio automatico e il monitoraggio del processo. Per l'avvio automatico e il monitoraggio del processo.
Configurazione: Configurazione:
1. Copia i file .service in '/etc/systemd/system/': 1. Copia i file .service in '/etc/systemd/system/':
- Server: sudo cp fleet-console.service /etc/systemd/system/ - Server: sudo cp fleet-console.service /etc/systemd/system/