8. Accessi Wi-Fi a tempo#

openwisp-voucher è un programma per computer (Linux e Windows) che crea accessi Wi-Fi a tempo per il captive portal e li stampa come biglietti o etichette, come negli hotel: «Mario ha accesso per 3 giorni, poi l'utente si spegne da solo». Usa le API REST di OpenWISP: sul server non si installa niente.

Cosa fa#

• ospite con nome (nome utente, email, password generata) oppure serie di voucher (ospite1, ospite2, …) con password generate dal server;
• durata in giorni: la data stampata è l'ultimo giorno valido, OpenWISP disattiva l'utente alle 00:01 del giorno dopo; si può anche disattivare subito;
• stampa su foglio A4 (10 biglietti), scontrino 58/80 mm o etichetta di misura libera, con logo, sito, email, telefono, nome della rete e QR code; oppure PDF o testo da copiare;
• elenco degli accessi creati, con ristampa e stato letto dal server;
• il superuser sceglie l'organizzazione, l'operatore vede solo la sua.

Le schermate usano dati di fantasia («Hotel Ninux Basilicata»).

Biglietto del foglio A4	Scontrino 58 mm

Installazione#

Scarica l'eseguibile dalle release: openwisp-voucher-<versione>-windows.exe per Windows, openwisp-voucher-<versione>-linux-x86_64.tar.gz per Linux. Non si installa: si avvia e basta. Su Windows l'eseguibile per ora non è firmato e SmartScreen chiede conferma («Ulteriori informazioni» → «Esegui comunque»); la richiesta di firma gratuita alla SignPath Foundation è in corso.

In Impostazioni: «Accedi…» con il server (openwisp.ninux-nnxx.it) e il tuo utente, poi organizzazione, gruppo RADIUS, logo e dati della struttura. La password serve solo a ottenere il token, che va nel portachiavi del sistema.

Lato server#

Cosa	Dove
API dei batch di openwisp-radius e task deactivate_expired_users	già nel playbook openwisp2
Gruppo RADIUS per gli ospiti	admin → RADIUS → Gruppi; per Basilicata basilicata-24H (24 ore e 3 GB al giorno)
Pagina di login che accetta il nome utente	login_form.input_fields.username.type: "text" nel YAML dell'organizzazione (vedi capitolo 3)
Utenti operatori (reception)	staff, gestori dell'organizzazione, permessi elencati nel README

L'ospite si collega alla rete dell'hotspot e, nella pagina del portale che si apre da sola, scrive nome utente e password del biglietto nel campo «Email, numero di telefono o nome utente».

Release#

Le release le compila GitHub Actions al push di un tag v*: test, eseguibili per Windows e Linux con PyInstaller, SHA256 e attestazione di provenienza. La procedura è nel README del programma, sezione Sviluppo.

Questa pagina viene dal repository mikysal78/ninux-basilicata-infra: le correzioni vanno fatte lì.