Guida Utente della PddConsole. Guida Utente della PddConsole

Transcript

1 Guida Utente della PddConsole i Guida Utente della PddConsole

2 Guida Utente della PddConsole ii Copyright Link.it srl

3 Guida Utente della PddConsole iii Indice 1 Introduzione 1 2 Prerequisiti per l utilizzo della PddConsole Verifica dell applicazione di gestione PddConsole Gestione utenti e permessi Indice Porte di Dominio Raccolta parametri di Configurazione Fruizione di un servizio Oneway Raccolta informazioni Configurazione Sincrono Raccolta informazioni Configurazione Asincrono Simmetrico Raccolta informazioni Configurazione Asincrono Asimmetrico Raccolta informazioni Configurazione Erogazione di un servizio Oneway Raccolta informazioni Configurazione Sincrono Raccolta informazioni Configurazione Asincrono Simmetrico Raccolta informazioni Configurazione Fruizione servizio correlato per generazione risposta Asincrono Asimmetrico Raccolta informazioni Configurazione

4 Guida Utente della PddConsole iv 5 Funzionalità avanzate Importazione ed Esportazione delle entità del Registro Servizi Autenticazione ed Autorizzazione dei Servizi Applicativi Autorizzazione Richieste in Entrata Ricezione Richieste di Erogazione (Porta Applicativa) Correlazione Applicativa Consegna contenuti applicativi Integrazione Connettori Connettore HTTPS Connettore JMS Modalità d identificazione Properties Validazione XSD WS-Security Riscrittura delle URL Descrizione di un accordo di servizio (SPCoop) Configurazione dei parametri 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

5 Guida Utente della PddConsole v Elenco delle figure 1 Menu per la gestione degli utenti Creazione nuovo utente Lista degli utenti della PddConsole Elenco Porte di Dominio Aggiunta di una Porta di Dominio esterna Scenario di cooperazione di esempio tra due domini Creazione del soggetto SPC/Erogatore Impostazione del connettore per il soggetto 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 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 Guida Utente della PddConsole 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 del servizio applicativo erogatore SAErogatore_OneWay associato al soggetto che ci rappresenta Impostazione dei parametri per l invocazione del servizio applicativo erogatore 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 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 applicativo erogatore associato al soggetto che ci rappresenta Impostazione dei parametri per l invocazione del servizio applicativo erogatore Creazione del servizio ServizioSincrono erogato dal soggetto che ci rappresenta Creazione del soggetto SPC/Fruitore Sottoscrizione di SPC/Fruitore al servizio ServizioSincrono erogato dal soggetto che ci rappresenta Creazione accordo di servizio AS con referente il soggetto che ci rappresenta 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

7 Guida Utente della PddConsole vii 73 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 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 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 servizio SPC/ServizioAsincronoAsimmetrico relativo all accordo AS ed erogato da SPC/Erogatore Creazione del soggetto SPC/Fruitore Sottoscrizione di SPC/Fruitore al servizio erogato dal soggetto che ci rappresenta Maschera di importazione di package 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 Creazione di una porta applicativa 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 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

8 Guida Utente della PddConsole viii 110 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 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 Livello severità

9 Guida Utente della PddConsole 1 / Introduzione Questo manuale documenta le funzionalità e modalità d uso dell applicazione PddConsole di OpenSPCoop2. Tale applicazione permette agli operatori di gestire il funzionamento della Porta di Dominio OpenSPCoop2 come ad esempio: Consultare e/o configurare il Registro dei Servizi. Consultare le tracce e i messaggi diagnostici emessi dalla PdD. Impostare i dettagli di integrazione con i servizi applicativi interni al dominio. Tutti gli esempi di utilizzo della PddConsole, che verranno forniti in seguito, utilizzano servizi relativi al protocollo SPCoop (Sistema Pubblico di Cooperazione Applicativa) ma risultano validi per qualsiasi protocollo di cooperazione. Si rimanda al manuale del kit di sviluppo della Porta di Dominio OpenSPCoop2 per dettagli su come implementare e aggiungere un nuovo protocollo di cooperazione alla PdD. Nel prosieguo si assume che la PddConsole sia già installata e operativa raggiungibile via browser dai Gestori del Sistema. Per informazioni sulle modalità di installazione si rimanda ai manuali di installazione distribuiti assieme al prodotto. Nella prossima sezione, [?title], vengono descritte le operazioni preliminari che devono essere verificate ed eseguite prima di iniziare con le attività di gestione. Nelle sezioni Sezione 3 e Sezione 4 sono mostrate le fasi del processo di configurazione rispettivamente nel caso della fruizione e dell erogazione di servizi. Nella sezione Sezione 5 vengono documentate funzionalità più avanzate di configurazione dei servizi. Nella sesta sezione (vedi Sezione 6) vengono documentate le funzionalità relative alla consultazione dei dati di tracciamento e diagnostici. 2 Prerequisiti per l utilizzo della PddConsole 2.1 Verifica dell applicazione di gestione PddConsole Come prima operazione è necessario verificare la possibilità di accedere alla console, accedendo dal 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 e ogni volta che si indica di consultare tracce e messaggi diagnostici. 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à, sulla base del ruolo che ciascuna utenza 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, quali: Accordi di Servizio, Soggetti, Porte Delegate e Applicative, eccetera. [D] - Accesso alle maschere di consultazione delle tracce 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.

10 Guida Utente della PddConsole 2 / 100 L applicazione, al termine dell installazione, contiene tre utenti predefiniti, super, amministratore e operatore, con differenti livelli di autorizzazione: super: [U] amministratore: [S,D,C,M,A] operatore: [D] 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 Si può aprire la maschera di creazione di un nuovo utente tramite il pulsante Aggiungi, presente sotto il riquadro che elenca gli utenti già presenti. La maschera di creazione utenti è quella mostrata in Figura 2. Figura 2: Creazione nuovo utente Selezionando, nel menu di sinistra, la voce Visualizza verranno visualizzati gli utenti già presenti nel sistema con i relativi permessi e i link per modificarli o assumerne l identità (Figura 3)

11 Guida Utente della PddConsole 3 / 100 Figura 3: Lista degli utenti della PddConsole 2.3 Indice Porte di Dominio In fase di installazione viene generato un repository che contiene l indice di tutte le Porte di Dominio gestite tramite l istanza in uso dell applicazione PddConsole. L indice delle Porte di Dominio è visibile e modificabile autenticandosi sulla PddConsole con un utente che possieda il permesso contrassegnato con [S] e selezionando Visualizza nella sezione Porte di Dominio Figura 4: Elenco Porte di Dominio L unica Porta di Dominio contrassegnata con il tipo Operativo rappresenta l istanza gestita dalla PddConsole. I soggetti interni al dominio saranno associati a questa Porta di Dominio. Per quanto riguarda invece i soggetti appartenenti a domini esterni potranno essere associati a Porte di Dominio esterne da aggiungere in questa sezione della PddConsole. La creazione di Porte di Dominio esterne in questo contesto non è obbligatoria ai fini del funzionamento della Porta di Dominio operativa ma si rende indispensabile nel momento in cui ci si vuole avvalere di meccanismi di autenticazione client di tali PdD in fase di ricezione messaggi. Maggiori dettagli sull argomento verranno forniti in seguito. Per aggiungere una nuova PdD esterna 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 dalla PdD esterna Subject: Subject del certificato con cui la Porta di Dominio si presenta nelle comunicazioni https

12 Guida Utente della PddConsole 4 / 100 Figura 5: Aggiunta di una Porta di Dominio esterna 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. Figura 6: Scenario di cooperazione di esempio tra due domini Lo scenario illustrato in figura [?title] è tratto da un caso di cooperazione nell ambito del Sistema Pubblico di Cooperazione (SPCoop). Gli esempi trattati in questo manuale sono in gran parte tratti dal contesto SPCoop. Si tenga presente tuttavia che SPCoop è solo un esempio di protocollo supportato da OpenSPCoop2. La figura precedente ci aiuta a localizzare i seguenti parametri, ai quali si farà poi riferimento nel resto del manuale per la configurazione dei servizi sulla PdD:

13 Guida Utente della PddConsole 5 / 100 Accordo di Servizio Parte Comune: identificativo all interno del Registro dei Servizi dell accordo di servizio definito tra i partecipanti alla cooperazione Accordo di Servizio Parte Specifica: istanza del servizio, riferita ad un accordo di servizio parte comune, erogata da uno specifico soggetto. Azione: nome dell azione/operazione del servizio utilizzata nella cooperazione Nome PdD: identificativo della Porta di Dominio Nome Soggetto: nome del soggetto 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 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. 3 Fruizione di un servizio In questa sezione vengono illustrati i passi di configurazione, tramite la PddConsole, per permettere ad un servizio applicativo interno al nostro dominio di usufruire di servizi erogati da altri domini, per ognuno dei 4 profili di cooperazione supportati dalla Porta di Dominio: 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 tramite PddConsole. 3.1 Oneway Raccolta informazioni Raccogliere i dati necessari per questa configurazione, facendo riferimento alla tabella Tabella Configurazione 1. Creare il soggetto erogatore: autenticarsi con un utente avente il permesso [S] (vedi [?title]) e selezionare Aggiungi nella sezione Soggetti compilando il form che compare con i valori nella sezione Info Soggetto Interlocutore della Tabella 1: Nome: Nome Soggetto Erogatore Descrizione: Descrizione Soggetto Erogatore Codice IPA: (Campo Specifico per il caso SPCoop) Codice IPA Soggetto Erogatore Tipo: Tipo del Soggetto. Determina il protocollo adottato nelle comunicazioni Versione Protocollo: Versione del protocollo supportata dal soggetto per le comunicazioni. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo Soggetto

14 Guida Utente della PddConsole 6 / 100 Nome Esempio Vostro valore Accordo di Servizio Parte Comune Nome Accordo AS Soggetto Referente SPC/Erogatore Versione 1 Info Soggetto Erogatore Nome Soggetto Erogatore Erogatore Codice IPA c=it,o=c_h501 URL Pubblica Servizio Erogatore Info Servizio Nome servizio ServizioOneway Profilo di Collaborazione Oneway Azione AzioneOneway Servizio Applicativo Fruitore Nome Servizio Applicativo SAFruitore_OneWay Modalita di autenticazione basic Username (solo se autenticazione=basic) SAFruitore_OneWay Password (solo se autenticazione=basic) Subject (solo se autenticazione=ssl) Tabella 1: Dati richiesti per la creazione fruitore Oneway Figura 7: Creazione del soggetto SPC/Erogatore 2. Impostare il connettore del soggetto erogatore: dall Elenco dei Soggetti selezionare visualizza nella colonna Connettore in corrispondenza del soggetto appena creato (passo 1) abilitando il connettore ed inserendo i valori: Abilitato: Abilita il connettore per il soggetto. L interfaccia standard assume che il connettore sia http. Per la documentazione d uso degli altri connettori si rimanda a Sezione 5.8 Url: Indirizzo della porta applicativa a cui è raggiungibile il soggetto

15 Guida Utente della PddConsole 7 / 100 Figura 8: Impostazione del connettore per il soggetto SPC/Erogatore 3. Aggiungere il Servizio Applicativo fruitore: utilizzare il pulsante Aggiungi presente nella sezione Servizi Applicativi. Il servizio applicativo deve essere associato al soggetto fruitore (se non esiste, crearlo in modo analogo all erogatore). Nella scelta delle credenziali, per esempio, utilizzare la modalità di accesso di tipo basic e compilare il form con i valori del gruppo Servizio Applicativo Fruitore della Tabella 1: Nome: Nome Servizio Applicativo Soggetto: selezionare il soggetto che ci rappresenta e che dovrà fruire del servizio Credenziali di accesso: Specifica il tipo di credenziali che il servizio applicativo deve utilizzare per autenticarsi sulla Porta di Dominio. A scelta tra nessuna, basic e ssl Utente: Username (caso autenticazione basic) Password: Password (caso autenticazione basic) Subject: Subject (caso autenticazione ssl) del certificato utilizzato dal servizio applicativo Modalità di Fault: Formato con cui verranno restituiti gli errori al servizio applicativo. (quest ultimo è il formato definito nelle specifiche ) A scelta tra soap e xml Sbustamento Informazioni di Protocollo: Permette di abilitare/disabilitare la presenza dell header di protocollo nei messaggi consegnati dalla PdD al servizio applicativo. Per maggiori informazioni vedere la Sezione 5.2. Figura 9: Creazione del servizio applicativo SAFruitore_OneWay per il soggetto che ci rappresenta 4. Aggiungere un nuovo Accordo di Servizio Parte Comune. Nel caso si sia in possesso del package per l importazione dell accordo di servizio, non è necessario effettuare manualmente la configurazione e si potrà procedere all importazione automatica seguendo le istruzioni riportate in Sezione 5.1.

16 Guida Utente della PddConsole 8 / 100 Per procedere manualmente, selezionare Aggiungi nella sezione Accordi Servizio Parte Comune compilando il form che compare con i valori nella sezione Accordo di Servizio della Tabella 1: Nome: Nome della Parte Comune dell Accordo di Servizio. Descrizione: Descrizione della Parte Comune dell Accordo di Servizio. Soggetto referente: è il soggetto promotore dell accordo di servizio. Tipicamente coincide con uno dei soggetti erogatori. In questo caso utilizzare il soggetto creato al punto 1. Versione: Progressivo intero che assieme alla coppia <nome, referente> va a formare la chiave identificativa dell accordo di servizio. Specifica delle Interfacce: I WSDL che descrivono tecnicamente l accordo di servizio. Specifica delle Conversazioni: (Campo specifico per SPCoop) Nell esempio riportato nella figura sottostante questa sezione appare poiché il soggetto referente ha il tipo SPC che è associato al protocollo SPCoop Figura 10: Creazione dell accordo di servizio AS con referente SPC/Erogatore Per ulteriori dettagli sulla creazione degli Accordi di Servizio si rimanda alla Sezione Aggiungere il Servizio Generico all accordo: dall Elenco degli Accordi di Servizio Parte Comune selezionare visualizza nella colonna Servizi corrispondente all accordo di servizio creato al passo 4. Selezionare, quindi, Aggiungi e compilare il form con i valori della sezione Info Servizio della Tabella 1: Nome: Nome servizio. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio

17 Guida Utente della PddConsole 9 / 100 Descrizione: Descrizione servizio Profilo Collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (oneway nel nostro caso) Scadenza: Se prevista la scadenza dei messaggi, impostare qui il valore in minuti Figura 11: Creazione del servizio generico Oneway relativo all accordo di servizio AS 6. Aggiungere l azione al Servizio dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form Nome: Nome dell azione. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo. Figura 12: Aggiunta di un azione al servizio generico 7. Creare l Accordo di Servizio Parte Specifica che implementa l Accordo di Servizio appena definito. Nel caso si sia in possesso del package per l importazione dell accordo di servizio parte specifica, non è necessario effettuare manualmente la configurazione e si potrà procedere all importazione automatica seguendo le istruzioni riportate in Sezione 5.1. Per procedere manualmente, selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e compilare il form: Accordo di servizio: selezionare l accordo creato al punto 4 Servizio: selezionare il Servizio dell Accordo creato al punto 5 Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto creato al punto 1

18 Guida Utente della PddConsole 10 / 100 Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica. Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica. Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione Figura 13: Creazione dell Accordo di Servizio Parte Specifica ServizioOneWay erogato da SPC/Erogatore 8. Aggiungere il soggetto che ci rappresenta come fruitore della parte specifica dell accordo di servizio: selezionare Visualizza nella colonna Fruitori in corrispondenza della parte specifica creata al punto 7. Selezionare Aggiungi e compilare il form: Soggetto : Nome del soggetto che ci rappresenta Versione Protocollo : versione del protocollo per le comunicazioni con questo specifico fruitore. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo per il servizio. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo impostata a livello del soggetto fruitore

19 Guida Utente della PddConsole 11 / 100 Figura 14: Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioOneWay erogato da SPC/Erogatore L aggiunta del fruitore al servizio comporta la creazione automatica della Porta Delegata associata al soggetto che ci rappresenta. Per maggiori informazioni sull autenticazione/autorizzazione dei servizi applicativi che possono invocare la porta delegata vedere la Sezione 5.2. Per informazioni sulle modalità di identificazione dei parametri di consultare la Sezione Per vincolare la fruizione del servizio allo specifico servizio applicativo tramite autenticazione, selezionare visualizza nella colonna Servizi Applicativi Autorizzati nella lista dei soggetti fruitori del servizio, in corrispondenza del fruitore aggiunto al passo precedente, punto 8. Figura 15: Elenco fruitori del servizio SPC/ServizioOneWay Selezionare Aggiungi e quindi compilare il form: Servizio Applicativo: il Servizio Applicativo creato al punto 3. Figura 16: Autorizzazione del servizio applicativo SAFruitore_OneWay alla fruizione del servizio SPC/ServizioOneWay 3.2 Sincrono Raccolta informazioni Raccogliere i dati necessari per questa configurazione, facendo riferimento alla tabella Tabella Configurazione 1. Creare il soggetto erogatore: autenticarsi con un utente avente il permesso [S] (vedi [?title]) e selezionare Aggiungi nella sezione Soggetti compilando il form che compare con i valori nella sezione Info Soggetto Interlocutore della Tabella 2:

20 Guida Utente della PddConsole 12 / 100 Nome Esempio Vostro valore Accordo di Servizio Parte Comune Nome Accordo AS Soggetto Referente SPC/Erogatore Versione 1 Info Soggetto Interlocutore Nome erogatore Erogatore Codice IPA c=it,o=c_h501 URL Pubblica Servizio Erogatore Info Servizio Nome servizio ServizioSincrono Azione AzioneSincrona Servizio Applicativo Fruitore Nome Servizio Applicativo SAFruitore_Sincrono Modalita di autenticazione basic Username (solo se autenticazione=basic) SAFruitore_Sincrono Password (solo se autenticazione=basic) Subject (solo se autenticazione=ssl) Tabella 2: Dati richiesti per la creazione di un fruitore sincrono Nome: Nome Soggetto Erogatore Descrizione: Descrizione Soggetto Erogatore Codice IPA: (Campo Specifico per il caso SPCoop) Codice IPA Soggetto Erogatore Tipo: Tipo del Soggetto. Determina il protocollo adottato nelle comunicazioni Versione Protocollo: Versione del protocollo supportata dal soggetto per le comunicazioni. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo Soggetto Figura 17: Creazione del soggetto SPC/Erogatore 2. Impostare il connettore del soggetto erogatore: dall Elenco dei Soggetti selezionare visualizza nella colonna Connettore in corrispondenza del soggetto appena creato (passo 1) abilitando il connettore ed inserendo i valori: Abilitato: Abilita il connettore per il soggetto. L interfaccia standard assume che il connettore sia http. Per la documentazione d uso degli altri connettori si rimanda a Sezione 5.8 Url: Indirizzo della porta applicativa a cui è raggiungibile il soggetto

21 Guida Utente della PddConsole 13 / 100 Figura 18: Impostazione del connettore per il soggetto SPC/Erogatore 3. Aggiungere il Servizio Applicativo fruitore: selezionare Aggiungi nella sezione Servizi Applicativi. Nella scelta delle credenziali, per esempio, utilizzare la modalità di accesso di tipo basic e compilare i campi del form con i valori del gruppo Servizio Applicativo Fruitore della Tabella 2: Nome: Nome Servizio Applicativo Soggetto : selezionare il soggetto che ci rappresenta e che dovrà fruire del servizio Credenziali di accesso: Specifica il tipo di credenziali che il servizio applicativo deve utilizzare per autenticarsi sulla Porta di Dominio. A scelta tra nessuna, basic e ssl Utente: Username (caso autenticazione basic) Password: Password (caso autenticazione basic) Subject: Subject (caso autenticazione ssl) del certificato utilizzato dal servizio applicativo Modalità di Fault: Formato con cui verranno restituiti gli errori al servizio applicativo. (quest ultimo è il formato definito nelle specifiche ) A scelta tra soap e xml Sbustamento Informazioni di Protocollo: Permette di abilitare/disabilitare la presenza dell header di protocollo nei messaggi consegnati dalla PdD al servizio applicativo. Per maggiori informazioni vedere la Sezione 5.2 Figura 19: Creazione del servizio applicativo SAFruitore_Sincrono per il soggetto che ci rappresenta 4. Aggiungere un nuovo Accordo di Servizio Parte Comune. Nel caso si sia in possesso del package per l importazione dell accordo di servizio, non è necessario effettuare manualmente la configurazione e si potrà procedere all importazione automatica seguendo le istruzioni riportate in Sezione 5.1.

22 Guida Utente della PddConsole 14 / 100 Per procedere manualmente, selezionare Aggiungi nella sezione Accordi Servizio Parte Comune compilando la form che compare con i valori nella sezione Accordo di Servizio della Tabella 2: Nome: Nome della Parte Comune dell Accordo di Servizio. Descrizione: Descrizione della Parte Comune dell Accordo di Servizio. Soggetto referente: è il soggetto promotore dell accordo di servizio. Tipicamente coincide con uno dei soggetti erogatori. In questo caso utilizzare il soggetto creato al punto 1. Versione: Progressivo intero che assieme alla coppia <nome, referente> va a formare la chiave identificativa dell accordo di servizio. Specifica delle Interfacce: I WSDL che descrivono tecnicamente l accordo di servizio. Specifica delle Conversazioni: (Campo specifico per SPCoop) Nell esempio riportato nella figura sottostante questa sezione appare poiché il soggetto referente ha il tipo SPC che è associato al protocollo SPCoop Figura 20: Creazione accordo di servizio AS con referente SPC/Erogatore Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione Aggiungere il Servizio Generico all accordo: dall Elenco degli Accordi servizio selezionare visualizza nella colonna Servizi corrispondente all accordo di servizio creato al passo 4. Selezionare, quindi, Aggiungi ed inserite i valori della sezione Info Servizio della Tabella 2: Nome: Nome servizio. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio

23 Guida Utente della PddConsole 15 / 100 Descrizione: Descrizione servizio Profilo Collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (oneway nel nostro caso) Scadenza: Se prevista la scadenza dei messaggi, impostare qui il valore in minuti Figura 21: Creazione del servizio generico con profilo sincrono relativo all accordo AS 6. Aggiungere l azione al Servizio dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form Nome: Nome dell azione. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo. Figura 22: Aggiunta dell azione sincrona al servizio generico dell accordo AS 7. Creare l Accordo di Servizio Parte Specifica che implementa l Accordo di Servizio appena definito. Nel caso si sia in possesso del package per l importazione dell accordo di servizio, non è necessario effettuare manualmente la configurazione e si potrà procedere all importazione automatica seguendo le istruzioni riportate in Sezione 5.1. Per procedere manualmente, selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e compilare il form: Accordo di servizio: selezionare l accordo creato al punto 4 Servizio: selezionare il Servizio dell Accordo creato al punto 5 Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto creato al punto 1 Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica.

24 Guida Utente della PddConsole 16 / 100 Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica. Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per informazioni sugli altri valori richiesti da questo form rimandiamo alla Sezione 5.14 Figura 23: Creazione dell Accordo di Servizio Parte Specifica ServizioSincrono erogato da SPC/Erogatore 8. Aggiungere il soggetto che ci rappresenta come fruitore della parte specifica dell accordo di servizio: selezionare Visualizza nella colonna Fruitori in corrispondenza del Servizio creato al punto 7. Selezionare Aggiungi e compilare il form: Soggetto : Nome del soggetto che ci rappresenta Versione Protocollo : versione del protocollo per le comunicazioni con questo specifico fruitore. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo per il servizio. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo impostata a livello del soggetto fruitore

25 Guida Utente della PddConsole 17 / 100 Figura 24: Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioSincrono L aggiunta del fruitore al servizio comporta la creazione automatica della Porta Delegata associata al soggetto che ci rappresenta. Per maggiori informazioni sull autenticazione/autorizzazione dei servizi applicativi che possono invocare la porta delegata vedere la Sezione 5.2. Per informazioni sulle modalità di identificazione consultare la Sezione Per vincolare la fruizione del servizio allo specifico servizio applicativo tramite autenticazione, selezionare visualizza nella colonna Servizi Applicativi Autorizzati nella lista dei soggetti fruitori del servizio, in corrispondenza del fruitore aggiunto al passo precedente, punto 8. Selezionare Aggiungi e quindi compilare il form: Servizio Applicativo: il Servizio Applicativo creato al punto 3. Figura 25: Autorizzazione del servizio applicativo SAFruitore_Sincrono alla fruizione di SPC/ServizioSincrono 3.3 Asincrono Simmetrico Raccolta informazioni Raccogliere i dati necessari per questa configurazione, facendo riferimento alla tabella Tabella Configurazione 1. Creare il soggetto erogatore: autenticarsi con un utente avente il permesso [S] (vedi [?title]) e selezionare Aggiungi nella sezione Soggetti compilando il form che compare con i valori nella sezione Info Soggetto Interlocutore della Tabella 3: Nome: Nome Soggetto Erogatore Descrizione: Descrizione Soggetto Erogatore Codice IPA: (Campo Specifico per il caso SPCoop) Codice IPA Soggetto Erogatore Tipo: Tipo del Soggetto. Determina il protocollo adottato nelle comunicazioni Versione Protocollo: Versione del protocollo supportata dal soggetto per le comunicazioni. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo Soggetto

26 Guida Utente della PddConsole 18 / 100 Nome Esempio Vostro valore Accordo di Servizio Nome Accordo di Servizio AS Soggetto Referente SPC/Erogatore Versione 1 Info Soggetto Interlocutore Nome erogatore Erogatore Codice IPA c=it,o=c_h501 URL Pubblica Servizio Erogatore Info Servizio Nome servizio ServizioAsincronoSimmetrico Azione AzioneAsincronaSimmetrica Nome servizio correlato (Erogato dal fruitore) ServizioAsincronoSimmetricoCorrelato Azione correlata (Erogata dal fruitore) AzioneAsincronaSimmetricaCorrelata Servizio Applicativo Fruitore Nome Servizio Applicativo SAFruitore_AsincronoSimmetrico Modalita di autenticazione basic Username (solo se autenticazione=basic) SAFruitore_AsincronoSimmetrico Password (solo se autenticazione=basic) Subject (solo se autenticazione=ssl) URL Servizio ricezione Risposta Asincrona Tabella 3: Dati richiesti per la creazione di un fruitore asincrono simmetrico Figura 26: Creazione del soggetto SPC/Erogatore 2. Impostare il connettore del soggetto erogatore: dall Elenco dei Soggetti selezionare visualizza nella colonna Connettore in corrispondenza del soggetto appena creato (passo 1) abilitando il connettore ed inserendo i valori: Abilitato: Abilita il connettore per il soggetto. L interfaccia standard assume che il connettore sia http. Per la documentazione d uso degli altri connettori si rimanda a Sezione 5.8 Url: Indirizzo della porta applicativa a cui è raggiungibile il soggetto

27 Guida Utente della PddConsole 19 / 100 Figura 27: Impostazione del connettore per il soggetto SPC/Erogatore 3. Aggiungere il Servizio Applicativo fruitore associato al soggetto che ci rappresenta selezionando Aggiungi nella sezione Servizi Applicativi. Nella scelta delle credenziali, per esempio, utilizzare la modalità di accesso di tipo basic e compilare il form: Nome: Nome Servizio Applicativo Soggetto : selezionare il soggetto che ci rappresenta e che dovrà fruire del servizio Credenziali di accesso: Specifica il tipo di credenziali che il servizio applicativo deve utilizzare per autenticarsi sulla Porta di Dominio. A scelta tra nessuna, basic e ssl Utente: Username (caso autenticazione basic) Password: Password (caso autenticazione basic) Subject: Subject (caso autenticazione ssl) del certificato utilizzato dal servizio applicativo Modalità di Fault: Formato con cui verranno restituiti gli errori al servizio applicativo. (quest ultimo è il formato definito nelle specifiche ) A scelta tra soap e xml Sbustamento Informazioni di Protocollo: Permette di abilitare/disabilitare la presenza dell header di protocollo nei messaggi consegnati dalla PdD al servizio applicativo. Nota Per la fruizione di un servizio Asincrono Simmetrico l autenticazione è obbligatoria Per maggiori informazioni vedere la Sezione 5.2. Figura 28: Creazione del servizio applicativo SAFruitore_AsincronoSimmetrico associato al soggetto che ci rappresenta

28 Guida Utente della PddConsole 20 / Definire il connettore per la consegna della risposta asincrona simmetrica sul Servizio Applicativo fruitore: selezionare disabilitato nella colonna Risposta asincrona in corrispondenza del servizio applicativo creato al passo precedente, punto 3. Figura 29: Elenco Servizi Applicativi Successivamente compilare il form che segue: Sbustamento SOAP: (abilitato/disabilitato) Se si abilita l impostazione, la PdD consegna il contenuto applicativo privandolo della busta SOAP, quindi solo il contenuto del Body Sbustamento Informazioni di Protocollo: (abilitato/disabilitato) Se si abilita l impostazione, la PdD priva la busta SOAP dell header di protocollo. Salvataggio in MessageBox: (abilitato/disabilitato) Abilitando questa impostazione se la PdD non è in condizione di poter consegnare il messaggio applicativo, lo tiene nella MessageBox. Il servizio applicativo potrà prelevare il messaggio successivamente tramite le interfacce applicative dell Integration Manager Connettore: Impostando il flag Abilitato l interfaccia standard assume un connettore di tipo HTTP da utilizzare per la consegna del messaggio. Url: URL Servizio ricezione Risposta Asincrona Figura 30: Impostazione del connettore per la ricezione della risposta asincrona da parte del servizio applicativo fruitore 5. Aggiungere un nuovo Accordo di Servizio Parte Comune. Nel caso si sia in possesso del package per l importazione dell accordo di servizio, non è necessario effettuare manualmente la configurazione e si potrà procedere all importazione automatica seguendo le istruzioni riportate in Sezione 5.1. Per procedere manualmente, selezionare Aggiungi nella sezione Accordi servizio compilando il form che compare con i valori nella sezione Accordo di Servizio della Tabella 3: Nome: Nome della Parte Comune dell Accordo di Servizio. Descrizione: Descrizione della Parte Comune dell Accordo di Servizio. Soggetto referente: è il soggetto promotore dell accordo di servizio. Tipicamente coincide con uno dei soggetti erogatori. In questo caso utilizzare il soggetto creato al punto 1.

29 Guida Utente della PddConsole 21 / 100 Versione: Progressivo intero che assieme alla coppia <nome, referente> va a formare la chiave identificativa dell accordo di servizio. Specifica delle Interfacce: I WSDL che descrivono tecnicamente l accordo di servizio. Specifica delle Conversazioni: (Campo specifico per SPCoop) Nell esempio riportato nella figura sottostante questa sezione appare poiché il soggetto referente ha il tipo SPC che è associato al protocollo SPCoop Figura 31: Creazione dell accordo di servizio parte comune AS con referente SPC/Erogatore Per ulteriori informazioni sui valori richiesti da questa form rimandiamo alla Sezione Aggiungere il Servizio Generico all Accordo di Servizio: dall Elenco degli Accordi Servizio Parte Comune selezionare visualizza nella colonna Servizi corrispondente all accordo di servizio creato al punto 5. Selezionare, quindi, Aggiungi ed inserire i valori della sezione Info Servizio della Tabella 3: Nome: Nome servizio. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio Descrizione: Descrizione servizio Profilo Collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (oneway nel nostro caso) Scadenza: Se prevista la scadenza dei messaggi, impostare qui il valore in minuti

30 Guida Utente della PddConsole 22 / 100 Figura 32: Creazione del servizio generico con profilo Asincrono Simmetrico associato all accordo AS 7. Aggiungere l azione al Servizio dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form: Nome: Nome dell azione. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo. Figura 33: Aggiunta dell azione Asincrona Simmetrica al servizio generico dell accordo AS 8. Aggiungere il Servizio Generico correlato all Accordo di Servizio (si tratta del servizio erogato dal soggetto che ci rappresenta): dall Elenco degli Accordi servizio selezionare visualizza nella colonna Servizio corrispondente all accordo di servizio creato al passo 5. Selezionare, quindi, Aggiungi ed inserire i valori della sezione Info Servizio della Tabella 3: Nome: Nome servizio correlato. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio Profilo di collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (asincrono simmetrico nel nostro caso)

31 Guida Utente della PddConsole 23 / 100 Figura 34: Creazione del servizio generico correlato relativo all accordo di servizio AS 9. Aggiungere l azione al Servizio correlato dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form: Nome: Nome azione correlata. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Correlata al Servizio: Selezionare il servizio che contiene l azione che si sta correlando Correlata all Azione: Selezionare l azione che si sta correlando Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo. Figura 35: Aggiunta dell azione AsincronaSimmetricaCorrelata associata al servizio generico correlato 10. Creare l Accordo di Servizio Parte Specifica che implementa l Accordo di Servizio appena definito. Nel caso si sia in possesso del package per l importazione dell accordo di servizio, non è necessario effettuare manualmente la configurazione e si potrà procedere all importazione automatica seguendo le istruzioni riportate in Sezione 5.1. Per procedere manualmente, selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e riempire i campi del form: Accordo di servizio: selezionare l accordo creato al punto 5 Servizio: selezionare il Servizio dell Accordo creato al punto 6 Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto creato al punto 1

32 Guida Utente della PddConsole 24 / 100 Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica. Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica. Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione 5.14 Figura 36: Creazione del servizio ServizioAsincronoSimmetrico relativo all accordo AS ed erogato da SPC/Erogatore 11. Aggiungere il soggetto che ci rappresenta come fruitore dell accordo di servizio parte specifica: selezionare Visualizza nella colonna Adesioni in corrispondenza del Servizio creato al punto 10. Selezionare Aggiungi e compilare il form: Soggetto : Nome del soggetto che ci rappresenta Versione Protocollo : versione del protocollo per le comunicazioni con questo specifico fruitore. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo per il servizio. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo impostata a livello del soggetto fruitore

33 Guida Utente della PddConsole 25 / 100 Figura 37: Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioAsincronoSimmetrico erogato da SPC/Erogatore L aggiunta del fruitore al servizio comporta la creazione automatica della Porta Delegata associata al soggetto che ci rappresenta. Per maggiori informazioni sull autenticazione/autorizzazione dei servizi applicativi che possono invocare la porta delegata vedere la Sezione 5.2. Per informazioni sulle modalità di identificazione consultare la Sezione Per vincolare la fruizione del servizio allo specifico servizio applicativo tramite autenticazione, selezionare visualizza nella colonna Servizi Applicativi Autorizzati nella lista dei soggetti fruitori del servizio, in corrispondenza del fruitore aggiunto al passo precedente, punto 11. Selezionare Aggiungi e quindi compilare il form: Servizio Applicativo: il Servizio Applicativo creato al passo 3. Figura 38: Autorizzazione del servizio applicativo SAFruitore_AsincronoSimmetrico alla fruizione del servizio SPC/ServizioAsincronoSimmetrico 13. Creare l Accordo di Servizio Parte Specifica correlato al precedente ed erogato dal fruitore. Tale accordo di servizio implementa il Servizio correlato dell Accordo: selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e riempire i campi del form: Accordo di servizio: selezionare l accordo creato al punto 5 Servizio: selezionare il Servizio dell Accordo creato al punto 8 Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto che ci rappresenta Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica. Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica.

34 Guida Utente della PddConsole 26 / 100 Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione 5.14 Figura 39: Creazione del servizio correlato SPC/ServizioAsincronoSimmetricoCorrelato erogato dal soggetto che ci rappresenta 14. Aggiungere il soggetto erogatore come fruitore dell accordo di servizio parte specifica correlato: selezionare Visualizza nella colonna Fruitori in corrispondenza del Servizio creato al punto 13. Selezionare Aggiungi e compilare il form: Soggetto : Nome del soggetto erogatore Versione Protocollo: versione del protocollo per le comunicazioni con questo specifico fruitore. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo per il servizio. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo impostata a livello del soggetto fruitore Figura 40: Sottoscrizione del soggetto erogatore al servizio SPC/ServizioAsincronoSimmetricoCorrelato erogato da SPC/Fruitore

35 Guida Utente della PddConsole 27 / Asincrono Asimmetrico Raccolta informazioni Raccogliere i dati necessari per questa configurazione, facendo riferimento alla tabella Tabella 4. Nome Esempio Vostro valore Accordo di Servizio Nome Accordo di Servizio AS Soggetto Referente SPC/Erogatore Versione 1 Info Soggetto Interlocutore Nome erogatore Erogatore Codice IPA c=it,o=c_h501 URL Pubblica Servizio Erogatore Info Servizio Nome servizio ServizioAsincronoAsimmetrico Azione AzioneAsincronaAsimmetrica Azione (correlata) per la richiesta della Risposta Asincrona AzioneAsincronaAsimmetricaRichiestaStato Servizio Applicativo Fruitore Nome Servizio Applicativo SAFruitore_AsincronoAsimmetrico Modalita di autenticazione basic Username (solo se autenticazione=basic) SAFruitore_AsincronoAsimmetrico Password (solo se autenticazione=basic) Subject (solo se autenticazione=ssl) Tabella 4: Dati richiesti per la creazione di un fruitore asincrono asimmetrico Configurazione 1. Creare il soggetto erogatore: autenticarsi con un utente avente il permesso [S] (vedi [?title]) e selezionare Aggiungi nella sezione Soggetti compilando il form che compare con i valori nella sezione Info Soggetto Interlocutore della Tabella 4: Nome: Nome Soggetto Erogatore Descrizione: Descrizione Soggetto Erogatore Codice IPA: (Campo Specifico per il caso SPCoop) Codice IPA Soggetto Erogatore Tipo: Tipo del Soggetto. Determina il protocollo adottato nelle comunicazioni Versione Protocollo: Versione del protocollo supportata dal soggetto per le comunicazioni. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo Soggetto

36 Guida Utente della PddConsole 28 / 100 Figura 41: Creazione del soggetto SPC/Erogatore 2. Impostare il connettore del soggetto erogatore: dall Elenco dei Soggetti selezionare visualizza nella colonna Connettore in corrispondenza del soggetto appena creato (passo 1) abilitando il connettore ed inserendo i valori: Abilitato: Abilita il connettore per il soggetto. L interfaccia standard assume che il connettore sia http. Per la documentazione d uso degli altri connettori si rimanda a Sezione 5.8 Url: Indirizzo della porta applicativa a cui è raggiungibile il soggetto Figura 42: Impostazione del connettore relativo al soggetto SPC/Erogatore 3. Aggiungere un Servizio Applicativo selezionando Aggiungi nella sezione Servizi Applicativi. Nella scelta delle credenziali, per esempio, utilizzare la modalità di accesso di tipo basic e compilare il form: Nome: Nome Servizio Applicativo Soggetto: selezionare il soggetto che ci rappresenta Credenziali di accesso: basic Utente: Username Password: Password Subject: Subject (caso autenticazione ssl) del certificato utilizzato dal servizio applicativo Modalità di Fault: Formato con cui verranno restituiti gli errori al servizio applicativo. (quest ultimo è il formato definito nelle specifiche ) A scelta tra soap e xml Sbustamento Informazioni di Protocollo: Permette di abilitare/disabilitare la presenza dell header di protocollo nei messaggi consegnati dalla PdD al servizio applicativo. Per maggiori informazioni vedere la Sezione 5.2.

37 Guida Utente della PddConsole 29 / 100 Figura 43: Creazione del servizio applicativo SAFruitore_AsincronoAsimmetrico associato al soggetto che ci rappresenta 4. Aggiungere un nuovo Accordo di Servizio Parte Comune. Nel caso si sia in possesso del package per l importazione dell accordo di servizio, non è necessario effettuare manualmente la configurazione e si potrà procedere all importazione automatica seguendo le istruzioni riportate in Sezione 5.1. Per procedere manualmente, selezionare Aggiungi nella sezione Accordi Servizio Parte Comune compilando il form che compare con i valori nella sezione Accordo di Servizio della Tabella 4: Nome: Nome della Parte Comune dell Accordo di Servizio. Descrizione: Descrizione della Parte Comune dell Accordo di Servizio. Soggetto referente: è il soggetto promotore dell accordo di servizio. Tipicamente coincide con uno dei soggetti erogatori. In questo caso utilizzare il soggetto creato al punto 1. Versione: Progressivo intero che assieme alla coppia <nome, referente> va a formare la chiave identificativa dell accordo di servizio. Specifica delle Interfacce: I WSDL che descrivono tecnicamente l accordo di servizio. Specifica delle Conversazioni: (Campo specifico per SPCoop) Nell esempio riportato nella figura sottostante questa sezione appare poiché il soggetto referente ha il tipo SPC che è associato al protocollo SPCoop

38 Guida Utente della PddConsole 30 / 100 Figura 44: Creazione dell accordo di servizio parte comune AS con referente SPC/Erogatore Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione Aggiungere il Servizio generico all Accordo: dall Elenco degli Accordi servizio selezionare visualizza nella colonna Servizi corrispondente all accordo di servizio creato al punto 4. Selezionare, quindi, Aggiungi ed inserire i valori della sezione Info Servizio della Tabella 4: Nome: Nome servizio. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio Descrizione: Descrizione servizio Profilo Collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (oneway nel nostro caso) Scadenza: Se prevista la scadenza dei messaggi, impostare qui il valore in minuti

39 Guida Utente della PddConsole 31 / 100 Figura 45: Creazione del servizio generico relativo all accordo di servizio AS con profilo Asincrono Asimmetrico 6. Aggiungere l azione al Servizio dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form: Nome: Nome dell azione. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo. Figura 46: Aggiunta dell azione Asincrona Asimmetrica relativa al servizio generico dell accordo AS 7. Aggiungere l azione, correlata alla precedente, per la richiesta della Risposta Asincrona: tornare nella lista delle azioni come al punto precedente e selezionare Aggiungi: Nome: Nome dell azione per la richiesta della risposta asincrona. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Correlata al servizio: lista vuota, in quanto l azione e la sua correlata appartengono al medesimo servizio Correlata all azione: selezionare l Azione creata al punto precedente Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo.

40 Guida Utente della PddConsole 32 / 100 Figura 47: Aggiunta dell azione correlata a AzioneAsincronaAsimmetrica 8. Creare l Accordo di Servizio Parte Specifica, erogato dal soggetto Erogatore, che implementa l Accordo AS. Nel caso si sia in possesso del package per l importazione dell accordo di servizio, non è necessario effettuare manualmente la configurazione e si potrà procedere all importazione automatica seguendo le istruzioni riportate in Sezione 5.1. Per procedere manualmente, selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e riempire i campi del form: Accordo di servizio: selezionare l accordo creato al punto 4 Servizio: selezionare il Servizio dell Accordo creato al punto 5 Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto creato al punto 1 Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica. Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica. Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione 5.14

41 Guida Utente della PddConsole 33 / 100 Figura 48: Creazione servizio SPC/ServizioAsincronoAsimmetrico relativo all accordo AS ed erogato da SPC/Erogatore 9. Aggiungere il soggetto che ci rappresenta come fruitore dell accordo di servizio parte specifica: selezionare Visualizza nella colonna Adesioni in corrispondenza del Servizio creato al punto 8. Selezionare Aggiungi e compilare il form: Soggetto : Nome del soggetto che ci rappresenta Versione Protocollo : versione del protocollo per le comunicazioni con questo specifico fruitore. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo per il servizio. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo impostata a livello del soggetto fruitore Figura 49: Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioAsincronoAsimmetrico L aggiunta del fruitore al servizio comporta la creazione automatica della Porta Delegata associata al soggetto che ci rappresenta. Per maggiori informazioni sull autenticazione/autorizzazione dei servizi applicativi che possono invocare la porta delegata vedere la Sezione 5.2. Per informazioni sulle modalità di identificazione consultare la Sezione Per vincolare la fruizione del servizio allo specifico servizio applicativo tramite autenticazione, selezionare visualizza nella colonna Servizi Applicativi Autorizzati nella lista dei soggetti fruitori del servizio, in corrispondenza del fruitore aggiunto al passo precedente, punto 9. Selezionare Aggiungi e quindi compilare il form:

42 Guida Utente della PddConsole 34 / 100 Servizio Applicativo: il Servizio Applicativo creato al punto 3. Figura 50: Autorizzazione del servizio applicativo SAFruitore_AsincronoAsimmetrico alla fruizione di SPC/ServizioAsincronoAsimmetrico 4 Erogazione di un servizio Supponiamo che si desideri erogare un servizio e renderlo fruibile a servizi applicativi di altri domini. Per abilitare l interazione tra le PdD, dobbiamo agire sulla configurazione tramite la PddConsole. Alcuni dati necessari alla configurazione dipendono dal nostro dominio dei servizi, mentre altri dipendono dalla configurazione delle PdD dei soggetti che fruiranno del servizio erogato. Negli scenari seguenti sono mostrati i passaggi necessari alla configurazione tramite la PddConsole per tutti i profili di collaborazione in qualità di erogatore. Le tabelle riportate per ciascun profilo, mostrano quali dati è necessario raccogliere per la configurazione. Ottenuti tali dati, possiamo registrare tramite PddConsole l Accordo di Servizio e le Porte Applicative necessarie a rendere fruibile il servizio all esterno. 4.1 Oneway Raccolta informazioni Nome Esempio Vostro valore Accordo di Servizio Nome Accordo AS Soggetto Referente SPC/Erogatore Versione 1 Info Soggetto Fruitore Nome fruitore Fruitore Codice IPA o=fruitore,c=it Info Servizio Nome servizio ServizioOneWay Azione AzioneOneWay Servizio Applicativo Erogatore Nome Servizio Applicativo SAErogatore_OneWay URL Servizio da erogare Tabella 5: Dati richiesti per la creazione di una erogazione di un servizio con profilo Oneway Configurazione 1. Aggiungere un nuovo Accordo di Servizio Parte Comune: selezionare Aggiungi nella sezione Accordi Servizio Parte Comune compilando il form che compare con i i valori nella sezione Accordo di Servizio della Tabella 5:

43 Guida Utente della PddConsole 35 / 100 Nome: Nome della Parte Comune dell Accordo di Servizio. Descrizione: Descrizione della Parte Comune dell Accordo di Servizio. Soggetto referente: è il soggetto promotore dell accordo di servizio. Tipicamente coincide con uno dei soggetti erogatori. In questo caso utilizzare il soggetto creato al punto 1. Versione: Progressivo intero che assieme alla coppia <nome, referente> va a formare la chiave identificativa dell accordo di servizio. Specifica delle Interfacce: I WSDL che descrivono tecnicamente l accordo di servizio. Specifica delle Conversazioni: (Campo specifico per SPCoop) Nell esempio riportato nella figura sottostante questa sezione appare poiché il soggetto referente ha il tipo SPC che è associato al protocollo SPCoop Figura 51: Creazione accordo AS con referente il soggetto che ci rappresenta Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione Aggiungere il Servizio generico all Accordo: dall Elenco degli Accordi Servizio Parte Comune selezionare visualizza nella colonna Servizi corrispondente all accordo di servizio creato al passo precedente. Selezionare, quindi, Aggiungi ed inserite i valori della sezione Info Servizio della Tabella 5: Nome: Nome servizio. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio Descrizione: Descrizione servizio Profilo Collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (oneway nel nostro caso)

44 Guida Utente della PddConsole 36 / 100 Scadenza: Se prevista la scadenza dei messaggi, impostare qui il valore in minuti Figura 52: Creazione servizio generico relativo all accordo AS e con profilo Oneway 3. Aggiungere l azione al Servizio dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form Nome: Nome dell azione. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo. Figura 53: Aggiunta dell azione oneway al servizio generico dell accordo AS 4. Aggiungere il Servizio Applicativo erogatore: selezionare Aggiungi nella sezione Servizi Applicativi e compilare il form con i valori: Nome: Nome Servizio Applicativo Soggetto : selezionare il soggetto che ci rappresenta Credenziali di accesso: non necessarie in quanto il servizio applicativo erogatore non deve accedere la PdD ma vale il viceversa Modalità di fault: selezionare il formato con cui vengono restituiti gli errori a scelta tra la modalità SOAP (SOAPFault) e quella XML descritta nei documenti della specifica Sbustamento Informazioni di Protocollo: Permette di abilitare/disabilitare la presenza dell header di protocollo nei messaggi consegnati dalla PdD al servizio applicativo.

45 Guida Utente della PddConsole 37 / 100 Figura 54: Creazione del servizio applicativo erogatore SAErogatore_OneWay associato al soggetto che ci rappresenta 5. Impostare i parametri di invocazione del Servizio Applicativo erogato: dall Elenco dei servizi applicativi individuare il servizio creato al punto precedente e selezionare disabilitato nella colonna Invocazione Servizio. Compilare il form nel modo seguente: Sbustamento SOAP: (abilitato/disabilitato) Se si abilita l impostazione, la PdD consegna il contenuto applicativo privandolo della busta SOAP, quindi solo il contenuto del Body Sbustamento Informazioni di Protocollo: (abilitato/disabilitato) Se si abilita l impostazione, la PdD priva la busta SOAP dell header di protocollo. Salvataggio in MessageBox: (abilitato/disabilitato) Abilitando questa impostazione se la PdD non è in condizione di poter consegnare il messaggio applicativo, lo tiene nella MessageBox. Il servizio applicativo potrà prelevare il messaggio successivamente tramite le interfacce applicative dell Integration Manager Connettore: impostare il flag. Nell interfaccia standard si assume che il connettore per la sia consegna del messaggio sia di tipo HTTP Url: URL Servizio da erogare Credenziali di accesso: impostare le credenziali nel caso il servizio erogatore richieda autenticazione Figura 55: Impostazione dei parametri per l invocazione del servizio applicativo erogatore 6. Creare l Accordo di Servizio Parte Specifica erogato dal soggetto che ci rappresenta: selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e riempire i campi del form con i valori della Tabella 5:

46 Guida Utente della PddConsole 38 / 100 Accordo di servizio: selezionare l accordo creato al punto 1 Servizio: selezionare il Servizio dell Accordo creato al punto 2 Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto che ci rappresenta Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica. Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Porta Applicativa: in questa sezione si inseriscono i dati per la creazione della porta applicativa: nome e servizio applicativo erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica. Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per ulteriori informazioni sui valori richiesti da questa form rimandiamo alla Sezione 5.14 Figura 56: Creazione della parte specifica dell accordo di servizio ServizioOneWay che si vuole erogare

47 Guida Utente della PddConsole 39 / Creare il/i soggetto/i fruitore/i: selezionare Aggiungi nella sezione Soggetti ed impostare i parametri del gruppo Info Soggetto Fruitore della Tabella 5: Nome: Nome Soggetto Fruitore Descrizione: Descrizione Soggetto Fruitore Codice IPA: (Campo Specifico per il caso SPCoop) Codice IPA Soggetto Fruitore Tipo: Tipo del Soggetto. Determina il protocollo adottato nelle comunicazioni Versione Protocollo: Versione del protocollo supportata dal soggetto per le comunicazioni. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo Soggetto Figura 57: Creazione del soggetto SPC/Fruitore 8. Aggiungere il/i soggetto/i fruitore/i alla lista dei soggetti che possono fruire del servizio: nell elenco degli Accordi Servizio Parte Specifica individuare quello creato al passo 4, selezionare Visualizza nella colonna Fruitori e quindi il pulsante Aggiungi Soggetto : quello creato al passo precedente Figura 58: Sottoscrizione di SPC/Fruitore al servizio ServizioOneway erogato dal soggetto che ci rappresenta Per maggiori informazioni sugli altri campi del form consultare la Sezione Sincrono Raccolta informazioni Raccogliere i dati necessari per questa configurazione, facendo riferimento alla tabella Tabella 6.

48 Guida Utente della PddConsole 40 / 100 Nome Esempio Vostro valore Accordo di Servizio Nome Accordo AS Soggetto Referente SPC/Erogatore Versione 1 Info Soggetto Fruitore Nome fruitore Fruitore Codice IPA o=fruitore,c=it Info Servizio Nome servizio ServizioSincrono Azione AzioneSincrona Servizio Applicativo Erogatore Nome Servizio Applicativo SAErogatore_Sincrono URL Servizio da erogare Tabella 6: Dati richiesti per la creazione di un erogatore Sincrono Configurazione 1. Aggiungere un nuovo Accordo: selezionare Aggiungi nella sezione Accordi servizio compilando il form che compare con i valori nella sezione Accordo di Servizio della Tabella 6: Nome: Nome della Parte Comune dell Accordo di Servizio. Descrizione: Descrizione della Parte Comune dell Accordo di Servizio. Soggetto referente: è il soggetto promotore dell accordo di servizio. Tipicamente coincide con uno dei soggetti erogatori. In questo caso utilizzare il soggetto creato al punto 1. Versione: Progressivo intero che assieme alla coppia <nome, referente> va a formare la chiave identificativa dell accordo di servizio. Specifica delle Interfacce: I WSDL che descrivono tecnicamente l accordo di servizio. Specifica delle Conversazioni: (Campo specifico per SPCoop) Nell esempio riportato nella figura sottostante questa sezione appare poiché il soggetto referente ha il tipo SPC che è associato al protocollo SPCoop

49 Guida Utente della PddConsole 41 / 100 Figura 59: Creazione dell accordo AS con referente il soggetto che ci rappresenta Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione Aggiungere il Servizio all Accordo: dall Elenco degli Accordi servizio selezionare visualizza nella colonna Servizi corrispondente all accordo di servizio creato al passo precedente. Selezionare, quindi, Aggiungi ed inserire i valori della sezione Info Servizio della Tabella 6: Nome: Nome servizio. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio Descrizione: Descrizione servizio Profilo Collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (oneway nel nostro caso) Scadenza: Se prevista la scadenza dei messaggi, impostare qui il valore in minuti

50 Guida Utente della PddConsole 42 / 100 Figura 60: Creazione del servizio generico associato all accordo AS con profilo Sincrono 3. Aggiungere l azione al Servizio dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form Nome: Nome dell azione. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo. Figura 61: Aggiunta dell azione sincrona associata al servizio generico relativo all accordo AS 4. Aggiungere il Servizio Applicativo erogatore: selezionare Aggiungi nella sezione Servizi Applicativi e compilare il form con i valori: Nome: Nome Servizio Applicativo Soggetto : selezionare il soggetto che ci rappresenta Credenziali di accesso: non necessarie in quanto il servizio applicativo erogatore non deve accedere la PdD ma vale il viceversa Modalità di fault: selezionare il formato con cui vengono restituiti gli errori a scelta tra la modalità SOAP (SOAPFault) e quella XML descritta nei documenti della specifica Sbustamento Informazioni di Protocollo: Permette di abilitare/disabilitare la presenza dell header di protocollo nei messaggi consegnati dalla PdD al servizio applicativo.

51 Guida Utente della PddConsole 43 / 100 Figura 62: Creazione del servizio applicativo erogatore associato al soggetto che ci rappresenta 5. Impostare i parametri di invocazione del Servizio Applicativo erogato: dall Elenco dei servizi applicativi individuare il servizio creato al punto precedente e abilitare l Invocazione Servizio. Sbustamento SOAP: (abilitato/disabilitato) Se si abilita l impostazione, la PdD consegna il contenuto applicativo privandolo della busta SOAP, quindi solo il contenuto del Body Sbustamento Informazioni di Protocollo: (abilitato/disabilitato) Se si abilita l impostazione, la PdD priva la busta SOAP dell header di protocollo. Salvataggio in MessageBox: (abilitato/disabilitato) Abilitando questa impostazione se la PdD non è in condizione di poter consegnare il messaggio applicativo, lo tiene nella MessageBox. Il servizio applicativo potrà prelevare il messaggio successivamente tramite le interfacce applicative dell Integration Manager Connettore: impostare il flag. Nell interfaccia standard si assume che il connettore per la sia consegna del messaggio sia di tipo HTTP Url: URL Servizio da erogare Credenziali di accesso: impostare le credenziali nel caso il servizio erogatore richieda autenticazione Figura 63: Impostazione dei parametri per l invocazione del servizio applicativo erogatore 6. Creare l Accordo di Servizio Parte Specifica erogato che implementa il Servizio dell Accordo: selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e riempire i campi del form:

52 Guida Utente della PddConsole 44 / 100 Accordo di servizio: selezionare l accordo creato al punto 1 Servizio: selezionare il Servizio dell Accordo creato al punto 2 Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto che ci rappresenta Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica. Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Porta Applicativa: in questa sezione si inseriscono i dati per la creazione della porta applicativa: nome e servizio applicativo erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica. Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione 5.14 Figura 64: Creazione del servizio ServizioSincrono erogato dal soggetto che ci rappresenta

53 Guida Utente della PddConsole 45 / Creare il/i soggetto/i fruitore/i: selezionare Aggiungi nella sezione Soggetti ed impostare i parametri del gruppo Info Soggetto Fruitore della Tabella 6: Nome: Nome Soggetto Fruitore Descrizione: Descrizione Soggetto Fruitore Codice IPA: (Campo Specifico per il caso SPCoop) Codice IPA Soggetto Fruitore Tipo: Tipo del Soggetto. Determina il protocollo adottato nelle comunicazioni Versione Protocollo: Versione del protocollo supportata dal soggetto per le comunicazioni. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo Soggetto Figura 65: Creazione del soggetto SPC/Fruitore 8. Aggiungere il/i soggetto/i fruitore/i alla lista dei soggetti che possono fruire del servizio: nell elenco degli Accordi di Servizio Parte Specifica individuare quello creato al passo 4 e selezionare visualizza nella colonna Adesioni e successivamente il pulsante Aggiungi. Compilare il form: Soggetto : quello creato al passo precendente Versione Protocollo : usa profilo soggetto Figura 66: Sottoscrizione di SPC/Fruitore al servizio ServizioSincrono erogato dal soggetto che ci rappresenta Per ulteriori informazioni sui campi del form consultare la Sezione Asincrono Simmetrico Raccolta informazioni Raccogliere i dati necessari per questa configurazione, facendo riferimento alla tabella Tabella 7.

54 Guida Utente della PddConsole 46 / 100 Nome Esempio Vostro valore Accordo di Servizio Nome Accordo AS Soggetto Referente SPC/Erogatore Versione 1 Info Soggetto Fruitore Nome fruitore Fruitore Codice IPA o=fruitore,c=it URL Pubblica della PdD Fruitore Info Servizio Nome servizio ServizioAsincronoSimmetrico Azione AzioneAsincronaSimmetrica Nome servizio correlato (Erogato dal fruitore) ServizioAsincronoSimmetricoCorrelato Azione correlata (Erogata dal fruitore) AzioneAsincronaSimmetricaCorrelata Servizio Applicativo Erogatore URL Servizio da erogare Porta Delegata per l invio della Risposta Nome Porta Delegata PD_AsincronaSimmetrica_Risposta Servizio Applicativo Erogatore (Generazione risposta) Nome Servizio Applicativo SAErogatore_AsincronoSimmetrico Modalita di autenticazione basic Username (solo se autenticazione=basic) SAErogatore_AsincronoSimmetrico Password (solo se autenticazione=basic) Subject (solo se autenticazione=ssl) Tabella 7: Dati richiesti per la creazione di un erogatore asincrono simmetrico

55 Guida Utente della PddConsole 47 / Configurazione 1. Aggiungere un nuovo Accordo: selezionare Aggiungi nella sezione Accordi servizio compilando il form che compare con i i valori nella sezione Accordo di Servizio della Tabella 7: Nome: Nome della Parte Comune dell Accordo di Servizio. Descrizione: Descrizione della Parte Comune dell Accordo di Servizio. Soggetto referente: è il soggetto promotore dell accordo di servizio. Tipicamente coincide con uno dei soggetti erogatori. In questo caso utilizzare il soggetto creato al punto 1. Versione: Progressivo intero che assieme alla coppia <nome, referente> va a formare la chiave identificativa dell accordo di servizio. Specifica delle Interfacce: I WSDL che descrivono tecnicamente l accordo di servizio. Specifica delle Conversazioni: (Campo specifico per SPCoop) Nell esempio riportato nella figura sottostante questa sezione appare poiché il soggetto referente ha il tipo SPC che è associato al protocollo SPCoop Figura 67: Creazione accordo di servizio AS con referente il soggetto che ci rappresenta Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione Aggiungere il Servizio all accordo: dall Elenco degli Accordi servizio selezionare visualizza nella colonna Servizio corrispondente all accordo di servizio creato al passo precedente. Selezionare, quindi, Aggiungi ed inserire i valori della sezione Info Servizio della Tabella 7:

56 Guida Utente della PddConsole 48 / 100 Nome: Nome servizio. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio Descrizione: Descrizione servizio Profilo Collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (oneway nel nostro caso) Scadenza: Se prevista la scadenza dei messaggi, impostare qui il valore in minuti Figura 68: Creazione servizio generico relativo all accordo AS con profilo asincrono simmetrico 3. Aggiungere l azione al Servizio dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form: Nome: Nome dell azione. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo. Figura 69: Aggiunta dell azione asincrona simmetrica al servizio generico relativo all accordo AS 4. Aggiungere il Servizio Applicativo erogatore: selezionare Aggiungi nella sezione Servizi Applicativi e compilare il form con i valori: Nome: Nome Servizio Applicativo Soggetto : selezionare il soggetto che ci rappresenta Credenziali di accesso: non necessarie in quanto il servizio applicativo erogatore non deve accedere la PdD ma vale il viceversa Sbustamento Informazioni di Protocollo: Permette di abilitare/disabilitare la presenza dell header di protocollo nei messaggi consegnati dalla PdD al servizio applicativo.

57 Guida Utente della PddConsole 49 / 100 Figura 70: Creazione del servizio applicativo SAErogatore_AsincronoSimmetrico associato al soggetto che ci rappresenta 5. Impostare i parametri di invocazione del Servizio Applicativo erogatore: dall Elenco dei servizi applicativi individuare quello creato al punto precedente e selezionare disabilitato in corrispondenza della colonna Invocazione servizio, quindi compilare il form: Sbustamento SOAP: (abilitato/disabilitato) Se si abilita l impostazione, la PdD consegna il contenuto applicativo privandolo della busta SOAP, quindi solo il contenuto del Body Sbustamento Informazioni di Protocollo: (abilitato/disabilitato) Se si abilita l impostazione, la PdD priva la busta SOAP dell header di protocollo. Salvataggio in MessageBox: (abilitato/disabilitato) Abilitando questa impostazione se la PdD non è in condizione di poter consegnare il messaggio applicativo, lo tiene nella MessageBox. Il servizio applicativo potrà prelevare il messaggio successivamente tramite le interfacce applicative dell Integration Manager Connettore: impostare il flag. Nell interfaccia standard si assume che il connettore per la sia consegna del messaggio sia di tipo HTTP Url: URL Servizio da erogare Credenziali di accesso: impostare le credenziali nel caso il servizio erogatore richieda autenticazione Figura 71: Impostazione dei parametri per l invocazione del servizio applicativo erogatore 6. Creare l Accordo di Servizio Parte Specifica erogato che implementa il Servizio dell Accordo: selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e riempire i campi del form:

58 Guida Utente della PddConsole 50 / 100 Accordo di servizio: selezionare l accordo creato al punto 1 Servizio: selezionare il Servizio dell Accordo creato al punto 2 Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto che ci rappresenta Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica. Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Porta Applicativa: in questa sezione si inseriscono i dati per la creazione della porta applicativa: nome e servizio applicativo erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica. Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione 5.14 Figura 72: Creazione del servizio ServizioAsincronoSimmetrico relativo all accordo AS ed erogato dal soggetto che ci rappresenta

59 Guida Utente della PddConsole 51 / Creare il/i soggetto/i fruitore/i: selezionare Aggiungi nella sezione Soggetti ed impostare i parametri del gruppo Info Soggetto Fruitore della Tabella 7: Nome: Nome Soggetto Fruitore Descrizione: Descrizione Soggetto Fruitore Codice IPA: (Campo Specifico per il caso SPCoop) Codice IPA Soggetto Fruitore Tipo: Tipo del Soggetto. Determina il protocollo adottato nelle comunicazioni Versione Protocollo: Versione del protocollo supportata dal soggetto per le comunicazioni. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo Soggetto Figura 73: Creazione del soggetto SPC/Fruitore 8. Impostare il/i connettore del/i soggetto/i fruitore/i dove verrà spedita la busta contenente la risposta asincrona simmetrica: dall Elenco dei soggetti individuare il/i fruitore/i del servizio e selezionare Visualizza nella colonna Connettore e compilare il form Abilitato: selezionato Url: URL Pubblica della PdD Fruitore Figura 74: Impostazione del connettore relativo al soggetto SPC/Fruitore 9. Aggiungere il/i soggetto/i fruitore/i alla lista dei soggetti che possono fruire del servizio: nell elenco degli Accordi Servizio Parte Specifica individuare quello creato al passo 4 e selezionare visualizza nella colonna Fruitori, quindi il pulsante Aggiungi: Soggetto : quello creato al passo precendente Versione Protocollo : usa profilo soggetto

60 Guida Utente della PddConsole 52 / 100 Figura 75: Sottoscrizione di SPC/Fruitore al servizio ServizioAsincronoSimmetrico erogato dal soggetto che ci rappresenta Per ulteriori informazioni sui campi del form consultare la Sezione Fruizione servizio correlato per generazione risposta 1. Aggiungere il Servizio Generico Correlato all accordo di servizio parte comune creato nella sezione precedente (si tratta del servizio erogato dal fruitore per l invio della risposta asincrona): dall Elenco degli Accordi servizio selezionare visualizza nella colonna Servizio corrispondente all accordo di servizio configurato nella sezione precedente. Selezionare, quindi, Aggiungi ed inserire i valori della sezione Info Servizio della Tabella 7 relativamente al servizio correlato: Nome: Nome servizio correlato. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio Descrizione: Descrizione servizio correlato Profilo Collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (asincrono simmetrico nel nostro caso) Figura 76: Creazione servizio generico correlato relativo all accordo AS con profilo asincrono simmetrico 2. Aggiungere l azione al Servizio correlato dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form: Nome: Nome azione correlata. Nell ambito SPCoop, per compatibilità con le linee guida 1.1 all uso della busta, questo campo deve contenere il nome della corrispondente operation, così come specificate nei WSDL dell accordo di servizio Profilo di collaborazione: usa profilo servizio Correlata al Servizio: Selezionare il servizio che contiene l azione che si sta correlando Correlata all Azione: Selezionare l azione che si sta correlando Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo.

61 Guida Utente della PddConsole 53 / 100 Figura 77: Aggiunta dell azione AsincronaSimmetricaCorrelata associata al servizio generico correlato 3. Creare l Accordo di Servizio Parte Specifica correlato erogato dal fruitore. Tale accordo di servizio implementa il Servizio correlato dell Accordo: selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e riempire i campi del form: Accordo di servizio: selezionare l accordo di servizio parte comune Servizio: selezionare il Servizio dell Accordo Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto fruitore Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica. Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica. Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione 5.14

62 Guida Utente della PddConsole 54 / 100 Figura 78: Creazione del servizio correlato SPC/ServizioAsincronoSimmetricoCorrelato erogato dal soggetto che ci rappresenta 4. Aggiungere il soggetto che ci rappresenta come fruitore dell accordo di servizio parte specifica correlato: selezionare Visualizza nella colonna Fruitori in corrispondenza del Servizio creato al punto precedente. Selezionare Aggiungi e compilare il form: Soggetto : Nome del soggetto che ci rappresenta Versione Protocollo : usa profilo soggetto Figura 79: Sottoscrizione del soggetto che ci rappresenta (erogatore) al servizio SPC/ServizioAsincronoSimmetricoCorrelato erogato da SPC/Fruitore L aggiunta del fruitore al servizio comporta la creazione automatica della Porta Delegata associata al soggetto che ci rappresenta. Per maggiori informazioni sull autenticazione/autorizzazione dei servizi applicativi che possono invocare la porta delegata vedere la Sezione 5.2. Per informazioni sulle modalità di identificazione consultare la Sezione Aggiungere al Servizio Applicativo erogatore le credenziali di accesso necessarie all invocazione della porta delegata. Per esempio definiamo credenziali di accesso di tipo basic. Per maggiori informazioni vedere la Sezione 5.2. Selezionare dall Elenco dei Servizi Applicativi il servizio creato in precedenza col nome indicato nella Tabella 7 alla voce Nome Servizio Applicativo e modificare il form: Credenziali di accesso: Modalità di autenticazione

63 Guida Utente della PddConsole 55 / 100 Utente: Username Password: Password Figura 80: Impostazione delle credenziali per il servizio applicativo erogatore per l invio della risposta asincrona 6. Per vincolare la fruizione del servizio correlato allo specifico servizio applicativo tramite autenticazione, selezionare visualizza nella colonna Servizi Applicativi Autorizzati nella lista dei soggetti fruitori del servizio correlato in corrispondenza dell adesione creata al passo 4. Selezionare Aggiungi e quindi compilare il form: Servizio Applicativo: il Servizio Applicativo erogatore le cui credenziali sono state aggiunte al passo precedente. Figura 81: Autorizzazione del servizio applicativo SAFruitore_AsincronoSimmetrico alla fruizione del servizio SPC/ServizioAsincronoSimmetrico 4.4 Asincrono Asimmetrico Raccolta informazioni Raccogliere i dati necessari per questa configurazione, facendo riferimento alla tabella Tabella Configurazione 1. Aggiungere un nuovo Accordo di Servizio Parte Comune: selezionare Aggiungi nella sezione Accordi Servizio Parte Comune compilando il form che compare con i valori nella sezione Accordo di Servizio della Tabella 8:

64 Guida Utente della PddConsole 56 / 100 Nome Esempio Vostro valore Accordo di Servizio Nome Accordo AS Soggetto Referente SPC/Erogatore Versione 1 Info Soggetto Fruitore Nome fruitore Fruitore Codice IPA o=fruitore,c=it Info Servizio Nome servizio ServizioAsincronoAsimmetrico Azione AzioneAsincronaAsimmetrica Azione per la richiesta della Risposta Asincrona AzioneAsincronaAsimmetricaRichiestaStato Servizio Applicativo Erogatore Nome Servizio Applicativo SAErogatore_AsincronoAsimmetrico URL Servizio da erogare URL Servizio di richiesta della Risposta Sincrona Tabella 8: Dati richiesti per la creazione di un erogatore asincrono asimmetrico Nome: Nome della Parte Comune dell Accordo di Servizio. Descrizione: Descrizione della Parte Comune dell Accordo di Servizio. Soggetto referente: è il soggetto promotore dell accordo di servizio. Tipicamente coincide con uno dei soggetti erogatori. In questo caso utilizzare il soggetto creato al punto 1. Versione: Progressivo intero che assieme alla coppia <nome, referente> va a formare la chiave identificativa dell accordo di servizio. Specifica delle Interfacce: I WSDL che descrivono tecnicamente l accordo di servizio. Specifica delle Conversazioni: (Campo specifico per SPCoop) Nell esempio riportato nella figura sottostante questa sezione appare poiché il soggetto referente ha il tipo SPC che è associato al protocollo SPCoop

65 Guida Utente della PddConsole 57 / 100 Figura 82: Creazione dell accordo di servizio parte comune AS con referente SPC/Erogatore Per informazioni sugli altri valori richiesti da questo form rimandiamo alla Sezione Aggiungere il Servizio generico all Accordo: dall Elenco degli Accordi servizio selezionare visualizza nella colonna Servizi corrispondente all accordo di servizio creato al punto 1. Selezionare, quindi, Aggiungi ed inserire i valori della sezione Info Servizio della Tabella 8: Nome: Nome servizio. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome del PortType corrispondente nei WSDL dell accordo di servizio Descrizione: Descrizione servizio Profilo Collaborazione: Il profilo di collaborazione a scelta tra: oneway, sincrono, asincrono asimmetrico o asincrono simmetrico (oneway nel nostro caso) Scadenza: Se prevista la scadenza dei messaggi, impostare qui il valore in minuti

66 Guida Utente della PddConsole 58 / 100 Figura 83: Creazione del servizio generico relativo all accordo di servizio AS con profilo Asincrono Asimmetrico 3. Aggiungere l azione al Servizio dell Accordo: nell elenco dei Servizi dell Accordo individuare quello creato al punto precedente e selezionare visualizza nella colonna Azioni. Selezionare Aggiungi e compilare il form: Nome: Nome dell azione. Nell ambito SPCoop, per conformità alle linee guida 1.1 della specifica, questo valore deve essere identico al nome dell operation corrispondente nei WSDL dell accordo di servizio. Profilo: usa profilo servizio. In alternativa è possibile ridefinire alcuni parametri specifici per il protocollo adottato Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo. Figura 84: Aggiunta dell azione Asincrona Asimmetrica relativa al servizio generico dell accordo AS 4. Aggiungere l azione, correlata alla precedente, per la richiesta della Risposta Asincrona: tornare nella lista delle azioni come al punto precedente e selezionare Aggiungi: Nome: Azione per la richiesta della Risposta Asincrona (Polling) Profilo di collaborazione: usa profilo servizio Correlata al servizio: lista vuota, in quanto l azione e la sua correlata appartengono al medesimo servizio Correlata all azione: selezionare l Azione creata al punto precedente Selezionando usa profilo servizio viene utilizzato il Profilo di collaborazione impostato nel Servizio dell Accordo.

67 Guida Utente della PddConsole 59 / 100 Figura 85: Aggiunta dell azione correlata a AzioneAsincronaAsimmetrica 5. Aggiungere il Servizio Applicativo erogatore: selezionare Aggiungi nella sezione Servizi Applicativi e compilare il form con i valori: Nome: Nome Servizio Applicativo Soggetto : selezionare il soggetto che ci rappresenta Credenziali di accesso: non necessarie in quanto il servizio applicativo erogatore non deve accedere la PdD ma vale il viceversa Sbustamento Informazioni di Protocollo: Permette di abilitare/disabilitare la presenza dell header di protocollo nei messaggi consegnati dalla PdD al servizio applicativo. Figura 86: Creazione del servizio applicativo SAErogatore_AsincronoAsimmetrico associato al soggetto che ci rappresenta 6. Impostare i parametri di invocazione del Servizio Applicativo erogatore: dall Elenco dei servizi applicativi individuare il servizio creato al punto precedente e selezionare disabilitato in corrispondenza della colonna Invocazione Servizio, quindi compilare il form: Sbustamento SOAP: (abilitato/disabilitato) Se si abilita l impostazione, la PdD consegna il contenuto applicativo privandolo della busta SOAP, quindi solo il contenuto del Body Sbustamento Informazioni di Protocollo: (abilitato/disabilitato) Se si abilita l impostazione, la PdD priva la busta SOAP dell header di protocollo. Salvataggio in MessageBox: (abilitato/disabilitato) Abilitando questa impostazione se la PdD non è in condizione di poter consegnare il messaggio applicativo, lo tiene nella MessageBox. Il servizio applicativo potrà prelevare il messaggio successivamente tramite le interfacce applicative dell Integration Manager

68 Guida Utente della PddConsole 60 / 100 Connettore: impostare il flag. Nell interfaccia standard si assume che il connettore per la sia consegna del messaggio sia di tipo HTTP Url: URL Servizio da erogare Credenziali di accesso: impostare le credenziali nel caso il servizio erogatore richieda autenticazione Figura 87: Impostazione dei parametri di invocazione del servizio applicativo erogatore 7. Impostare i parametri di invocazione del Servizio Applicativo erogatore per la ricezione delle richieste di polling (correlate): dall Elenco dei servizi applicativi individuare il servizio creato al punto precedente e selezionare disabilitato in corrispondenza della colonna Risposta Asincrona, quindi compilare il form: Sbustamento SOAP: (abilitato/disabilitato) Se si abilita l impostazione, la PdD consegna il contenuto applicativo privandolo della busta SOAP, quindi solo il contenuto del Body Sbustamento Informazioni di Protocollo: (abilitato/disabilitato) Se si abilita l impostazione, la PdD priva la busta SOAP dell header di protocollo. Salvataggio in MessageBox: (abilitato/disabilitato) Abilitando questa impostazione se la PdD non è in condizione di poter consegnare il messaggio applicativo, lo tiene nella MessageBox. Il servizio applicativo potrà prelevare il messaggio successivamente tramite le interfacce applicative dell Integration Manager Connettore: impostare il flag. Nell interfaccia standard si assume che il connettore per la sia consegna del messaggio sia di tipo HTTP Url: URL Servizio per la ricezione delle richieste di invio risposta asincrona (polling) Credenziali di accesso: impostare le credenziali nel caso il servizio erogatore richieda autenticazione

69 Guida Utente della PddConsole 61 / 100 Figura 88: Impostazione dei parametri di invocazione del servizio applicativo erogatore 8. Creare l Accordo di Servizio Parte Specifica, erogato dal soggetto che ci rappresenta, che implementa l Accordo AS: selezionare Aggiungi nella sezione Accordi Servizio Parte Specifica e riempire i campi del form: Accordo di servizio: selezionare l accordo di servizio creato al punto 1 Servizio: selezionare il Servizio dell Accordo creato al punto 2 Nome: inserire un nome da assegnare all accordo di servizio parte specifica Descrizione: inserire una descrizione per l accordo di servizio parte specifica Soggetto erogatore: selezionare il soggetto che ci rappresenta Stato: selezionare uno stato per l accordo di servizio parte specifica. In bozza è possibile omettere alcune informazioni da fornire in seguito. Lo stato operativo richiede la presenza di tutti i dati necessari ma consente di effettuare modifiche. Lo stato finale congela l accordo di servizio impedendone qualunque modifica. Tipo: selezionare il tipo dell accordo di servizio parte specifica. In base al tipo selezionato si ricava il protocollo di cooperazione da adottare per le comunicazioni. Versione protocollo: versione del protocollo per le comunicazioni di questo specifico servizio. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo. Tra le opzioni disponibili è possibile scegliere che venga adottata la stessa versione del protocollo adottata dal soggetto erogatore. Porta Applicativa: in questa sezione si inseriscono i dati per la creazione della porta applicativa: nome e servizio applicativo erogatore. Specifica dei porti di accesso: in questa sezione possono essere aggiunti i WSDL che descrivono tecnicamente l accordo di servizio parte specifica. Connettore: abilitare il flag connettore se si vuole specificare un connettore per il servizio differente da quello inserito per il soggetto erogatore. Se non è stato inserito un connettore per il soggetto erogatore, è obbligatorio abilitare questo connettore per salvare l accordo di servizio parte specifica. Per ulteriori informazioni sui valori richiesti da questo form rimandiamo alla Sezione 5.14

70 Guida Utente della PddConsole 62 / 100 Figura 89: Creazione servizio SPC/ServizioAsincronoAsimmetrico relativo all accordo AS ed erogato da SPC/Erogatore 9. Creare il/i soggetto/i fruitore/i: selezionare Aggiungi nella sezione Soggetti ed impostare i parametri del gruppo Info Soggetto Fruitore della Tabella 8: Nome: Nome Soggetto Fruitore Descrizione: Descrizione Soggetto Fruitore Codice IPA: (Campo Specifico per il caso SPCoop) Codice IPA Soggetto Fruitore Tipo: Tipo del Soggetto. Determina il protocollo adottato nelle comunicazioni Versione Protocollo: Versione del protocollo supportata dal soggetto per le comunicazioni. I valori della lista variano in base al protocollo selezionato tramite la scelta del Tipo Soggetto

71 Guida Utente della PddConsole 63 / 100 Figura 90: Creazione del soggetto SPC/Fruitore 10. Aggiungere il/i soggetto/i fruitore/i alla lista dei soggetti che possono fruire del servizio: nell elenco degli Accordi Servizio Parte Specifica individuare quello creato al passo 5 e selezionare Aggiungi nella colonna Fruitori: Soggetto : quello creato al passo precedente Versione Protocollo : usa profilo soggetto Figura 91: Sottoscrizione di SPC/Fruitore al servizio erogato dal soggetto che ci rappresenta Per maggiori informazioni sugli altri campi del form consultare la Sezione Funzionalità avanzate In questa sezione si descrivono le funzionalità avanzate per la configurazione della Porta di Dominio OpenSPCoop2 tramite la PddConsole. 5.1 Importazione ed Esportazione delle entità del Registro Servizi Il processo di configurazione delle entità del registro servizi può essere notevolmente velocizzato utilizzando la funzionalità di import/export automatico. Il formato dei package di importazione/esportazione dipende dal protocollo di cooperazione in uso sulla Porta di Dominio e può essere personalizzato attraverso gli strumenti di sviluppo dei plugin. Le entità importabili ed esportabili tramite i package sono: 1. Accordi di Servizio Parte Comune 2. Accordi di Servizio Parte Specifica 3. Accordi di Servizio Composto

72 Guida Utente della PddConsole 64 / Accordi di Cooperazione Per poter procedere all importazione automatica è necessario disporre del package corrispondente. Per analogia con le entità gestite, le tipologie di package sono: 1. APC (Accordi di Servizio Parte Comune) 2. APS (Accordi di Servizio Parte Specifica) 3. SC (Accordi di Servizio Composto) 4. AC (Accordi di Cooperazione) Analogamente sarà possibile procedere all esportazione di tali package partendo dalla configurazione presente nel Registro Servizi. Per importare un package selezionare la voce Importa nel menu della PddConsole in corrispondenza della sezione corrispondente alla tipologia di entità che si vuole importare. Si presenta un form che consente di selezionare il file che raprresenta il package da importare. Figura 92: Maschera di importazione di package Durante la fase di caricamento del file e successiva importazione del package potrebbe accadere che le informazioni contenute nel package non siano sufficienti per il completamento del processo di importazione. In tal caso verranno mostrate all utente alcune maschere per integrare i dati mancanti. Per esportare package partendo dalle configurazioni presenti nel proprio Registro Servizi sarà sufficiente selezionare le entità che si desidera esportare dalla lista che le elenca tramite l apposito checkbox posto a fine riga. Dopo aver completato la selezione si preme il pulsante Esporta Selezionati per produrre l archivio esportato. Se si seleziona più di una entità il risultato sarà la creazione di un archivio unico contenente tutti i package (uno per ciascuna entità). 5.2 Autenticazione ed Autorizzazione dei Servizi Applicativi Nome Default Vostro valore Autenticazione ssl Autorizzazione openspcoop Tabella 9: Informazioni di Autenticazione e Autorizzazione È possibile configurare la Porta di Dominio affinché controlli le credenziali di autenticazione e autorizzazione di un servizio applicativo fruitore. Al momento della creazione dei Servizi Applicativi fruitori specifichiamo con quale modalità intendono autenticarsi, fornendo i parametri addizionali di cui hanno bisogno: basic: vengono richiesti nome utente e password da inserire nell header di trasporto ssl: viene richiesto di inserire il subject del certificato

73 Guida Utente della PddConsole 65 / 100 Figura 93: Impostazione di credenziali ssl per un servizio applicativo generico Configuriamo adesso la Porta Delegata specificando il tipo di autorizzazione richiesta al Servizio Applicativo. Fatto questo solo i servizi applicativi che forniscono delle credenziali valide vengono accettate dalla Porta di Dominio. Figura 94: Impostazione di una porta delegata con autenticazione ssl Se abilitiamo l opzione di Autorizzazione openspcoop, istruiamo la Porta di Dominio a controllare che i servizi applicativi autenticati siano nella lista Servizi Applicativi della Porta Delegata in questione.

74 Guida Utente della PddConsole 66 / 100 Figura 95: Autorizzazione di un servizio applicativo sulla porta delegata 5.3 Autorizzazione Richieste in Entrata La Porta di Dominio consente opzionalmente di utilizzare meccanismi a supporto della sicurezza nelle comunicazioni tra le porte di dominio. Questi meccanismi fanno parte dei moduli dedicati all autenticazione e all autorizzazione. Il meccanismo già incluso è denominato Autorizzazione Buste e prevede l autorizzazione delle buste in ingresso. Per abilitare l autorizzazione occorre popolare la lista dei fruitori delle parti specifiche degli accordi di servizio. Per quanto riguarda la PdD del fruitore è sufficiente aggiungere alla lista il soggetto che lo rappresenta, mentre nella PdD dell erogatore devono essere specificati tutti i potenziali fruitori. Vediamo adesso in dettaglio il comportamento della PdD in fase di autorizzazione di una busta in ingresso. La PdD effettua le seguenti verifiche: 1. che il Soggetto Mittente della busta sia effettivamente registrato come fruitore del Servizio Richiesto. In caso contrario rifiuta la busta con un codice errore dipendente dal protocollo di cooperazione (EGOV_IT_201 nel caso SPCoop) 2. controlla nel Registro dei Servizi, se per il Soggetto Mittente è specificata la Porta di Dominio a cui afferisce. In caso contrario, accetta la busta senza ulteriori verifiche 3. verifica se esiste il campo client-auth nella registrazione del Soggetto Mittente come fruitore del Servizio richiesto; se non esiste procede con le prossime verifiche, altrimenti: se il valore del campo è disabilitato, accetta la busta senza ulteriori verifiche; se il valore del campo è abilitato, verifica che la trasmissione della busta sia avvenuta su protocollo https con autenticazione della Porta di Dominio mittente, e che il subject della Porta di Dominio mittente sia uguale a quanto indicato dal campo subject della Porta di Dominio nel Registro Servizi. In caso di successo accetta la busta, altrimenti la rifiuta restituendo una busta errore con codice dipendente dal protocollo di cooperazione (EGOV_IT_201 nel caso SPCoop) alla Porta di Dominio mittente 4. controlla nel Registro il valore del campo client-auth per la Porta di Dominio associata al Soggetto Mittente; se il campo non esiste o risulta disabilitato, accetta la busta senza ulteriori verifiche; si invece il valore del campo client-auth è abilitato, verifica che la trasmissione della busta sia avvenuta su protocollo https con autenticazione della Porta di Dominio mittente e che il subject della Porta di Dominio mittente sia uguale a quanto indicato dal campo subject della Porta di Dominio nel Registro Servizi. In caso di successo accetta la busta, altrimenti la rifiuta restituendo una busta errore con codice dipendente dal protocollo di cooperazione (EGOV_IT_201 nel caso SPCoop) alla Porta di Dominio mittente Figura 96: Autorizzazione di un soggetto alla fruizione di un dato servizio

75 Guida Utente della PddConsole 67 / Ricezione Richieste di Erogazione (Porta Applicativa) Quando si crea un nuovo Accordo di Servizio Parte Specifica viene contestualmente creata una Porta Applicativa, associata al soggetto erogatore di tale accordo. La porta applicativa creata automaticamente viene impostata con valori di uso comune. In alcuni casi è necessario intervenire per personalizzare una porta applicativa o crearne di nuove. Per intervenire sulle porte applicative è sufficiente visualizzare la lista dei soggetti e selezionare il link visualizza in corrispondenza della colonna Porte Applicative e riga del soggetto proprietario. In tal modo si giunge all elenco delle porte applicative appartenenti al soggetto con la possibilità di modificare le esistenti o crearne di nuove. La creazione di una porta applicativa comporta l inserimento dei seguenti dati: Nome: Nome porta applicativa Descrizione: Descrizione porta applicativa Validazione Contenuti: Se sono stati inseriti i WSDL del servizio sarà possibile abilitare la validazione xsd dei messaggi in transito. Abilitando la validazione, in caso di errore la PdD non consegna il messaggio al servizio e restituisce un fault. In alternativa è possibile scegliere l opzione warningonly per far consegnare il messaggio anche in caso di errore ma tenendo traccia del problema nei messaggi diagnostici Gestione Body: Opzione utilizzabile negli scenari SOAP With Attachments. Stabilisce cosa deve fare la PdD del SOAPBody del messaggio tra: nulla, scartarlo o inserirlo come allegato al messaggio Gestione Manifest: Opzione utilizzabile negli scenari SOAP With Attachments. Stabilisce se la PdD deve gestire o meno il Manifest Attachment previsto dalla specifica negli scenari con allegati Accordo di Servizio Parte Specifica: Nome Servizio Nome Azione: Azione. Non specificando l azione, la configurazione della porta applicativa sarà valida per tutte le azioni appartenenti al servizio Figura 97: Creazione di una porta applicativa 5.5 Correlazione Applicativa La funzione di Correlazione Applicativa consente alla porta di dominio di estrarre un identificatore relativo al contenuto applicativo del messaggio in transito. L identificatore applicativo, se presente, finisce nei sistemi di tracciamento e diagnostici, a completamento delle informazioni già presenti. Le informazioni di correlazione applicativa consistono in un insieme di regole

76 Guida Utente della PddConsole 68 / 100 per l estrazione dell identificatore. Tali regole sono associabili sia alle porte delegate che applicative. Nel caso delle porte delegate, la correlazione applicativa, consente di identificare rispedizioni dello stesso messaggio applicativo, offrendo alla Porta di Dominio la possibilità di imbustare il messaggio usando lo stesso id utilizzato in precedenza. In questo modo, il messaggio duplicato potrà essere riconosciuto dalla Porta di Dominio destinataria, usando la funzionalità di filtro-duplicati prevista nella specifica. Figura 98: Inserimento di una regola di correlazione applicativa associata ad una porta delegata è possibile impostare più regole per identificare l id di correlazione all interno dei messaggi in transito, indicando Elemento: nome dell elemento xml radice del contenuto applicativo del messaggio. Questo dato serve per capire quale regola di correlazione applicativa si applica al messaggio in transito. Lasciando il campo vuoto, si intende Qualunque Identificazione: rappresenta la modalità di acquisizione dell identificatore applicativo. Può assumere i seguenti valori: urlbased: il valore viene preso dalla url utilizzata dal servizio applicativo per l invocazione della porta delegata. La regola per l estrazione dalla url viene specificata tramite un espressione regolare presente inserita nel campo pattern. Questa opzione è presente solo per le porte delegate; contentbased: Il valore viene estratto direttamente dal messaggio applicativo xml. La regola per l estrazione dal messaggio è specificata tramite un espressione XPath inserita nel campo pattern; inputbased: il valore viene estratto dall header di integrazione OpenSPCoop2, utilizzato dal servizio applicativo per l invio del messaggio, e presente nel valore della proprietà IDApplicativo. Questa opzione è presente solo per le porte delegate; disabilitato: l identificatore applicativo non viene estratto. Questa opzione è utile quando si vuole disabilitare l estrazione dell id applicativo solo per specifici messaggi; Pattern: definisce l espressione regolare, nel caso di identificazione urlbased, o l espressione xpath, nel caso di identificazione contentbased, utilizzata per l acquisizione dell identificatore applicativo. Gestione identificazione fallita: azione da intraprendere nel caso fallisca l estrazione dell identificatore applicativo tramite la regola specificata. Nel caso sia stato indicato blocca, tali richieste non verranno accettate dalla Porta di Dominio che restituisce un errore al mittente; Riuso ID: opzione per abilitare/disabilitare il riuso dell identificatore della busta nel caso in cui la Porta di Dominio riceva messaggi con identificatori applicativi già processati in precedenza. 5.6 Consegna contenuti applicativi È possibile fornire alla Porta di Dominio diversi dettagli riguardanti le modalità di consegna dei contenuti applicativi al servizio erogatore. Tali opzioni sono configurabili nell ambito della sezione Servizi Applicativi della PddConsole, alle voci Invocazione Servizio e Risposta Asincrona (quest ultima da utilizzarsi solo nei profili asincroni). L opzione di invocazione servizio deve essere abilitata e i relativi dati forniti per consentire alla componente di integrazione della Porta di Dominio di consegnare le richieste di servizio all applicativo erogante.

77 Guida Utente della PddConsole 69 / 100 Figura 99: Impostazione dei parametri di integrazione per un servizio applicativo Vediamo in dettagli il significato di ogni parametro: Sbustamento SOAP: (abilitato/disabilitato) Se si abilita l impostazione, la PdD consegna il contenuto applicativo privandolo della busta SOAP, quindi solo il contenuto del Body Sbustamento Informazioni di Protocollo: (abilitato/disabilitato) Se si abilita l impostazione, la PdD priva la busta SOAP dell header di protocollo. Salvataggio in MessageBox: (abilitato/disabilitato) Abilitando questa impostazione se la PdD non è in condizione di poter consegnare il messaggio applicativo, lo tiene nella MessageBox. Il servizio applicativo potrà prelevare il messaggio successivamente tramite le interfacce applicative dell Integration Manager Invio per Riferimento: Opzione avanzata da utilizzarsi solo in scenari in cui è coinvolto il gestore eventi. Se abilitato, la porta di dominio non consegna il messaggio vero e proprio ma solo il riferimento a tale contenuto che viene invece mantenuto nella message box. Risposta per Riferimento: Opzione avanzata complementare alla precedente. In questo caso il messaggio ricevuto dalla Porta di Dominio contiene un riferimento ad un contenuto della message box. La Porta di Dominio preleva il contenuto riferito e lo consegna al servizio applicativo destinatario mettendolo nel corpo del messaggio. Connettore: Selezionando un opzione diversa da disabilitato si attiva la consegna del contenuto in modalità Proxy Trasparente. Se si configura un connettore, la Porta di Dominio tenta la consegna del messaggio utilizzando il trasporto specificato nel connettore. Il connettore di default è HTTP, il quale si configura semplicemente fornendo la URL per l invocazione del servizio. Gli altri connettori richiedono parametri specifici. Credenziali di accesso: Nel caso in cui il servizio da invocare preveda autenticazione si devono fornire alla Porta di Dominio le credenziali. Nota Abilitando sia Salvataggio in MessageBox che Connettore, la Porta di Dominio tenta inizialmente di consegnare attraverso il connettore specificato. Nel caso in cui la consegna fallisse, invece di gestire l errore, conserva il messaggio nella Message Box utilizzando quindi l opzione Salvataggio in MessageBox.

78 Guida Utente della PddConsole 70 / Integrazione In alcune situazioni, i Servizi Applicativi devono avere una precisa visibilità dei dati di intestazione scambiati tra le Porte di Dominio. Una situazione del genere si verifica, ad esempio, quando diversi messaggi sono correlati tra loro, come nel caso dell uso dell id di collaborazione o dei profili di collaborazione Asincroni, sia simmetrico che asimmetrico. Per questo, alcune delle informazioni parte dell header della busta possono essere scambiate tra il Servizio Applicativo e la PdD al momento dell invocazione di una porta delegata o tra la PdD ed il Servizio Applicativo al momento dell invocazione di una porta applicativa. In particolare le informazioni in questione variano in funzione di quanto specificato negli Accordi di Servizio a cui la busta si riferisce. Nel caso di uso dell IntegrationManager, tali informazioni sono accessibili tramite le interfacce di get/set della classe Protocol- HeaderInfo descritta in dettaglio nel manuale di sviluppo. Nel caso di uso della modalità trasparente, tali informazioni sono invece accessibili tramite quattro diverse modalità: Url Based: le informazioni sono incapsulate nella url di richiesta Trasporto: le informazioni sono contenute nell header di trasporto (dipendente dal protocollo adottato) SOAP: le informazioni sono incluse in uno specifico header SOAP proprietario di OpenSPCoop2 WS-Addressing: le informazioni sono incluse in un header SOAP secondo il formato standard WS-Addressing La Porta Delegata, per default, utilizza il metodo Trasporto. Se si verifica che caso non riesca a trovare le informazioni necessarie, tenta di recuperarle con il metodo UrlBased. La Porta Applicativa utilizza, per default, la modalità Trasporto. Se viene utilizzato l header di trasporto le keyword per riferire i dati di integrazione sono: X-OpenSPCoop2-IdMessaggio X-OpenSPCoop2-TipoMittente X-OpenSPCoop2-Mittente X-OpenSPCoop2-TipoDestinatario X-OpenSPCoop2-Destinatario X-OpenSPCoop2-TipoServizio X-OpenSPCoop2-Servizio X-OpenSPCoop2-Azione X-OpenSPCoop2-RiferimentoMessaggio X-OpenSPCoop2-Collaborazione X-OpenSPCoop2-IdApplicativo X-OpenSPCoop2-ServizioApplicativo Se viene utilizzata la query string (e quindi la url) le keyword per riferire i dati di integrazione sono: OpenSPCoop2IdMessaggio OpenSPCoop2TipoMittente OpenSPCoop2Mittente OpenSPCoop2TipoDestinatario OpenSPCoop2Destinatario

79 Guida Utente della PddConsole 71 / 100 OpenSPCoop2TipoServizio OpenSPCoop2Servizio OpenSPCoop2Azione OpenSPCoop2RiferimentoMessaggio OpenSPCoop2Collaborazione OpenSPCoop2IdApplicativo OpenSPCoop2ServizioApplicativo La Porta di Dominio fornisce anche la possibilità di implementare metodi custom per il recupero delle informazioni di integrazione. Per creare un metodo personalizzato occorre fornire un implementazione di una delle seguenti interfacce: org.openspcoop2.pdd.integrazione.igestoreintegrazionepdsoap, per l integrazione con la porta delegata org.openspcoop2.pdd.integrazione.igestoreintegrazionepasoap, per l integrazione con la porta applicativa Una volta disponibile il modulo di integrazione personalizzato, deve essere registrato nel file di configurazione openspcoop2.properties analogamente al seguente esempio: # Integrazione tra Servizi Applicativi e PdD org.openspcoop2.integrazione.pd.trasporto = org.openspcoop2.pdd.core.integrazione. GestoreIntegrazionePDTrasporto org.openspcoop2.integrazione.pd.urlbased = org.openspcoop2.pdd.core.integrazione. GestoreIntegrazionePDUrlBased org.openspcoop2.integrazione.pd.soap = org.openspcoop2.pdd.core.integrazione. GestoreIntegrazionePDSoap # integrazione custom org.openspcoop2.integrazione.pd.custom = org.package.personale.integrazionecustompd Per utilizzare il metodo di integrazione aggiunto o modificare le impostazioni di default sulla specifica porta delegata o applicativa è sufficiente modificare i dati della porta inserendo nel campo Integrazione i metodi che si vogliono adottare, separati da virgola, in ordine di priorità. Le keyword che possono essere impiegate nel campo integrazione devono essere scelte tra le seguenti: trasporto urlbased soap wsa Figura 100: Modifica della modalità di passaggio dell header di integrazione per una porta delegata

80 Guida Utente della PddConsole 72 / Connettori I connettori rappresentano le modalità di trasporto attraverso le quali comunicano le applicazioni. Nel nostro contesto possiamo distinguere due tipologie di comunicazioni: Porta di Dominio <--> Porta di Dominio Servizio Applicativo <--> Porta di Dominio Le comunicazioni tra Porte di Dominio avvengono solo su protocollo HTTP (o HTTPS). Per le comunicazioni tra PdD e servizi applicativi, oltre ad HTTP, è possibile prevedere altri protocolli. La PddConsole, tramite l interfaccia in modalità avanzata consente di configurare le comunicazioni attraverso connettori diversi da HTTP. OpenSPCoop2 offre built-in i seguenti connettori: HTTPS: connettore che utilizza i protocolli SSL/TLS JMS: connettore basato sul protocollo JMS Null: connettore per test. Si comporta come un servizio Oneway ricevendo richieste senza rispondere NullEcho: connettore per test. Si comporta come un servizio Sincrono rispondendo con un messaggio identico alla richiesta Passiamo adesso a descrivere i connettori HTTPS e JMS Connettore HTTPS Il connettore HTTPS permette di personalizzare i parametri SSL per ogni connessione che utilizza questo protocollo ed è applicabile sia alle connessioni tra le PdD (cooperazione), sia alle connessioni con i Servizi Applicativi interni (integrazione). Il connettore HTTPS supporta: Autenticazione Server, è possibile definire le trusted keys e indicare se si desidera verificare l hostname rispetto al certificato server contenuto nella sessione SSL. Autenticazione Client, è opzionale; se abilitata permette di definire il keystore contenente la chiave privata che si deve utilizzare durante la sessione SSL.

81 Guida Utente della PddConsole 73 / 100 Figura 101: Dati di configurazione di un connettore HTTPS Facendo riferimento alla maschera raffigurata in Figura 101 andiamo a descrivere il significato dei parametri: Connettore Url: indirizzo endpoint del connettore Tipologia (SSL, SSLv3, TLS e TLSv1): Tipo e versione del protocollo di trasporto (default: SSLv3) Hostname Verifier (true/false): Attiva la verifica in fase di autenticazione server della corrispondenza tra l hostname indicato nella url e quello presente nel certificato server ritornato dal server (nel subject CN=hostname) Autenticazione Server Path: Path dove è localizzato il truststore contenente i certificati server trusted. Tipo (jks, pkcs12, jceks, bks, uber e gkr): Tipologia del TrustStore (default: jks) Password: Password per l accesso al TrustStore Algoritmo: Algoritmo di firma utilizzato (default: PKIX) Autenticazione Client (opzionale) Dati di Accesso al KeyStore (usa valori del TrustStore, Ridefinisci): Consente di riutilizzare i medesimi riferimenti del TrustStore anche per il KeyStore o in alternativa ridefinirli. Password Chiave Privata: Password per accedere alla chiave privata presente nel keystore. Algoritmo: Algoritmo di firma utilizzato (default: SunX509) Connettore JMS Il connettore JMS consente di configurare i parametri per abilitare la comunicazione tra la PdD e l esterno attraverso il protocollo JMS. In Figura 102 è mostrata la maschera di configurazione del connettore JMS.

82 Guida Utente della PddConsole 74 / 100 Figura 102: Dati di configurazione di un connettore JMS In riferimento alla Figura 102 descriviamo in dettaglio il significato dei campi per la configurazione: Nome: identificatore JNDI della risorsa queue/topic JMS Tipo (Queue/Topic): Si specifica se la risorsa JMS è di tipo queue o topic Utente: Username relativo alle credenziali per l autenticazione e la negoziazione di una connessione sul Broker JMS Password: Password relativa alle credenziali per l autenticazione e la negoziazione di una connessione sul Broker JMS Initial Context Factory: Class Name per l inizializzazione del server JNDI per la lookup della Connection Factory e della Coda Url Pkg Prefixes: Lista sperata da : per specificare i prefissi dei package da utilizzare per l inizializzazione del Context JNDI Provider Url: Indirizzo che localizza il server JNDI Connection Factory: Identificatore della risorsa JNDI per la creazione di una connessione verso il broker JMS Send As (TextMessage/BytesMessage): Si sceglie la codifica del messaggio da inviare tramite broker JMS, tra TextMessage e BytesMessage. 5.9 Modalità d identificazione Vediamo le modalità offerte dalla Porta di Dominio per l identificazione del Soggetto Erogatore, dell Accordo di Servizio Parte Specifica e dell azione associata ad una Porta Delegata: user-input: modalità statica che prevede un valore definito esplicitamente dall utente register-input: modalità statiche che prevede la selezione esplicita di un valore tra quelli presenti nel registro url-based: modalità dinamica in cui l identificatore viene estratto dalla url invocata in base al pattern specificato content-based: modalità dinamica in cui l identificatore viene estratto dal contenuto del messaggio in base al pattern specificato input-based: modalità dinamica in cui l identificatore viene estratto dalle informazioni presenti nell header di integrazione (Sezione 5.7)

83 Guida Utente della PddConsole 75 / 100 soap-action-based: modalità dinamica, utilizzabile solo per l identificazione dell azione, in cui l identificatore viene estratto dall elemento soapaction, dell header HTTP, previsto dalla specifica SOAP Di seguito viene fornito un esempio di Porta Delegata dove le tre informazioni vengono estratte dalla url di invocazione Figura 103: Impostazione porta delegata con modalità di identificazione dinamica di soggetto, servizio e azione La figura seguente mostra invece un esempio di Porta Delegata dove le tre informazioni vengono estratte dalla url di invocazione

84 Guida Utente della PddConsole 76 / 100 Figura 104: Porta delegata con identificazione dinamica con pattern url-based alternativo Infine un ultimo esempio di Porta Delegata dove le tre informazioni vengono estratte dal contenuto del messaggio che segue: <soapenv:envelope xmlns:soapenv=" xmlns :xsd=" xmlns:xsi=" XMLSchema-instance"> <soapenv:header> <servizio soapenv:actor=" soapenv:mustunderstand="1"> ServizioSincrono</servizio> </soapenv:header> <soapenv:body> <ns1:richiesta xmlns:ns1=" <ns1:soggetto>erogatore</ns1:soggetto> <ns1:azione>azionesincrona</ns1:azione> </ns1:richiesta> </soapenv:body> </soapenv:envelope>

85 Guida Utente della PddConsole 77 / 100 Figura 105: Porta delegata con identificazione dinamica basata sul contenuto del messaggio 5.10 Properties è possibile inserire delle proprietà nell header di trasporto. Le informazioni richieste sono il nome che assumerà l header e una keyword che indirizza ad un valore, presente nella busta che ha richiesto il servizio. Può assumere i seguenti valori: mittente, valore del Mittente della busta ; tipomittente, valore del tipo di Mittente della busta ; destinatario, valore del Destinatario della busta ; tipodestinatario, valore del tipo di Destinatario della busta ; servizio, valore del Servizio richiesto dalla busta ; tiposervizio, valore del tipo di Servizio richiesto dalla busta ; azione, valore dell azione presente nella busta. id, identificativo della busta Validazione XSD Le Porte Delegate e Porte Applicative forniscono la possibilità di configurare la validazione dei messaggi in transito. Se abilitato, viene richiesto quale tipo di validazione eseguire, ovvero se usare una validazione basata semplicemente sull XSD o se effettuare una validazione in base ai WSDL contenuti nell accordo di servizio.

86 Guida Utente della PddConsole 78 / 100 Nome Default Vostro valore Validazione Contenuti disabilitato Tipo validazione Tabella 10: Informazioni di Validazione Figura 106: Configurazione della validazione xsd su porta applicativa Quando si sceglie la validazione rispetto all XSD è sufficiente aver definito il WSDL Definitorio (Sezione 5.14) ed il messaggio verrà validato per il suo contenuto senza tener conto dell Azione. Nel caso della validazione rispetto al WSDL, oltre al Definitorio deve esser fornito anche il WSDL Logico/Implementativo. In questo modo viene validato il messaggio in transito verificando che il messaggio sia idoneo al Port Type (Servizio Generico) e operation (Azione ) in uso. Inoltre la validazione tramite xsd si adatta alla definizione del porttype (wrapped o rpc) e ai suoi stili (literal o encoded). L opzione WarningOnly permette di eseguire la validazione senza che il messaggio venga scartato nel caso in cui questa fallisca WS-Security Qualora si desideri rendere sicura la comunicazione tra le Porte di Dominio, è possibile modificare le Porte Delegate ed Applicative configurandone le proprietà secondo lo standard WS-Security. Per impostare i parametri di WS-Security: scegliere la Porta Delegata o Applicativa dal rispettivo Elenco e selezionare disabilitato in corrispondenza della colonna WS-security, quindi abilitare lo stato Figura 107: Abilitazione WS-Security su porta delegata

87 Guida Utente della PddConsole 79 / 100 A questo punto è possibile impostare i parametri di tipo Request Flow e Response Flow selezionando gli omonimi collegamenti, quindi il pulsante Aggiungi e compilare il form: Nome: Nome dell attributo WS-Security Valore: Valore dell attributo WS-Security Figura 108: WS-Security: impostazione parametro request-flow su porta delegata Nota Per una completa visione dei parametri utilizzabili ci si può riferire alla pagina web Riscrittura delle URL Una funzionalità avanzata consente di effettura la riscrittura automatica delle URL gestite dalla PdD in base a regole definite per lo specifico soggetto. Questa funzionalità si rivela preziosa nei casi in cui la presenza di determinati elementi di networking (proxy, bilanciatori, firewall xml, ecc.) rende necessario l adeguamento delle url di indirizzamento dei servizi in modo differenziato rispetto al Soggetto interno coinvolto nella comunicazione. In questi casi, l uso dell url rewriting semplifica notevolmente il processo di configurazione della PdD. La configurazione delle regole di riscrittura si effettua nelle maschere di modifica dei Soggetti (interfaccia in modalità avanzata) tramite i due seguenti parametri: pd-url-prefix-rewriter: prefisso composto da protocollo, host e porta (es. Tale prefisso verrà sostituito alla parte analoga degli indirizzi in uscita (inoltro buste ) per le invocazioni provenienti dai servizi applicativi appartenenti al soggetto cui è associato il prefisso. pa-url-prefix-rewriter: prefisso composto da protocollo, host e porta (es. Tale prefisso verrà sostituito alla parte analoga degli indirizzi in uscita (consegna contenuti applicativi) per i messaggi in ingresso destinati ai servizi applicativi appartenenti al soggetto cui è associato il prefisso. Vediamo un esempio facendo riferimento alla Figura 109. Supponendo di voler modificare tutte le url in uscita per le fruizioni del soggetto MinisteroFruitore utilizzando il prefisso andremo ad impostare tale valore nel campo UrlPrefix rewriter della sezione Client.

88 Guida Utente della PddConsole 80 / 100 Figura 109: Impostazione di una regola di URL Rewriting Il risultato di tale impostazione sarà che se un servizio applicativo di MinisteroFruitore invoca un servizio avente connettore la PdD modificherà questa url e quindi invocherà in realtà Vediamo adesso un esempio di utilizzo del meccanismo di url rewriting per le erogazioni. Supponiamo di voler modificare l url di destinazione ai nostri servizi applicativi per le richieste provenienti dal soggetto MinisteroErogatore. Impostando il soggetto MinisteroErogatore come riportato in Figura 110, otterremo che quando un servizio applicativo di MinisteroErogatore invoca un nostro servizio per il quale la PdD deve consegnare alla url in realtà la PdD consegnerà la richiesta alla url

89 Guida Utente della PddConsole 81 / 100 Figura 110: Impostazione di una regola di URL Rewriting 5.14 Descrizione di un accordo di servizio (SPCoop) La specifica SPCoop prevede che nell accordo di servizio siano specificati i documenti WSDL del servizio applicativo erogatore e, nel caso di profili di collaborazione asincroni asimmetrici, anche quelli del servizio applicativo correlato erogato dal soggetto fruitore. La Tabella 11 riepiloga i documenti necessari alla descrizione formale di un accordo di servizio Nome Default Vostro valore Specifica delle Interfacce WSDL Definitorio WSDL Concettuale WSDL Logico Erogatore WSDL Logico Fruitore Specifica delle Implementazioni WSDL Implementativo Erogatore WSDL Implementativo Fruitore Tabella 11: Descrizione di un accordo di servizio 5.15 Configurazione dei parametri La Configurazione Generale della Porta di Dominio consente di modificare alcuni aspetti della gestione delle buste in transito. La Tabella 12 mostra i parametri di configurazione presenti con valori di esempio

90 Guida Utente della PddConsole 82 / 100 Nome Valori ammessi Descrizione Inoltro Buste non riscontrate Cadenza (min.) valore numerico Validazione Buste Stato [ abilitato disabilitato warningonly ] Controllo [ rigido normale ] Profilo di Collaborazione [ abilitato disabilitato ] Manifest attachments [ abilitato disabilitato ] Messaggi diagnostici Livello Severità [ off fatal errorprotocol errorintegration infoprotocol infointegration debuglow debugmedium debughigh all ] Livello Severità Log4J [ off fatal errorprotocol errorintegration infoprotocol infointegration debuglow debugmedium debughigh all ] Tracciamento Buste [ abilitato disabilitato ] Dump [ abilitato disabilitato ] Integration Manager Tipo autenticazione [ ssl basic basic,ssl ] Validazione Contenuti Applicativi Stato [ abilitato disabilitato warningonly ] Risposte Connessione [ new reply ] Indirizzo Telematico Utilizzo [ abilitato disabilitato ] Manifest Attachments Gestione [ abilitato disabilitato ] Tabella 12: Parametri di configurazione

91 Guida Utente della PddConsole 83 / 100 Figura 111: Configurazione PdD: parametri generali La sezione di configurazione dei Messaggi Diagnostici definisce il livello didettaglio dei messaggi emessi dalla Porta di Dominio. I messaggi diagnostici sono consultabili nella sezione di Diagnostica, mentre i messaggi OpenSPCoop sono memorizzati nel file openspcoop2.log o come diversamente specificato nella configurazione di Log4J. La parte di Tracciamento consente di indicare se memorizzare o meno le buste in transito o eseguire il dump dell intero messaggio. Gli ultimi due parametri dell interfaccia consentono di configurare il tipo di autenticazione del servizio di Integration Manager e se abilitare o meno la gestione dei Manifest attachments dei messaggi in transito Registro La Porta di Dominio legge le informazioni sui servizi che eroga/fruisce dal registro dei servizi configurato nella sezione Configurazione - Registro. è possibile configurare diverse tipologie di registri, dal semplice registro realizzato tramite un file XML, ad un registro realizzato tramite database, fino ad arrivare ai più complessi registri realizzati come WebRepository, RepositoryUDDI o WebService. Per aggiungere un nuovo registro selezionare la voce Registro nella sezione Configurazione, quindi Elenco Registri dove apparirà la lista dei registri già presente. Selezionare il pulsante Aggiungi e compilare il form: Nome: Nome da assegnare al nuovo registro

92 Guida Utente della PddConsole 84 / 100 Location: Indirizzo cui è raggiungibile il registro (dipende dal tipo) Tipo: Tipo del registro (XML, DB, UDDI, WEB o WS) Se il tipo scelto è UDDI verrà richiesto di inserire anche username e password per l autenticazione. Figura 112: Configurazione PdD: aggiunta nuovo registro è possibile avere più di un Registro dei Servizi dove cercare gli Accordi di Servizio. In questa sezione è possibile vederne la lista e aggiungerne di nuovi Figura 113: Configurazione PdD: gestione registri Esiste infine la possibilità di far utilizzare alla Porta di Dominio una cache per l accesso ai dati letti dal registro dei servizi, per migliorare le performance. è possibile configurare dimensione della cache, algoritmo, vita degli elementi e idle time. Figura 114: Configurazione PdD: gestione cache di registro

93 Guida Utente della PddConsole 85 / Tabella di Routing La Porta di Dominio offre la possibilità di personalizzare le politiche di routing delle buste in transito. Nella sezione Configurazione, selezionando Tabella di Routing è possibile abilitare il routing della Porta di Dominio specificando in dettaglio la politica di consegna delle buste. Abbiamo due tipi di rotte definibili: default e statiche. Nome Default Vostro valore Routing delle buste disabilitato Rotta di default Tipo routing gateway Nome Soggetto SoggettoRouter Registro Rotte statiche Nome destinazione SoggettoDestinazione Tipo routing registro Nome Soggetto Registro RegistroUDDI Tabella 13: Configurazione del routing per le buste Default. Se viene abilitato il routing, la rotta di default deve essere obbligatoriamente configurata. Può essere configurata di tipo gateway e in tal caso viene indicato un soggetto (che deve essere stato registrato nel registro dei servizi) cui inviare tutte le buste in transito. Con il tipo registro viene invece specificato quale Registro dei Servizi utilizzare per risolvere il destinatario del messaggio. Per modificare la lista dei Registri dei Servizi rimandiamo al [?title] Figura 115: Configurazione PdD: abilitazione routing alternativo Statica. Possono essere definite un numero arbitrario di rotte statiche. Le rotte statiche hanno la precedenza sulla rotta di default e quindi sono di fatto delle eccezioni alla regola standard. Per aggiungere una rotta statica, selezionare Destinazioni e quindi il pulsante Aggiungi, a questo punto compilare il form in maniera analoga al caso della rotta di default. Quando definiamo una rotta statica indichiamo in primo luogo il nome del soggetto destinatario del messaggio, del quale vogliamo modificare la politica di routing, ed a seguire il tipo di routing. Come prima, se selezioniamo gateway indichiamo il soggetto al quale ruotare tutti i messaggi per il soggetto specificato in precedenza, mentre nel caso di registro specifichiamo il Registro dei Servizi da utilizzare per risolvere la rotta da utilizzare.

94 Guida Utente della PddConsole 86 / 100 Figura 116: Configurazione PdD: configurazione di una rotta statica 5.18 Configurazione Utente Il pannello Configurazione Utente consente di modificare: La password di accesso per l utente attualmente autenticato. La tipologia dell interfaccia utente tra standard e avanzata L interfaccia di tipo standard contiene numerose semplificazioni, mostra solo le opzioni indispensabili impostando al default quelle non ricorrenti. Nel caso del protocollo SPCoop inoltre l interfaccia standard è concepita in modo da supportare l utente nella produzione di configurazioni conformi alla versione più recente della specifica Figura 117: Configurazione PdD: area utente Per maggiori dettagli sui due tipi di interfaccia si veda Sezione 5 6 Reportistica e risoluzione dei problemi Sotto la sezione Reportistica sono raccolti gli strumenti di monitoraggio dello stato operativo e di configurazione del livello di logging della Porta di Dominio. Sono inoltre presenti le interfacce per la consultazione dei messaggi diagnostici e delle buste tracciate. Il servizio di Auditing consente di tracciare le operazioni effettuate dagli operatori della PddConsole 6.1 Monitoraggio Applicativo L interfaccia di Monitoraggio Applicativo consente la visualizzazione dei messaggi in transito nella Porta di Dominio in attesa di essere consegnati. La ricerca dei messaggi può essere ristretta impostando criteri di filtro nel form iniziale

95 Guida Utente della PddConsole 87 / 100 Figura 118: Monitoraggio applicativo: Form di ricerca Il risultato della ricerca produce un elenco di messaggi che corrispondono ai criteri impostati Figura 119: Monitoraggio applicativo: risultato di una ricerca è possibile selezionare uno o più messaggi in giacenza per effettuare la cancellazione. Selezionando uno dei messaggi viene mostrata una scheda con le informazioni di dettaglio ed eventualmente le motivazioni della mancata consegna.

96 Guida Utente della PddConsole 88 / 100 Figura 120: Monitoraggio applicativo: dettaglio di un elemento 6.2 Diagnostica Selezionando Diagnostica si ottiene un pannello in cui l utente può inserire un certo numero di dati che saranno applicati dal sistema come filtro sul totale dei diagnostici contenuti nel data base. In questo modo il sistema può restituire una risposta mirata all utente. Tutti i valori sono facoltativi, è possibile specificare: Livello severità, in cui i possibili valori sono mostrati in tabella, vengono mostrati solo i messaggi relativi al livello scelto: nome descrizione 0 errori gravi dell applicazione es: database non presenti messaggi diagnostici che evidenziano errori come richiesto 1 dalla specifica messaggi diagnostici che evidenziano errori non richiesti 2 dalla specifica messaggi diagnostici che evidenziano informazioni come 3 richiesto dalla specifica messaggi diagnostici che evidenziano informazioni non 4 richiesti dalla specifica 5 messaggi diagnostici di debug low level 6 messaggi diagnostici di debug medium level 7 messaggi diagnostici di debug high level Tabella 14: Livello severità Identificativo funzione, i cui valori rappresentano i moduli di processamento di un messaggio. Vengono mostrati solo i messaggi relativi alla funzione specificata; Inizio intervallo, vengono mostrati solo i messaggi diagnostici a partire da questa data; Fine intervallo, vengono mostrati solo i messaggi diagnostici fino a questa data; ID Applicativo, consente di filtrare sulla base dei valori identificativi estratti tramite la correlazione applicativa;

97 Guida Utente della PddConsole 89 / 100 Protocollo, si filtra in base al protocollo di cooperazione; Mittente, vengono mostrati solo i messaggi relativi al mittente specificato; Destinatario, vengono mostrati solo i messaggi relativi al destinatario specificato; Servizio, vengono mostrati solo i messaggi relativi al nome del servizio specificato; Azione, vengono mostrati solo i messaggi relativi all azione specificata; Si possono, per esempio, specificare i seguenti valori nella richiesta: Figura 121: Messaggi diagnostici: form di ricerca Una volta selezionato il pulsante Invia si ottiene una tabella dei messaggi diagnostici come mostrato nell esempio in figura:

98 Guida Utente della PddConsole 90 / 100 Figura 122: Messaggi diagnostici: risultato di una ricerca In questa tabella sono rappresentati i dati principali di un messaggio diagnostico: Protocollo, il protocollo di cooperazione adottato; Severità, il livello di severità della segnalazione; ID-Funzione, il modulo di processamento del messaggio; Data, la data di emissione del messaggio diagnostico; Dettaglio, il testo del messaggio. Selezionando il link nella colonna Dettaglio si ottiene il dettaglio del testo contenuto nel messaggio come mostrato nella figura successiva. Figura 123: Messaggi diagnostici: visualizzazione dettaglio 6.3 Tracciamento Selezionando: Reportistica -> Tracciamento si ottiene un pannello in cui inserire alcuni dati utili ad ottenere informazioni riguardo alle tracce che si vogliono consultare. In base ai valori inseriti in questo pannello vengono filtrate le tracce presenti nel database. Il pannello richiede: Inizio intervallo, vengono mostrate tutte le tracce a partire da questa data;

99 Guida Utente della PddConsole 91 / 100 Fine intervallo, vengono mostrate tutte le tracce fino a questa data; ID Applicativo, consente di filtrare sulla base dei valori identificativi estratti tramite la correlazione applicativa; Protocollo, si filtra in base al protocollo di cooperazione; Mittente, vengono mostrati tutte le tracce inviate dal soggetto specificato; Destinatario, vengono mostrati tutte le tracce spedite al soggetto specificato; Servizio, L Accordo di Servizio Parte Specifica per cui si vogliono consultare le tracce; Azione, vengono scelte solo le tracce con l azione specificata; Profilo di collaborazione, il profilo per cui si vogliono consultare le tracce; Figura 124: Messaggi Tracciamento: form di ricerca Una volta selezionato il pulsante Invia si ottiene una tabella delle tracce come mostrato nell esempio in figura:

100 Guida Utente della PddConsole 92 / 100 Figura 125: Messaggi Tracciamento: risultato di una ricerca In questa tabella sono rappresentati i dati principali di una traccia: Data, la data in cui è stata tracciata la comunicazione; Protocollo, il protocollo di cooperazione riferito alla traccia; Mittente, il soggetto mittente della traccia; Destinatario, il soggetto destinatario della traccia; Servizio[@Azione], il nome dell Accordo di Servizio Parte Specifica ed eventualmente dell Azione se presente; ID Messaggio, l identificativo del messaggio cui fa riferimento la traccia; Riferimento Messaggio, l identificativo del messaggio di richiesta cui fa riferimento la traccia del messaggio di risposta; Tipo, può essere Risposta o Richiesta. Selezionando il link nella colonna ID Messaggio si ottiene il dettaglio della traccia come mostrato nella figura successiva.

101 Guida Utente della PddConsole 93 / 100 Figura 126: Messaggi Tracciamento: visualizzazione dettaglio Selezionando il link nella colonna Riferimento messaggio si ottiene il dettaglio del messaggio come mostrato nella figura successiva.

102 Guida Utente della PddConsole 94 / 100 Figura 127: Messaggi Tracciamento: visualizzazione dettaglio di messaggio correlato 6.4 Esporta i dati in formato XML È possibile salvare sia i messaggi diagnostici che le tracce ottenuti come risultato di una ricerca, in un archivio in formato zip. Il formato di esportazione è personalizzabile per ciascun protocollo di cooperazione. Nel caso SPCoop l archizio prodotto contiene i messaggi diagnostici e le tracce salvate nel formato standard CNIPA definito nel documento Sistema pubblico di cooperazione: Porta di Dominio, versione 1.0. Questa funzionalità si ottiene selezionando il pulsante Esporta XML presente durante la visualizzazione dei dati che hanno soddisfato i criteri di ricerca impostati nelle sezioni Diagnostica e Tracciamento. Di seguito viene visualizzato un esempio di Esporta XML per l estrazione dei messaggi diagnostici individuati dalla ricerca.

103 Guida Utente della PddConsole 95 / 100 Figura 128: Esportazione in formato XML dei messaggio diagnostici Di seguito viene visualizzato un esempio di Esporta XML per l estrazione delle tracce individuati dalla ricerca.

104 Guida Utente della PddConsole 96 / 100 Figura 129: Esportazione in formato XML dei messaggi di tracciamento 6.5 Auditing La funzionalità di auditing consente di tracciare il comportamento degli utenti che gestiscono la Porta di Dominio, tramite la PddConsole, al fine di verificare le operazioni eseguite e i loro effetti. Questa funzionalità è suddivisa in due moduli: Auditing Setup - Area della PddConsole dedicata alla configurazione del servizio di auditing, al fine di definire quali informazioni devono essere tracciate, con che formato e con che livello di dettaglio. Auditing Query - Area della PddConsole dedicata alla consultazione delle informazioni raccolte tramite il servizio di auditing Auditing Setup Gli utenti con permesso [C] Configurazione (vedi [?title]) hanno la possibilità di configurare il servizio di auditing, al fine di stabilire cosa tracciare, con che formato e con che livello di dettaglio. L accesso alla funzionalità di configurazione del servizio di auditing avviene tramite la voce Auditing nella sezione Configurazione del menu laterale sinistro.

105 Guida Utente della PddConsole 97 / 100 Se la maschera si presenta come in Figura 130 il servizio di auditing è disabilitato e quindi nessun dato verrà tracciato. Figura 130: Servizio di auditing disabilitato Modificando lo Stato del servizio di auditing in Abilitato appariranno ulteriori campi nel form (vedi Figura 131) per effettuare le impostazioni. Figura 131: Servizio di auditing abilitato La configurazione del servizio di auditing avviene tramite la creazione di una lista di Filtri, ciascuno dei quali stabilisce un criterio per stabilire se una data informazione deve o non deve essere tracciata. Alle informazioni cui non si applica nessuno dei filtri definiti, viene applicato il comportamento di default, i cui parametri sono presenti nella schermata principale del servizio. Facendo riferimento alla Figura 131 vediamo quali sono i parametri per specificare il comportamento di default: Audit (abilitato/disabilitato): Se abilitato, tutte le informazioni, cui non risulta applicabile nessuno dei filtri impostati, verranno tracciate dal servizio di auditing. Dump (abilitato/disabilitato): Questo campo viene preso in considerazione quando Audit = abilitato. Stabilisce, nei casi in cui non si applica nessun filtro, se oltre a tracciare i campi che descrivono l operazione, devono essere tracciate anche le strutture dati coinvolte. Formato Dump (JSON/XML): Stabilisce il formato in cui vengono memorizzate le strutture dati di cui si è scelto di effettuare il dump. Le opzioni possibili sono tra il formato standard JSON ( e la sua rappresentazione in formato XML. Log4J Auditing (abilitato/disabilitato): Questa opzione consente di abilitare/disabilitare l appender log4j relativo ai dati tracciati dal servizio di auditing. Una volta stabilito il comportamento di default si potranno definire i filtri specifici. Per passare alla sezione di gestione dei filtri si seleziona Visualizza nella sezione Filtri. Nell area di gestione filtri viene mostrata la lista dei filtri esistenti con la possibilità di modificare/cancellare gli esistenti o inserirne di nuovi. Si può aggiungere un nuovo filtro premendo il pulsante Aggiungi. In Figura 132 è mostrata la maschera per la creazione di un nuovo filtro di auditing.

106 Guida Utente della PddConsole 98 / 100 Figura 132: Creazione di un filtro per il servizio di auditing Facendo riferimento alla Figura 132 vediamo in dettaglio il significato dei campi di un filtro: Filtro Generico Utente: è possibile specificare in questo campo uno username relativo ad un utente della PddConsole del quale si vogliono tracciare le operazioni effettuate. Lasciare il campo di testo vuoto equivale a Qualsiasi Utente Tipo Operazione (ADD/CHANGE/DEL): Specifica il tipo di operazione che si vuole tracciare distinguendo tra operazioni di creazione, modifica e cancellazione. Lasciare il campo vuoto equivale a Qualsiasi Tipo. Tipo Oggetto: Questo campo è costituito da una lista contenente tutte le entità gestibili tramite l interfaccia PddConsole (ad esempio: Accordo di Servizio, Porta Delegata, ecc). Consente di restringere il tracciamento alle sole operazioni riguardanti una determinata entità. Lasciare il campo vuoto equivale a Qualsiasi Tipo Oggetto. Stato Operazione (requesting/error/completed): Consente di restringere le operazioni da tracciare in base al loro stato: * requesting: indica un operazione in fase di richiesta e non ancora completata * error: Indica un operazione completata che ha restituito un errore * completed: Indica un operazione che è terminata correttamente Lasciare il campo vuoto equivale a Qualsiasi Stato Operazione. Filtro per contenuto Stato (abilitato/disabilitato): Opzione che consente di abilitare il filtro basato sul contenuto degli oggetti coinvolti nell operazione. Se l opzione viene abilitata compariranno i 2 campi descritti ai passi successivi. Tipo (normale/espressioneregolare): Descrive se la stringa riportata nel campo Dump deve essere interpretata come pattern o come espressione regolare. Dump: Campo di testo per inserire il pattern (o espressione regolare) sulla base del quale verranno filtrate le operazioni. Il sistema di auditing traccerà soltanto le operazioni che coinvolgeranno entità il cui contenuto corrisponde alla stringa specificata. Azione: indica quale azione deve essere effettuata al verificarsi delle condizioni del filtro Stato (abilitato/disabilitato): Se abilitato, al verificarsi delle condizioni impostate nel filtro, i dati dell operazione verranno tracciati. Dump (abilitato/disabilitato): Se Stato = abilitato è possibile specificare se si deve effettuare anche il dump delle entità coinvolte nell operazione. Ad esempio, se viene tracciata un operazione di modifica di un Accordo di Servizio, si decide se si vuole effettuare anche il dump dell Accordo di Servizio oggetto della modifica.

107 Guida Utente della PddConsole 99 / Auditing Query Gli utenti della PddConsole aventi il permesso [A] Auditing (vedi [?title]) hanno accesso alla funzionalità di consultazione dei dati presenti nel repository del servizio di auditing. Per accedere al servizio di consultazione selezionare la voce Auditing nella sezione Reportistica del menu laterale sinistro. La consultazione dei dati di auditing avviene tramite ricerche effettuate impostando i criteri attraverso il form riportato in Figura 133. Figura 133: Maschera di ricerca dei dati di auditing Vediamo adesso il significato dei parametri per la ricerca dei dati di auditing: Criteri di Ricerca Inizio Intervallo: Data iniziale che serve ad impostare l intervallo temporale su cui restringere la ricerca dei dati di auditing. Lasciare il campo vuoto equivale all impostazione illimitato. Fine Intervallo: Data finale che serve ad impostare l intervallo temporale su cui restringere la ricerca dei dati di auditing. Lasciare il campo vuoto equivale all impostazione illimitato. Utente: Consente di restringere la ricerca alle sole operazioni effettuate da un determinato utente. Il campo lasciato vuoto equivale a qualasiasi utente. Operazione Tipo: Filtro per tipo di operazione, distinguendo tra: * ADD: creazione di un entità * CHANGE: modifica di un entità * DEL: cancellazione di un entità * LOGIN: accesso alla PddConsole * LOGOUT: disconnessione dalla PddConsole Stato: Filtro in base allo stato dell operazione, distinguendo tra: * requesting: in fase di richiesta * error: terminata con errore * completed: terminata correttamente Oggetto Tipo: campo per restringere la ricerca alle sole operazioni riferite ad un determinato tipo di entità. Il campo è costituito da una lista a discesa popolata con tutte le tipologie di entità gestite dalla PddConsole.

108 Guida Utente della PddConsole 100 / 100 Identificativo: campo testuale per restringere la ricerca alle sole operazioni effettuate su una specifica entità. La composizione dell identificativo cambia in base alla tipologia dell entità. Ad esempio un soggetto è identificato attraverso il tipo e il nome: Tipo/NomeSoggetto. Id precedente alla modifica: campo testuale analogo al precedente ma utile in quei casi in cui l operazione che si sta cercando ha modificato i dati che compongono l identificativo. Contenuto: pattern per la ricerca sul contenuto dell entità associata all operazione. Per utilizzare questo criterio di filtro il servizio di auditing deve essere configurato in modo da effettuare il dump degli oggetti. Una volta effettuata la ricerca viene mostrata una pagina con la lista dei risultati corrispondenti (vedi Figura 134). Figura 134: Risultato della ricerca dei dati di auditing Ciascun elemento della lista riporta i dati principali che identificano l operazione. Selezionando l identificatore dell operazione si visualizzano i dati di dettaglio (vedi Figura 135). Dal dettaglio dell operazione, se è attivo il dump, si può visualizzare il dettaglio dell entità coinvolta nell operazione e gli eventuali documenti binari (ad esempio i file WSDL associati ad un accordo di servizio). Figura 135: Dettaglio di una traccia di auditing