VntRAS Communication Suite Manuale di Riferimento 1
Indice pag. 1. Introduzione 3 2. Interfaccia web di amministrazione 4 3. Programmazione 5 4. Programmazione pagine HTML pubbliche 8 2
Introduzione Il Progetto vntras Communication Suite è stato realizzato per consentire di effettuare una connessione remota verso un POP Internet, direttamente dalla pagina HTML nell ambiente di Internet Explorer mediante una applicazione ActiveX. La gestione dinamica delle numerazioni telefoniche, username, password, url tramite una interfaccia web, per garantire un ampia flessibilità di gestione e un pieno controllo della distribuzione degli oggetti da un unico punto di amministrazione. La soluzione di effettuare uno scambio di connessione mediante un documento HTML che contiene applicazione ActiveX, offre il vantaggio agli utenti di non scaricare ogni volta file eseguibile (*.exe) nel proprio Personal Computer. Si ha il vantaggio di ottenere una maggior sicurezza e protezione dai virus, oltre ad un aggiornamento automatico in caso di rilascio di nuove versioni. L oggetto vntras é certificato con il VeriSign Class 3 Code Signing 2001-4 CA rilasciato da Class 3 Public Primary Certification Authority. VntRAS é compatibile con Windows 95, 98, ME, 2000, XP e non necessita di nessun tipo di library aggiuntive. 3
Interfaccia web di amministrazione L interfaccia web di amministrazione é raggiungibile presso il nostro sito web all indirizzo https://www.voitek.net/membersits. Tale area é riservata esclusivamente ai nostri clienti per la gestione di piattaforme di servizio offerte dal nostro workgroup. Il protocollo https, presente nell indirizzo, identifica una connessione protetta dal sistema SSL Secure Socket Layer. L utente che utilizza il browser Internet Explorer può verificare che la transazione avvenga in base al protocollo SSL, controllando nella barra di stato che l icona del lucchetto sia chiusa, inoltre che l'incipit dell'indirizzo sia passato da http a https (come è visibile nell indirizzo del nostro sito web https://www.voitek.net/membersite). Poiché SSL risiede al livello socket, è indipendente dalle applicazioni di alto livello, quindi può offrire servizi di sicurezza a protocolli di livello più elevato, come TELNET, FTP e HTTP. Effettuato il login si accede ad una pagina composta da un menù comprendente un tools di strumenti, necessari per la gestione del servizio, posizionato alla sinistra dell area informativa centrale. Questa è la struttura che accomuna ogni pagina del sito ed é attraverso i tools di strumenti che l utente interagisce per visualizzare il contenuto richiesto nell area informativa. 4
Programmazione Per visualizzare i codici registrati, seleziono nel menù Account View. La pagina visualizzata mostra una tabella che associa ad ogni codice, in questo caso 709xxx, un numero identificativo guidkey, la tabella contiene rispettivamente le colonne : fig.1 Contract che identifica il numero del contratto con l utente. Icona ( ) che indica lo stato di abilitato o disabilitato. Description che riporta la descrizione del servizio. Class che indica il numero telefonico per la chiamata del dialer. Banners che indica la tipologia del banner visualizzato. Icona ( ) che indica l editing del singolo codice. Icona ( ) che cancella il record (ricordiamo all utente di fare attenzione a non cancellare alcun record). Il campo Description é linkabile ed é necessario a verificare, direttamente da questa pagina, la corretta programmazione dei parametri. Il click del link esegue l apertura della pagina vntras Communication Suite. La pagina verrà visualizzata in prima piano nella parte alta dello schermo, subito dopo verrà visualizzato un avviso che vi informa che l operazione ha richiesto dati non protetti da SSL. Confermate con apposito bottone YES/SI. Fig.2 5
Questo avviso sarà visualizzato soltanto quando la richiesta verrà inviata dall area Membersite. Una normale apertura di pagina vntras Communication Suite da parte di un cliente dal sito web non genera nessun tipo di avviso. fig.2 Cliccando l icona dell editing, si visualizza la form associata alla guidkey - chiave con la quale viene effettuata la chiamata per l oggetto ActiveX - identificativa del servizio. La form contiene i seguenti campi: fig.3 6
DESCRIPTIONS, descrizione del servizio o nome del sito. CLASS, indica la numerazione a valore aggiunto. TAX*, valore della tassazione che abbiamo classificato con il codice 709 (invitiamo l utente a non variare il contenuto già presente per default). RAS-USERID, nome utente per accedere al pop del servizio remoto. RAS-PASSWORD, password per accedere al pop del servizio remoto. BANNERS**, indica la categoria del bunner visualizzato (questa categoria non può essere modificata dall utente). REDIRECT, indirizzo per l accesso verso un server di servizio per l apertura del documento richiesto. URL EXEC, url per un file eseguibile (dialer) che dovrà essere scaricato quando sulla macchina del cliente non potrà essere eseguita l applicazione ActiveX. STATUS, lo status attivo o inattivo. Successivamente alla compilazione, si conferma con l invio. Attenzione URL EXEC per default in questo campo verrà inserito un url per il file eseguibile compilato dal nostro sistema, all interno del quale in modo automatico verranno inseriti i parametri: CLASS, RAS-USERID, RAS-PASSWORD, REDIRECT. E importante considerare che la tecnologia vntras è stata progettata per l utilizzo dell oggetto ActiveX per cui il file eseguibile non verrà mai modificato durante i cambiamenti da voi apportati all interno della form. Di conseguenza nel caso in cui vorrete cambiare i parametri sopra citati, dovrete provvedere ad una nuova versione del file eseguibile, ed effettuare un cambio di URL EXEC. L URL EXEC è stato progettato in funzione di una maggiore compatibilità di utilizzo della nostra piattaforma in quanto l oggetto ActiveX può essere eseguito esclusivamente in ambiente Internet Explorer, tale parametro garantisce in modo automatico all utente, il file eseguibile per la connessione in caso di problemi con ActiveX. 7
Programmazione pagine HTML pubbliche Per utilizzare correttamente il vntras nella modalità ActiveX, è necessario inserire nelle pagine in formato html alcune righe di codice. Chiaramente si intende che il codice da inserire è residente in un web server, che eroga il vostro sito web destinato al pubblico. In ogni pagina dalla quale dovrà essere aperta la pagina vntras Communication Suite contenente il dialer, dovrà essere inserito il seguente codice: fig.4 <SCRIPT language=javascript src="http://www.voitek.net/vntras/load.js"></script> Questo codice di volta in volta che la vostra pagina verrà visualizzata, preleva il file load.js che fa riferimento per la funzione di apertura della pagina vntras Communication Suite [ javascript:openwindow(); ] 8
Per richiamare la pagina vntras Communication Suite contenente il dialer, bisogna inserire un classico [ <A href ] nel seguente modo: fig.5 <A href="javascript:openwindow('xxx')">cliccaqui</a> Nel posto di xxx deve essere inserito un guidkey attraverso il quale verrà identificato il servizio richiesto e assegnati tutti i parametri necessari per il collegamento. Quando l utente effettua un click sull apposito link, verrà visualizzata la finestra vntras Communication Suite che si posiziona in alto a sinistra in primo piano sullo schermo, all interno della quale è inserito l oggetto ActiveX con gli strumenti per poter effettuare una nuova connessione. 9
Durante la prima volta che verrà richiamata questa pagina, l oggetto ActiveX verrà scaricato all interno della macchina del cliente. La dimensione del file vntras.cab é di circa 340 KB. Una volta installato l oggetto ActiveX si visualizza direttamente all interno della pagina vntras Communication Suite. Il cliente a la possibilità di selezionare il tipo di modem per effettuare il collegamento da un elenco creato in modo automatico dalla macchina stessa, questa informazione verrà prelevata grazie a un interfaccia TAPI. Nella zona sinistra in basso, si trova una cella per inserire il codice di accesso alla linea esterna che sarà composto prima dell immissione del numero a valore aggiunto. I due parametri sopra descritti, una volta effettuata la connessione, (si intende una connessione completata correttamente e la visualizzazione della pagina richiamata dal REDIRECT) verranno memorizzate all interno di Windows Registry. [HKEY_CURRENT_USER\Software\Voitek\vntras] "outline"="943894" "device"="standard 33600 bps Modem" Il successivo click sull apposito link per richiamare la pagina vntras Communication Suite in modo automatico, richiama e inserisce i parametri memorizzati. 10
La finestra vntras Communication Suite é una semplice pagina HTML aperta in modalità fullscreen e del tipo fullwindow che contiene un object. Una volta visualizzata verrà eseguita l applicazione vntrsa.ocx che interagisce direttamente con la library rasapi32.dll della Microsoft. Per effettuare il collegamento é sufficiente fare click sul bottone ENTRA presente nella form dell applicazione stessa, oppure utilizzate una chiamate esterna verso il [ <object id=vntras ]. Attualmente questa funzione é utilizzata nella pagina vntras Communication Suite sul testo ( Premi ENTER per la connessione. ) fig.6 (!)Durante il collegamentom la finestra vntras Communication Suite deve restare aperta, la chiusura interrompe la connessione, in quanto applicazione é eseguita direttamente dall interno di un documento HTML. Il meccanismo di apertura della pagina vntras Communication Suite è stato progettato in modo tale che in un ambiente del sistema operativo potrà essere aperta soltanto una sessione del dialer con le stesse caratteristiche. Di conseguenza una volta aperta la pagina il successivo click sullo stesso link non avrà alcun effetto. Nella versione attuale la seconda azione genera soltanto un errore dello scripts (Error on page.) che verrà segnalato soltanto con il cambio dell icona nella bara di stato di Internet Explorer. La scelta di questa procedura ha una grande importanza per quanto riguarda la navigazione nel sito web nel quale verrà utilizzato lo stesso link in più pagine. Una volta aperta la pagina vntras Communication Suite e eseguita l applicazione, l utente é già in grado di effettuare un cambio della connessione. Una volta connesso l utente può tornare nelle pagine del sito web pubblico ed effettuare nuovi click sui link che richiamano la pagina vntras Communication Suite. Chiaramente in questa situazione la pagina di connessione é già aperta e la sua azione verrà ignorata, e segnalata soltanto con il cambio dell icona nella barra di stato di Internet Explorer. In questo modo non verrà mai aperta una nuova finestra, viene aggiornata quella già presente, per non interrompere la connessione che in questo momento viene gestita dal vntras Communication Suite. (!) 11