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