Guida Utente della PddConsole i Guida Utente della PddConsole
Guida Utente della PddConsole ii Copyright 2005-2014 Link.it srl
Guida Utente della PddConsole iii Indice 1 Introduzione 1 2 Prerequisiti per l utilizzo della PddConsole 1 2.1 Verifica dell applicazione di gestione PddConsole.................................. 1 2.2 Gestione utenti e permessi.............................................. 1 2.3 Indice Porte di Dominio................................................ 3 2.4 Raccolta parametri di Configurazione........................................ 4 3 Fruizione di un servizio 5 3.1 Oneway........................................................ 5 3.1.1 Raccolta informazioni............................................ 5 3.1.2 Configurazione................................................ 5 3.2 Sincrono........................................................ 11 3.2.1 Raccolta informazioni............................................ 11 3.2.2 Configurazione................................................ 11 3.3 Asincrono Simmetrico................................................ 17 3.3.1 Raccolta informazioni............................................ 17 3.3.2 Configurazione................................................ 17 3.4 Asincrono Asimmetrico................................................ 27 3.4.1 Raccolta informazioni............................................ 27 3.4.2 Configurazione................................................ 27 4 Erogazione di un servizio 34 4.1 Oneway........................................................ 34 4.1.1 Raccolta informazioni............................................ 34 4.1.2 Configurazione................................................ 34 4.2 Sincrono........................................................ 39 4.2.1 Raccolta informazioni............................................ 39 4.2.2 Configurazione................................................ 40 4.3 Asincrono Simmetrico................................................ 45 4.3.1 Raccolta informazioni............................................ 45 4.3.2 Configurazione................................................ 47 4.3.3 Fruizione servizio correlato per generazione risposta............................ 52 4.4 Asincrono Asimmetrico................................................ 55 4.4.1 Raccolta informazioni............................................ 55 4.4.2 Configurazione................................................ 55
Guida Utente della PddConsole iv 5 Funzionalità avanzate 63 5.1 Importazione ed Esportazione delle entità del Registro Servizi........................... 63 5.2 Autenticazione ed Autorizzazione dei Servizi Applicativi.............................. 64 5.3 Autorizzazione Richieste in Entrata......................................... 66 5.4 Ricezione Richieste di Erogazione (Porta Applicativa)................................ 67 5.5 Correlazione Applicativa............................................... 67 5.6 Consegna contenuti applicativi............................................ 68 5.7 Integrazione...................................................... 70 5.8 Connettori....................................................... 72 5.8.1 Connettore HTTPS.............................................. 72 5.8.2 Connettore JMS............................................... 73 5.9 Modalità d identificazione.............................................. 74 5.10 Properties....................................................... 77 5.11 Validazione XSD................................................... 77 5.12 WS-Security...................................................... 78 5.13 Riscrittura delle URL................................................. 79 5.14 Descrizione di un accordo di servizio (SPCoop)................................... 81 5.15 Configurazione dei parametri............................................ 81 5.16 Registro........................................................ 83 5.17 Tabella di Routing................................................... 85 5.18 Configurazione Utente................................................ 86 6 Reportistica e risoluzione dei problemi 86 6.1 Monitoraggio Applicativo............................................... 86 6.2 Diagnostica...................................................... 88 6.3 Tracciamento..................................................... 90 6.4 Esporta i dati in formato XML............................................ 94 6.5 Auditing........................................................ 96 6.5.1 Auditing Setup................................................ 96 6.5.2 Auditing Query................................................ 99
Guida Utente della PddConsole v Elenco delle figure 1 Menu per la gestione degli utenti........................................... 2 2 Creazione nuovo utente................................................ 2 3 Lista degli utenti della PddConsole.......................................... 3 4 Elenco Porte di Dominio............................................... 3 5 Aggiunta di una Porta di Dominio esterna...................................... 4 6 Scenario di cooperazione di esempio tra due domini................................. 4 7 Creazione del soggetto SPC/Erogatore........................................ 6 8 Impostazione del connettore per il soggetto SPC/Erogatore............................. 7 9 Creazione del servizio applicativo SAFruitore_OneWay per il soggetto che ci rappresenta............. 7 10 Creazione dell accordo di servizio AS con referente SPC/Erogatore........................ 8 11 Creazione del servizio generico Oneway relativo all accordo di servizio AS.................... 9 12 Aggiunta di un azione al servizio generico...................................... 9 13 Creazione dell Accordo di Servizio Parte Specifica ServizioOneWay erogato da SPC/Erogatore.......... 10 14 Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioOneWay erogato da SPC/Erogatore.... 11 15 Elenco fruitori del servizio SPC/ServizioOneWay.................................. 11 16 Autorizzazione del servizio applicativo SAFruitore_OneWay alla fruizione del servizio SPC/ServizioOneWay.. 11 17 Creazione del soggetto SPC/Erogatore........................................ 12 18 Impostazione del connettore per il soggetto SPC/Erogatore............................. 13 19 Creazione del servizio applicativo SAFruitore_Sincrono per il soggetto che ci rappresenta............. 13 20 Creazione accordo di servizio AS con referente SPC/Erogatore........................... 14 21 Creazione del servizio generico con profilo sincrono relativo all accordo AS.................... 15 22 Aggiunta dell azione sincrona al servizio generico dell accordo AS......................... 15 23 Creazione dell Accordo di Servizio Parte Specifica ServizioSincrono erogato da SPC/Erogatore......... 16 24 Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioSincrono.................. 17 25 Autorizzazione del servizio applicativo SAFruitore_Sincrono alla fruizione di SPC/ServizioSincrono....... 17 26 Creazione del soggetto SPC/Erogatore........................................ 18 27 Impostazione del connettore per il soggetto SPC/Erogatore............................. 19 28 Creazione del servizio applicativo SAFruitore_AsincronoSimmetrico associato al soggetto che ci rappresenta.. 19 29 Elenco Servizi Applicativi.............................................. 20 30 Impostazione del connettore per la ricezione della risposta asincrona da parte del servizio applicativo fruitore.. 20 31 Creazione dell accordo di servizio parte comune AS con referente SPC/Erogatore................. 21 32 Creazione del servizio generico con profilo Asincrono Simmetrico associato all accordo AS........... 22 33 Aggiunta dell azione Asincrona Simmetrica al servizio generico dell accordo AS................. 22 34 Creazione del servizio generico correlato relativo all accordo di servizio AS.................... 23 35 Aggiunta dell azione AsincronaSimmetricaCorrelata associata al servizio generico correlato........... 23 36 Creazione del servizio ServizioAsincronoSimmetrico relativo all accordo AS ed erogato da SPC/Erogatore... 24
Guida Utente della PddConsole vi 37 Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioAsincronoSimmetrico erogato da SPC/Erogatore.......................................................... 25 38 Autorizzazione del servizio applicativo SAFruitore_AsincronoSimmetrico alla fruizione del servizio SPC/ServizioAsincronoSimmetrico.................................................. 25 39 Creazione del servizio correlato SPC/ServizioAsincronoSimmetricoCorrelato erogato dal soggetto che ci rappresenta......................................................... 26 40 Sottoscrizione del soggetto erogatore al servizio SPC/ServizioAsincronoSimmetricoCorrelato erogato da SPC/Fruitore 26 41 Creazione del soggetto SPC/Erogatore........................................ 28 42 Impostazione del connettore relativo al soggetto SPC/Erogatore........................... 28 43 Creazione del servizio applicativo SAFruitore_AsincronoAsimmetrico associato al soggetto che ci rappresenta. 29 44 Creazione dell accordo di servizio parte comune AS con referente SPC/Erogatore................. 30 45 Creazione del servizio generico relativo all accordo di servizio AS con profilo Asincrono Asimmetrico...... 31 46 Aggiunta dell azione Asincrona Asimmetrica relativa al servizio generico dell accordo AS............ 31 47 Aggiunta dell azione correlata a AzioneAsincronaAsimmetrica........................... 32 48 Creazione servizio SPC/ServizioAsincronoAsimmetrico relativo all accordo AS ed erogato da SPC/Erogatore.. 33 49 Sottoscrizione del soggetto che ci rappresenta al servizio SPC/ServizioAsincronoAsimmetrico.......... 33 50 Autorizzazione del servizio applicativo SAFruitore_AsincronoAsimmetrico alla fruizione di SPC/ServizioAsincronoAsimmetrico.................................................. 34 51 Creazione accordo AS con referente il soggetto che ci rappresenta......................... 35 52 Creazione servizio generico relativo all accordo AS e con profilo Oneway..................... 36 53 Aggiunta dell azione oneway al servizio generico dell accordo AS......................... 36 54 Creazione del servizio applicativo erogatore SAErogatore_OneWay associato al soggetto che ci rappresenta... 37 55 Impostazione dei parametri per l invocazione del servizio applicativo erogatore.................. 37 56 Creazione della parte specifica dell accordo di servizio ServizioOneWay che si vuole erogare........... 38 57 Creazione del soggetto SPC/Fruitore......................................... 39 58 Sottoscrizione di SPC/Fruitore al servizio ServizioOneway erogato dal soggetto che ci rappresenta........ 39 59 Creazione dell accordo AS con referente il soggetto che ci rappresenta....................... 41 60 Creazione del servizio generico associato all accordo AS con profilo Sincrono................... 42 61 Aggiunta dell azione sincrona associata al servizio generico relativo all accordo AS................ 42 62 Creazione del servizio applicativo erogatore associato al soggetto che ci rappresenta................ 43 63 Impostazione dei parametri per l invocazione del servizio applicativo erogatore.................. 43 64 Creazione del servizio ServizioSincrono erogato dal soggetto che ci rappresenta.................. 44 65 Creazione del soggetto SPC/Fruitore......................................... 45 66 Sottoscrizione di SPC/Fruitore al servizio ServizioSincrono erogato dal soggetto che ci rappresenta........ 45 67 Creazione accordo di servizio AS con referente il soggetto che ci rappresenta................... 47 68 Creazione servizio generico relativo all accordo AS con profilo asincrono simmetrico............... 48 69 Aggiunta dell azione asincrona simmetrica al servizio generico relativo all accordo AS.............. 48 70 Creazione del servizio applicativo SAErogatore_AsincronoSimmetrico associato al soggetto che ci rappresenta. 49 71 Impostazione dei parametri per l invocazione del servizio applicativo erogatore.................. 49 72 Creazione del servizio ServizioAsincronoSimmetrico relativo all accordo AS ed erogato dal soggetto che ci rappresenta...................................................... 50
Guida Utente della PddConsole vii 73 Creazione del soggetto SPC/Fruitore......................................... 51 74 Impostazione del connettore relativo al soggetto SPC/Fruitore........................... 51 75 Sottoscrizione di SPC/Fruitore al servizio ServizioAsincronoSimmetrico erogato dal soggetto che ci rappresenta. 52 76 Creazione servizio generico correlato relativo all accordo AS con profilo asincrono simmetrico.......... 52 77 Aggiunta dell azione AsincronaSimmetricaCorrelata associata al servizio generico correlato........... 53 78 Creazione del servizio correlato SPC/ServizioAsincronoSimmetricoCorrelato erogato dal soggetto che ci rappresenta......................................................... 54 79 Sottoscrizione del soggetto che ci rappresenta (erogatore) al servizio SPC/ServizioAsincronoSimmetricoCorrelato erogato da SPC/Fruitore............................................. 54 80 Impostazione delle credenziali per il servizio applicativo erogatore per l invio della risposta asincrona...... 55 81 Autorizzazione del servizio applicativo SAFruitore_AsincronoSimmetrico alla fruizione del servizio SPC/ServizioAsincronoSimmetrico.................................................. 55 82 Creazione dell accordo di servizio parte comune AS con referente SPC/Erogatore................. 57 83 Creazione del servizio generico relativo all accordo di servizio AS con profilo Asincrono Asimmetrico...... 58 84 Aggiunta dell azione Asincrona Asimmetrica relativa al servizio generico dell accordo AS............ 58 85 Aggiunta dell azione correlata a AzioneAsincronaAsimmetrica........................... 59 86 Creazione del servizio applicativo SAErogatore_AsincronoAsimmetrico associato al soggetto che ci rappresenta. 59 87 Impostazione dei parametri di invocazione del servizio applicativo erogatore.................... 60 88 Impostazione dei parametri di invocazione del servizio applicativo erogatore.................... 61 89 Creazione servizio SPC/ServizioAsincronoAsimmetrico relativo all accordo AS ed erogato da SPC/Erogatore.. 62 90 Creazione del soggetto SPC/Fruitore......................................... 63 91 Sottoscrizione di SPC/Fruitore al servizio erogato dal soggetto che ci rappresenta................. 63 92 Maschera di importazione di package........................................ 64 93 Impostazione di credenziali ssl per un servizio applicativo generico......................... 65 94 Impostazione di una porta delegata con autenticazione ssl.............................. 65 95 Autorizzazione di un servizio applicativo sulla porta delegata............................ 66 96 Autorizzazione di un soggetto alla fruizione di un dato servizio........................... 66 97 Creazione di una porta applicativa.......................................... 67 98 Inserimento di una regola di correlazione applicativa associata ad una porta delegata................ 68 99 Impostazione dei parametri di integrazione per un servizio applicativo....................... 69 100 Modifica della modalità di passaggio dell header di integrazione per una porta delegata.............. 71 101 Dati di configurazione di un connettore HTTPS................................... 73 102 Dati di configurazione di un connettore JMS..................................... 74 103 Impostazione porta delegata con modalità di identificazione dinamica di soggetto, servizio e azione........ 75 104 Porta delegata con identificazione dinamica con pattern url-based alternativo.................... 76 105 Porta delegata con identificazione dinamica basata sul contenuto del messaggio.................. 77 106 Configurazione della validazione xsd su porta applicativa.............................. 78 107 Abilitazione WS-Security su porta delegata..................................... 78 108 WS-Security: impostazione parametro request-flow su porta delegata........................ 79 109 Impostazione di una regola di URL Rewriting.................................... 80
Guida Utente della PddConsole viii 110 Impostazione di una regola di URL Rewriting.................................... 81 111 Configurazione PdD: parametri generali....................................... 83 112 Configurazione PdD: aggiunta nuovo registro.................................... 84 113 Configurazione PdD: gestione registri........................................ 84 114 Configurazione PdD: gestione cache di registro................................... 84 115 Configurazione PdD: abilitazione routing alternativo................................ 85 116 Configurazione PdD: configurazione di una rotta statica............................... 86 117 Configurazione PdD: area utente........................................... 86 118 Monitoraggio applicativo: Form di ricerca...................................... 87 119 Monitoraggio applicativo: risultato di una ricerca.................................. 87 120 Monitoraggio applicativo: dettaglio di un elemento................................. 88 121 Messaggi diagnostici: form di ricerca........................................ 89 122 Messaggi diagnostici: risultato di una ricerca.................................... 90 123 Messaggi diagnostici: visualizzazione dettaglio................................... 90 124 Messaggi Tracciamento: form di ricerca....................................... 91 125 Messaggi Tracciamento: risultato di una ricerca................................... 92 126 Messaggi Tracciamento: visualizzazione dettaglio.................................. 93 127 Messaggi Tracciamento: visualizzazione dettaglio di messaggio correlato..................... 94 128 Esportazione in formato XML dei messaggio diagnostici.............................. 95 129 Esportazione in formato XML dei messaggi di tracciamento............................ 96 130 Servizio di auditing disabilitato............................................ 97 131 Servizio di auditing abilitato............................................. 97 132 Creazione di un filtro per il servizio di auditing................................... 98 133 Maschera di ricerca dei dati di auditing........................................ 99 134 Risultato della ricerca dei dati di auditing...................................... 100 135 Dettaglio di una traccia di auditing.......................................... 100 Elenco delle tabelle 1 Dati richiesti per la creazione fruitore Oneway.................................... 6 2 Dati richiesti per la creazione di un fruitore sincrono................................ 12 3 Dati richiesti per la creazione di un fruitore asincrono simmetrico.......................... 18 4 Dati richiesti per la creazione di un fruitore asincrono asimmetrico......................... 27 5 Dati richiesti per la creazione di una erogazione di un servizio con profilo Oneway................ 34 6 Dati richiesti per la creazione di un erogatore Sincrono............................... 40 7 Dati richiesti per la creazione di un erogatore asincrono simmetrico........................ 46 8 Dati richiesti per la creazione di un erogatore asincrono asimmetrico........................ 56 9 Informazioni di Autenticazione e Autorizzazione.................................. 64 10 Informazioni di Validazione............................................. 78 11 Descrizione di un accordo di servizio......................................... 81 12 Parametri di configurazione.............................................. 82 13 Configurazione del routing per le buste....................................... 85 14 Livello severità.................................................... 88
Guida Utente della PddConsole 1 / 100 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 è http://ipportadominio/pddconsole; 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.
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)
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
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:
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 3.1.1 Raccolta informazioni Raccogliere i dati necessari per questa configurazione, facendo riferimento alla tabella Tabella 1. 3.1.2 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
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 http://pdderogatore/openspcoop/pa 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) 123456 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