Dipartimento Affari Interni e Territoriali Direzione Centrale per i Servizi Demografici INA-SAIA. SSLProxy. Manuale Utente. versione 1.

Dimensione: px

Iniziare la visualizzazioe della pagina:

Download "Dipartimento Affari Interni e Territoriali Direzione Centrale per i Servizi Demografici INA-SAIA. SSLProxy. Manuale Utente. versione 1."

Antonietta Luciani
7 anni fa
Visualizzazioni

1 SSLProxy Manuale Utente versione 1.0

2 Indice 1 Panoramica Installazione Prerequisiti Acquisizione del pacchetto Copia dei file sulla postazione client Esecuzione del programma Configurazione Configurazione di base Modifica del file hosts Modifica delle impostazioni del browser Risoluzione dei problemi Host sconosciuto Handshake fallito Errore nel file di configurazione Errore nell'installazione dei certificati

3 1 Panoramica SSLProxy è un programma Open Source, rilasciato sotto licenza GNU GPL, che consente la comunicazione sicura su canale SSL verso la Porta di accesso ai domini applicativi del CNSD (d'ora in poi indicata semplicemente come Porta di accesso). Il proxy si occupa di instaurare una connessione con la porta, rendendo trasparente alle applicazioni dei sistemi comunali il processo di autenticazione e scambio di certificati digitali. Nel presente manuale sono descritti i passi necessari per l'installazione e la corretta configurazione di SSLProxy. 3

4 2 Installazione 2.1 Prerequisiti Per il corretto funzionamento di SSLProxy è necessario che sulla postazione client sia presente la JRE (Java Runtime Environment) versione o successive. Sul supporto informatico delle QSAC (Quantità di Sicurezza, Attivazione e Certificazione), nella cartella vm, è presente il programma di installazione della JRE per sistemi MS Windows. Per le postazioni che utilizzano un sistema operativo differente (ad esempio Linux) è possibile scaricare una versione aggiornata della JRE collegandosi al sito Acquisizione del pacchetto Il pacchetto contenente SSLProxy deve essere generato utilizzando il programma di Gestione QSAC presente sulla Porta di accesso. Il programma, tramite un menu, permette all'utente l'estrazione di certificati digitali dal CD delle QSAC o, in alternativa, del pacchetto relativo al proxy. L'utente può generare 7 differenti pacchetti; si ricorda che ogni postazione comunale deve utilizzare un pacchetto di SSLProxy differente dalle altre. 2.3 Copia dei file sulla postazione client Una volta generato il pacchetto, il programma di Gestione QSAC comunica all'utente la posizione della cartella sslproxy, contenente il pacchetto stesso. A questo punto è sufficiente copiare la cartella sslproxy dalla Porta di accesso alla postazione comunale dove si intende installare il proxy. 2.4 Esecuzione del programma Per i sistemi Windows, SSLProxy può essere avviato con un doppio clic sul file SSLProxy.jar 4

5 presente nella cartella sslproxy (v. figura seguente). Figura 1. Avvio del programma (MS Windows) Per i sistemi Linux è sufficiente digitare il comando $ java -jar SSLProxy.jar dalla cartella sslproxy. Una volta avviato, SSLProxy sarà visibile come icona nel System Tray (la zona in basso a destra del Desktop, per i sistemi Windows). 5

6 Figura 3. Icona di SSLProxy (Linux) Figura 2. Icona di SSLProxy (MS Windows) Il proxy può essere interrotto o riavviato utilizzando il menu a tendina; se viene interrotto l'icona assume un aspetto differente. Figura 4. Interruzione del proxy (MS Windows) E' possibile visualizzare informazioni sui certificati utilizzati dal proxy e sullo stato attuale (byte inviati e ricevuti) utilizzando la voce Informazioni... del menu. 6

7 Figura 5. Informazioni sullo stato del proxy (Linux) 7

8 3 Configurazione 3.1 Configurazione di base I principali parametri di configurazione del proxy possono essere modificati direttamente dalla voce Configurazione... del menu a tendina. E' mostrata all'utente la schermata riportata in figura: Figura 6. Configurazione di SSLProxy parametri generali 8

9 Nella prima sezione si trovano i parametri di carattere generale: Porta: la porta TCP su cui è in ascolto il proxy Timeout locale: se diverso da zero, il timeout della comunicazione fra il proxy e il client locale (in millisecondi) Timeout remoto: se diverso da zero, il timeout della comunicazione fra il proxy e il server remoto (in millisecondi) Dimensione del buffer: lunghezza in bit del buffer in ricezione Host/Porta di default: rappresentano la destinazione di default per le richieste, utilizzata se non è possibile determinare una coppia host/porta dall'intestazione della richiesta Comunicazione SSL: specifica se il dialogo con l'host di default avviene in chiaro o su SSL Protocollo: il proxy può essere configurato per interpretare le richieste in modi differenti; v. nota di seguito Un chiarimento sui protocolli: per richiesta con delimitatore si intende un messaggio delimitato da una sequenza precisa di caratteri, mentre per richiesta binaria si intende un flusso di informazione privo di delimitatori. Ovviamente il proxy riesce ad interpretare le richieste, e determinare una coppia host/porta a cui indirizzarle, solo se esse sono in formato HTTP 1.1; in tutti gli altri casi le richieste vengono inoltrate all'host di default. Per questo motivo deve essere inserita nei campi Host di default e Porta di default la coppia host/porta relativa alla Porta di accesso. 9

10 Figura 7. Configurazione di SSLProxy protocolli Nella seconda sezione è possibile configurare parametri specifici per ogni protocollo. Per le richieste con delimitatore: Delimitatore: la sequenza di caratteri che termina le richieste delimitate Ignora delimitatore: è possibile scegliere se inoltrare o meno il delimitatore insieme alla richiesta Per le richieste binarie: Dimensione del buffer: la dimensione in bit del buffer su cui vengono memorizzate le richieste da inviare all'host remoto 10

11 L'ultima sezione della configurazione riguarda il livello di dettaglio dei file di log: Figura 8. Configurazione di SSLProxy log E' possibile scegliere fra 3 livelli distinti. Il livello FINE è consigliabile solo per la risoluzione di problemi (il dettaglio è considerevole). 11

12 12

13 3.2 Modifica del file hosts Un utilizzo tipico di SSLProxy è quello di proxy HTTP: consente infatti di inviare alla Porta di accesso anche solo una parte delle richieste provenienti dai client (ad esempio browser web). E' possibile selezionare quali richieste inviare alla Porta di accesso e quali instradare normalmente verso gli host remoti modificando il file hosts presente nella cartella sslproxy. Il file ha la seguente struttura: host_origine:porta SSL(s/n) host_destinazione:porta In altre parole, ogni riga specifica una regola per inoltrare le richieste da una coppia host/porta a una coppia host/porta differente. Ad esempio, la riga :443 s impone al proxy di inviare le richieste dirette al sito verso l'host , sulla porta 443 e utilizzando SSL. E' possibile utilizzare come host di destinazione la parola chiave default per indicare la coppia host/porta di default specificati nella configurazione del proxy (v.figura). 13

14 Figura 9. Inserimento di host/porta di default nel file "hosts" Nella pratica, una volta indicati nella configurazione il nome host e la porta TCP della Porta di accesso come host/porta di default, sarà possibile accedere al servizio nomeservizio.dominio.it inserendo nel file hosts la riga nomeservizio.dominio.it:80 default s 14

15 3.3 Modifica delle impostazioni del browser Nel caso in cui si utilizzi un browser web come client, è necessario impostare SSLProxy come proxy HTTP per quel browser. Nelle figure seguenti sono indicati i passi da compiere per configurare MS Internet Explorer e Mozilla Firefox. Internet Explorer: Figura 10. Accedere alla schermata "Opzioni internet" del menu "Strumenti" 15

16 Figura 11. Premere il pulsante "Impostazioni LAN" e utilizzare come proxy server "localhost", inserendo la stessa porta presente nella configurazione di SSLProxy 16

17 17

18 Mozilla Firefox: Figura 12. Nelle impostazioni generali premere il pulsante "Impostazioni Connessione" e inserire host e porta del proxy 18

19 4 Risoluzione dei problemi SSLProxy può inviare all'utente diversi messaggi di errore. Vengono qui descritti alcuni casi specifici. 4.1 Host sconosciuto Nel caso l'utente abbia digitato un indirizzo inesistente, il proxy visualizza il seguente messaggio: Figura 13. Host sconosciuto 4.2 Handshake fallito Il proxy è configurato per dialogare esclusivamente con la Porta di accesso; se si tenta di comunicare in SSL con un altro host viene mostrato il messaggio Handshake SSL fallito. 19 Figura 14. Handshake fallito

20 Verificare che l'indirizzo riportato nell'host di default coincida con quello della Porta di accesso, e controllare che nel file hosts non siano presenti host di destinazione diversi dalla Porta di accesso. 4.3 Errore nel file di configurazione Il file di configurazione di SSLProxy ( config.xml ) viene generato automaticamente dal programma durante l'esecuzione. Una modifica o cancellazione del file da parte dell'utente può provocare il seguente messaggio: Figura 15. Errore nel file di configurazione Non è necessaria alcuna azione da parte dell'utente; il proxy genera un nuovo file, sostituendolo al precedente. Potrebbe essere necessario ripetere la configurazione del Proxy. 4.4 Errore nell'installazione dei certificati Nel caso di problemi riguardanti i certificati, SSLProxy mostra il seguente messaggio di errore: 20

21 Figura 16. Problemi con i certificati In questo caso è necessario eliminare la cartella sslproxy e ripetere l'installazione. 21

Documenti analoghi

INVIO FATTURE ATTIVE IN CONSERVAZIONE. Istruzioni

INVIO FATTURE ATTIVE IN CONSERVAZIONE Istruzioni Per l'invio delle Fatture attive è possibile utilizzare un prodotto di trasferimento file ( client ftp ) quali FileZilla oppure WinSCP. I due prodotti,