martedì 30 dicembre 2014

Captive Portal Plus

Utilizzare pfSense come Captive Portal è semplice ed intuitivo, se poi lo si unisce alla creazione di vouchers la cosa diventa ancora più semplice.
Un po'meno semplice ed intuitivo è generare delle card contenenti i vouchers da distribuire ai propri utenti.
Quest'articolo vi spiegherà come superare questo limite ed ottenere vouchers professionali stampabili tramite una normale stampante o tramite una stampante POS.
Per poter stampare i nostri vouchers in modo semplice e professionale, utilizzeremo un package che non è presente nel package manager ufficiale.

Il package che utilizzeremo è Captive Portal Plus, il progetto è pubblicato su sourceforge.net

Il software è semplice ma ben studiato, le funzionalità che mette a disposizione sono:
  • possibilità di creare diversi profili di stampa e di voucher (Outputs);
  • stampa su file pdf;
  • stampa su stampanti POS;
  • creazione didiverse tipologie di vouchers (Time Packages);
  • gestione di utenti abilitati alla generazione e stampa dei voucher;
  • possibilità di effettuare il backup della configurazione del modulo.
Il modulo si integra con il servizio Captive Portal, tutti i voucher creati sono visibili all'interno del modulo Captive Portal > Vouchers > Voucher Rolls.

Installazione

Per prima cosa occorre scaricare il pacchetto di Captive Portal Plus poi procediamo come segue:
  1. Scompattiamo il file compresso sul nostro PC;
  2. Accediamo al nostro pfSense e selezioniamo Diagnostics > Command Prompt;
  3. Dalla sezione upload clicchiamo su browse... e selezioniamo il file cpp_install.php e successimamente clicchiamo su upload;
  4. Ora nella sezione Execute Shell command inseriamo il seguente comando mv /tmp/cpp_install.php /usr/local/www;
  5. Apriamo il browser e digitiamo <pfSense_IP>/cpp_install.php;
  6. Ora non resta che seguire i tre step proposti dalla pagina per completare l'installazione.


Configurazione

Accediamo al modulo che ora è disponibile sotto Services > Captive Portal Plus.

Per prima cosa clicchiamo su Settings e creiamo un profilo di stampa nella sezione Outputs.
Diamo un nome al nostro profilo di stampa, selezioniamo PDF come tipo di stampa.


Ora passiamo alla sezione Lines ed aggiungiamo le linee che andranno a comporre la nostra tessera. 

Nella composizione il software mette a disposizione la possibilità di inserire un testo con il relativo font, dimensione, stile ed allineamento. Nel testo possono essere utilizzate le seguenti variabili {code}, {time_package} e {id} che identificano rispettivamente il codice del voucher, il nome del pacchetto a cui appartiene e l'ID del codice.


L'ultima sezione definisce le dimensioni del file di stampa e la suddivisione in card. 



Nella configurazione ripostata nel precedente screenshot abbiamo un foglio A4 suddiviso in 6 righe per 3 colonne per un totale di 18 card con un margine sui lati di 1 cm.


Oltre al profilo di stampa su PDF è possibile configurare un profilo di stampa per stampanti POS connesse in rete e che utilizzano lo standard ESC/POS.

Ora possiamo portarci nella sezione Time Packages per creare i diversi profili temporali dei nostri vouchers.


Qui le impostazioni si limitano al nome da attribuire al profilo e poi la durata del voucher espressa in minuti.
Con quest'operazione abbiamo concluso le operazioni più importanti di configurazione del modulo Captive Portal Plus.

Il modulo mette a disposizione anche la possibilità di creare utenti con poteri limitati che possano accedere alla creazione e stampa dei vouchers.

Per attivare questa possibilità è necessario creare un gruppo denominato captive-portal a cui associare i seguenti permessi: WebCfg - Services: Captive Portal Plus: Menu Link e WebCfg - Services: Captive Portal Plus: Vouchers.

Dopo aver creato questo gruppo, sarà sufficiente accedere a  Services > Captive Portal Plus > Users e creare gli account per gli utenti a cui si vuole delegare la gestione dei vouchers. Gli utenti creati verranno automaticamente aggiunti al gruppo captive-portal.

 

Generazione e stampa

Per procedere con la stampa e la generazione dei nostri voucers è sufficiente accedere a Services > Captive Portal Plus > Vouchers


In questa pagina è sufficiente selezionare il profilo temporale, il profilo di stampa ed il numero di stampe da generare, successivamente basta cliccare sull'icona PDF o Stampante per procedere con la stampa.

All'interno di questa pagina è disponibile anche un comodo tools che inserendo il numero del rool e l'id del voucher ci mostra il codice.


Stampanti POS

Le stampanti utilizzabili per la stampa diretta dei vouchers devonoèssere compatibili con lo standard Epsons ESC/POS over ethernet (Porta 9100).

Lo sviluppatore ha testato il software solo con la stampante EPSON TM-T88III ma dovrebbero essere compatibili anche i modello TM-T88IV, TM-T88V e TM-T88V-I.

Conclusioni

Con l'installazione di questo modulo anche il nostro pfSense si arricchisce aggiungendo un usabilità eccezionale nella gestione dei vouchers che prima non era neanche immaginabile. L'unica pecca ancora da colmare è la possibilità di inserire un proprio logo o un layout grafico più elaborato del semplice testo.

Per maggiori informazioni su come attivare il servizio Captive Portal di pfSense potete consultare quest'articolo ed i successivi:
Accesso WiFi con captive portal e vouchers - Parte 1, Parte 2, Parte 3 e Parte 4
Posta un commento