Manuale d'uso Sistema di gestione delle richieste di configurazione dei servizi CART Versione 1.4 21/05/2013
1 Scopo del manuale... 3 2 Il Sistema di gestione delle richieste...4 2.1 Sottoscrizione utenti...6 2.2 Home page utente...8 2.3 Inserimento Richieste...14 2.3.1 Richiesta di erogazione...14 2.3.2 Richiesta di fruizione...20 2.3.3 Richiesta di Attivazione Proxy... 24 2.3.4 Richiesta di Deploy di Proxy... 27 2.3.5 Notifiche cambio di stato delle richieste... 29 2.4 Gestione Richieste...29 2.5 Approvazione delle richieste...31 2.6 Scheda di Configurazione...32 2.7 Sospensione delle richieste di erogazione / fruizione...35 2.8 Riattivazione delle richieste di erogazione / fruizione...35 2.9 Reportistica...36 2.10 Ricerca richieste...41 2.11 Statistiche richieste...43 3 Riferimenti per Help Desk... 44 4 Lista dei documenti...45
1 Scopo del manuale Lo scopo del presente manuale è quello di fornire indicazioni circa l'utilizzo del sistema di gestione delle richieste di attivazione di servizi nell'architettura di cooperazione applicativa CART di Regione Toscana, integrato nel portale CART ed accessibile a partire dalla sezione Uso del CART. 3/45
2 Il Sistema di gestione delle richieste Per la gestione delle richieste di fruizione e di erogazione dei servizi in ambito CART è stata sviluppata un applicazione Web, integrata all'interno del portale CART, il cui scopo è quello di guidare il processo di gestione dei servizi CART al fine di garantire il rispetto delle procedure definite dalla Comunità etoscana Compliance e consentire di uniformare il trattamento di tutte le interazioni fra utenti dell'infrastruttura e gestore CART. All'interno del portale CART è stato predisposto un ambiente ad accesso riservato per la gestione delle richieste di fruizione e di erogazione dei servizi: tali richieste in passato venivano effettuate mediante la compilazione e l'invio tramite mail dei moduli di richiesta ottenibili dal portale CART. L'esperienza ha dimostrato che la gestione di tali documenti è complessa e può quindi essere fonte di errori o fraintendimenti fra utenti e gestori. In aggiunta è stato attivato un servizio anche per la gestione del processo di dispiegamento dei proxy applicativi in ambiente CART. L'applicazione consente ad utenti associati alla piattaforma OSCAT di effettuare richieste di Verifica di un proxy in ambiente CART di staging: il gestore di OSCAT in seguito alla installazione del proxy effettuata dal gestore CART, effettua le operazioni di verifica del proxy lanciando la test suite e certifica, mediante il sistema SLC, il corretto funzionamento del proxy. Inoltre l'applicazione consente agli Sviluppatore dei Servizi di effettuare richieste di Attivazione del Proxy in ambiente di Staging del CART. Infine consente ai Referenti del progetto in collaborazione con i Referenti di progetto pressi gli Enti, di effettuare richieste di Attivazione del Proxy in ambiente di Produzione del CART. In entrambi i casi possono essere accettate solo richieste di attivazione relativamente a proxy che sono stati precedentemente verificati e certificati. Riepilogando, quindi, le richieste gestite dall'applicazione sono: Richieste di fruizione di servizi CART; Richeste di erogazione di servizi CART; Richieste di deploy di proxy in ambiente CART; Richieste di attivazione di proxy, ovvero di servizi che prevedono l'uso di proxy in ambiente CART. All'interno del sistema è previsto un insieme di profili a cui i vari utenti vengono associati al momento della sottoscrizione, in modo tale da consentire l'abilitazione delle varie funzionalità del sistema alle varie utenze. I profili previsti sono: Richiedente: l'utente associato a questo profilo può inoltrare richieste di erogazione e/o fruizione di un servizio CART. Inoltre, un utente con profilo richiedente può presentare richieste di attivazione di un proxy, ovvero richiedere l'attivazione di servizi che prevedono l'uso di proxy applicativi; Richiedente-proxy: l'utente associato a questo profilo può inoltrare richieste di erogazione e/o fruizione di servizi CART (come il profilo richiedente), ed inoltre può 4/45
presentare richieste di deploy e verifica di proxy in ambiente di staging CART; tale profilo è normalmente associato ai gestori della piattaforma OSCAT di RT. Gestore: l'utente associato a questo profilo può prendere in carico le richieste presentate dai richiedenti (richieste di erogazione, fruizione, deploy e attivazione proxy), effettuare le relative configurazioni e restituire una scheda di configurazione all'utente che ha presentato la richiesta; Referente di progetto: è colui il quale, contattato da un gestore in merito ad una richiesta di erogazione, fruizione o attivazione di proxy, può autorizzarne o meno la configurazione sul CART in ambiente di produzione; Amministratore: abilitato a tutte le funzionalità sopra descritte. 5/45
2.1 Sottoscrizione utenti Come detto, il sistema presenta un controllo degli accessi, la cui pagina di Login è riportata nella figura seguente. Per attivare una nuova utenza è previsto un sistema di registrazione degli utenti che permette la sottoscrizione a SLC. Nella pagina di Login è disponibile un link alla pagina di registrazione: come mostrato in figura seguente, sarà richiesto l'inserimento delle seguenti informazioni: Nome (*); Cognome (*); Indirizzo Mail (*); Codice fiscale (*); Telefono; Ragione Sociale Ditta; Login scelta (*); Password scelta (*). Le informazioni contrassegnate con (*) sono obbligatorie. 6/45
Il sistema di sottoscrizione, in seguito alla ricezione di una nuova richiesta, effettuerà una preiscrizione ed invierà all'indirizzo di posta elettronica fornito dall'utente, una mail di verifica, contenente un link necessario per il completamento della procedura di sottoscrizione. L'utente cliccando sul link presente nel testo della mail completerà la sottoscrizione a SLC. Il profilo associato di default all'utente sarà quello di richiedente. Il sistema di sottoscrizione abilita l'utenza creata all'accesso ad entrambi gli ambienti di dispiegamento dell'applicazione SLC, ovvero sia in ambiente di staging che in ambiente di produzione. 7/45
2.2 Home page utente Dopo aver effettuato la login al sistema, l'utente accederà alla pagina principale, la quale presenta una vista sintetica delle richieste effettuate dall'utente, raggruppate per tipologia (fruizione, erogazione, deploy ed attivazione proxy) e per stato. Gli stati del workflow previsti dal sistema sono i seguenti: Presentata: la richiesta è stata inoltrata dall'utente richiedente al sistema di gestione; Presa in carico: la richiesta è stata presa in carico dal gestore CART; Richiesta di aggiornamento: il gestore CART dopo aver analizzato la richiesta ritiene opportuno avere chiarimenti o ulteriori informazioni al richiedente; Aggiornata: l'utente richiedente, in seguito alla ricezione di una richiesta di aggiornamento, effettua le modifiche necessarie alla richiesta o chiarisce i dubbi al gestore anche utilizzando il campo Commenti ; Richiesta di approvazione: il gestore CART, prima di procedere con le configurazioni del servizio nell'ambiente di produzione, richiede l'approvazione da parte del Referente del progetto. Approvata: il Referente del progetto autorizza la richiesta; In configurazione: il gestore CART esegue le configurazioni sul sistema, i test ed i controlli necessari alla verifica della configurazione; Configurata: il gestore notifica al richiedente l'avvenuta configurazione. Da questo momento il servizio SPCoop risulta disponibile sull'infrastruttura di riferimento e il richiedente potrà accedere alla scheda di configurazione contenente tutte le informazioni necessarie all'utilizzo del servizio; Eliminata: l'utente annulla una richiesta. Nel caso di richieste di deploy di proxy il workflow è esteso mediante i seguenti stati: In installazione: il richiedente-proxy richiede al gestore CART l'installazione del proxy. Richiesta esecuzione Test Suite: il gestore CART informa il richiedente-proxy dell'avvenuta istallazione del proxy e richiede la verifica del funzionamento. Test Suite eseguita con successo: dopo aver eseguito con successo la test suite il richiedente-proxy certifica che il proxy è funzionante e quindi da quel momento in poi sarà possibile accettare richieste di attivazione anche per questo nuovo proxy. La pagina principale dell'utente è mostrata nella figura seguente. Essa riporta l'elenco delle richieste presentate dall'utente, suddivise per tipologia. Sono presenti quindi 4 sezioni principali (richieste di erogazione, fruizione, deploy proxy e attivazione proxy), all'apertura delle quali il sistema mostrerà una scheda per ogni stato, con il relativo numero di richieste; ogni scheda conterrà una lista parziale delle richieste, ordinate per data ultima modifica crescente. E' possibile invertire l'ordinamento delle richieste per data ultima modifica, cliccando sulla freccia accanto alla dicitura Data Modifica. Il sistema permette la navigazione fra gli stati cliccando sulla dicitura relativa allo stato di interesse. 8/45
Ogni richiesta è identificata da un ID univoco assegnato automaticamente dal sistema ad ogni nuova richiesta. Nella pagina vengono inoltre visualizzati il titolo della richiesta, la data e l'autore dell'ultima modifica (da notare che possono modificare la richiesta sia l'utente richiedente che il gestore CART che il Referente di progetto). Il link sull'identificativo permette di accedere in visualizzazione e modifica della richiesta: nel caso in cui la richiesta risulti nello stato Configurata, il link sul titolo permette di accedere alla scheda di configurazione, descritta di seguito, che riporta le informazioni necessarie per l'utilizzo del servizio. Come detto, cliccando sul link riportato sull'identificativo della richiesta si accede alla pagina di dettaglio, nella quale sono riportate tutte le informazioni relative alla richiesta. 9/45
10/45
11/45
Mediante il menù principale mostrato nelle figure seguenti, disponibile in ogni pagina dell'applicazione, è possibile accedere alle varie sezioni dell'applicazione. Il menù varia a seconda del profilo dell'utente e a seconda dell'ambiente di riferimento (staging o produzione). Nel caso di profilo Richiedente (sia in ambiente staging che in produzione) avremo un menù del tipo: Nel caso di profilo Referente di progetto (sia in ambiente staging che in produzione) avremo un menù del tipo: Nel caso di profilo Richiedente-proxy in ambiente di staging avremo un menù del tipo: 12/45
Nel caso di profilo Richiedente-proxy in ambiente di produzione avremo un menù del tipo: Nel caso di profilo Gestore CART in ambiente staging avremo un menù del tipo: Nel caso di profilo Gestore CART in ambiente produzione avremo un menù del tipo: Il link Home SLC riporta alla pagina principale sopra descritta. I link Erogazione, Fruizione, Attivazione Proxy e Deploy Proxy conducono alle sezioni principali del sistema, relative rispettivamente alle richieste di Erogazione, di Fruizione, di Attivazione di Proxy e di Deploy Proxy. Il link Proxy contiene i sotto-link di cui sopra Attivazione Proxy e Deploy Proxy. In tutti i casi si attiva un sottomenù che presenta un link a Gestione Richieste e uno a Nuova Richiesta, i quali conducono, rispettivamente, alla pagina riepilogativa delle richieste della tipologia selezionata e alla pagina per l'inserimento di una nuova richiesta. Il link Utility contiene i sotto-link: Ricerca per accedere alla pagina di ricerca richieste Statistiche per accedere alla pagina di statistiche delle richieste (solo per il profilo Gestore CART ) Reportistica per accedere alla pagina di reportistica, in cui è possibile avere una visione complessiva dello stato di tutte le richieste e delle configurazioni dei servizi sull'infrastruttura CART nell'ambiente di riferimento. Il gestore CART ha a disposizione una sezione Gestione Utenti per configurazione delle utenze del sistema. Infine nella sezione Profilo sono presenti link per l'accesso all'ambiente duale (staging/produzione), alla documentazione, alla pagina per il cambio password e all logout dal sistema. 13/45
2.3 Inserimento Richieste Selezionando dal menù principale la sezione Erogazione, la sezione Fruizione, la sezione Attivazione Proxy e successivamente scegliendo il sottomenù Nuova Richiesta si accede alla pagina per l'inserimento delle richieste della tipologia scelta. L'utente con profilo richiedente-proxy oltre alle funzionalità sopra elencate avrà anche la possibilità di effettuare richieste per il Deploy di Proxy in ambiente di staging del CART. Riportiamo di seguito la descrizione delle principali informazioni richieste dal sistema durante la compilazione delle richieste in ambiente CART. Alcune informazioni di carattere generale sono comuni a tutte le varie tipologie e sono elencate di seguito: Titolo per identificare sinteticamente la richiesta; Nome, cognome, indirizzo di posta elettronica e telefono del Referente di Progetto presso l'ente per cui si sta effettuando la richiesta; Nome, cognome, indirizzo di posta elettronica e telefono del Referente presso la Ditta che supporta tecnicamente l'ente e nome della Ditta stessa; Nome, cognome, indirizzo di posta elettronica del Referente di Progetto di Regione Toscana. In base al tipo di richiesta scelta si prefigureranno scenari distinti e quindi saranno richieste informazioni specifiche e differenziate per tipologia. Vediamo nello specifico ogni singola tipologia di richieste. 2.3.1 Richiesta di erogazione. Nella figura seguente è mostrata la pagina di inserimento di richieste di erogazione di servizi CART. 14/45
15/45
Per inserire le informazioni generali dei vari referenti, l'utente ha la possibilità di accedere ad una Rubrica condivisa fra tutti gli utenti, contenente tutti i Referenti di Progetto, i Referenti presso l'ente ed i Responsabili delle Ditte sviluppatrici, in modo da evitare di dover reinserire ogni volta le stesse informazioni. La rubrica è aggiornabile direttamente dagli utenti del sistema SLC. Il vincolo di unicità del riferimento inserito è legato all indirizzo di mail, quindi non sarà permesso inserire un nuovo elemento nella rubrica avente indirizzo e-mail uguale ad uno già presente. Per accedere alla rubrica è necessario cliccare sul bottone Rubrica, attraverso il quale si aprirà un pop-up per la ricerca della persona in funzione di nome, cognome ed e-mail. 16/45
I tre campi di ricerca non sono obbligatori. Il risultato della ricerca sarà la lista di utenti che corrispondono ai criteri di ricerca. E' possibile quindi selezionare un utente dalla lista al fine di popolare il campo della richiesta. Cliccando sulla voce Inserimento in rubrica l'utente può inserire nuovi utenti nella rubrica. 17/45
L'utente quindi, oltre alle informazioni generali sul Referente di Progetto presso l'ente, del Referente tecnico e relativa Ditta che supporta tecnicamente l'ente e del Referente di Progetto di Regione Toscana, dovrà indicare innanzitutto il soggetto erogatore a cui il servizio dovrà essere associato, mediante l'inserimento di un campo descrittivo: in seguito il gestore CART assocerà alla richiesta il relativo soggetto SPCoop come definito nell'architettura di cooperazione, riportandone gli estremi nella scheda di configurazione finale. Sarà necessario selezionare la RFC di riferimento. Nel caso in cui siano già presenti Accordi di servizio associati alla RFC selezionata, il sistema visualizzerà l'elenco degli Accordi e l elenco dei relativi servizi, se esistenti, in modo da consentire all utente di verificare la coerenza del proprio servizio erogato rispetto alle precedenti configurazioni e selezionarne uno fra di essi. Nel caso invece in cui nel sistema non siano già stati definiti Accordi associati alla RFC, l'utente avrà due possibilità dipendentemente dal fatto che abbia a disposizione il WSDL Logico del servizio: 18/45
1. Caricare il WSDL descrittivo del servizio. In questo caso è necessario che l'utente effettui il caricamento di file WSDL cliccando sul bottone Carica WSDL. Questo consentirà al sistema di estrarre automaticamente i nomi dei servizi e delle azioni in modo da mantenere l'allineamento fra WSDL logico e i servizi e le azioni configurate sul sistema CART, secondo l'associazione port-type servizio operation azione Per proseguire con la richiesta, l'utente dovrà selezionare uno dei servizi riportati dal sistema; 2. In mancanza del WSDL, potrà inserire manualmente il nome del servizio e delle azioni negli opportuni campi di testo libero. In entrambi i casi la creazione dell'accordo è a carico del gestore CART. Inoltre il richiedente avrà la possibilità di fornire il Types.xsd del servizio. Il richiedente deve selezionare il profilo di collaborazione tra i seguenti valori: oneway; sincrono; asincrono simmetrico; asincrono asimmetrico. Se il servizio da erogare è relativo ad un accordo di servizio preesistente, il profilo di collaborazione viene definito dall'accordo stesso. E' possibile attivare il Filtro Duplicati e selezionare l'utilizzo dell'accordo senza l'azione. Per consentire al gestore CART di effettuare le opportune abilitazioni di rete per l'accesso al servizio erogatore, è possibile inserire l'indirizzo IP del SIL erogatore. Il richiedente potrà scegliere la modalità di integrazione che intende utilizzare per interagire con la PdD tra Proxy Trasparente e Integration Manager : quest ultima è utilizzabile solo nel caso di profili di collaborazione oneway. Nel caso di scelta di modalità Proxy Trasparente sarà necessario indicare: - URL del servizio erogatore da invocare; 19/45
- Tipo di autenticazione (nessuna, basic, https): - per il tipo basic sarà necessario specificare username e password; - per il tipo https sarà necessario indicare il subject del certificato; Solo nel caso di modalità di integrazione mediante Proxy Trasparente si potrà specificare se avvalersi dell utilizzo della riconsegna in caso di errori dovuti al mancato raggiungimento del servizio erogatore (indicato precedentemente nella URL) durante l'invocazione da parte della porta di dominio. Il richiedente, inoltre, sceglierà il protocollo utilizzato per l erogazione. I valori possibili saranno http o https. E' possibile inserire altri destinatari di posta elettronica ai quali notificare in copia le mail inviate dal sistema ad ogni cambio di stato della richiesta. E' possibile eseguire l upload di uno o più messaggi di test da usare per la validazione delle configurazioni. Nella sezione Note e Commenti il richiedente potrà inserire nella text-area eventuali commenti e/o richieste che saranno puntualmente valutate dal gestore CART ed infine potrà effettuare l upload di un documento che ritiene possa essere utile al gestore CART per il completamento della configurazione. 2.3.2 Richiesta di fruizione La pagina presentata per effettuare richieste di fruizione è mostrata in figura seguente. 20/45
Per inserire le informazioni dei vari referenti l'utente può utilizzare la rubrica, descritta nel paragrafo Richieste di erogazione. 21/45
Oltre alle informazioni generali sul Referente di Progetto presso l'ente, del Referente tecnico e relativa Ditta che supporta tecnicamente l'ente e del Referente di Progetto di Regione Toscana, è previsto l'indicazione del soggetto fruitore a cui dovrà essere associata la fruizione, mediante l'inserimento di un campo descrittivo: in seguito il gestore CART assocerà alla richiesta il relativo soggetto SPCoop come definito nell'architettura di cooperazione, riportandone gli estremi nella scheda di configurazione finale. L utente quindi dovrà selezionare la RFC di riferimento. Successivamente verrà mostrato l accordo di servizio e l elenco dei servizi configurati associati alla RFC di riferimento scelta, in modo tale che l utente possa selezionare il servizio per cui esiste almeno un erogatore configurato. Nel caso in cui non esista la RFC per il servizio per cui si richiede la fruizione, sarà possibile in ogni caso cercare fra gli accordi presenti se esiste l'accordo di servizio desiderato. Nel caso in cui invece, selezionata la RFC, non esista un accordo e un servizio erogatore relativo, il sistema consentirà comunque di inoltrare la richiesta di fruizione solo con l'indicazione della RFC: in seguito il gestore CART si consulterà con il Referente di progetto di Regione Toscana per la definizione dell'accordo di servizio e del servizio erogatore e successivamente aggiornerà la richiesta con tali informazioni. Per le richieste di fruizione non sarà necessario indicare la modalità di integrazione, in quanto sulla porta di dominio saranno sempre disponibili entrambi le modalità. A tal proposito, nella scheda di configurazione finale il sistema presenterà le informazioni necessarie per l'integrazione in entrambe le modalità Integration Manager o Proxy Trasparente. L utente dovrà scegliere il protocollo utilizzato per la fruizione. I valori possibili saranno http o https. Sarà inoltre possibile selezionare l utilizzo della funzionalità di correlazione applicativa. In caso di selezione di tale opzione verrà richiesta la modalità di iniezione scelta tra: - modalità url-based: si dovrà indicare il nome del parametro aggiunto alla url di invocazione della PD il cui valore rappresenterà l ID univoco da usare come ID applicativo; - modalità content-based: si dovrà indicare il PATH XML per l estrazione dell ID univoco dal messaggio applicativo; - modalità input-based (iniettata quindi direttamente mediante IM): non sarà necessario inserire nessun altra informazione. 22/45
Il richiedente, inoltre, sceglierà il protocollo utilizzato per l erogazione. I valori possibili saranno http o https. Sarà possibile inserire altri destinatari di posta elettronica ai quali notificare in copia le mail inviate dal sistema ad ogni cambio di stato della richiesta. Nella sezione Note e Commenti il richiedente potrà inserire nella text-area eventuali commenti e/o richieste che saranno puntualmente valutate dal gestore CART ed infine potrà effettuare l upload di un documento che ritiene possa essere utile al gestore CART. Al termine della compilazione della richiesta l'utente, cliccando sul bottone Inoltra, potrà effettuare l'inoltro della richiesta al gestore CART: la richiesta verrà posta in stato Presentata. 23/45
2.3.3 Richiesta di Attivazione Proxy L'applicazione consente all'utente di effettuare una richiesta di attivazione di servizi che prevedono l'uso di proxy applicativi: prerequisito a tale richiesta è l'esistenza di un proxy sviluppato, testato e validato in ambiente di staging del CART. Come per le altre richieste, sarà necessario inserire le seguenti informazioni: Titolo della richiesta; Nome, Cognome e Mail del Referente di Progetto; Per inserire le informazioni dei vari referenti l'utente può utilizzare la rubrica, descritta nel paragrafo Richieste di erogazione. Nel caso di richieste di attivazione proxy è necessario distinguere le informazioni richieste fra ambiente di staging da quello di produzione. Ambiente di Staging: in figura seguente è mostrata la pagina di inserimento delle richieste di attivazione proxy per l'ambiente di staging. 24/45
Il richiedente (tipicamente l'azienda sviluppatrice del servizio applicativo che si interfaccia con il proxy) indica nella richiesta anche le seguenti informazioni: Nome, Cognome, Telefono e Mail del Referente della Ditta sviluppatrice del servizio applicativo e Ragione Sociale della ditta stessa; Ambiente di Produzione: in figura seguente è mostrata la pagina di inserimento delle richieste di attivazione proxy per l'ambiente di produzione. Il richiedente (tipicamente un referente di progetto oppure un referente di PA) indica nella richiesta le seguenti informazioni: Lista degli Enti per cui si sta richiedendo l'attivazione del proxy: per ogni ente inserire il Nome, Cognome, Telefono e Mail del Referente del progetto presso l'ente (Nota: La finestra di inserimento Ente è a scomparsa : si attiva cliccando sul link Aggiungi Ente. Ogni qualvolta si inserisce un nuovo Ente è necessario cliccare sul pulsante OK per confermare l'inserimento). 25/45
In entrambi i casi dovrà essere selezionata la RFC per cui è stato sviluppato il servizio applicativo relativo al servizio per cui si sta richiedendo l'attivazione, fra l'elenco delle RFC che sono associate ad un proxy Certificato ovvero un proxy precedentemente installato in ambiente CART e verificato dai gestori CART e dai gestori della piattaforma OSCAT. Sarà possibile inserire altri destinatari di posta elettronica ai quali notificare in copia le mail inviate dal sistema ad ogni cambio di stato della richiesta. Nella sezione Note e Commenti il richiedente potrà inserire nella text area eventuali commenti e/o richieste che saranno puntualmente valutate dal gestore CART ed infine potrà effettuare l upload di un documento che ritiene possa essere utile al gestore CART. Nota: L'utente con profilo Richiedente potrà visualizzare anche le richieste per cui è stato indicato come Referente di progetto presso l'ente. Il discriminante in questo caso è dato dalla corrispondenza tra l'indirizzo di mail utilizzato nella compilazione dei dati dell'ente e quello presente nel profilo utente. 26/45
2.3.4 Richiesta di Deploy di Proxy Solo per il profilo richiedente-proxy (associato tipicamente ai gestori della piattaforma OSCAT di RT) sarà possibile accedere mediante la barra di navigazione alla sezione per le richieste di Deploy di proxy in ambiente di staging (in ambiente di produzione tale sezione non è attiva). 27/45
Il richiedente dovrà inserire le seguenti informazioni: Titolo della richiesta; Nome, Cognome e Mail del Referente di Progetto; Nome, Cognome, Telefono e Mail del Referente della Ditta sviluppatrice del proxy applicativo e Ragione Sociale della ditta stessa; Nome del Proxy; Release del proxy da installare; URL da cui effettuare il download del proxy (mediante piattaforma OSCAT); Elenco delle RFC a cui il proxy è associato (selezione multipla fra le RFC ecompliance di RT); Indicazione del tipo di NAL su cui dovrà essere dispiegato il proxy (generico o sanità); Per inserire le informazioni dei vari referenti l'utente può utilizzare la rubrica, descritta nel paragrafo Richieste di erogazione. Sarà possibile inserire altri destinatari di posta elettronica ai quali notificare in copia le mail inviate dal sistema ad ogni cambio di stato della richiesta. Nella sezione Note e Commenti il richiedente potrà inserire nella text area eventuali commenti e/o richieste che saranno puntualmente valutate dal gestore CART ed infine potrà effettuare l upload di un documento che ritiene possa essere utile al gestore CART. 28/45
2.3.5 Notifiche cambio di stato delle richieste Ad ogni transizione di stato della richiesta, effettuato da uno qualsiasi degli attori autorizzati alla modifica della richiesta e abilitati alla transizione di stato, verrà inviata all'utente richiedente, ai Referenti di Progetto, al gestore CART e, se presente, alla lista dei destinatari in CC, una mail in cui verrà riportato l'identificativo della richiesta, lo stato associato alla richiesta ed un estratto delle principali informazioni inserite nella richiesta. 2.4 Gestione Richieste Selezionando il sottomenù Gestione Richieste, presente nel menù Erogazione, nel menù Fruizione, nel menù Attivazione Proxy e nel menù Deploy Proxy, si accede ad una pagina di archivio delle richieste nella quale sono riportate tutte le richieste presentate dall'utente, ordinate in ordine di tempo decrescente come mostrato nella figura seguente. In particolare, per le richieste di erogazione/fruizione, viene riportato un menu a tendina che permette di selezionare le richieste in un determinato stato (Presentata, In carico,.). Alla selezione di uno stato il sistema carica le richieste che si trovano nello stato indicato. Per ogni richiesta è riportato l'identificativo univoco ID, il titolo, la data e l'autore di ultima modifica, lo stato e un link allo storico della richiesta. Cliccando sul link presente sull'id si accede al dettaglio: l'utente con profilo richiedente e richiedente-proxy potrà apportare modifiche alla richiesta solo nel caso in cui lo stato della richiesta sia Presentata o in Richiesta di Aggiornamento. In tutti gli altri casi non sarà possibile eseguire modifiche in quanto in carico al gestore CART oppure in attesa di approvazione da parte di un Referente di Progetto. L'utente che ha i diritti per apportare modifiche alla richiesta, può anche eliminarla scegliendo Eliminazione nella lista delle azioni da eseguire. La richiesta sarà visibile quindi fra quelle eliminate. Solo nel caso in cui la richiesta sia in stato Configurata, sarà attivato un link sulla colonna Stato che condurrà alla Scheda di configurazione. 29/45
Selezionando il link Storico si potrà accedere alla pagina che visualizza tutti i vari passaggi di stato o aggiornamenti subiti dalla richiesta, a partire dal momento della presentazione fino all'ultimo aggiornamento. 30/45
2.5 Approvazione delle richieste Come descritto precedentemente, la procedura di attivazione di servizi in ambiente di produzione CART prevede che la richiesta, prima di procedere nel suo iter di configurazione, debba essere approvata dal Referente di Progetto. In questo caso, il gestore CART, dopo un analisi iniziale, pone la richiesta nello stato di Richiesta approvazione affinché questa possa essere esaminata dal Referente di Progetto. Quest'ultimo sarà avvisato attraverso una apposita mail ed accedendo al sistema SLC con le proprie credenziali, potrà visualizzare il dettaglio della richiesta. Inoltre, accedendo alla home page di SLC, nella sezione identificata dallo stato Richiesta approvazione, potrà verificare tutte le richieste che attendono ancora la sua approvazione. Cliccando sull'identificativo ID della richiesta, potrà accedere al dettaglio e selezionando il menu a tendina relativo a Azioni da eseguire (vedi figura successiva) potrà approvare la richiesta ponendola nello stato Approvata e quindi far si che questa continui il percorso di configurazione, oppure richiedere ulteriori chiarimenti al richiedente ponendo la richiesta nello stato Richiesta aggiornamento. In quest'ultimo caso, il richiedente riceverà una mail che lo avvertirà del cambio di stato che la sua richiesta ha subito. Da qui il richiedente potrà modificare la richiesta, mettendola nello stato Aggiornata cosicché il gestore possa riproporla per essere nuovamente approvata. Il Referente può a sua volta presentare nuove richieste di erogazione/fruizione di servizi CART. 31/45
L'utente associato al profilo Referente di Progetto ha la possibilità di visualizzare tutte le richieste presenti nel sistema e modificare quelle da lui presentate e quelle per cui è stata richiesta un'approvazione. 2.6 Scheda di Configurazione Nella pagina di gestione richieste, nel caso in cui la richiesta sia in stato Configurata, viene attivato un link sulla colonna Stato, mediante il quale sarà possibile accedere alla Scheda di Configurazione, contenente tutte le informazioni necessarie all'utilizzo del servizio configurato. Nella scheda verranno riportate le principali informazioni relativamente all'accordo di servizio, al servizio, ai soggetti e al NAL coinvolto. Nella scheda di fruizione verranno mostrate inoltre le informazioni relative ad entrambe le modalità di integrazione previste (Proxy Trasparente e Integration Manager) in quanto sempre disponibili sulla Porta di Dominio. L'utente potrà decidere in autonomia quale delle due utilizzare. In figura è mostrato un esempio di scheda di fruizione. 32/45
Nella scheda di erogazione invece verranno mostrate solo le informazioni relative alla modalità di integrazione scelta dall'utente durante la richiesta. In figura è mostrato un esempio di scheda di erogazione. E' possibile effettuare un export in formato csv della informazioni mostrate nella scheda, cliccando sul pulsante Export CSV in basso. Analogamente, anche per le richieste di attivazione dei proxy, sarà possibile accedere alla scheda di configurazione, contenente tutte le informazioni che il gestore del CART riterrà necessario fornire per l'uso del proxy: in figura è mostrato un esempio. 33/45
Infine da evidenziare che accedendo al dettaglio della richiesta che si trova in stato Configurata, sulla barra di intestazione della richiesta, è attivato un ulteriore link per l'accesso alla scheda di configurazione, come mostrato in figura seguente. 34/45
2.7 Sospensione delle richieste di erogazione / fruizione Il gestore CART o il referente di progetto hanno la facoltà di sospendere una richiesta di erogazione o di fruizione già configurata. Questo perché talvolta accade che il servizio CART erogatore è correttamente configurato, ma vi è un malfunzionamento (o l'assenza) dell'end-point esterno al dominio CART. Con la funzionalità di sospensione, è possibile la sospensione delle erogazioni e delle fruizioni associate all'anomalia di erogazione. La sospensione di un'erogazione può avvenire solo se la richiesta si trova in stato Configurata. L'utente gestore o il referente di progetto troveranno il pulsante 'Sospendi' in fondo alla pagina di dettaglio della richiesta di erogazione. Tale sospensione comporta la sospensione delle fruizioni configurate del servizio. In questo caso, l'utente richiedente la fruizione riceverà una mail di avviso e non potrà più accedere alla scheda di configurazione della fruizione. Contemporaneamente verranno disabilitate le credenziali di accesso alla porta delegata. L'utente gestore o il referente di progetto possono sospendere anche una singola fruizione in stato Configurata. In questo caso l'erogazione rimane attiva, viene sospesa solamente la singola fruizione. In fondo alla pagina di gestione della richiesta di fruizione sarà presente il pulsante Sospendi La sospensione di una erogazione o di una fruizione viene evidenziata dall'icona presente nelle pagine di lista delle richieste. 2.8 Riattivazione delle richieste di erogazione / fruizione Una richiesta di erogazione sospesa può essere riattivata. Per fare questa operazione il gestore CART o il referente di progetto troveranno il pulsante Riattiva in fondo alla pagina di gestione della richiesta di erogazione 35/45
Cliccando sul pulsante Riattiva il sistema riattiverà le fruizioni del servizio configurate ed invierà una mail di avviso ai richiedenti le fruizioni e al richiedente l'erogazione. La riattivazione delle fruizioni permetterà l'invio messaggi da parte dei soggetti fruitori. Il gestore CART o il referente di progetto può riattivare anche una sola richiesta di fruizione utilizzando il pulsante Riattiva in fondo alla pagina di gestione della richiesta La riattivazione di un fruizione è possibile solo se il servizio erogatore non è stato sospeso. 2.9 Reportistica All'interno dell'applicazione è disponibile un sistema di reportistica delle richieste e delle relative configurazioni dei servizi in ambito CART, accessibile dal menu Utility, selezionando il link Reportistica. Mediante l'interfaccia web, mostrata nella figura seguente, è possibile selezionare una serie di criteri di ricerca al fine di visualizzare lo stato dell arte dei servizi. Tale ricerca sarà effettuata: sulle richieste di fruizione ed erogazione di servizi gestite mediante l'applicazione sulle configurazioni di fruizione ed erogazione effettuate sull'infrastruttura CART sulle richieste di deploy ed attivazione proxy gestite mediante l'applicazione 36/45
Mediante l'interfaccia quindi è possibile selezionare i seguenti valori di ricerca: Numero RFC (se non è selezionato allora l'accordo di servizio è obbligatorio, da scegliere fra quelli sprovvisti di RFC); Accordo di servizio (la lista del AdS è funzione della RFC precedentemente scelta in tal caso non è obbligatorio - oppure, se non selezionata, corrisponde agli accordi sprovvisti di RFC in tal caso è obbligatorio); Servizio (la lista dei servizi è funzione del AdS precedentemente selezionato, non è obbligatorio); Soggetto (non obbligatorio); Stato della richiesta (TUTTI GLI STATI RICHIESTA, PRESENTATA, PRESA IN CARICO,, CONFIGURATA) (obbligatorio); Tipo richiesta (erogazione/fruizione/deploy proxy solo in staging - /attivazione proxy) (obbligatorio); In base all impostazione dei campi di ricerca il sistema mostra la situazione delle richieste e relative configurazioni eseguite sull'infrastruttura. I campi tipologia della richiesta (fruizione, erogazione, deploy e attivazione proxy) e stato (tutti gli stati richiesta, presentata, presa in carico, configurata...) sono obbligatori. Nel caso in cui sia stata scelta la tipologia fruizione, il sistema mostra per ciascun RFC, accordo, servizio, soggetto erogatore e stato richiesta, il numero di fruizioni relative. Selezionando la voce tutti gli stati richiesta il sistema recupera i dati di tutte le richieste, in qualsiasi stato esse si trovino. 37/45
Nel caso in cui sia stata scelta la tipologia erogazione, il sistema mostra il numero di erogatori presenti per ciascun RFC, accordo, servizio e stato. Selezionando la voce tutti gli stati richiesta il sistema recupera i dati di tutte le richieste, in qualsiasi stato esse si trovino. E' possibile effettuare un export in formato csv della tabella mostrata, cliccando sul pulsante Export CSV in basso. Nel caso in cui sia stata scelta la tipologia deploy proxy (presente solo in ambiente di staging), il sistema mostra il numero di richieste di deploy proxy presenti per ciascun RFC, proxy applicativo e stato. Selezionando la voce tutti gli stati richiesta il sistema recupera i dati delle richieste, in qualsiasi stato esse si trovino. Nel caso in cui sia stata scelta la tipologia attivazione proxy, se siamo in ambiente di staging il sistema mostra il numero di richieste di attivazione proxy presenti per ciascun rfc, autore e stato. Selezionando la voce tutti gli stati richiesta il sistema recupera i dati delle richieste, in qualsiasi stato esse si trovino. 38/45
Nel caso in cui sia stata scelta la tipologia attivazione proxy e siamo in ambiente di produzione il sistema mostra il numero di enti relativi all'attivazione per ciascun rfc e stato. Selezionando la voce tutti gli stati richiesta il sistema recupera i dati delle richieste che si trovino in qualsiasi stato. In tutti i casi i dati risultano paginati se superiori a 30 elementi. Nei casi di fruizione ed erogazione, cliccando sul dato della colonna Fruizioni oppure Erogatori si accederà alla pagina di dettaglio della configurazione, come mostrato nella figura successiva. Un link ( Indietro ) permetterà di ritornare alla prima pagina della ricerca in cui venivano mostrati i dati aggregati, mentre Nuova ricerca permetterà di effettuare una nuova ricerca con nuovi parametri. 39/45
Per i casi di deploy proxy (presente solo in staging) ed attivazione proxy in staging non è prevista la pagina di dettaglio, mentre è presente nel caso di ricerca attivazione proxy in ambiente di produzione per la visualizzazione dei nomi degli enti. I report suddetti sono ordinati per numero RFC, accordo di servizio e nome servizio. 40/45
2.10 Ricerca richieste L'applicazione rende disponibile la funzionalità di ricerca delle richieste, attraverso cui è possibile filtrare tutte le richieste di erogazione, fruizione, deploy e attivazione proxy che si trovino in un certo stato o che siano associate ad una certa RFC, accordo di servizio, servizio. La maschera di ricerca permette anche di specificare il nome del richiedente, il titolo e l'id della richiesta, e di filtrare anche per data richiesta. Cliccando sui campi relativi alle date viene visualizzato un piccolo calendario per agevolare l'inserimento dei valori opportuni. La funzionalità è accessibile dal menu Utility, cliccando sulla voce Ricerca. Mediante l'interfaccia quindi è possibile selezionare i seguenti valori di ricerca: Tipo richiesta (indica il tipo di richiesta ovvero fruizione, erogazione, deploy proxy, attivazione proxy ed è obbligatorio) Stato richiesta (non obbligatorio, è la lista degli stati possibili in cui si possono trovare le richieste, Configurata / Presentata / In carico / Aggiornamento / Aggiornata / Approvazione / Approvata /In configurazione / Eliminata) Nome richiedente (non obbligatorio, indica nome e cognome, anche parziali, dell'autore della richiesta) Numero RFC (non obbligatorio, se non è selezionato allora gli accordi di servizio visibili sono quelli sprovvisti di RFC); 41/45
Accordo di servizio (non obbligatorio, la lista è funzione della RFC precedentemente scelta oppure, se non selezionata, corrisponde agli accordi sprovvisti di RFC); Servizio (la lista dei servizi è funzione dell'accordo di servizio precedentemente selezionato, non è obbligatorio); Titolo della richiesta (campo di testo libero, non obbligatorio) ID richiesta (campo di testo libero, da riempire se si conosce l'identificatore della richiesta da cercare, non obbligatorio) Data richiesta (giorno in cui è stata riempita la richiesta, non obbligatorio) Periodo richiesta (costituito dai campi Da e A, indica il periodo in cui sono state riempite le richieste, non obbligatori; può essere riempito anche un solo campo dei due) Sospesa (se spuntato ricerca tutte le richieste di fruizione o erogazione che sono state sospese. Non è significativo per le richieste di deploy o attivazione proxy). I campi Data richiesta e Periodo richiesta non sono mutuamente esclusivi e la coerenza delle date è quindi a discrezione dell'utente (se ad esempio in Data richiesta viene inserito un giorno che non rientra nel periodo indicato in Periodo richiesta, la ricerca non determinerà nessun risultato). Il risultato della ricerca è costituito da una tabella in cui sono riportate le seguenti colonne: Id Richiesta Titolo Richiesta Autore Data Richiesta Data Modifica Stato Storico I valori presenti nella colonna Id Richiesta permettono di navigare fino al dettaglio della richiesta. I valori In configurazione e Configurata presenti nella colonna Stato permettono di navigare fino alla scheda di configurazione della richiesta. La colonna Storico contiene invece i link per accedere allo storico delle richieste. I risultati sono paginati per un massimo di 30 righe per pagina. Gli utenti associati ai profili Referente di Progetto, Gestore e Amministratore potranno effettuare ricerche su tutte le richieste, mentre gli utenti associati ai profili Richiedente e Richiedente di proxy potranno ricercare solo richieste ad essi associate. 42/45
Nota: per effettuare una nuova ricerca non si deve premere il pulsante back del browser ma è necessario cliccare su Nuova ricerca. 2.11 Statistiche richieste L'applicazione dispone di una funzionalità per ottenere informazioni statistiche sul numero delle richieste delle varie tipologie (fruizione, erogazione, deploy e attivazione proxy) su base annuale. La funzionalità è disponibile accedendo al menu Utility e cliccando su Statistiche. L'applicazione visualizza inizialmente la tabella delle statistiche per l'anno corrente e dispone di un menu per scegliere l'anno. La tabella contiene le statistiche raggruppate per tipo richiesta e mese, distinguendo fra quelle Presentate e Configurate. Per Presentate in questo caso di intende tutte le richieste inserite nel mese corrente a prescindere dallo stato in cui esse si trovano. Per Configurate si intendono invece tutte le richieste in stato Configurato con data ultima modifica nel mese corrente, ovvero tutte le richieste che sono state evase nel mese, a prescindere dalla data di inserimento. La tabella contiene anche i totali per righe e per colonne. 43/45
I valori diversi da 0 sono anche link che permettono di visualizzare il dettaglio delle richieste che rientrano nella categoria scelta; la pagina visualizzata è del tutto analoga alla pagina dei risultati della ricerca richieste (di cui al 2.8). E' possibile infine effettuare un export in formato csv della tabella mostrata, cliccando sul pulsante Export CSV in basso. 3 Riferimenti per Help Desk L'Utente potrà rivolgersi al servizio di Help Desk secondo tre modalità: Tramite l invio di una mail all indirizzo di posta elettronica: cartdesk@regione.toscana.it; Tramite il Numero Verde: 800.232.330 opzione 1; il servizio è attivo sulle 24 ore per tutti i giorni della settimana festivi compresi; Tramite Web al link http://www.cart.rete.toscana.it/otrs/customer.pl. Gli Utenti CART potranno accedere al suddetto indirizzo autenticandosi con le stesse credenziali del servizio SLC; aprire richieste sul sistema di Trouble Ticketing e seguire l andamento delle proprie richieste. 44/45
4 Lista dei documenti Titolo Descrizione Responsabil ità RFC#19 Obiettivo di questo rfc e' quello di contribuire a formalizzare l'intero ciclo di vita del servizio CART, aiutando a garantire l'esecuzione delle procedure corrette in fase di progettazione, predisposizione ed attivazione dei servizi CART. Comunità e.toscana Compliance SDK-CART Documenti e software di esempio da utilizzare per sviluppare un servizio erogato tramite l'infrastruttura CART Responsabile Infrastruttura CART Richiesta apertura CART Documento da utilizzare per richiedere l'apertura dell'infrastruttura CART ad un soggetto esterno ad RTRT (es. Minitero, INPS, INAIL, altra Regione,...) Responsabile Infrastruttura CART Introduzione infrastruttura CART Introduzione infrastruttura CART Responsabile Infrastruttura Manuale uso e.compliance Chiarimenti sul processo e.toscana Compliance Responsabile Infrastruttura 45/45