Manuale Gestione di OpenSPCoop 1.4 i. Manuale Gestione di OpenSPCoop 1.4

Transcript

1 i Manuale Gestione di OpenSPCoop 1.4

2 ii Copyright Link.it srl

3 iii Indice 1 Introduzione 1 2 Prerequisiti per la Configurazione della Porta di Dominio Verifica dell applicazione di gestione PdD Console Gestione utenti e permessi Anagrafica Porte di Dominio Raccolta parametri di Configurazione Fruizione di un servizio Oneway Raccolta informazioni Configurazione della PdD tramite PddConsole Sincrono Raccolta informazioni Configurazione della PdD tramite PddConsole Asincrono Simmetrico Raccolta informazioni Configurazione della PdD tramite PddConsole Asincrono Asimmetrico Raccolta informazioni Configurazione della PdD tramite PddConsole Erogazione di un servizio Oneway Raccolta informazioni Configurazione della PdD tramite PddConsole Sincrono Raccolta informazioni Configurazione della PdD tramite PddConsole Asincrono Simmetrico Raccolta informazioni Configurazione della PdD tramite PddConsole Fruizione servizio correlato per generazione risposta Asincrono Asimmetrico Raccolta informazioni Configurazione della PdD tramite PddConsole

4 iv 5 Funzionalità avanzate Importazione ed Esportazione delle entità del Registro Servizi Autenticazione ed Autorizzazione dei Servizi Applicativi Autorizzazione SPCoop Correlazione Applicativa Consegna contenuti applicativi Integrazione Connettori Connettore HTTPS Connettore JMS Modalità d identificazione SPCoop Properties Validazione XSD WS-Security Riscrittura delle URL Descrizione di un accordo di servizio Configurazione dei parametri SPCoop Registro Tabella di Routing Configurazione Utente Reportistica e risoluzione dei problemi Monitoraggio Applicativo Diagnostica Tracciamento Esporta i dati in formato XML Auditing Auditing Setup Auditing Query Profili e Compatibilità Profilo di gestione Info e-gov per profilo di gestione e-gov Compatibilità busta e-gov

5 v Elenco delle figure 1 Menu per la gestione degli utenti Creazione nuovo utente Lista degli utenti della pddconsole Elenco Porte di Dominio Creazione Porta di Dominio Scenario di cooperazione di esempio tra due domini Creazione del soggetto SPCoop SPC/Erogatore Impostazione del connettore per il soggetto SPCoop SPC/Erogatore Creazione del servizio applicativo SAFruitore_OneWay per il soggetto che ci rappresenta Creazione dell accordo di servizio AS con referente SPC/Erogatore Creazione del servizio generico Oneway relativo all accordo di servizio AS Aggiunta di un azione al servizio generico Creazione dell Accordo di Servizio Parte Specifica ServizioOneWay erogato da SPC/Erogatore Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioOneWay erogato da SPC/Erogatore Elenco fruitori del servizio SPC/ServizioOneWay Autorizzazione del servizio applicativo SAFruitore_OneWay alla fruizione del servizio SPC/ServizioOneWay Creazione del soggetto SPCoop SPC/Erogatore Impostazione del connettore per il soggetto SPC/Erogatore Creazione del servizio applicativo SAFruitore_Sincrono per il soggetto che ci rappresenta Creazione accordo di servizio AS con referente SPC/Erogatore Creazione del servizio generico con profilo sincrono relativo all accordo AS Aggiunta dell azione sincrona al servizio generico dell accordo AS Creazione dell Accordo di Servizio Parte Specifica ServizioSincrono erogato da SPC/Erogatore Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioSincrono Autorizzazione del servizio applicativo SAFruitore_Sincrono alla fruizione di SPC/ServizioSincrono Creazione del soggetto SPC/Erogatore Impostazione del connettore per il soggetto SPC/Erogatore Creazione del servizio applicativo SAFruitore_AsincronoSimmetrico associato al soggetto che ci rappresenta Elenco Servizi Applicativi Impostazione del connettore per la ricezione della risposta asincrona da parte del servizio applicativo fruitore Creazione dell accordo di servizio parte comune AS con referente SPC/Erogatore Creazione del servizio generico con profilo Asincrono Simmetrico associato all accordo AS Aggiunta dell azione Asincrona Simmetrica al servizio generico dell accordo AS Creazione del servizio generico correlato relativo all accordo di servizio AS Aggiunta dell azione AsincronaSimmetricaCorrelata associata al servizio generico correlato Creazione del servizio ServizioAsincronoSimmetrico relativo all accordo AS ed erogato da SPC/Erogatore... 24

6 vi 37 Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioAsincronoSimmetrico erogato da SPC/Erogatore Autorizzazione del servizio applicativo SAFruitore_AsincronoSimmetrico alla fruizione del servizio SPC/ServizioAsincronoSimmetrico Creazione del servizio correlato SPC/ServizioAsincronoSimmetricoCorrelato erogato dal soggetto che ci rappresenta Sottoscrizione del soggetto erogatore al servizio SPC/ServizioAsincronoSimmetricoCorrelato erogato da SPC/- Fruitore Creazione del soggetto SPC/Erogatore Impostazione del connettore relativo al soggetto SPC/Erogatore Creazione del servizio applicativo SAFruitore_AsincronoAsimmetrico associato al soggetto che ci rappresenta Creazione dell accordo di servizio parte comune AS con referente SPC/Erogatore Creazione del servizio generico relativo all accordo di servizio AS con profilo Asincrono Asimmetrico Aggiunta dell azione Asincrona Asimmetrica relativa al servizio generico dell accordo AS Aggiunta dell azione correlata a AzioneAsincronaAsimmetrica Creazione servizio SPC/ServizioAsincronoAsimmetrico relativo all accordo AS ed erogato da SPC/Erogatore Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioAsincronoAsimmetrico Autorizzazione del servizio applicativo SAFruitore_AsincronoAsimmetrico alla fruizione di SPC/ServizioAsincronoAsimmetrico Creazione accordo AS con referente il soggetto che ci rappresenta Creazione servizio generico relativo all accordo AS e con profilo Oneway Aggiunta dell azione oneway al servizio generico dell accordo AS Creazione della parte specifica dell accordo di servizio ServizioOneWay che si vuole erogare Creazione del soggetto SPC/Fruitore Sottoscrizione di SPC/Fruitore al servizio ServizioOneway erogato dal soggetto che ci rappresenta Creazione del servizio applicativo erogatore SAErogatore_OneWay associato al soggetto che ci rappresenta Impostazione dei parametri per l invocazione del servizio applicativo erogatore Creazione della porta applicativa associata al soggetto che ci rappresenta Associazione del servizio applicativo erogatore alla porta applicativa Creazione dell accordo AS con referente il soggetto che ci rappresenta Creazione del servizio generico associato all accordo AS con profilo Sincrono Aggiunta dell azione sincrona associata al servizio generico relativo all accordo AS Creazione del servizio ServizioSincrono erogato dal soggetto che ci rappresenta Creazione del servizio applicativo erogatore associato al soggetto che ci rappresenta Impostazione dei parametri per l invocazione del servizio applicativo erogatore Creazione del soggetto SPC/Fruitore Sottoscrizione di SPC/Fruitore al servizio ServizioSincrono erogato dal soggetto che ci rappresenta Creazione della porta applicativa associata al soggetto che ci rappresenta Associazione del servizio applicativo erogatore SAErogatore_Sincrono alla porta applicativa Creazione accordo di servizio AS con referente il soggetto che ci rappresenta

7 vii 72 Creazione servizio generico relativo all accordo AS con profilo asincrono simmetrico Aggiunta dell azione asincrona simmetrica al servizio generico relativo all accordo AS Creazione del servizio applicativo SAErogatore_AsincronoSimmetrico associato al soggetto che ci rappresenta Impostazione dei parametri per l invocazione del servizio applicativo erogatore Creazione del servizio ServizioAsincronoSimmetrico relativo all accordo AS ed erogato dal soggetto che ci rappresenta Creazione del soggetto SPC/Fruitore Impostazione del connettore relativo al soggetto SPC/Fruitore Sottoscrizione di SPC/Fruitore al servizio ServizioAsincronoSimmetrico erogato dal soggetto che ci rappresenta Creazione della porta applicativa associata al soggetto che ci rappresenta Associazione del servizio applicativo erogatore alla porta applicativa del soggetto che ci rappresenta Creazione servizio generico correlato relativo all accordo AS con profilo asincrono simmetrico Aggiunta dell azione AsincronaSimmetricaCorrelata associata al servizio generico correlato Creazione del servizio correlato SPC/ServizioAsincronoSimmetricoCorrelato erogato dal soggetto che ci rappresenta Sottoscrizione del soggetto che ci rappresenta (erogatore) al servizio SPC/ServizioAsincronoSimmetricoCorrelato erogato da SPC/Fruitore Impostazione delle credenziali per il servizio applicativo erogatore per l invio della risposta asincrona Autorizzazione del servizio applicativo SAFruitore_AsincronoSimmetrico alla fruizione del servizio SPC/ServizioAsincronoSimmetrico Creazione dell accordo di servizio parte comune AS con referente SPC/Erogatore Creazione del servizio generico relativo all accordo di servizio AS con profilo Asincrono Asimmetrico Aggiunta dell azione Asincrona Asimmetrica relativa al servizio generico dell accordo AS Aggiunta dell azione correlata a AzioneAsincronaAsimmetrica Creazione servizio SPC/ServizioAsincronoAsimmetrico relativo all accordo AS ed erogato da SPC/Erogatore Creazione del servizio applicativo SAErogatore_AsincronoAsimmetrico associato al soggetto che ci rappresenta Impostazione dei parametri di invocazione del servizio applicativo erogatore Impostazione dei parametri di invocazione del servizio applicativo erogatore Creazione del soggetto SPC/Fruitore Sottoscrizione di SPC/Fruitore al servizio erogato dal soggetto che ci rappresenta Creazione della porta applicativa associata al soggetto che ci rappresenta Associazione del servizio applicativo erogatore alla porta applicativa associata al soggetto che ci rappresenta Maschera di importazione di package SICA Impostazione di credenziali ssl per un servizio applicativo generico Impostazione di una porta delegata con autenticazione ssl Autorizzazione di un servizio applicativo sulla porta delegata Autorizzazione di un soggetto alla fruizione di un dato servizio Inserimento di una regola di correlazione applicativa associata ad una porta delegata Impostazione dei parametri di integrazione per un servizio applicativo Modifica della modalità di passaggio dell header di integrazione per una porta delegata

8 viii 108 Dati di configurazione di un connettore HTTPS Dati di configurazione di un connettore JMS Impostazione porta delegata con modalità di identificazione dinamica di soggetto, servizio e azione Porta delegata con identificazione dinamica con pattern url-based alternativo Porta delegata con identificazione dinamica basata sul contenuto del messaggio Configurazione della validazione xsd su porta applicativa Abilitazione WS-Security su porta delegata WS-Security: impostazione parametro request-flow su porta delegata Impostazione di una regola di URL Rewriting Impostazione di una regola di URL Rewriting Configurazione PdD: parametri generali Configurazione PdD: aggiunta nuovo registro Configurazione PdD: gestione registri Configurazione PdD: gestione cache di registro Configurazione PdD: abilitazione routing alternativo Configurazione PdD: configurazione di una rotta statica Configurazione PdD: area utente Monitoraggio applicativo: Form di ricerca Monitoraggio applicativo: risultato di una ricerca Monitoraggio applicativo: dettaglio di un elemento Messaggi diagnostici: form di ricerca Messaggi diagnostici: risultato di una ricerca Messaggi diagnostici: visualizzazione dettaglio Messaggi Tracciamento: form di ricerca Messaggi Tracciamento: risultato di una ricerca Messaggi Tracciamento: visualizzazione dettaglio Messaggi Tracciamento: visualizzazione dettaglio di messaggio correlato Esportazione in formato XML dei messaggio diagnostici Esportazione in formato XML dei messaggi di tracciamento Servizio di auditing disabilitato Servizio di auditing abilitato Creazione di un filtro per il servizio di auditing Maschera di ricerca dei dati di auditing Risultato della ricerca dei dati di auditing Dettaglio di una traccia di auditing Controlli avanzati sulle informazioni egov relative all accordo di servizio Creazione di un azione direttamente associata all accordo di servizio (invece del servizio generico) Creazione di un servizio che implementa direttamente l accordo (invece del servizio generico) Creazione di un soggetto con possibilità di scegliere il tipo Creazione di un servizio con possibilità di scegliere il tipo ed impostare connettori non-http Porta delegata con soggetti di cui si specifica il tipo e campo url di invocazione che sovrascrive il nome Porta applicativa con selezione del tipo servizio Impostazione di connettori non-http per i servizi applicativi

9 ix Elenco delle tabelle 1 Dati richiesti per la creazione fruitore Oneway Dati richiesti per la creazione di un fruitore sincrono Dati richiesti per la creazione di un fruitore asincrono simmetrico Dati richiesti per la creazione di un fruitore asincrono asimmetrico Dati richiesti per la creazione di una erogazione di un servizio con profilo Oneway Dati richiesti per la creazione di un erogatore Sincrono Dati richiesti per la creazione di un erogatore asincrono simmetrico Dati richiesti per la creazione di un erogatore asincrono asimmetrico Informazioni di Autenticazione e Autorizzazione Informazioni di Validazione Descrizione di un accordo di servizio Parametri di configurazione Configurazione del routing per le buste e-gov Livello severità Funzionalita egov Connettori

10 1 / Introduzione Questo manuale documenta le modalità di gestione della versione 1.4 della Porta di Dominio (PdD) OpenSPCoop ed è rivolto agli Operatori che si dovranno occupare di configurare la PdD, al momento dell attivazione di nuovi servizi SPCoop da fruire o da erogare, e di mantenerne l operatività nel tempo. Nel prosieguo si assume che la Porta di Dominio sia già installata e che l applicazione web di gestione PddConsole sia operativa e raggiungibile via browser dai Gestori del Sistema. Per informazioni sulle modalità di installazione si rimanda ai manuali di installazione distribuiti assieme al prodotto o alla Guida di Installazione in linea. Nella prossima sezione vengono descritte le operazioni preliminari che devono essere verificate ed eseguite prima di iniziare con la gestione della PdD. Nelle sezioni Sezione 3 e Sezione 4 sono mostrate le fasi del processo di configurazione della Porta di Dominio rispettivamente nel caso della fruizione e dell erogazione di servizi SPCoop. Nella sezione Sezione 5 vengono documentate funzionalità più avanzate di configurazione dei servizi. Nella sesta sezione (vedi Sezione 6) vengono documentate le funzionalità per il monitoraggio dell attività della PdD. Infine nella settima e ultima sezione saranno affrontati i temi riguardanti i differenti profili di gestione della busta egov e relativa compatibilità sulla base delle diverse versioni della specifica SPCoop. 2 Prerequisiti per la Configurazione della Porta di Dominio 2.1 Verifica dell applicazione di gestione PdD Console Come prima operazione è necessario verificare la possibilità di accedere all applicazione di gestione della Porta di Dominio OpenSPCoop, accedendo da browser alla url di deploy dell applicazione, che generalmente è a questa applicazione ci si riferisce ogni volta che, nel resto del manuale, viene richiesto di intervenire sulla Configurazione della Porta di Dominio. 2.2 Gestione utenti e permessi Le funzionalità della pddconsole sono partizionate in gruppi che rappresentano anche i permessi che possono essere concessi agli utenti per limitarne l operatività, riguardo la gestione della PdD, sulla base del ruolo che ciascuna persona ricopre. Vediamo quali sono i gruppi funzionali, e conseguentemente i permessi associabili a ciascun utente: [U] - Possibilità di gestire gli utenti della pddconsole. Gli utenti con questo permesso, sono di fatto dei superutenti in quanto possono assumere l identità di un qualunque utente del sistema. [S] - Gestione delle entità di configurazione dei servizi della Porta di Dominio, quali: Accordi di Servizio, Soggetti, Porte Delegate e Applicative, eccetera. [D] - Accesso alle maschere di consultazione delle tracce egov e dei messaggi diagnostici. [C] - Accesso alle funzionalità di configurazione generali della Porta di Dominio. Queste funzionalità sono quelle presenti nel menu di navigazione nel gruppo Configurazione e riguardano: livelli di dettaglio del tracciamento, binding con i registri servizi, politiche di routing, configurazione servizio di auditing, eccetera. [M] - Accesso alle code messaggi in gestione alla Porta di Dominio. Questa autorizzazione consente ad esempio di consultare i messaggi presenti nelle Message Box dell Integration Manager ed eventualmente effettuare delle rimozioni. [A] - Accesso alle funzionalità di consultazione delle tracce del servizio di Auditing. Dopo aver installato la Porta di Dominio sono presenti tre utenti predefiniti, super, amministratore e operatore, con differenti livelli di autorizzazione: super: [U] amministratore: [S,D,C,M,A] operatore: [D]

11 2 / 101 Gli utenti in possesso del permesso [U] possono creare dei nuovi utenti utilizzando le funzionalità presenti nel menu Utenti in Figura 1. Figura 1: Menu per la gestione degli utenti Per creare un nuovo utente selezionare la voce Aggiungi che apre il form mostrato in Figura 2. Figura 2: Creazione nuovo utente Selezionando la voce Elenco verranno visualizzati gli utenti già presenti nel sistema con i relativi permessi e i link per modificarli o assumerne l identità (Figura 3)

12 3 / 101 Figura 3: Lista degli utenti della pddconsole 2.3 Anagrafica Porte di Dominio In fase di installazione viene generata l anagrafica della Porta di Dominio interna e gestita tramite l applicazione web Pdd- Console. L anagrafica della PdD è visibile e modificabile autenticandosi sulla PddConsole con un utente avente il diritto [S] e selezionando Elenco nella sezione Porte di Dominio Figura 4: Elenco Porte di Dominio I soggetti interni al proprio dominio saranno associati a questa PdD. Per quanto riguarda invece i soggetti appartenenti a domini esterni dovranno essere associati a PdD esterne. Per questo sarà necessario creare altre PdD tramite questa sezione della Pdd- Console. Per aggiungere una nuova PdD utilizzare il pulsante Aggiungi collocato in fondo alla lista delle Porte di Dominio e compilare il form: Nome: Nome della Porta di Dominio esterna Descrizione: Descrizione della Porta di Dominio esterna Client Auth: Abilita/Disabilita l autenticazione del client in fase di ricezione di buste egov dalla PdD esterna Subject: Subject del certificato con cui la Porta di Dominio si presenta nelle comunicazioni https

13 4 / 101 Figura 5: Creazione Porta di Dominio Negli esempi trattati nel seguito del presente manuale si farà assunzione semplificativa che i soggetti siano sempre appartenenti ad un unica Porta di Dominio 2.4 Raccolta parametri di Configurazione Nel resto del manuale, per ogni configurazione da realizzare viene mostrata una tabella che raccoglie tutti i dati necessari per la configurazione ed i rispettivi valori utilizzati come esempio nella documentazione. Al fine di semplificare la compilazione delle tabelle di cui sopra, nella figura successiva è mostrato un tipico scenario d interazione tra un servizio fruitore ed un servizio erogatore in accordo allo standard SPCoop. Figura 6: Scenario di cooperazione di esempio tra due domini La figura ci aiuta a localizzare i seguenti parametri, ai quali si farà poi riferimento nel resto del manuale per la configurazione dei servizi sulla PdD:

14 5 / 101 Accordo: identificativo all interno del Registro dei Servizi dell accordo di servizio definito tra i partecipanti alla cooperazione Servizio: nome del servizio di cooperazione SPCoop utilizzato per la cooperazione. Un Accordo di servizio può contenere più Servizi Azione: nome dell azione/operazione del servizio utilizzata nella cooperazione Nome PdD: identificativo della Porta di Dominio Nome Soggetto: nome del soggetto SPCoop che partecipa alla cooperazione Porta Delegata: punto di accesso alla PdD per i fruitori dei servizi Porta Applicativa: punto di uscita della PdD verso il servizio erogato URL Pubblica Servizio Erogato: url esposta dalla PdD per la ricezione delle buste e-gov dalla rete pubblica URL Privata Servizio Erogato: url di invocazione del servizio che intendiamo erogare interno al Dominio dei servizi URL Invocazione: punto di ingresso della PdD per le richieste dei servizi applicativi fruitori appartenenti al proprio Dominio dei Servizi Nota Non è tra gli obiettivi di questo manuale fornire indicazioni su come raccogliere tali dati. Per un approfondita comprensione del paradigma di Cooperazione Applicativa e della specifica SPCoop, si rimanda al resto della documentazione utente distribuita assieme al Prodotto. Nota Le immagini presentate nel seguito di questo manuale, raffiguranti le schermate della pddconsole, faranno riferimento alla modalità avanzata. Tale modalità non è attiva per default, ma può essere attivata modficando l opportuno parametro nel profilo di ciascun utente. Operando in modalità standard diversi elementi dell interfaccia non saranno visibili. 3 Fruizione di un servizio In questa sezione viene mostrato come configurare la PdD per permettere ad un servizio applicativo interno al nostro dominio di usufruire di servizi SPCoop erogati da altri domini, per ognuno dei 4 profili supportati: Oneway, Sincrono, Asincrono Simmetrico ed Asincrono Asimmetrico. Ogni scenario viene preceduto da una tabella nella quale sono riportate tutte le informazioni da raccogliere preliminarmente per poter poi procedere alla configurazione della Porta di Dominio. 3.1 Oneway Raccolta informazioni Raccogliere i dati necessari per questa configurazione, facendo riferimento alla tabella Tabella Configurazione della PdD tramite PddConsole 1. Creare il soggetto erogatore: autenticarsi con un utente avente il permesso [S] (vedi [?title]) e selezionare Aggiungi nella sezione Soggetti SPCoop compilando il form che compare con i valori nella sezione Info Soggetto Interlocutore della Tabella 1: Nome: Nome Soggetto Erogatore Codice IPA: Codice IPA Soggetto Erogatore