diff --git a/ChangeLog b/ChangeLog index f4f50d6836..9970927c02 100755 --- a/ChangeLog +++ b/ChangeLog @@ -1,4 +1,4 @@ -2018-11-06 Andrea Poli +2018-11-07 Andrea Poli * Rilasciata versione 3.0.1.rc2 diff --git a/ant/setup/antinstall-config.xml b/ant/setup/antinstall-config.xml index 08f8d747d4..8f1171260a 100644 --- a/ant/setup/antinstall-config.xml +++ b/ant/setup/antinstall-config.xml @@ -42,13 +42,13 @@ ifProperty="${antinstaller_modalita_installazione}==nuova"> - - diff --git a/resources/doc/pdf/GovWay-ManualeInstallazione.pdf b/resources/doc/pdf/GovWay-ManualeInstallazione.pdf index 65f0b746be..858474044c 100644 Binary files a/resources/doc/pdf/GovWay-ManualeInstallazione.pdf and b/resources/doc/pdf/GovWay-ManualeInstallazione.pdf differ diff --git a/resources/doc/pdf/GovWay-ManualeMonitoraggio.pdf b/resources/doc/pdf/GovWay-ManualeMonitoraggio.pdf index a5333f8cd2..3b17adb83c 100644 Binary files a/resources/doc/pdf/GovWay-ManualeMonitoraggio.pdf and b/resources/doc/pdf/GovWay-ManualeMonitoraggio.pdf differ diff --git a/resources/doc/pdf/GovWay-ManualeUtente.pdf b/resources/doc/pdf/GovWay-ManualeUtente.pdf index 49b2b5c4c7..446e2a1a5a 100644 Binary files a/resources/doc/pdf/GovWay-ManualeUtente.pdf and b/resources/doc/pdf/GovWay-ManualeUtente.pdf differ diff --git a/resources/doc/pdf/GovWay-ReleaseNotes.pdf b/resources/doc/pdf/GovWay-ReleaseNotes.pdf index ae8bc1503e..cf2a71fb9e 100644 Binary files a/resources/doc/pdf/GovWay-ReleaseNotes.pdf and b/resources/doc/pdf/GovWay-ReleaseNotes.pdf differ diff --git a/resources/doc/src/core/docbook-custom/chunk-common.xsl b/resources/doc/src/core/docbook-custom/chunk-common.xsl new file mode 100644 index 0000000000..dee2d63e64 --- /dev/null +++ b/resources/doc/src/core/docbook-custom/chunk-common.xsl @@ -0,0 +1,1892 @@ + + + + + + + + + + + + + + + + + + + Computing chunks... + + + + + Fast chunking requires exsl:node-set(). + Using "slow" chunking. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error + + is not a chunk! + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -toc + + + + + + + + + + + +

+ +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + -toc + + + + + + + + + + + -toc + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ + + + +
+ + + + +
+
+

The following annotations are from this essay. You are seeing + them here because your browser doesn’t support the user-interface + techniques used to make them appear as ‘popups’ on modern browsers.

+
+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 1 + 0 + + + + + + + + + + + + + + + + # + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Olink error: cannot compute relative + sitemap path because $current.docid ' + + ' not found in target database. + + + + + + + Olink warning: cannot compute relative + sitemap path without $current.docid parameter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ../ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + +
+ +
+
+ + + + + + + + + + + + +   + + + + + + + + + + + + + + +  |  + + +   + + + + + + + + + -toc + + + + + + + + +   + + + + + + + + + + + + +
+ + +
+ +
+ + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + + + + + +
+ + + + + + + + + + + + +   + + + + + + + + + + + + + + +  |  + + +   + + + + + + + + + -toc + + + + + + + + +   + + + + + + + + + + + + +
+ +
+ + + + + + + + + + + + + + + + + + + + + + + xxx + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + / + + + + + diff --git a/resources/doc/src/core/makefile/commons b/resources/doc/src/core/makefile/commons new file mode 100644 index 0000000000..bd3bd030ae --- /dev/null +++ b/resources/doc/src/core/makefile/commons @@ -0,0 +1,55 @@ +html: convert-accents + @echo "Producing html files ..." + xmlto html-nochunks -x ../core/xsl/main-html-nochunks.xsl ${SOURCE_FILE}.converted --skip-validation + @echo "Producing html files ok" + +xhtml: + xmlto xhtml -x ../core/xsl/main-xhtml-chunks.xsl ${SOURCE_FILE}.converted -o xhtmlout --skip-validation + +pdf: convert-accents + @echo "Producing pdf ..." + dblatex ${DB_LATEX_OPTIONS} --pdf ${SOURCE_FILE}.converted -o ${SOURCE_NAME}${PDF_DOC_VERSION}_originalCover.pdf + gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -sOutputFile=${SOURCE_NAME}${PDF_DOC_VERSION}_originalCover_noPagineIniziali.pdf -dFirstPage=2 ${SOURCE_NAME}${PDF_DOC_VERSION}_originalCover.pdf + gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -sOutputFile=GovWay-${SOURCE_NAME}.pdf cover/cover.pdf ${SOURCE_NAME}${PDF_DOC_VERSION}_originalCover_noPagineIniziali.pdf + @echo "Producing pdf ok" + +img: + @echo "Producing img ..." + @mkdir -p FIGURE_OUT + @for file in figure/*.jpg; do \ + ( convert $$file FIGURE_OUT/`basename $$file jpg`pdf; convert $$file FIGURE_OUT/`basename $$file`) \ + done + @for file in figure/*.png; do \ + ( convert $$file FIGURE_OUT/`basename $$file png`pdf; convert $$file FIGURE_OUT/`basename $$file`) \ + done + @echo "Producing img ok" + +clean: clean-html clean-pdf clean-xhtml + rm -f ${SOURCE_FILE}~ + rm -f ${SOURCE_FILE}.converted + rm -rf FIGURE_OUT + +clean-html: + rm -f *.html + +clean-xhtml: + rm -rf xhtmlout + +clean-pdf: + rm -f *${SOURCE_NAME}*.pdf + +convert-accents: + cp ${SOURCE_FILE} ${SOURCE_FILE}.converted + perl -pi -e "s/à/à/g" ${SOURCE_FILE}.converted + perl -pi -e "s/è/è/g" ${SOURCE_FILE}.converted + perl -pi -e "s/È/È/g" ${SOURCE_FILE}.converted + perl -pi -e "s/È/È/g" ${SOURCE_FILE}.converted + perl -pi -e "s/ì/ì/g" ${SOURCE_FILE}.converted + perl -pi -e "s/Ì/Ì/g" ${SOURCE_FILE}.converted + perl -pi -e "s/ù/ù/g" ${SOURCE_FILE}.converted + perl -pi -e "s/Ù/Ù/g" ${SOURCE_FILE}.converted + perl -pi -e "s/Ò/Ò/g" ${SOURCE_FILE}.converted + perl -pi -e "s/é/é/g" ${SOURCE_FILE}.converted + perl -pi -e "s/É/É/g" ${SOURCE_FILE}.converted + + diff --git a/resources/doc/src/core/makefile/env b/resources/doc/src/core/makefile/env new file mode 100644 index 0000000000..96d8ed515c --- /dev/null +++ b/resources/doc/src/core/makefile/env @@ -0,0 +1,5 @@ +LANG=it_IT + +DB_LATEX_OPTIONS=-P latex.output.revhistory=0 -P doc.collab.show=0 +DOC_VERSION=3.0 +PDF_DOC_VERSION=3.0 diff --git a/resources/doc/src/core/xsl/html-common-relnotes.xsl b/resources/doc/src/core/xsl/html-common-relnotes.xsl new file mode 100644 index 0000000000..49564d93ec --- /dev/null +++ b/resources/doc/src/core/xsl/html-common-relnotes.xsl @@ -0,0 +1,40 @@ + + + + + + + + + +./stylesheet-images/ +./stylesheet-images/ + + + + +figure after +example after +equation after +table after +procedure after + + + + + + + +text/css + + + + + + diff --git a/resources/doc/src/core/xsl/html-common.xsl b/resources/doc/src/core/xsl/html-common.xsl new file mode 100644 index 0000000000..826b59c9e0 --- /dev/null +++ b/resources/doc/src/core/xsl/html-common.xsl @@ -0,0 +1,35 @@ + + + + + + + + + +./stylesheet-images/ +./stylesheet-images/ + + + + +figure after +example after +equation after +table after +procedure after + + + + + +text/css + + + + + + diff --git a/resources/doc/src/core/xsl/main-html-chunks.xsl b/resources/doc/src/core/xsl/main-html-chunks.xsl new file mode 100644 index 0000000000..1b86bcc899 --- /dev/null +++ b/resources/doc/src/core/xsl/main-html-chunks.xsl @@ -0,0 +1,51 @@ + + + + + + + + + + + + + +3 + + + + +book toc,title,figure,table,example,equation +article toc +chapter nop +qandadiv toc +qandaset toc +sect1 nop +sect2 nop +sect3 nop +sect4 nop +sect5 nop +section nop + + + + + + + + +UTF-8 + + +yes + + diff --git a/resources/doc/src/core/xsl/main-html-nochunks-relnotes.xsl b/resources/doc/src/core/xsl/main-html-nochunks-relnotes.xsl new file mode 100644 index 0000000000..5e9854181a --- /dev/null +++ b/resources/doc/src/core/xsl/main-html-nochunks-relnotes.xsl @@ -0,0 +1,47 @@ + + + + + + + + + + + +3 + + + +book toc,title,figure,table,example,equation +article toc +chapter nop +qandadiv toc +qandaset toc +sect1 nop +sect2 nop +sect3 nop +sect4 nop +sect5 nop +section nop + + + + + + + + + + + diff --git a/resources/doc/src/core/xsl/main-html-nochunks.xsl b/resources/doc/src/core/xsl/main-html-nochunks.xsl new file mode 100644 index 0000000000..be796cca19 --- /dev/null +++ b/resources/doc/src/core/xsl/main-html-nochunks.xsl @@ -0,0 +1,51 @@ + + + + + + + + + + + +3 + + + +book toc,title,figure,table,example,equation +article toc +chapter nop +qandadiv toc +qandaset toc +sect1 nop +sect2 nop +sect3 nop +sect4 nop +sect5 nop +section nop + + + + + + + + + + + + + + + diff --git a/resources/doc/src/core/xsl/main-html.xsl b/resources/doc/src/core/xsl/main-html.xsl new file mode 100644 index 0000000000..e11b06389b --- /dev/null +++ b/resources/doc/src/core/xsl/main-html.xsl @@ -0,0 +1,148 @@ + + + + + + + + + + + + + + + + +3 + + + + + + +book toc +article toc +chapter nop +qandadiv toc +qandaset toc +sect1 nop +sect2 nop +sect3 nop +sect4 nop +sect5 nop +section nop + + + + + + 3 + 2 + + + + +
+ + + + + + + +
+ + + + + +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + + revhistory + + + + + + + + Revision History + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + diff --git a/resources/doc/src/core/xsl/main-pdf.xsl b/resources/doc/src/core/xsl/main-pdf.xsl new file mode 100644 index 0000000000..a749ce33b7 --- /dev/null +++ b/resources/doc/src/core/xsl/main-pdf.xsl @@ -0,0 +1,788 @@ + + + + + + + + +article toc +3 + + + +.. + + + + + + + + + + + + + + + + + + + + + + + + + + 0in + 0in + 0in + 0in + no-repeat + + + + + + + + + + + + + + + + + + + + + + + + Got element= pageclass= default= + + + + + + + + + + + + + + + + + + + + + + + + + + normal + + + section.head.marker + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + + + + + + 1 + 1 + 3 + + + + + + 3 + 3 + 1 + + + + + + + + + + + + + + proportional-column-width( + + header + + + ) + + + + + proportional-column-width( + + header + + + ) + + + + + proportional-column-width( + + header + + + ) + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0em + + + 0em + + + 0.2em + + + + + + + 0.3em + + + 0.1em + + + 0.5em + + + 0.3em + + + 0.1em + + + 0.5em + + + + + + + 0.5em + + + 0.3em + + + 0.7em + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #F0F0F0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + + + 0pc + + + + + + + + + + + + + + + + + + + + + + + + + + wrap + ↲ + + 3pt + 3pt + 3pt + 3pt + + + + + + + + + + + + + + + + + + character-by-character + disregard-shifts + + + + + + + + + + + + + + + + + + + + + + pt + + bold + + 6pt + 3pt + + + + + + pt + + bold + + + + + + + pt + + + normal + italic + + + + + + + + pt + + + 0.3em + + + 0.5em + + + 0.7em + + + 0.3em + + + 0.5em + + + 0.7em + + + + + + + + + + +qanda + + + + + + + + + + + + + + + + + + + + + + + + + + + + +6in + + +6in + +0.25pt +none +black +0.5pt +solid +black + + + 1pt + 1pt + 1pt + 1pt + + + + retain + collapse + + + + + + + + + + + + + + + + 0pt + 14.4pt + serif + bold + always + + + + 0pt + + + + + 0pt + serif + + + + + + + + + + + + + + diff --git a/resources/doc/src/core/xsl/main-xhtml-chunks.xsl b/resources/doc/src/core/xsl/main-xhtml-chunks.xsl new file mode 100644 index 0000000000..9ce12031bf --- /dev/null +++ b/resources/doc/src/core/xsl/main-xhtml-chunks.xsl @@ -0,0 +1,51 @@ + + + + + + + + + + + + + +3 + + + + +book toc,title,figure,table,example,equation +article toc +chapter nop +qandadiv toc +qandaset toc +sect1 nop +sect2 nop +sect3 nop +sect4 nop +sect5 nop +section nop + + + + + + + + +UTF-8 + + +yes + + diff --git a/resources/doc/src/core/xsl/redhat.xsl b/resources/doc/src/core/xsl/redhat.xsl new file mode 100644 index 0000000000..4709dd6dd9 --- /dev/null +++ b/resources/doc/src/core/xsl/redhat.xsl @@ -0,0 +1,55 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/resources/doc/src/manualeInstallazione/Makefile b/resources/doc/src/manualeInstallazione/Makefile new file mode 100644 index 0000000000..d097a99657 --- /dev/null +++ b/resources/doc/src/manualeInstallazione/Makefile @@ -0,0 +1,7 @@ +include ../core/makefile/env +include ../core/makefile/commons + +SOURCE_NAME=ManualeInstallazione +SOURCE_FILE=${SOURCE_NAME}.xml + + diff --git a/resources/doc/src/manualeInstallazione/ManualeInstallazione.xml b/resources/doc/src/manualeInstallazione/ManualeInstallazione.xml new file mode 100644 index 0000000000..979580eb67 --- /dev/null +++ b/resources/doc/src/manualeInstallazione/ManualeInstallazione.xml @@ -0,0 +1,1044 @@ + + + +
+ + GovWay - Guida all'Installazione + GovWay - Guida all'installazione + + 2005-2018 + + + Link.it srl + + + +
Link.it SRL Via S. Martino,51 + I-56125 + Pisa + ITALY + e-mail: info@link.it +
+ + + + Introduzione + In questa sezione trovi una guida rapida per l'installazione della versione binaria + di GovWay. Verifica e, se necessario, installa il software di base per GovWay come + indicato nella Fase Preliminare. Un installer grafico ti guider nella personalizzazione + della binary release verso la tua piattaforma. + + + Fase Preliminare + Prima di procedere con l'installazione di GovWay necessario disporre del software + di base nell'ambiente di esercizio. Verificare i passi seguenti, procedendo + eventualmente all'installazione dei componenti mancanti. + + + Java Runtime Environment (JRE) 8 o superiore ( + possibile scaricare JRE al seguente indirizzo: http://www.oracle.com/technetwork/java/javase/downloads/index.html + ) + Verificare la configurazione dell'ambiente Java dell'Application Server. + Si raccomanda una configurazione minima dei parametri della JVM, come segue: + + -XX:MaxMetaspaceSize=516m -Xmx1024m + + + + + + + Application Server WildFly (http://wildfly.org) (versione 10.x, + 11.x, 12.x, 13.x o 14.x). In alternativa possibile effettuare + l'installazione su Apache Tomcat (http://tomcat.apache.org) (versione 7.x, 8.x o 9.x). + GovWay supporta anche altri application server j2ee diversi da + quelli citati, partendo dalla distribuzione sorgente. + + + + + Un RDBMS accessibile via JDBC. La binary release + supporta le seguenti piattaforme: + + + PostgreSQL 8.x o superiore + + + + + MySQL 5.6.4 o superiore + + + + + Oracle 10g o superiore + + + + + HyperSQL 2.0 o superiore + + + + + MS SQL Server 2008 o superiore + + + + + IBM DB2 9.5 o superiore + + + + + + La distribuzione GovWay stata estesamente testata prima del rilascio + sulla seguente piattaforma di riferimento: + + Sun JRE 8 (version: 1.8.0_111) + + + PostgreSQL 9 (version: 9.5.10) + + + WildFly 14 (version: 14.0.0.Final) + + + + + + Esecuzione dell'Installer + + + + Scarica qui la + binary release di GovWay + + + Scompatta l'archivio, verifica ed eventualmente imposta la variabile + d'ambiente JAVA_HOME in modo che riferisca la directory + radice dell'installazione di Java. Lancia l'utility di installazione + mandando in esecuzione il file install.sh su + Unix/Linux, oppure install.cmd su Windows. + + Nota Bene: L'utility di installazione non + installa il prodotto ma produce tutti gli elementi necessari che dovranno + essere dispiegati nell'ambiente di esercizio. L'utility di installazione + mostra all'avvio una pagina introduttiva. + + + + Dopo la pagina introduttiva, cliccando sul pulsante + Next, si procede con la scelta della + Modalit di Installazione. Le scelte possibili + sono: + + + Nuova Installazione: scelta da effettuare + nel caso in cui si stia procedendo con una nuova installazione + di GovWay. + + + + Aggiornamento: scelta da effettuare nel + caso in cui si stia procedendo con l'aggiornamento di una + versione di GovWay precedentemente installata. + + + + + + + + Nuova Installazione + Supponiamo che la scelta sia quella di una nuova installazione. Vediamo come si + sviluppa il processo di installazione: + + Si procede con l'inserimento delle Informazioni + Preliminari, che prevede i seguenti dati: Operare le scelte sulla maschera di Informazioni + Preliminari tenendo presente che: + + + Directory di lavoro: una directory + utilizzata da GovWay per inserire i diversi file di + tracciamento prodotti. Non necessario che questa directory + esista sulla macchina dove si sta eseguendo l'installer; + tale directory dovr esistere nell'ambiente di esercizio + dove verr effettivamente installato il software GovWay. + + + + + Directory di log: una directory + utilizzata da GovWay per produrre i file di log. Non + necessario che questa directory esista sulla macchina dove + si sta eseguendo l'installer; tale directory dovr esistere + nell'ambiente di esercizio dove verr effettivamente + installato il software GovWay. + + + + DBMS: il tipo di database scelto tra + quelli supportati: PostgreSQL, MySQL, Oracle, HyperSQL, + SQLServer, IBM DB2. + + + + Application Server: Application server + utilizzato selezionato tra: WildFly (10.x, 11.x, 12.x, 13.x + o 14.x) e Apache Tomcat (9.x, 8.x, 7.x). + + + + + + Al passo successivo si dovranno inserire tutti i dati per l'accesso + al database ed in particolare: + + + + Hostname: indirizzo per raggiungere il + database + + + + Porta: la porta da associare all'host + per la connessione al database + + + + Nome Database: il nome dell'istanza del + database a supporto di GovWay. Non necessario che questo + database esista in questa fase. Il database di GovWay + infatti potr essere creato nella fase successiva purch il + nome assegnato coincida con il valore inserito in questo + campo. + + + + Username: l'utente con diritti di + lettura/scrittura sul database sopra indicato. Analogamente + al punto precedente, l'utente potr essere creato nella fase + successiva dopo aver creato il database. Ricordarsi per di + utilizzare il medesimo username indicato in questo campo. + + + + + Password: la password dell'utente del + database. + + + + + + Il successivo passo richiede di stabilire le credenziali relative alle + utenze di amministrazione per l'accesso ai cruscotti di gestione: + I dati da inserire sono: + + + Username/Password relativi all'utente + amministratore della govwayConsole. + + + + Username/Password relativi all'utente + operatore della govwayMonitor. + + + + + + Al passo successivo si dovranno inserire i dati relativi alle + modalit operative da supportare: + + + + Modalit: contrassegnare con un flag le + modalit che saranno gestite da GovWay, scelti tra quelli + offerti built-in dal prodotto. Allo stato attuale le + modalit operative supportate sono: + + API Gateway + + + SPCoop + + + eDelivery + + + SdI (Fatturazione + Elettronica) + + + + + + Soggetto: nome del soggetto interno che + verr creato automaticamente. + + + + + + Se si scelto di includere la modalit eDelivery viene richiesto di + immettere i relativi dati di configurazione. I dati di configurazione da immettere in questo step + riguardano l'installazione di Domibus con la quale GovWay deve + integrarsi per il dialogo con altri access point tramite il protocollo + eDelivery. I dati richiesti sono: + + HTTP Endpoint: gli endpoint per contattare l'access point + domibus interno + + Domibus MSH URL: endpoint pubblico per la + raggiungibilit dagli altri access point + + + Domibus Backend WS URL: endpoint dei servizi + di backend che saranno utilizzati da GovWay per + l'integrazione a Domibus + + + + + + Broker JMS: i dati di accesso al broker JMS utilizzato + internamente da Domibus + + Provider URL: endpoint del Broker JMS + + + Username/Password: credenziali per l'accesso + ai servizi del Broker JMS + + + + + + DBMS + + Tipo: la piattaforma database utilizzata da + Domibus. + + + + + + + + + Se si scelto di includere il protocollo eDelivery, in aggiunta allo + step precedente, verranno richiesti i dati di accesso al database + utilizzato da Domibus: + + + + Hostname: indirizzo per raggiungere il + database + + + + Porta: la porta da associare all'host + per la connessione al database + + + + Nome Database: il nome dell'istanza del + database a supporto di Domibus. + + + + Username: l'utente con diritti di + lettura/scrittura sul database sopra indicato. + + + + Password: la password dell'utente del + database. + + + + + + + All'ultimo passo, premendo il pulsante Install + il processo di configurazione si conclude con la produzione dei file + necessari per l'installazione di GovWay che verranno inseriti nella + nuova directory dist creata al termine di questo + processo. I files presenti nella directory dist dovranno essere utilizzati nella fase successiva di + dispiegamento di GovWay + + + + + + Aggiornamento + Supponiamo che la scelta sia quella di aggiornare una installazione precedente. + Vediamo come si sviluppa il processo per differenza rispetto al caso di una nuova + installazione: + + Il primo passo quello di indicare la versione di GovWay da cui si + parte per l'aggiornamento. + + + + Al passo successivo, dove si indicano le informazioni preliminari, vi + il vincolo di indicare la medesima piattaforma database utilizzata per + l'installazione che si vuole aggiornare. + + + + I rimanenti passaggi sono uguali al caso della nuova installazione + con la differenza che non sar disponibile la funzione per impostare le + credenziali dei cruscotti grafici. + + + + + + + Fase di Dispiegamento + Al termine dell'esecuzione dell'utility di installazione vengono prodotti i files + necessari per effettuare il dispiegamento nell'ambiente di esercizio. Tali files sono + disponibili nella directory dist. + Il processo di dispiegamento del software si distingue nei casi di nuova + installazione e aggiornamento. Le sezioni seguenti illustrano i due casi. + + Nuova Installazione + Per completare il processo di installazione si devono effettuare i passi + seguenti: + + Creare un utente sul RDBMS avente i medesimi valori di username e + password indicati in fase di setup. + + + Creare un database, per ospitare le tabelle dell'applicazione, avente + il nome indicato durante la fase di setup. Il charset da utilizzare + UTF-8. + + + Impostare i permessi di accesso in modo che l'utente creato al passo 1 + abbia i diritti di lettura/scrittura sul database creato al + passo 2. Si pu consultare un esempio relativo + a questi primi 3 passi, riferito alla piattaforma PostgreSQL, in + + + + Eseguire lo script sql/GovWay.sql per la + creazione dello schema del database. Ad esempio, nel caso di PostgreSQL, + si potr eseguire il comando psql <hostname> + <username> -f sql/GovWay.sql + + Successivamente eseguire lo script + sql/GovWay_init.sql per inserire i dati di + inizializzazione del database. + + + Installare il DriverJDBC, relativo al tipo di RDBMS indicato in fase + di setup, nella directory: + + <WILDFLY_HOME>/standalone/deployments, + nel caso di Wildfly. + + + <TOMCAT_HOME>/lib, nel caso di + Tomcat. + + + + + + Per le connessioni al database necessario configurare i seguenti + datasource impostati con i parametri forniti durante l'esecuzione + dell'utility di installazione: + + Il gateway necessita di un datasource con nome JNDI + org.govway.datasource + + + Le console grafiche necessitano di un datasource con nome + JNDI + org.govway.datasource.console + + + Nel caso si sia richiesto il supporto al protocollo + eDelivery, necessario un terzo datasource con nome JNDI + org.govway.datasource.domibus + + I datasource, preconfigurati per l'Application Server + indicato, sono disponibili nella directory datasource e contengono le + configurazioni di accesso al database indicate (ip, db_name, utenza, + password). Tali files possono essere utilizzati come riferimento per la + definizione dei datasource richiesti nelle modalit disponibili per + l'Application Server scelto. Tali files possono anche essere utilizzati + direttamente per un rapido dispiegamento copiandoli nelle seguenti + posizioni nel file system: + + <WILDFLY_HOME>/standalone/deployments, + nel caso di Wildfly. + + + <TOMCAT_HOME>/conf/Catalina/localhost, + nel caso di Tomcat + + Utilizzando i file preconfigurati, su WildFly + necessario sostituire al loro interno il placeholder + NOME_DRIVER_JDBC.jar con il nome del driver + JDBC installato in precedenza. + + + Eseguire il dispiegamento delle applicazioni presenti nella directory + archivi secondo le modalit disponibili per + l'Application Server scelto. Per un rapido dispiegamento possibile + copiare gli archivi nelle seguenti posizioni nel file system: + + <WILDFLY_HOME>/standalone/deployments, + nel caso di Wildfly. + + + <TOMCAT_HOME>/webapps, nel caso + di Tomcat + + + + + + Verificare che la directory di lavoro di GovWay, fornita con le + informazioni preliminari dell'utility di installazione, esista o + altrimenti crearla con permessi tali da consentire la scrittura + all'utente di esecuzione dell'application server + + + Copiare nella directory di lavoro tutti i files di configurazioni + presenti nella directory cfg. Ad esempio con il + comando: cp cfg/*.properties /etc/govway/ + La directory di destinazione deve essere accessibile in lettura + all'utente con cui si esegue l'Application Server. + + + Avviare l'application server con il relativo service oppure + utilizzando la linea di comando: + + <WILDFLY_HOME>/bin/standalone.sh, + nel caso di Wildfly. + + + <TOMCAT_HOME>/bin/startup.sh, + nel caso di Tomcat. + + + + + + + + + Aggiornamento + Sulla base delle scelte operate sulle maschere del wizard, nella directory + dist saranno presenti i file necessari per procedere + all'aggiornamento richiesto. + L'aggiornamento richiede i i seguenti step: + + Fermo dell'Application Server + + + Aggiornamento del database come descritto nella + + + + Aggiornamento dei datasource come descritto nella + + + + Aggiornamento degli archivi applicativi come descritto nella + + + + Aggiornamento dei files di properties come descritto nella + + + + Riavvio dell'Application Server + + + + + Aggiornamento del database + Nella sottodirectory sql si trovano gli script SQL da + eseguire sul database attualmente utilizzato per adeguarlo alla nuova versione: + + Eseguire lo script + sql/GovWay_upgrade_<new_version>.sql + per aggiornare lo schema del database. + + + Se si modificata la tipologia di Application Server rispetto a + quella utilizzata nell'installazione precedente (es. da jboss a + tomcat), deve anche essere eseguito lo script + sql/utilities/as/upgradeAS_to<new-type>.sql + + + + + + + Aggiornamento dei datasource + Nella sottodirectory datasource si trovano le + configurazioni dei datasource automaticamente generate in base ai dati di + connessione al database forniti e all'Application Server indicato. Se non + stato modificato l'Application Server, rispetto a quello utilizzato nell'attuale + installazione, un aggiornamento dei datasource non necessario. Eventualmente + confrontare i dati di configurazione dei datasource generati dall'installer con + i dati degli attuali datasource presenti nell'Application Server per verificare + che non esistano differenze. Se necessario aggiornare questi elementi, procedere + come indicato per questa attivit nella . + + + Aggiornamento degli archivi applicativi + Eseguire il dispiegamento delle applicazioni presenti nella sottodirectory + archivi secondo le modalit disponibili per + l'Application Server scelto. Per un rapido dispiegamento possibile copiare gli + archivi nelle seguenti posizioni del file system: + + jboss: JBOSS_HOME/standalone/deployments/ + + + tomcat: TOMCAT_HOME/webapps/ + + + + + + Aggiornamento dei file di properties + Nella sottodirectory cfg si trovano i template dei file + di properties esterni. Questi file, durante l'installazione del prodotto, sono + gi stati copiati nella directory di lavoro di GovWay. Tali file di properties + hanno lo scopo di fornire all'utente dei file pre-confezionati, con propriet + commentate, da utilizzare rapidamente secondo quanto descritto nei manuali + d'utilizzo del prodotto, per modificare eventuali configurazioni built-in. Non + quindi indispensabile che tali file vengano riportati sull'installazione + precedente e soprattutto occorre fare attenzione a non sovrascrivere + eventualmente i precedenti, se erano stati modificati rispetto al template + iniziale (generato dall'installer). + + + + + Verifica dell'Installazione + Appena conclusa la fase di dispiegamento si pu procedere con l'avvio + dell'application server, quindi: + + Verificare che la govwayConsole, l'applicazione web + per la gestione di GovWay, sia accessibile tramite browser all'indirizzo: + http://<hostname-pdd>/govwayConsole. In caso + di corretto funzionamento verr visualizzata la schermata seguente: + + + + Accedere alla govwayConsole utilizzando le credenziali fornite durante + l'esecuzione dell'installer. + + + Verificare che la govwayMonitor, l'applicazione web + per il monitoraggio di GovWay, sia accessibile tramite browser + all'indirizzo: + http://<hostname-pdd>/govwayMonitor. In caso + di corretto funzionamento verr visualizzata la schermata seguente: + + + + Accedere alla govwayMonitor utilizzando le credenziali fornite durante + l'esecuzione dell'installer. + + + + + + Configurazione in Load Balancing + Per realizzare un'installazione in load balancing necessario predisporre pi + istanze dell'Application Server, ognuna con una propria installazione del software. Sar + inoltre necessario: + + Che tutte le istanze di GovWay siano configurate per condividere lo stesso + DB. + + + Che esista un Load Balancer in grado di bilanciare il flusso di richieste + in arrivo sulle varie istanze di AS ospitanti il software GovWay. + + + Che GovWay sia opportunamente configurato con un identificatore unico che + contraddistingua lo specifico nodo. + + In particolare per realizzare la configurazione descritta al punto 3, + necessario: + + Editare il file <directory-lavoro>/govway_local.properties + aggiungendo la seguente riga: + + # Identificativo univoco della macchina + org.govway.pdd.cluster_id=#IDGW# + + inserendo al posto di #IDGW# l'identificatore unico associato alla specifica + istanza che si sta configurando. Scegliere un identificativo con cui si + possa facilmente riconoscere la macchina, ad esempio l'hostname. + + + Nel caso del protocollo SPCoop, editare il file + <directory-lavoro>/spcoop_local.properties aggiungendo le seguenti + righe: + + # Tipo di generazione dell'identificativo + org.govway.protocol.spcoop.id.tipo=static + # Prefisso dell'identificativo (opzionale) + org.govway.protocol.spcoop.id.prefix=#NUMERO# + + inserendo al posto di #NUMERO# l'identificatore unico associato a quella + istanza (da 0 a 99). Scegliere un identificativo numerico progressivo, a + partire da 0, per ciascuna istanza del software GovWay nel cluster. + + + Effettuata la modifica dei files necessario un riavvio dell'Application + Server per rendere operative le modifiche. + + + + NOTA: La directory '<directory-lavoro>' la directory contenente tutti i files + di configurazione. Verificare quale directory stata indicata durante l'esecuzione del + setup (vedi Esecuzione dell'Installer). + + Configurazione delle Console + La configurazione del Load Balancing si completa fornendo ulteriori dati di + configurazione alle console grafiche. Queste configurazioni consentono alle console + di avere i corretti riferimenti ai nodi presenti in modo da poter dettagliare questo + aspetto nelle proprie maschere ed inoltre poter propagare eventuali modifiche su + ogni nodo senza attendere il timeout della cache o richiedere riavvii + dell'AS. + A tale scopo sar necessario: + + Editare il file <directory-lavoro>/govway_local.properties + aggiungendo le seguenti righe su ogni PdD in Load Balancing: + + # JMX Resources + org.govway.pdd.checkPdD.readJMXResources.enabled=true + org.govway.pdd.checkPdD.readJMXResources.username=#USERNAME# + org.govway.pdd.checkPdD.readJMXResources.password=#PASSWORD# + + inserendo al posto di #USERNAME# e #PASSWORD# le credenziali che + dovranno essere utilizzate dalle console e che dovranno essere + configurate nei punti successivi di questo paragrafo. + + + Editare il file <directory-lavoro>/console_local.properties + aggiungendo le seguenti righe al fine di configurare la govwayConsole: + + # Configurazione gateway in Load Balancing + risorseJmxPdd.tipoAccesso=openspcoop + risorseJmxPdd.aliases=#IDGW1#,..,#IDGWN# + + Devono essere elencati tutti gli identificativi, di ogni nodo gateway in + Load Balancing, registrati nel file GovWay_local.properties nella + propriet 'org.govway.pdd.cluster_id' come descritto in precedenza. Per + ogni identificativo devono inoltre essere fornite le seguenti + informazioni: + + # Configurazione IDGW1 + #IDGW1#.risorseJmxPdd.descrizione=#DESCRIZIONEGW1# + #IDGW1#.risorseJmxPdd.remoteAccess.url=http://#HOSTGW1#:#PORTGW1#/GovWay/checkPdD + #IDGW1#.risorseJmxPdd.remoteAccess.username=#USERNAMEGW1# + #IDGW1#.risorseJmxPdd.remoteAccess.password=#PASSWORDGW1# + ... + # Configurazione IDGWN + #IDGWN#.risorseJmxPdd.descrizione=#DESCRIZIONEGWN# + #IDGWN#.risorseJmxPdd.remoteAccess.url=http://#HOSTGWN#:#PORTGWN#/GovWay/checkPdD + #IDGWN#.risorseJmxPdd.remoteAccess.username=#USERNAMEGWN# + #IDGWN#.risorseJmxPdd.remoteAccess.password=#PASSWORDGWN# + + Devono essere elencati inserendo al posto di #USERNAMEGW# e #PASSWORDGW# + le credenziali utilizzate nel govway_local.properties nella propriet + 'org.govway.pdd.checkPdD.readJMXResources.username' e + 'org.govway.pdd.checkPdD.readJMXResources.password' come descritto in + precedenza. + Indicare inoltre al posto di #HOSTGW# e #PORTGW# l'hostname e la + porta con cui raggiungibile GovWay. Infine deve anche essere fornita + una descrizione per ogni nodo in Load Balancing al posto di + #DESCRIZIONEGW#. + + + Editare il file <directory-lavoro>/monitor_local.properties + Disabilitare la configurazione per la singola istanza commentando la + propriet statoPdD.sonde.standard.Gateway.url: + + # Configurazione PdD in Singola Istanza + statoPdD.sonde.standard.Gateway.url=http://127.0.0.1:8080/govway/checkPdD?forceInvocationDisablePdD=true + + Aggiungere le seguenti righe al fine di configurare la govwayMonitor per + il Load Balancing: + + # Configurazione PdD in Load Balancing + configurazioni.risorseJmxPdd.tipoAccesso=openspcoop + configurazioni.risorseJmxPdd.aliases=IDGW1,..,IDGWN + statoPdD.sonde.standard.nodi=IDGW1,..,IDGWN + transazioni.idCluster.useSondaPdDList=true + + Devono essere elencati tutti gli identificativi, di ogni PdD in Load + Balancing, registrati nel file govway_local.properties nella propriet + 'org.govway.pdd.cluster_id' come descritto in precedenza. Per ogni + identificativo devono inoltre essere fornite le seguenti informazioni: + + # Configurazione IDGW1 + statoPdD.sonde.pddOE.#IDGW1#.url=http://#HOSTGW1#:#PORTGW1#/SondaPdD/check?forceInvocationDisablePdD=true + #IDGW1#.configurazioni.risorseJmxPdd.remoteAccess.url=http:// #HOSTGW1# : #PORTGW1 + # /govway/checkPdD + #IDGW1#.configurazioni.risorseJmxPdd.remoteAccess.username=#USERNAMEGW1# + #IDGW1#.configurazioni.risorseJmxPdd.remoteAccess.password=#PASSWORDGW1# + ... + # Configurazione IDGWN + statoPdD.sonde.pddOE.#IDGWN#.url=http://#HOSTGWN#:#PORTGWN#/SondaPdD/check?forceInvocationDisablePdD=true + #IDGWN#.configurazioni.risorseJmxPdd.tipoAccesso=openspcoop + #IDGWN#.configurazioni.risorseJmxPdd.remoteAccess.url=http://#HOSTGWN#:#PORTGWN + #/govway/checkPdD + #IDGWN#.configurazioni.risorseJmxPdd.remoteAccess.username=#USERNAMEGWN# + #IDGWN#.configurazioni.risorseJmxPdd.remoteAccess.password=#PASSWORDGWN# + + Devono essere elencati inserendo al posto di #USERNAMEGW# e #PASSWORDGW# + le credenziali utilizzate nel govway_local.properties nella propriet + 'org.govway.pdd.checkPdD.readJMXResources.username' e + 'org.govway.pdd.checkPdD.readJMXResources.password' come descritto in + precedenza. Indicare inoltre al posto di #HOSTGW# e #PORTGW# l'hostname + e la porta con cui raggiungibile GovWay. + + + + + + + Esempio di setup del database PostgreSQL + Procedura indicativa, applicabile alla piattaforma RDBMS PostgreSQL, per la + redisposizione del database di GovWay: + + Creazione Utente + + [user@localhost]$ su + Parola d'ordine: XXX + [root@localhost]# su - postgres + -bash-3.1$ createuser -P + Enter name of role to add: govway + Enter password for new role: govway + Conferma password: govway + Shall the new role be a superuser? (y/n) n + Shall the new role be allowed to create databases? (y/n) n + Shall the new role be allowed to create more new roles? (y/n) n + CREATE ROLE + + + + + Creazione Database + + [user@localhost]$ su + Parola d'ordine: XXX + [root@localhost]# su - postgres + -bash-3.1$createdb -O govway govway + CREATE DATABASE + + + + + Abilitazione accesso dell'utente al Database, possibile abilitare + l'accesso editando il file + /var/lib/pgsql/data/pg_hba.conf (come super + utente). Abilitiamo quindi l'utente govway ad accedere al db govway, + aggiungendo le seguenti righe al file: + + local govway govway md5 + host govway govway 127.0.0.1 255.255.255.255 md5 + + + + + + +
diff --git a/resources/doc/src/manualeInstallazione/cover/cover.pdf b/resources/doc/src/manualeInstallazione/cover/cover.pdf new file mode 100644 index 0000000000..102863383f Binary files /dev/null and b/resources/doc/src/manualeInstallazione/cover/cover.pdf differ diff --git a/resources/doc/src/manualeInstallazione/figure/govwayConsole_login.png b/resources/doc/src/manualeInstallazione/figure/govwayConsole_login.png new file mode 100644 index 0000000000..7b39f7a4d3 Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/govwayConsole_login.png differ diff --git a/resources/doc/src/manualeInstallazione/figure/govwayMonitor_login.png b/resources/doc/src/manualeInstallazione/figure/govwayMonitor_login.png new file mode 100644 index 0000000000..6efa73ac02 Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/govwayMonitor_login.png differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr0.jpg b/resources/doc/src/manualeInstallazione/figure/installer-scr0.jpg new file mode 100644 index 0000000000..3aa14f76dc Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr0.jpg differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr1.jpg b/resources/doc/src/manualeInstallazione/figure/installer-scr1.jpg new file mode 100644 index 0000000000..66536ec10d Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr1.jpg differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr10.png b/resources/doc/src/manualeInstallazione/figure/installer-scr10.png new file mode 100644 index 0000000000..2de8770cd2 Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr10.png differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr2.jpg b/resources/doc/src/manualeInstallazione/figure/installer-scr2.jpg new file mode 100644 index 0000000000..090fcce26a Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr2.jpg differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr3.jpg b/resources/doc/src/manualeInstallazione/figure/installer-scr3.jpg new file mode 100644 index 0000000000..44d8c79c4f Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr3.jpg differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr4.jpg b/resources/doc/src/manualeInstallazione/figure/installer-scr4.jpg new file mode 100644 index 0000000000..8b4d787b74 Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr4.jpg differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr5.jpg b/resources/doc/src/manualeInstallazione/figure/installer-scr5.jpg new file mode 100644 index 0000000000..1f137c8053 Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr5.jpg differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr6.jpg b/resources/doc/src/manualeInstallazione/figure/installer-scr6.jpg new file mode 100644 index 0000000000..432d16a732 Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr6.jpg differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr7.jpg b/resources/doc/src/manualeInstallazione/figure/installer-scr7.jpg new file mode 100644 index 0000000000..a56144c4e5 Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr7.jpg differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr8.jpg b/resources/doc/src/manualeInstallazione/figure/installer-scr8.jpg new file mode 100644 index 0000000000..00dd937a86 Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr8.jpg differ diff --git a/resources/doc/src/manualeInstallazione/figure/installer-scr9.png b/resources/doc/src/manualeInstallazione/figure/installer-scr9.png new file mode 100644 index 0000000000..85a78d8b16 Binary files /dev/null and b/resources/doc/src/manualeInstallazione/figure/installer-scr9.png differ diff --git a/resources/doc/src/manualeMonitoraggio/Makefile b/resources/doc/src/manualeMonitoraggio/Makefile new file mode 100644 index 0000000000..6a027a9166 --- /dev/null +++ b/resources/doc/src/manualeMonitoraggio/Makefile @@ -0,0 +1,5 @@ +include ../core/makefile/env +include ../core/makefile/commons + +SOURCE_NAME=ManualeMonitoraggio +SOURCE_FILE=${SOURCE_NAME}.xml diff --git a/resources/doc/src/manualeMonitoraggio/ManualeMonitoraggio.xml b/resources/doc/src/manualeMonitoraggio/ManualeMonitoraggio.xml new file mode 100644 index 0000000000..2fada5abb2 --- /dev/null +++ b/resources/doc/src/manualeMonitoraggio/ManualeMonitoraggio.xml @@ -0,0 +1,2143 @@ + + +
+ + Console di Monitoraggio + + Console di Monitoraggio + + + 2005-2018 + + + + Link.it srl + + + + +
Link.it SRL Via S. Martino,51 + I-56125 Pisa + ITALY + e-mail: info@link.it +
+ + + Introduzione + L'applicazione govwayMonitor è un ambiente grafico web-based per il monitoraggio + applicativo, il controllo e l'indagine diagnostica delle transazioni gestite da GovWay. + La govwayMonitor eroga le proprie funzionalità grazie ad un repository dedicato che viene + alimentato con i dati delle transazioni gestite e popolato tramite elaborazione di dati + statistici. + Ad alto livello, le funzionalità coperte sono: + + + Il monitoraggio delle comunicazioni transitate con meccanismi avanzati di supporto + all'indagine diagnostica. + + + La generazione di report statistici, in formato tabellare e grafico, che presentano i + dati in forma aggregata su base oraria, giornaliera, settimanale o mensile. + + + La consultazione degli eventi occorsi con meccanismi di filtro per la ricerca. + + + + + + Accesso alla Console + L'utente accede alla console govwayMonitor tramite browser all'indirizzo + http://<hostname>/govwayMonitor. All'inizio si viene rediretti alla pagina di login dove + possono essere inserite le proprie credenziali di accesso (). +
+ Maschera di login della Console di Monitoraggio (govwayMonitor) + + + + + + + + +
+ + Profili di autorizzazione + Dopo che l'utente ha superato la fase di autenticazione ha la possibilità di utilizzare + le funzionalità della govwayMonitor limitatamente alle autorizzazioni di cui dispone. Il + profilo di autorizzazione di ciascun utente è amministrato tramite l'applicazione di + configurazione govwayConsole. + Per quanto attiene le funzionalità della govwayMonitor gli aspetti di autorizzazione + degli utenti sono i seguenti: + + + + Permessi di Gestione: stabiliscono quali funzionalità sono + accessibili tramite il menu di navigazione: + + + Monitoraggio: permesso che consente di accedere alla consultazione delle + transazioni (aspetti di monitoraggio e diagnostica) e degli eventi. + + + Reportistica: permesso che consente di accedere alle funzionalità di + generazione dei report statistici. + + + + + + Restrizioni su Soggetti/Servizi: è possibili limitare la visibilità + dei dati del repository, relativamente a monitoraggio e statistiche, solo a determinati + soggetti/servizi. In assenza di specifiche restrizioni, tutti gli elementi risulteranno + visibili. + + + + Profilo di Interoperabilità: indica quali profili sono utilizzabili + dall'utente per la consultazione delle informazioni. La selezione di un profilo comporta + il filtro dei dati mostrati dalla console relativamente ad un singolo protocollo di + cooperazione (SPCoop, API Gateway, eDelivery, ...). + + + + + Homepage + Una volta effettuato l'accesso, viene mostrata la pagina di benvenuto () che permette di visualizzare, tramite un grafico, il volume di + traffico complessivo, suddiviso in base all'esito delle singole comunicazioni. Il grafico + può essere modificato specificando alcuni valori tramite gli elementi seguenti: + + + Periodo + Vengono mostrati i dati, aggiornati alla data odierna, con una tra le quattro + finestre temporali disponibili: 1 giorno, 1 settimana, 1 mese e 1 anno. + + + Soggetto Locale / API + Consente di filtrare i dati del grafico specificando il soggetto locale che + partecipa, come fruitore o erogatore, alle comunicazioni registrate. In alternativa è + possibile anche indicare una specifica API. + + +
+ Pagina di ingresso con statistiche generali sul traffico + + + + + + + + +
+ + + La Testata + La testata della console () prevede l'indicazione sul lato + sinistro del nome esteso dell'applicazione; tale testo rappresenta un link che porta alla + homepage ed è inoltre preceduto dall'icona di autodiagnosi che, assumendo tre colorazioni + possibili, raffigura lo stato del gateway: + + + + verde: rappresenta lo stato di corretto funzionamento. + + + + giallo: notifica un'anomalia che non sta compromettendo + completamente il funzionamento del gateway. Questa situazione avviene ad esempio in + un'installazione in load balancing quando uno dei nodi non risulta disponibile. + + + + rosso: notifica il verificarsi di un problema. + + +
+ Testata del GovWay Monitor + + + + + + + + +
+ Cliccando sull'icona si raggiunge la pagina di riepilogo () + che descrive lo stato complessivo di GovWay. +
+ Stato di funzionamento complessivo di GovWay + + + + + + + + +
+ Sul lato destro sono presenti le voci descritte di seguito e rappresentate nella : + + + Soggetto + Nome del soggetto interno, rispetto al quale sono visualizzati di dati di + monitoraggio e statistica. + + + Profilo + Menu a discesa che consente di selezionare il profilo di interoperabilità tra + quelli disponibili per l'utente in sessione. Selezionare un profilo ha l'effetto di + filtrare le informazioni presentate dall'interfaccia in base allo specifico protocollo + corrispondente. Ad esempio: + + + API Gateway + + + SPCoop + + + eDelivery + + + Fatturazione Elettronica + + + Selezionando il profilo "Tutti" non verrà effettuato alcun filtro preimpostato + nelle diverse sezioni in consultazione, ma sarà necessario indicare il profilo richiesto + in ogni singolo contesto. + + + Icona Utente + Menu a discesa per l'accesso alle seguenti funzionalità: + + + Informazioni + informazioni di dettaglio sulla versione del software installata. +
+ Informazioni sul prodotto + + + + + + + + +
+ + + Profilo Utente + Informazioni sul profilo dell'utente in sessione con la possibilità di + effettuare la modifica della password. +
+ Profilo Utente + + + + + + + + +
+ + + Logout + Permette di effettuare il logout, disconnettendo così l'utente attuale. + + + + + + + + Monitoraggio e Diagnostica + La console offre due modalità per il monitoraggio del traffico (live e storico) + accessibili dalla sezione monitoraggio del menu di navigazione. + Le due modalità "storico" e "live" consentono di visualizzare le singole transazioni con + la possibilità di filtrare i dati mostrati. La modalità "storico" consente di filtrare anche + per un intervallo temporale personalizzabile. La modalità "live" consente invece di + visualizzare le ultime 25 transazioni e offre un aggiornamento continuo dei risultati. + + Ricerca delle Transazioni in modalità "Live" + La pagina di monitoraggio in modalità "live" presenta le ultime 25 transazioni che sono + state gestite. La lista delle transazioni mostrata si aggiorna automaticamente (). +
+ Visualizzazione live transazioni + + + + + + + + +
+ È possibile impostare un filtro di ricerca per mostrare nel riquadro live solo le + transazioni con determinate caratteristiche (). +
+ Criteri di filtro per la Visualizzazione live + + + + + + + + +
+ Vediamo in dettaglio le opzioni di selezione per la modalità live: + + + Modalità Ricerca + + + Profilo Interoperabilità: elemento presente solo quando il profilo di + interoperabilità selezionato nella testata della console è "Tutti". In questo caso è + richiesto che l'utente indichi il profilo su cui filtrare le transazioni. + + + Funzione Gateway: elemento presente solo se la configurazione del prodotto + prevede l'utilizzo del modulo Integration Manager. Consente di distinguere le + transazioni riferite alle interazioni con l'integration manager da tutte le altre. + + + + + + Filtro Dati API + + + + Tipo: Indica se le transazioni da visualizzare + riguardano "erogazioni", "fruizioni". + + + + Soggetto Locale: opzione, disponibile se attiva + la modalità multi-tenant, che consente di filtrare rispetto al soggetto del dominio + interno che partecipa nella transazione. + + + + Soggetto Fruitore/Erogatore: rappresenta il + soggetto interlocutore del soggetto locale. Sarà il mittente se stiamo cercando + transazioni con tipologia "Erogazione", destinatario nell'altro caso. + + + + API: permette di filtrare su una specifica API, + individuata tramite il pattern 'API_nome:API_versione (Soggetto)'. + + + + Azione/Risorsa: permette di selezionare una tra + le azioni/risorse della API precedentemente selezionata. + + + + + Filtro Dati Mittente + + + + Tipo: consente di filtrare i dati sulla base di + tra criteri alternativi. + + + + Applicativo: filtro rispetto all'applicativo + mittente della richiesta. Gli applicativi saranno visualizzati relativamente al + soggetto fruitore in ciascun caso specifico. + + + + Identificativo Autenticato: filtro rispetto + all'identità del mittente ricavata dal processo di autenticazione livello + trasporto. Una volta scelto il tipo di autenticazione (http-basic, https, + principal) si fornisce la stringa da confrontare con l'identità del mittente. È + possibile indicare inoltre: + + + + Case Sensitive: indica se il confronto deve considerare + le maiuscole/minuscole + + + + Ricerca Esatta: indica se l'operatore di confronto è + l'uguaglianza tra stringhe oppure se si tratta di un'operazione di pattern + matching. + + + + + + Token Info: filtro rispetto ad un dato + presente nel token ottenuto nel processo di autenticazione. Si deve indicare + quale "claim" del token deve essere utilizzato per il confronto. È possibile + indicare inoltre: + + + + Case Sensitive: indica se il confronto deve considerare + le maiuscole/minuscole; + + + + Ricerca Esatta: indica se l'operatore di confronto è + l'uguaglianza tra stringhe oppure se si tratta di un'operazione di pattern + matching. + + + + + + + + + Filtro Dati Transazione + + + + Esito: permette di selezionare una categoria di + esiti a cui le transazioni appartengono a scelta + + + + Completate con successo: sono tutte le transazioni per cui + non si hanno avuto errori che hanno comportato un fallimento dell'elaborazione + della richiesta. In questa casistica rientrano anche transazioni per cui durante + la gestione è stato sollevato un diagnostico di livello error dovuto a + funzionalità impostate al livello 'warning-only' (es. validazione dei contenuti) + + + + + Fallite: sono tutte le transazioni per cui si hanno avuto + errori che hanno comportato un fallimento dell'elaborazione della richiesta. + + + + + Fault Applicativo: identifica le transazioni per cui + l'applicativo erogatore ha generato un SOAPFault come risposta, per le API Soap, + oppure ha restituito un errore applicativo, in accordo al protocollo REST, nel + formato standard RFC 7807 "Problem Details for HTTP APIs - IETF Tools". + + + + Fallite + Fault Applicativo: sono tutte le transazioni che + rientrano nei due gruppi descritti in precedenza. + + + + Personalizzato: permette di selezionare puntualmente tutti + gli esiti delle transazioni che si desidera visualizzare. La selezione potrà + essere effettuata tramite l'elemento 'Dettaglio Esito'. + + + + + + Dettaglio Esito: i valori selezionabili cambiano + in base alla scelta effettuata al punto precedente. + Nel caso esito = "Completate con successo": + + + + OK: le transazioni completate con successo + + + + OK (Presenza Anomalie): le transazioni con esito OK dove + però vi è la presenza di messaggi diagnostici con severità error che non ha + inciso sul buon fine dell'operazione. + + + + Risposta HTTP 3XX: le transazioni che, in assenza di + errori, hanno riportato una risposta dal dominio esterno con un codice HTTP 3XX. + + + + + Messaggi non presenti [IM]: le transazioni di recupero + messaggi dall'integration manager che hanno ottenuto errore per indisponibilità + del messaggio nella Message Box (opzione visibile solo se abilitato in + configurazione il modulo IntegrationManager). + + + + Violazione Rate Limiting WarningOnly: Esito delle + transazioni che hanno violato policy del controllo traffico senza alcuna + restrizione poiché in modalità WarningOnly. + + + + Superamento Limite Richieste WarningOnly: Esito delle + transazioni che hanno violato la soglia relativa al numero massimo di richieste + concorrenti prevista dal sistema di controllo del traffico. In questo caso non è + stata applicata alcuna restrizione poiché è attiva la modalità WarningOnly. + + + + Nel caso esito = "Fallite": + + + + Risposta HTTP 4XX: le transazioni che hanno prodotto una + regolare risposta di errore applicativo dal dominio esterno con un codice HTTP + 4XX. + + + + Risposta HTTP 5XX: le transazioni che hanno prodotto una + regolare risposta di errore applicativo dal dominio esterno con un codice HTTP + 5XX. + + + + Gestione Token Fallita: le transazioni che hanno riportato + un fallimento relativo alle politiche di accesso basate sull'elaborazione del + token. + + + + Autenticazione Fallita: transazioni terminate con un errore dovuto al fallimento del processo di + autenticazione del chiamante (es. credenziali fornite errate); + + + + Autorizzazione Negata: transazioni terminate con un errore dovuto al fallimento del processo di + autorizzazione del chiamante; + + + + Errore di Connessione: transazioni che hanno ottenuto un + errore legato a problemi di connessione al servizio remoto; + + + + Errore SPCoop/SDI/eDelivery: transazioni che hanno generato + errori a livello del protocollo (es. SPCoop) specifico della comunicazione con + il dominio esterno; + + + + Violazione Rate Limiting: Esito delle transazioni che hanno + violato policy del controllo traffico con applicazione di restrizioni + sull'esecuzione. + + + + Superamento Limite Richieste: Esito delle transazioni che + hanno violato la soglia relativa al numero massimo di richieste concorrenti + prevista dal sistema di controllo del traffico. + + + + Sicurezza Messaggio Richiesta Fallita: Esito della + transazioni i cui controlli di sicurezza a livello del messaggio di richiesta + hanno riportato un errore. + + + + Sicurezza Messaggio Risposta Fallita: Esito della + transazioni i cui controlli di sicurezza a livello del messaggio di risposta + hanno riportato un errore. + + + + Gestione Allegati Richiesta Fallita: Esito delle + transazioni che hanno prodotto un errore durante la fase di elaborazione degli + allegati alla richiesta (ad esempio durante la gestione del protocollo MTOM). + + + + + Gestione Allegati Risposta Fallita: Esito delle transazioni + che hanno prodotto un errore durante la fase di elaborazione degli allegati alla + risposta (ad esempio durante la gestione del protocollo MTOM). + + + + Correlazione Applicativa Richiesta Fallita: Esito delle + transazioni in cui l'applicazione della regola di correlazione applicativa, + prevista sul messaggio di richiesta, ha prodotto un fallimento. + + + + Correlazione Applicativa Risposta Fallita: Esito delle + transazioni in cui l'applicazione della regola di correlazione applicativa, + prevista sul messaggio di risposta, ha prodotto un fallimento. + + + + Fault PdD Esterna: (Solo per il profilo SPCoop) transazioni + che hanno ottenuto un fault non applicativo nel quale non è presente + l'intestazione di protocollo. L'errore potrebbe essere stato generato dalla PdD + Esterna come anche da un firewall xml; + + + + Contenuto Richiesta non Riconosciuto: transazioni la cui + richiesta applicativa pervenuta non è risultata processabile (es. xml non valido + sintatticamente) + + + + Contenuto Risposta non Riconosciuto: transazioni la cui + risposta applicativa ritornata dal servizio remoto non è risultata processabile + (es. xml non valido sintatticamente) + + + + Richiesta Client Rifiutata da GovWay: transazioni sulle + quali il gateway ha rifiutato la richiesta inviata dall'applicativo mittente a + causa di un errore di invocazione; + + + + Connessione Client Interrotta: rientrano in questa + casistica le transazioni per cui il gateway non è riuscito a restituire la + risposta al chiamante poiché quest'ultimo ha interrotto la connessione; + + + + Errore Generico: transazioni che hanno riportato un + qualunque tipo di errore che non rientri nella casistica precedente; + + + + Autenticazione Fallita [IM]: In caso di invocazioni + dell'Integration Manager (Message Box) filtra le transazioni in cui è stato + restituito un errore di autenticazione; + + + + Autorizzazione Fallita [IM]: In caso di invocazioni + dell'Integration Manager (Message Box) filtra le transazioni in cui è stato + restituito un errore di autorizzazione; + + + + Messaggi Non Presenti [IM]: In caso di invocazioni + dell'Integration Manager (Message Box) filtra le transazioni che hanno generato + la segnalazione di "Messaggi non Presenti"; + + + + Messaggio Non Trovato [IM]: In caso di invocazioni + dell'Integration Manager (Message Box) filtra le transazioni in cui è stato + restituito l'errore di "Messaggio non Trovato". + + + + + + ID Cluster: Permette di filtrare le transazioni + in base al nodo del cluster che le ha gestite. + + + + Evento: Seleziona le sole transazioni associate + ad un determinato evento. + + + + + + + Ricerca delle Transazioni in modalità "Storico" + La modalità "storico" fornisce all'utente differenti tipologie di ricerca. L'utente + seleziona il tipo di ricerca che vuole effettuare tramite la prima maschera che gli si + presenta all'ingresso della relativa sezione (). +
+ Maschera di selezione per la ricerca delle transazioni in modalità "storico" + + + + + + + + +
+ Vediamo nel dettaglio quali sono le funzionalità offerte da ogni modalità di ricerca: + + + + Intervallo Temporale. Questa modalità consente di + effettuare ricerche di transazioni selezionando l'intervallo temporale di interesse + (). I campi utilizzati per filtrare + le transazioni da visualizzare sono i medesimi descritti nella . +
+ Filtro di Ricerca delle Transazioni in modalità "Intervallo Temporale" + + + + + + + + +
+ + + + Identificativo Applicativo. Modalità che consente di + effettuare ricerche di transazioni contenente uno specifico identificativo applicativo + estratto dalle comunicazioni in transito tramite la funzionalità di Correlazione + Applicativa. In questa modalità si deve comunque selezionare anche l'intervallo + temporale di interesse (). I + restanti filtri sono i medesimi descritti nella + arricchiti con una nuova sezione "Filtro Identificativo Applicativo" che consente di + filtrare specificando il valore dell'identificativo applicativo: + + + + Ricerca esatta: opzione si/no per indicare se il + confronto sugli identificativi deve essere basato sull'eguaglianza o se si utilizza + il pattern matching. + + + + Case Sensitive: opzione si/no per indicare se il + confronto deve considerare differenti lettere maiuscole e minuscole. + + + + ID Applicativo: testo da confrontare con + l'identificativo applicativo. + + +
+ Filtro di Ricerca delle Transazioni in modalità "Identificativo + Applicativo" + + + + + + + + +
+ + + + Identificativo Messaggio. Modalità che consente di + effettuare ricerche sulla base dell'identificativo del messaggio assegnato dal gateway. + La maschera di ricerca si compone dei seguenti campi (): + + + + Tipo: indica se l'identificativo è da ricercare + in un messaggio di richiesta o risposta. + + + + ID: identificativo da cercare. + + +
+ Filtro di Ricerca delle Transazioni in modalità "Identificativo + Messaggio" + + + + + + + + +
+ + + + Identificativo Transazione. Modalità che consente di + effettuare ricerche tramite l'identificativo di transazione (). +
+ Filtro di Ricerca delle Transazioni in modalità "Identificativo + Transazione" + + + + + + + + +
+ + + Una volta impostati i criteri di ricerca desiderati, per procedere con la ricerca si + deve utilizzare il pulsante 'Filtra'. Se si vogliono riportare i criteri di ricerca ai + valori iniziali è possibile utilizzare il pulsante 'Ripulisci'. + Nelle modalità di ricerca 'Andamento Temporale' e 'Identificativo Applicativo', + effettuata la prima ricerca (tramite il pulsante 'Filtra') saranno disponibili due nuovi + pulsanti: + + + 'Nuova Ricerca': utilizzando questo pulsante verrà effettuata una nuova ricerca + utilizzando i criteri impostati nel filtro di ricerca. + + + 'Filtra Risultati': utilizzando questo pulsante la ricerca effettuata non conterrà + eventuali nuove transazioni occorse dopo la prima ricerca. + + + Le colonne visualizzate nella modalità "storico" sono personalizzabili. È possibile + configurare le colonne che si desiderano visualizzare accedendo al menù dedicato accessibile + sull'header di una qualsiasi colonna come visualizzato nella . +
+ Modifica delle colonne visualizzate nello storico + + + + + + + + +
+ La posizione di una colonna, rispetto alle altre, la si può modificare trascinandola + nella posizione desiderata come visualizzato nella . +
+ Modifica della posizione di una colonna visualizzata nello storico +
+ Prima: +
+ + + + + + + + +
+ Dopo: +
+ + + + + + + + +
+ Dopo aver effettuato una ricerca vi è la possibilità di selezionare le transazioni + desiderate ed effettuare un export su file. Dopo aver selezionato le transazioni tramite il + checkbox posto a inizio riga nell'elenco, si sceglie quali dati includere nell'export tra + Tracce, Diagnostici e Contenuti. +
+ Lista delle transazioni risultanti da una ricerca + + + + + + + + +
+ Il risultato dell'esportazione è un archivio zip contenente una directory per ciascuna + transazione esportata. A loro volta le directory possono contenere una combinazione dei + seguenti files, in base al tipo dei dati esportati: + + + + manifest.xml + + Sempre presente, contiene i dati descrittivi della transazione (mittente, + destinatario, ora di registrazione, id-messaggio, ecc.); + + + tracce.xml + In caso di esportazione delle tracce questo file contiene le tracce della richiesta + e della risposta nel formato previsto dalla specifica del protocollo (es. SPCoop); + + + + diagnostici.xml + In caso di esportazione dei diagnostici questo file contiene i messaggi diagnostici + associati alla transazione nel formato previsto dalla specifica del protocollo (es. + SPCoop); + + + fault.xml + In caso di esportazione dei contenuti questo file contiene il messaggio di + soapFault restituito nei casi di errore. + + + contenuti + + + richiesta + + + + header.xml: header HTTP riguardante la gestione del + messaggio di richiesta + + + + envelope.xml: SOAPEnvelope del messaggio di richiesta + + + + + allegati: eventuali allegati presenti nel messaggio di + richiesta + + + + + risposta + + + + header.xml: header HTTP riguardante la gestione del + messaggio di risposta + + + + envelope.xml: SOAPEnvelope del messaggio di risposta + + + + + allegati: eventuali allegati presenti nel messaggio di + risposta + + + + + + +
+ Struttura dell'archivio di esportazione delle transazioni + + + + + + + + +
+ Oltre all'export appena descritto è possibile effettuare anche un'esportazione dei dati + delle transazione in un formato CSV. Per ottenere tale tipo di esportazione si deve + selezionare le transazioni interessate tramite il checkbox posto a inizio riga nell'elenco, + scegliere se includere nell'export anche le Tracce e Diagnostici (i Contenuti non sono + esportabili nel formato CSV) e cliccare sul pulsante 'Export CSV'. Prima di procedere con + l'esportazione effettiva vengono richiesti all'utente: + + + Tipologia di Documento: è possibile indicare un file CSV semplice o un XLS. + + + Colonne Esportate: tale opzione permette di decidere quali colonne saranno presenti + nel file esportato: + + + Solamente le colonne visualizzate nello storico delle transazioni (opzione: + 'Visualizzate nello Storico') + + + Tutte le informazioni disponibili per ogni transazione (opzione: Tutte) + + + Solamente le informazioni che interessano all'utente, modificando anche + l'ordine di apparizione di tali informazioni nelle colonne del file CSV (opzione: + Personalizza) + + + + + +
+ Export CSV personalizzato + + + + + + + + +
+ + Dettaglio Transazione + Dal risutalto di una ricerca transazioni, sia in modalità "live" () che in modalità "storico" (), + cliccando sulla data di ingresso di una specifica transazione si ottiene la pagina con le + informazioni di dettaglio, suddivisa nelle seguenti sezioni: + + + Informazioni Generali + + + Dettagli Richiesta + + + Dettagli Risposta + + + Informazioni Mittente + + + Informazioni Avanzate + + + Le informazioni presenti nel dettaglio cambiano a seconda dell'esito della + transazione: + + + In vediamo un esempio di dettaglio di + transazione con esito OK. + + + In vediamo un esempio di pagina di + dettaglio relativa a una transazione con esito ERRORE. + + + In vediamo un esempio di dettaglio + relativo ad una transazione con esito "Fault Applicativo". + + +
+ Dettaglio di una transazione con esito OK + + + + + + + + +
+
+ Dettaglio di una transazione con esito Errore + + + + + + + + +
+
+ Dettaglio di una transazione con esito Fault Applicativo + + + + + + + + +
+ La sezione Informazioni + Generali mostra le proprietà generali della transazione ed in + particolare i riferimenti al servizio invocato e l'esito. Nello stesso riquadro si trova + il link per la visualizzazione dei messaggi diagnosti o per effettuare un'esportazione + degli stessi (). +
+ Dettaglio dei messaggi diagnostici relativi ad una transazione + + + + + + + + +
+ Nella sezione Dettagli + Richiesta sono visualizzati i dati generali della richiesta, quali + id del messaggio, dimensioni in KB e timestamp del messaggio in ingresso e uscita. Nel + medesimo riquadro è possibile selezionare Visualizza Traccia per accedere alla pagina di + consultazione della traccia relativa alla richiesta (). + Quando prevista la registrazione dei messaggi in configurazione, si troveranno in + questo riquadro i collegamenti per visualizzare: + + + Contenuti Ingresso/Uscita: i contenuti di entrata ed uscita sul gateway. Sia in + entrata che uscita comprendono (in base al tipo di configurazione attiva): + + + Il messaggio veicolato + + + Gli eventuali attachment inclusi nel messaggio + + + Gli header di trasporto relativi alla richiesta + + + + + Dati Raw Ingresso/Uscita: la versione raw dei contenuti transitati in + ingresso/uscita sul gateway + + + Per tutte queste voci sono presenti i link Esporta che consentono di salvare tali + informazioni sul proprio filesystem. +
+ Dettaglio della traccia + + + + + + + + +
+
+ Visualizzazione contenuti in ingresso per una richiesta + + + + + + + + +
+ Nei casi di esito "Fault Applicativo", cioè se il servizio erogatore ha restituito un + messaggio di fault, è possibile visualizzarne il contenuto tramite il link Visualizza + Fault (). +
+ Dettaglio di un errore applicativo (fault) + + + + + + + + +
+ Le medesime funzionalità appena illustrate per la richiesta sono disponibili per la + risposta nel riquadro Dettagli Risposta. + La sezione Informazioni + Mittente riporta dati specifici correlati all'interazione tra + GovWay e il mittente: + + + Metodo HTTP: il metodo http relativo alla richiesta inviata dal mittente + + + URL Invocazione: la url di invocazione utilizzata dal mittente per contattare il + gateway + + + Indirizzo Client: l'indirizzo di provenienza della richiesta pervenuta + + + Codice Risposta Client: codice http restituito al mittente + + + Applicativo Fruitore: identificativo dell'applicativo mittente + + + Credenziali: Le credenziali utilizzate dall'applicativo per l'autenticazione + + + + X-Forwared-For: presente solamente se viene rilevato tra gli header http della + richiesta un header tra i seguenti: 'X-Forwared-For' , 'Forwared-For', 'Forwarded', + 'X-Client-IP', 'Client-IP' + + + Token Info: riporta il dettaglio delle informazioni estratte dal token ottenuto + in fase di autenticazione della richiesta del mittente + + + Nel riquadro Informazioni + Avanzate sono visualizzati i seguenti dati (): + + + ID Transazione + + + Dominio (ID e Soggetto): dominio del soggetto che ha gestito la transazione + + + + PortaApplicativa o PortaDelegata: indica il nome della porta invocata dal client + + + + URL Inoltro: specifica l'endpoint utilizzato per l'inoltro verso il dominio + esterno (nel caso di fruizione) + + + Codice Risposta: il codice HTTP inviato con il messaggio di risposta + + + Latenza Totale, Servizio e Gateway: indica i tempi di elaborazione del messaggi + + + +
+ Informazioni Avanzate di una Transazione + + + + + + + + +
+ + + + + Eventi + GovWay rileva e segnala gli eventi occorsi, i quali vengono classificati e resi + disponibili per la consultazione. + La consultazione degli eventi è possibile attraverso la console govwayMonitor accedendo + alla voce di menu "Eventi" presente nella sezione Monitoraggio. + La pagina di consultazione mostra la lista degli eventi registrati seguendo un ordine + temporale decrescente () e le colonne mostrano i campi di maggiore + importanza. + Dall'elenco è possibile selezionare il singolo elemento per visualizzarne il dettaglio. + Ciascun evento è composto dai seguenti dati: + + + Ora Registrazione + Timestamp relativo all'evento. + + + Severità + Livello di severità dell'evento. Può assumere i valori: FATAL, ERROR, INFO, WARN, + DEBUG. + + + Tipo + Etichetta che rappresenta la tipologia di appartenenza dell'evento. Ad esempio, + quando si effettua il riavvio di GovWay verrà generato un evento di tipo "StatoGateway". + + + + Codice + Il codice che identifica univocamente l'evento. + + + Origine + Riporta, quando applicabile, l'identificativo di un elemento della configurazione del + servizio, responsabile dell'evento sollevato. + + + Descrizione + Un campo di testo opzionale che fornisce una descrizione dell'evento. + + + Cluster ID + Un campo utilizzato nel caso di installazioni in cluster per identificare il nodo in + cui si è verificato l'evento. + + +
+ Consultazione Eventi + + + + + + + + +
+ Sopra l'elenco degli eventi è possibile espandere una maschera per impostare alcuni + criteri per filtrare gli eventi da visualizzare: + + + + Filtro Temporale + + + + + Periodo: Intervallo temporale in cui si sono + verificati gli eventi da cercare. + + + + + + + Filtro Dati Evento + + + + Severità: Livello di severità. + + + + Tipo: Il tipo di evento (per maggiori dettagli vedi + tabella sottostante). + + + + Codice: Il codice associato all'evento (per + maggiori dettagli vedi tabella sottostante). + + + + + + Filtro Dati Identificativi: elementi per filtrare gli + eventi in base agli identificativi. + + + + Ricerca Esatta: specifica se il confronto con + l'identificativo avviene per pattern oppure in maniera esatta. + + + + Case Sensitive: specifica se il valore fornito + viene confrontato considerando maiuscole e minuscole o meno. + + + + Origine: pattern o valore esatto + dell'identificativo di configurazione. + + + + ID Cluster: pattern o valore esatto + dell'identificativo del nodo cluster. + + + + + + Un evento può essere correlato ad una o più transazioni applicative (ad esempio poiché + l'evento è stato scatenato dall'esecuzione di una transazione). Consultando il dettaglio di + una transazione sarà possibile visualizzare gli eventi ad essa correlati. + La seguente tabella descrive gli eventi previsti. + + + + + + + + Tipo Evento + Codice Evento + Descrizione + + + + + StatoGateway + Valori Possibili: + + Start + + + Stop + + + + Questo evento segnala l'avvio e il fermo di GovWay o del singolo nodo in caso di + installazione in cluster. + + + ControlloTraffico_ NumeroMassimo RichiesteSimultanee + Valori Possibili: + + Violazione + + + ViolazioneRisolta + + + Violazione_WarningOnly + + + ViolazioneRisolta_WarningOnly + + + + Questo evento segnala il raggiungimento della soglia massima di richieste + simultanee + Le soglie sul numero massimo di richieste simultanee, sul congestionamento + del gateway e le relative policy di controllo, sono concetti legati alla + funzionalità di Controllo del Traffico, i cui aspetti di configurazione sono + trattati nel Manuale Utente della govwayConsole. + . Il secondo codice segnala l'evento di risoluzione. + + + ControlloTraffico_ SogliaCongestione + Valori Possibili: + + Violazione + + + ViolazioneRisolta + + + + Questo evento segnala il raggiungimento della soglia di + congestionamento (percentuale sul numero massimo di richieste + simultanee). Il secondo codice segnala l'evento di risoluzione. + + + RateLimiting_Policy + Valori Possibili: + + Violazione + + + ViolazioneRisolta + + + Violazione_WarningOnly + + + ViolazioneRisolta_WarningOnly + + + + Questo evento segnala la violazione di una policy di rate limiting + e la successiva risoluzione. Nel caso sia stata configurata, per la policy, la + modalità "WarningOnly" l'evento conterrà i due codici appositi. + + + + + + + Le Funzionalità di Reportistica + La sezione "Reportistica" della govwayMonitor permette di generare due differenti + tipologie di report: + + + + Analisi Statistica, che mostrano aggregazioni su base periodica delle + informazioni relative alle transazioni gestite. A seconda del tipo di report richiesto, + l'utente può scegliere tra i formati grafici a linea, a torta, ad istogramma oppure il + formato tabellare. + + + + Configurazione Servizi, che presentano i dati riassuntivi + relativamente ai servizi configurati, erogazioni e fruizioni, su GovWay. + + + + Analisi Statistica + Per accedere alla funzionalità di generazione di report statistici si deve selezionare + la voce 'Analisi Statistica' all'interno della sezione 'Reportistica' del menu di + navigazione. + Il primo passo è quello di selezionare il tipo di report che si intende generare e la + relativa modalità di visualizzazione (). Una volta + individuato il tipo di report che si desidera generare si deve selezionare il tipo di + grafico o, in alternativa, il formato tabellare. +
+ Tipo di analisi statistica + + + + + + + + +
+ I tipi di report che si possono generare sono: + + + Distribuzione Temporale + Consente di visualizzare al variare del tempo i valori rilevati riguardo numero di + richieste, KB transitati e tempi medi di risposta. + + + Distribuzione per Esiti + Consente di visualizzare la distribuzione delle richieste, in un dato periodo, + rispetto agli esiti riscontrati (OK, Errore, Fault Applicativo). + + + Distribuzione per Soggetto Remoto + Consente di visualizzare la distribuzione del numero di richieste, KB transitati e + tempi medi di risposta, aggregando i dati rispetto al soggetto interlocutore. + + + Distribuzione per Soggetto Locale + Report disponibile in modalità multi-tenant, consente di visualizzare la + distribuzione del numero di richieste, KB transitati e tempi medi di risposta, + aggregando i dati rispetto al soggetto interno al dominio GovWay. + + + Distribuzione per API + Consente di visualizzare la distribuzione del numero di richieste, KB transitati e + tempi medi di risposta, aggregando i dati in base alla API invocata + + + Distribuzione per Azione + Consente di visualizzare la distribuzione del numero di richieste, KB transitati e + tempi medi di risposta, aggregando i dati per azione + + + Distribuzione per Applicativo + Consente di visualizzare la distribuzione del numero di richieste, KB transitati e + tempi medi di risposta, aggregando i dati per applicativo client che ha inviato la + richiesta + + + Distribuzione per Identificativo Autenticato + Consente di visualizzare la distribuzione delle transazioni rispetto + all'identificativo dell'utente rilevato in fase di autenticazione + + + Distribuzione per Token Info + Consente di visualizzare la distribuzione delle transazioni rispetto ad uno dei + claim ricavati dal token ottenuto nel corso dell'autenticazione della richiesta + + + Per ogni report è possibile specificare dei criteri di filtro, per limitare i dati da + presentare (). I criteri di filtro selezionabili + variano in funzione del tipo di report selezionato. +
+ Maschera di selezione per la generazione dei report statistici + + + + + + + + +
+ I dati da indicare per generare un report sono: + + + Profilo Interoperabilità: visibile solo quando il profilo di interoperabilità, + sulla testata dell'applicazione, è stato impostato a "Tutti". Il campo permette di + selezionare il profilo con cui effettuare la ricerca delle transazioni. Questa scelta è + obbligatoria. + + + Filtro Temporale + + + + Unità di Tempo: consente di scegliere su quale + unità temporale basare il dato numerico relativo alle transazioni (oraria, + giornaliera, settimanale, mensile) + + + + Periodo: consente di indicare un intervallo + temporale di interesse + + + + + Filtro Dati API + + + + Tipologia: indica il "ruolo" che svolge il + "Soggetto in Gestione". Ad esempio selezionando "Erogazione" verranno visualizzate + solo le transazioni in cui il "Soggetto in Gestione" è l'erogatore. + + + + Soggetto Locale: nel caso in cui l'utente abbia + in gestione più soggetti sarà possibile inserire un filtro su di essi. + + + + Soggetto Remoto: rappresenta il soggetto + interlocutore del soggetto in gestione. Questo si traduce nel fatto che sarà il + mittente se stiamo cercando transazioni con tipologia "Erogazione", destinatario + nell'altro caso. + + + + API: permette di filtrare su una specifica API, + individuata tramite il pattern 'API_nome:API_versione (Soggetto)'. + + + + Azione/Risorsa: permette di selezionare una tra + le azioni/risorse della API selezionata. + + + + + Filtro Dati Mittente: permette di filtrare le transazioni da includere nel report + sulla base dei dati legati alla richiesta inviata dal mittente. + + + Tipo: consente di scegliere su quale dato + applicare il filtro tra: + + + Applicativo: si seleziona l'applicativo mittente delle transazioni + + + Identificativo Autenticato: si seleziona il metodo di autenticazione e si + specifica il criterio di confronto con l'identificativo ricavato dal processo di + autenticazione. + + + Token Info: si seleziona il claim del token e si specifica il criterio per + il confronto con il token ricavato durante il processo di autenticazione. + + + + + + + + Filtro Dati Transazione + + + + Esito: permette di selezionare una categoria di + esiti a cui le transazioni appartengono. Valgono le medesime considerazioni + effettuate nella relativamente allo stesso campo + presente tra i criteri di ricerca. + + + + Dettaglio Esito: i valori selezionabili cambiano + in base alla scelta effettuata al punto precedente. Valgono le medesime + considerazioni effettuate nella relativamente allo + stesso campo presente tra i criteri di ricerca. + + + + + Report + + + + Visualizza Per: è possibile scegliere se si vuole + visualizzare le Dimensioni, in termini di KB gestiti, il + Numero delle Transazioni o il Tempo Medio di + Risposta; + + + + + Dopo aver selezionato i parametri di interesse si genera il report utilizzando il + pulsante "Genera Report". L'area di visualizzazione del report, grafico o tabellare, si + trova sotto il form di selezione e presenta alla base i seguenti elementi fissi: + + + Alcuni link che consentono lo spostamento dell'intervallo temporale senza dover + tornare alla maschera di selezione (ad es. mese successivo o precedente, ecc.) + + + I link per l'esportazione dei dati visualizzati nei formati CSV, XLS, PDF e PNG. + + + + Sono inoltre presenti alcuni elementi di personalizzazione che dipendono dal tipo di + grafico generato: + + + Nel caso di rappresentazione grafica a torta o istogramma (denominate + rispettivamente pie chart o bar chart) è consentito impostare il numero massimo di + elementi visualizzabili (ordinati per cardinalità decrescente). Gli elementi rimanenti + saranno raggruppati in un unico altro elemento riportante l'etichetta "Altri". + + + Nel caso di rappresentazione grafica a linea o istogramma (denominate + rispettivamente line chart o bar chart) è possibile decidere l'orientamento delle + etichette dei risultati visualizzati. + + + In tutte le rappresentazioni grafiche è possibile allargare o restringere il + grafico se la pagina del browser (e la risoluzione) lo permette. + + + Vediamo adesso con maggior dettaglio le singole tipologie di report. + + Andamento Temporale + Fornisce statistiche riguardo l'andamento temporale delle transazioni che sono + transitate sul gateway. Di seguito alcuni esempi di reports generabili. + + Grafico 'Line Chart' sul numero di transazioni: + +
+ Esempio di report grafico di andamento temporale (Line Chart sul numero di + transazioni) + + + + + + + + +
+ + Grafico 'Line Chart' sull'occupazione di banda: + +
+ Esempio di report grafico di andamento temporale (Line Chart sull’occupazione di + banda) + + + + + + + + +
+ Grafico 'Line Chart' sul tempo medio di risposta: +
+ Esempio di report grafico di andamento temporale (Line Chart sul tempo medio di + risposta) + + + + + + + + +
+ Grafico 'Bar Chart' sul numero di transazioni: +
+ Esempio di report grafico di andamento temporale (Bar Chart sul numero di + transazioni) + + + + + + + + +
+ Grafico 'Bar Chart' sull'occupazione di banda: +
+ Esempio di report grafico di andamento temporale (Bar Chart sull’occupazione di + banda) + + + + + + + + +
+ Grafico 'Bar Chart' sul tempo medio di risposta: +
+ Esempio di report grafico di andamento temporale (Bar Chart sul tempo medio di + risposta) + + + + + + + + +
+ Tabella: +
+ Esempio di report tabellare di andamento temporale + + + + + + + + +
+ + + Distribuzione per Esito + Fornisce statistiche riguardo l'andamento delle transazioni sul periodo mantenendo la + suddivisione rispetto all'esito. Di seguito alcuni esempi di reports generabili. + Tabella: +
+ Esempio di Report di Distribuzione per Esiti in formato tabellare + + + + + + + + +
+ Grafico 'Bar Chart' sul numero di transazioni: +
+ Esempio di Report di Distribuzione per Esito (Bar Chart sul numero di + transazioni) + + + + + + + + +
+ Grafico 'Line Chart' sul numero di transazioni: +
+ Esempio di Report di Distribuzione per Esito (Line Chart sul numero di + transazioni) + + + + + + + + +
+ + + Distribuzione per Soggetto Locale + Questo report, disponibile se attiva la modalità multi-tenant, mostra come si + distribuiscono le transazioni registrate dal gateway sui soggetti locali. Di seguito + alcuni esempi di reports generabili. + Tabella: +
+ Esempio di report tabellare di distribuzione per soggetto locale + + + + + + + + +
+ + Grafico 'Pie Chart' sul numero di transazioni: +
+ Esempio di report grafico di distribuzione per soggetto locale (Pie Chart sul + numero di transazioni) + + + + + + + + +
+ + Grafico 'Bar Chart' sul numero di transazioni: + +
+ Esempio di report grafico di distribuzione per soggetto locale (Bar Chart sul + numero di transazioni) + + + + + + + + +
+ + + Distribuzione per Soggetto Remoto + Questo report mostra come si distribuiscono le transazioni registrate dal gateway sui + soggetti remoti (gli interlocutori dei soggetti locali). Di seguito alcuni esempi di + reports generabili. + Tabella: +
+ Esempio di report tabellare di distribuzione per soggetto remoto + + + + + + + + +
+ + Grafico 'Pie Chart' sul numero di transazioni: +
+ Esempio di Report di Distribuzione per Soggetto Remoto (Pie Chart sul numero di + transazioni) + + + + + + + + +
+ + + Distribuzione per API + Fornisce informazioni sulla ripartizione delle richieste Da/Per le API. Di seguito + alcuni esempi di reports generabili. + Tabella: +
+ Esempio di report tabellare di distribuzione per API + + + + + + + + +
+ + Grafico 'Pie Chart' sul numero di transazioni: + +
+ Esempio di report grafico di distribuzione per API (Pie Chart sul numero di + transazioni) + + + + + + + + +
+ + Grafico 'Bar Chart' sul tempo medio di risposta: + +
+ Esempio di report grafico di distribuzione per API (Bar Chart sul tempo medio di + risposta) + + + + + + + + +
+ + + Distribuzione per Azione + Fornisce informazioni sulla ripartizione delle richieste Da/Per Azioni/Risorse. Di + seguito alcuni esempi di reports generabili. + Tabella: +
+ Esempio di report tabellare di distribuzione per azione + + + + + + + + +
+ + Grafico 'Bar Chart' sul numero di transazioni: + +
+ Esempio di report grafico di distribuzione per azione (Bar Chart sul numero di + transazioni) + + + + + + + + +
+ + + Distribuzione per Applicativo + Fornisce statistiche sulle transazioni sulla base della loro ripartizione tra gli + applicativi dei soggetti interni al dominio GovWay che hanno inviato le richieste (di + fruizione o erogazione). + Di seguito alcuni esempi di report generabili. + Tabella: +
+ Esempio di report tabellare di distribuzione per applicativo + + + + + + + + +
+ Grafico 'Pie Chart' sul numero di transazioni: +
+ Esempio di report grafico di distribuzione per applicativo (Pie Chart sul numero di + transazioni) + + + + + + + + +
+ + + Distribuzione per Identificativo Autenticato + Fornisce statistiche sulle transazioni sulla base della loro ripartizione tra gli + identificativi degli utenti rilevati con il processo di autenticazione (principal, + username, ecc). + + + Distribuzione per Token Info + Fornisce statistiche sulle transazioni sulla base della loro ripartizione rispetto ai + valori assunti da uno specifico claim estratto dai token ottenuti in fase di + autenticazione (issuer, username, eMail, ecc). + + + + Report Configurazione API + Questo report consente di avere un quadro di sintesi riguardo le API configurate nel + registro di GovWay tramite la govwayConsole (api, erogazioni, fruizioni, applicativi, ecc). + Per accedere alla funzionalità si deve selezionare la voce 'Configurazione API' all'interno + della sezione 'Reportistica'. + La funzionalità fornisce immediatamente un prospetto di conteggio degli elementi di + configurazione presenti nel registro di GovWay () all'interno della sezione 'Informazioni + Generali'. Tale sezione è suddivisa nelle seguenti due parti: + + + API: fornisce informazioni relative alle API configurate. + + + API + + + Erogazioni + + + Fruizioni + + + + + Registro: + + + Soggetti Operativi + + + Soggetti Esterni + + + Applicativi + + + + +
+ Report sulle configurazioni dei servizi presenti nel registro GovWay + + + + + + + + +
+ Oltre ad un prospetto riepilogativo del numero di configurazioni attive è possibile + effettuare una ricerca di tali configurazioni al fine di esportarne i dettagli. Per poter + effettuare la ricerca devono essere definiti i criteri di tale ricerca agendo sul filtro. + I dati presenti nel filtro sono i seguenti: + + + Filtro Dati API + + + + Tipologia: indica se si desidera ricercare + configurazioni relative a fruizioni o erogazioni; + + + + Profilo Interoperabilità: permette di filtrare le + transazioni in base al profilo di interoperabilità; + + + + Soggetto: permette di filtrare rispetto al + soggetto locale, tra quelli in gestione; + + + + API: permette di filtrare su una specifica API, + individuata tramite il pattern 'API_nome:API_versione (Soggetto)'. + + + + + La sezione nel filtro di un determinato soggetto comporta l'aggiornamento del prospetto + riepilogativo del numero di configurazioni della sezione 'API' aggiornano i contatori + relativamente alle API di competenza del soggetto selezionato (). +
+ Prospetto riepilogativo con soggetto selezionato + + + + + + + + +
+ La selezione di una API nel filtro comporta l'aggiornamento del prospetto riepilogativo + del numero di configurazioni della sezione 'API' aggiornando i contatori relativamente alla + API selezionata (). Con la selezione della + API, tra le informazioni riportate vi sono anche il numero di azioni/risorse presenti. +
+ Prospetto riepilogativo con API selezionata + + + + + + + + +
+ Gli elementi di configurazione mostrati in elenco possono essere selezionati ed + esportati in formato CSV tramite il pulsante "Esporta". + + +
diff --git a/resources/doc/src/manualeMonitoraggio/cover/cover.pdf b/resources/doc/src/manualeMonitoraggio/cover/cover.pdf new file mode 100644 index 0000000000..825b7b4c39 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/cover/cover.pdf differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporale.png b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporale.png new file mode 100644 index 0000000000..922788c511 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporale.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBanda.png b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBanda.png new file mode 100644 index 0000000000..2f888b1128 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBanda.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBar.png b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBar.png new file mode 100644 index 0000000000..ba85d4ede5 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBar.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBarBanda.png b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBarBanda.png new file mode 100644 index 0000000000..f7bf431a5c Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBarBanda.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBarTempoMedio.png b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBarTempoMedio.png new file mode 100644 index 0000000000..1151bc0eee Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleBarTempoMedio.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleTabella.png b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleTabella.png new file mode 100644 index 0000000000..c2b6100716 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleTabella.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleTempoMedio.png b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleTempoMedio.png new file mode 100644 index 0000000000..1c2ba756b2 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/AndamentoTemporaleTempoMedio.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Avanzate.png b/resources/doc/src/manualeMonitoraggio/figure/Avanzate.png new file mode 100644 index 0000000000..28e7785add Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Avanzate.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Colonne.jpg b/resources/doc/src/manualeMonitoraggio/figure/Colonne.jpg new file mode 100644 index 0000000000..f351434119 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Colonne.jpg differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Colonne.png b/resources/doc/src/manualeMonitoraggio/figure/Colonne.png new file mode 100644 index 0000000000..f351434119 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Colonne.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/ColonneDopo.png b/resources/doc/src/manualeMonitoraggio/figure/ColonneDopo.png new file mode 100644 index 0000000000..5dcdcde2ef Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/ColonneDopo.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/ColonnePrima.png b/resources/doc/src/manualeMonitoraggio/figure/ColonnePrima.png new file mode 100644 index 0000000000..82677c4eb6 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/ColonnePrima.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Contenuti.png b/resources/doc/src/manualeMonitoraggio/figure/Contenuti.png new file mode 100644 index 0000000000..65df1bf333 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Contenuti.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Diagnostici.png b/resources/doc/src/manualeMonitoraggio/figure/Diagnostici.png new file mode 100644 index 0000000000..1c1a9a9ec9 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Diagnostici.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAPIBar.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAPIBar.png new file mode 100644 index 0000000000..4bc1c21d0a Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAPIBar.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAPIPie.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAPIPie.png new file mode 100644 index 0000000000..fb7ea2b2f8 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAPIPie.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAPITabella.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAPITabella.png new file mode 100644 index 0000000000..d9e59281c6 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAPITabella.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneApplicativoPie.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneApplicativoPie.png new file mode 100644 index 0000000000..265be507eb Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneApplicativoPie.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneApplicativoTabella.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneApplicativoTabella.png new file mode 100644 index 0000000000..76dafc23b5 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneApplicativoTabella.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAzioneBar.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAzioneBar.png new file mode 100644 index 0000000000..d227ea5547 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAzioneBar.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAzioneTabella.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAzioneTabella.png new file mode 100644 index 0000000000..5292ee77a9 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneAzioneTabella.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneEsitoBar.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneEsitoBar.png new file mode 100644 index 0000000000..27ef037927 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneEsitoBar.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneEsitoLine.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneEsitoLine.png new file mode 100644 index 0000000000..82476d6aeb Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneEsitoLine.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneEsitoTabella.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneEsitoTabella.png new file mode 100644 index 0000000000..eb5188a16b Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneEsitoTabella.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoBar.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoBar.png new file mode 100644 index 0000000000..771d65a00a Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoBar.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoPie.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoPie.png new file mode 100644 index 0000000000..5c32113fdc Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoPie.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoRemotoPie.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoRemotoPie.png new file mode 100644 index 0000000000..bbe63e38e8 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoRemotoPie.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoRemotoTabella.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoRemotoTabella.png new file mode 100644 index 0000000000..4d79baff00 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoRemotoTabella.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoTabella.png b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoTabella.png new file mode 100644 index 0000000000..970d1284a2 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/DistribuzioneSoggettoTabella.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/ElencoTransazioni.png b/resources/doc/src/manualeMonitoraggio/figure/ElencoTransazioni.png new file mode 100644 index 0000000000..c4d67d4ada Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/ElencoTransazioni.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/EsportaCSV.png b/resources/doc/src/manualeMonitoraggio/figure/EsportaCSV.png new file mode 100644 index 0000000000..cc2d98ef27 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/EsportaCSV.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/EsportaTransazioni.png b/resources/doc/src/manualeMonitoraggio/figure/EsportaTransazioni.png new file mode 100644 index 0000000000..ab17d1160d Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/EsportaTransazioni.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Eventi.png b/resources/doc/src/manualeMonitoraggio/figure/Eventi.png new file mode 100644 index 0000000000..3ac26f1828 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Eventi.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Fault.png b/resources/doc/src/manualeMonitoraggio/figure/Fault.png new file mode 100644 index 0000000000..083a6faa27 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Fault.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/FiltroIdentificativoApplicativo.png b/resources/doc/src/manualeMonitoraggio/figure/FiltroIdentificativoApplicativo.png new file mode 100644 index 0000000000..067dd74e34 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/FiltroIdentificativoApplicativo.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/FiltroIdentificativoMessaggio.png b/resources/doc/src/manualeMonitoraggio/figure/FiltroIdentificativoMessaggio.png new file mode 100644 index 0000000000..8849058c23 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/FiltroIdentificativoMessaggio.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/FiltroIdentificativoTransazione.png b/resources/doc/src/manualeMonitoraggio/figure/FiltroIdentificativoTransazione.png new file mode 100644 index 0000000000..fa0f7da1d4 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/FiltroIdentificativoTransazione.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/FiltroIntervalloTemporale.png b/resources/doc/src/manualeMonitoraggio/figure/FiltroIntervalloTemporale.png new file mode 100644 index 0000000000..7236a673ab Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/FiltroIntervalloTemporale.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/FiltroLive.png b/resources/doc/src/manualeMonitoraggio/figure/FiltroLive.png new file mode 100644 index 0000000000..0d1409a11f Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/FiltroLive.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/FiltroReportConfigurazioni.png b/resources/doc/src/manualeMonitoraggio/figure/FiltroReportConfigurazioni.png new file mode 100644 index 0000000000..131b60b4ab Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/FiltroReportConfigurazioni.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/FiltroStatistiche.png b/resources/doc/src/manualeMonitoraggio/figure/FiltroStatistiche.png new file mode 100644 index 0000000000..6490d7e588 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/FiltroStatistiche.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Homepage.png b/resources/doc/src/manualeMonitoraggio/figure/Homepage.png new file mode 100644 index 0000000000..16b4657b35 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Homepage.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/IndiceStorico.png b/resources/doc/src/manualeMonitoraggio/figure/IndiceStorico.png new file mode 100644 index 0000000000..cff1b18fb1 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/IndiceStorico.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Info.png b/resources/doc/src/manualeMonitoraggio/figure/Info.png new file mode 100644 index 0000000000..6506f4c5cb Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Info.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Live.png b/resources/doc/src/manualeMonitoraggio/figure/Live.png new file mode 100644 index 0000000000..267b59d06a Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Live.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Login.png b/resources/doc/src/manualeMonitoraggio/figure/Login.png new file mode 100644 index 0000000000..9500a601e0 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Login.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/ProfiloUtente.png b/resources/doc/src/manualeMonitoraggio/figure/ProfiloUtente.png new file mode 100644 index 0000000000..4959142d03 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/ProfiloUtente.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/ReportConfigurazioniAPI.png b/resources/doc/src/manualeMonitoraggio/figure/ReportConfigurazioniAPI.png new file mode 100644 index 0000000000..0b768181f0 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/ReportConfigurazioniAPI.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/ReportConfigurazioniSoggetto.png b/resources/doc/src/manualeMonitoraggio/figure/ReportConfigurazioniSoggetto.png new file mode 100644 index 0000000000..89cea29e55 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/ReportConfigurazioniSoggetto.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Statistiche.png b/resources/doc/src/manualeMonitoraggio/figure/Statistiche.png new file mode 100644 index 0000000000..4b315bf8bb Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Statistiche.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Stato.png b/resources/doc/src/manualeMonitoraggio/figure/Stato.png new file mode 100644 index 0000000000..f58e840f68 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Stato.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Testata.png b/resources/doc/src/manualeMonitoraggio/figure/Testata.png new file mode 100644 index 0000000000..9494e7f283 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Testata.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/Traccia.png b/resources/doc/src/manualeMonitoraggio/figure/Traccia.png new file mode 100644 index 0000000000..a0d0301afa Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/Traccia.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/TransazioneErrore.png b/resources/doc/src/manualeMonitoraggio/figure/TransazioneErrore.png new file mode 100644 index 0000000000..5a4e02ab42 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/TransazioneErrore.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/TransazioneFault.png b/resources/doc/src/manualeMonitoraggio/figure/TransazioneFault.png new file mode 100644 index 0000000000..1122fd58e2 Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/TransazioneFault.png differ diff --git a/resources/doc/src/manualeMonitoraggio/figure/TransazioneOK.png b/resources/doc/src/manualeMonitoraggio/figure/TransazioneOK.png new file mode 100644 index 0000000000..c411b35d9c Binary files /dev/null and b/resources/doc/src/manualeMonitoraggio/figure/TransazioneOK.png differ diff --git a/resources/doc/src/manualeUtente/Makefile b/resources/doc/src/manualeUtente/Makefile new file mode 100644 index 0000000000..4ea369784e --- /dev/null +++ b/resources/doc/src/manualeUtente/Makefile @@ -0,0 +1,5 @@ +include ../core/makefile/env +include ../core/makefile/commons + +SOURCE_NAME=ManualeUtente +SOURCE_FILE=${SOURCE_NAME}.xml diff --git a/resources/doc/src/manualeUtente/ManualeUtente.xml b/resources/doc/src/manualeUtente/ManualeUtente.xml new file mode 100644 index 0000000000..6643fba5ec --- /dev/null +++ b/resources/doc/src/manualeUtente/ManualeUtente.xml @@ -0,0 +1,9801 @@ + + +
+ + Guida Utente della govwayConsole + + Guida Utente della govwayConsole + + + 2005-2018 + + + + Link.it srl + + + + +
Link.it SRL Via S. Martino,51 + I-56125 Pisa + ITALY + e-mail: info@link.it +
+ + + + + + Introduzione + + Questo manuale documenta le funzionalità e le modalità d'uso della Console + di Gestione del prodotto GovWay (http://gowway.org). + + Oltre alla console di Gestione, GowWay mette a disposizione dei gestori una + seconda console utilizzata per il monitoraggio delle richieste applicative gestite + dal gateway. Per informazioni sulle modalità di utilizzo della Console di + Monitoraggio si rimanda alla relativa manualistica distribuita con il prodotto. + + + + Nel prosieguo si assume che il prodotto GovWay sia già correttamente installato e la + console di gestione sia accessibile via browser dai Gestori del Sistema. + L'indirizzo standard della Console di Gestione è + http://ip:porta/govwayConsole, che dovrà essere correttamente + perfezionato con ip e porta del proprio ambiente di installazione. Per informazioni + sulle modalità di installazione si rimanda alla relativa manualistica distribuita con il + prodotto. + + L'accesso alle diverse funzionalità della console è sempre mediato da un sistema + di autorizzazione che verifica che l'utente sia in possesso dei dovuti permessi. Le + istruzioni operative sulla gestione degli utenti e la configurazione dei permessi + sono descritte nella . + + + + I Profili di Interoperabilità + GovWay si differenzia dagli API Gateway tradizionali per essere progettato in + conformità con i principali profili di interoperabilità in uso nella Pubblica + Amministrazione italiana ed europea. Per tale motivo, le modalità di configurazione + del prodotto si differenziano in funzione dello specifico profilo a cui le API + debbano conformarsi. I profili di interoperabilità supportati dalla distribuzione + standard del prodotto sono i seguenti: + + API Gateway: è il profilo più generico e permette + di supportare, in accordo alle linee guida di interoperabilità di AGID, + qualunque generica API basata su scambio di messaggi SOAP e REST. + + + eDelivery: è il profilo standard adottato a + livello europeo nell'ambito del progetto CEF, e + basato sul protocollo AS4. + + + SPCoop: il profilo SPCoop è il profilo basato + sull'uso della busta eGov e sulla Porta di Dominio, recentemente + deprecato da AGID, ma ancora in uso per la quasi totalità dei servizi + centrali erogati dalla Pubblica Amministrazione italiana. + + + FatturaPA: questo profilo supporta le modalità di + scambio delle fatture elettroniche veicolate tramite il Sistema di + Interscambio della Fatturazione Elettronica. + + + + + In fase di installazione possono essere scelti i profili di proprio interesse + (per default viene proposto il solo profilo di API Gateway). + Durante l'utilizzo della Console di Gestione è preferibile selezionare il profilo + di interoperabilità adeguato in base al tipo di configurazioni sui quali si lavora. + La selezione del profilo di interoperabilità, tramite il menu presente in testata + (), comporta la visualizzazione dei soli elementi + dell'interfaccia, e relativi dati, attinenti con tale profilo.
+ Selezione del profilo di interoperabilità + + + + + + + + +
+ + Esiste la possibilità (non consigliata) di operare sulla console selezionando il + profilo Tutti. In tal caso non saranno applicati filtri sui + contenuti e le maschere di visualizzazione e di configurazione potranno apparire più + complesse di quanto avviene selezionando lo specifico profilo su cui si sta + lavorando. + + + Ulteriori profili sono programmabili in GovWay ed alcuni di questi sono in + uso in importanti progetti della pubblica amministrazione, come la Porta di + Comunicazione del Sistema di Interscambio del Mercato dell'Energia. + + + + + Le entità di configurazione dei servizi + Prima di descrivere le entità di configurazione presenti nel registro è importante + chiarire il concetto di Dominio cui alcuni elementi di + configurazione fanno riferimento. Il dominio rappresenta il confine logico + (tipicamente un ente amministrativo) entro il quale sono racchiuse le risorse + applicative da condividere con l'esterno. Nel seguito si fa distinzione tra i + seguenti: + + Dominio Gestito: l'insieme delle risorse + applicative i cui flussi di comunicazione sono sotto il controllo del + GovWay di propria gestione. + + + Dominio Esterno: Insieme di risorse applicative + esterne al dominio gestito. + + Le principali entità di configurazione del Registro sono: + + + Soggetto + + Entità che rappresenta la singola organizzazione, o ente + amministrativo, coinvolto nei flussi di comunicazione. Ciascun soggetto + censito nel registro può appartenere al dominio interno o esterno e può + avere associata un'unica modalità operativa. + + + + API + + Descrizione formale dei flussi di comunicazione previsti da un dato + servizio, erogato o fruito nel proprio dominio. Ad ogni API è assegnata + una singola modalità operativa e, in base ad essa, sarà fornita una + descrizione formale delle interfacce di dialogo supportate. Ad esempio + saranno forniti WSDL/XSD per le interfacce Soap o un file YAML in + formato Swagger per quelle Rest. + + + + Erogazione + + Registrazione di una specifica istanza di servizio che un soggetto + del dominio interno eroga in accordo alle interfacce applicative + descritte da un set di API censito nel registro. + + + + Fruizione + + Registrazione di una specifica istanza di servizio che un soggetto + del dominio interno fruisce in accordo alle interfacce applicative + descritte da un set di API censito nel registro. + + + + Ruolo + + Entità per censire i ruoli che possono essere utilizzati nell'ambito + del controllo degli accessi per costruire specifici criteri di + autorizzazione. I ruoli possono avere origine interna al registro oppure + essere passati da un sistema esterno, sia in contesti fruizione che di + erogazione. + + + + Applicativo + + Entità per censire i client, riferiti ad uno specifico soggetto (e + quindi modalità), che fruiscono di servizi. Censire un applicativo è + indispensabile nei casi in cui l'identificazione è necessaria per poter + superare i criteri di autenticazione autorizzazione specificati nella + configurazione del Controllo degli Accessi per + ciascun servizio fruito. + + + + + + Il processo di configurazione dei servizi + Le sezioni successive del documento illustrano i passi necessari per realizzare + le configurazioni necessarie per rendere operativi i flussi di erogazione/fruizione + dei servizi nei diversi profili di interoperabilità supportati. + Per semplificare il processo di configurazione, nel caso di configurazioni per + l'interoperabilità con le note piattaforme di erogazione di servizi centralizzate, + GovWay mette a disposizione specifici package, denominati + Govlet. Il Govlet, attraverso un modello di tipo wizard, + consente all'utente di fornire i dati necessari a produrre le entità di + configurazione per uno specifico servizio. I Govlet disponibili possono essere + acquisiti dal sito di Govway al seguente indirizzo http://www.govway.org/govlets. + Alcuni esempi di Govlet: + + + FatturaPA - Fatturazione Attiva: configurazione del + servizio per l'invio di fatture elettroniche al Sistema d'Interscambio + (SDI). + + + + FatturaPA - Fatturazione Passiva: configurazione + del servizio per la ricezione di fatture elettroniche dal Sistema + d'Interscambio (SDI). + + + + SIOPE+: configurazione del servizio per l'invio + degli ordinativi di pagamento alla piattaforma SIOPE+ e ricezione delle + relative notifiche e giornale di cassa. + + + + pagoPA: configurazione del servizio per l'accesso + alla piattaforma dei pagamenti elettronici pagoPA. + + + + Una volta entrati in possesso del Govlet è necessario eseguirlo sulla + govwayConsole tramite la funzione Importa descritta nella . + Per procedere manualmente alla produzione delle configurazioni per i servizi, si + utilizzano le funzionalità presenti nella sezione Registro + della GovWayConsole. Il processo manuale di configurazione può essere schematizzato + nei passi seguenti: + + + Definizione delle API. Il primo passo prevede la + definizione delle API relative ai servizi che si vogliono utilizzare. In + questa fase tipicamente si provvede al caricamento del descrittore + formale delle interfacce (WSDL, WADL, ...). + + + + Registrazione dell'erogazione o fruizione. Il + secondo passo, dopo aver registrato l'API del servizio, prevede la + creazione di una Erogazione, o di una Fruizione, a seconda del ruolo + previsto nell'interazione col servizio. + + + + Configurazione Specifica. Le interfacce della + GovWayConsole sono state progettate in modo che, il completamento dei + primi due passi di configurazione, sia sufficiente a disporre di una + configurazione funzionante del servizio. Il terzo, e quindi opzionale + passo, consiste nella produzione di tutti i dettaglio aggiuntivi di + configurazione che sono necessari alla particolare situazione. + In questo passo si forniscono i dettagli delle funzionalità + aggiuntive, che riguardano: + + + Controllo degli Accessi: indicazione + dei criteri di autenticazione e autorizzazione necessari per + l'accesso al servizio. + + + + Validazione: processo di validazione + dei messaggi in transito sul gateway. + + + + Sicurezza Messaggio: misure di + sicurezza al livello del messaggio richieste. + + + + Tracciamento: personalizzazione delle + tracce prodotte nel corso dell'elaborazione delle richieste + di servizio. + + + + Registrazione Messaggi: indicazione dei + criteri di salvataggio degli elementi che compongono le + richieste di servizio (payload, header, allegati, ...). + + + + + + + + La descrive lo scenario generale in cui + opera GovWay
+ Fasi dell'elaborazione di una richiesta + + + + + + + + +
+ + La sezioni successive descrivono in dettaglio il processo di configurazione di + cui sopra, fornendo i dettagli specifici per ciascun profilo di interoperabilità. + + + + + + + + + Profilo "API Gateway" + In questa sezione descriviamo le fasi di configurazione di GovWay al fine di attivare + l'erogazione o la fruizione di servizi che rispettano lo standard Soap o Rest. Per + semplificare l'utilizzo della console grafica govwayConsole, è consigliabile effettuare + la selezione del profilo API Gateway tramite l'apposito selettore + posto nell'intestazione della pagina. + + + Definizione delle API + Indipendentemente che si voglia erogare o fruire un servizio, è necessario + iniziare il processo di configurazione con il censimento delle relative API. Questa + operazione si effettua sulla govwayConsole posizionandosi nella sezione + Registro > API. + La pagina di ingresso mostra l'elenco delle API eventualmente già presenti in + configurazione. Ciascun elemento dell'elenco riporta l'identificativo, il tipo SOAP + o REST e il formato del descrittore fornito in configurazione ().
+ Elenco delle API + + + + + + + + +
+ + Gli elementi dell'elenco possono essere selezionati per l'eliminazione, con il + pulsante Elimina, e per l'esportazione, con il pulsante Esporta. La funzione di + esportazione è descritta nella . + + Le API in elenco sono visualizzate con un'icona colorata affiancata al nome. + L'icona di colore rosso indica un problema nella configurazione e quindi + l'inutilizzabilità della API. L'icona gialla indica il parziale utilizzo + limitato agli elementi configurati correttamente. L'icona verde indica la piena + funzionalità. + + Si crea una nuova API premendo il pulsante Aggiungi. +
+ Definizione di una API + + + + + + + + +
+ Compilare il form () inserendo i seguenti dati: + + + Tipo: Selezionare il tipo delle API a scelta tra + "Soap" e "Rest". + + + + Nome: Assegnare un nome che identifichi le API. + + + + + Descrizione: un testo opzionale di descrizione. + + + + + Versione: progressivo numerico che identifica + l'indice di revisione. + + + + Specifica delle Interfacce: In questa sezione è + possibile caricare il descrittore formale dell'interfaccia, analizzando + il quale, il gateway produce la corrispondente configurazione. Nel caso + di interfacce Soap si potrà caricare il relativo WSDL. Nel caso di + interfacce Rest si potrà scegliere tra i formati: WADL, Swagger 2.0 e + OpenAPI 3.0. + Nel caso non si disponga del descrittore dell'interfaccia è sempre + possibile inserire manualmente la relativa configurazione seguendo le + modalità descritte alla . + + + + + + + Registrazione dell'erogazione + Una volta disponibile la definizione delle API, si passa alla registrazione + dell'erogazione fornendo i dati di base per l'esposizione del servizio erogato + tramite GovWay. In è illustrato + graficamente il caso dell'erogazione.
+ Scenario di riferimento per l'erogazione + + + + + + + + +
+ + Per registrare l'erogazione del servizio ci si posiziona nella sezione + Registro > Erogazioni e si preme il pulsante + Aggiungi. +
+ Registrazione di una Erogazione + + + + + + + + +
+ Compilare il form () inserendo i seguenti + dati: + + API - Nome: Selezionare dall'elenco il nome e la + versione relativa alla API cui l'erogazione fa riferimento. Se la API + selezionata è di tipo Soap, sarà necessario selezionare anche il + Servizio che si vuole erogare. + + + + Autenticazione: In questa sezione è possibile + configurare il meccanismo di autenticazione richiesto per l'accesso al + servizio da parte dei fruitori. Il valore di default proposto prevede + l'autenticazione di tipo https. + Come mostrato in , è possibile + selezionare il tipo di autenticazione a livello del trasporto, + selezionando uno tra i valori disponibili: + + disabilitato: nessuna + autenticazione + + + ssl: autenticazione ssl + + + basic: autenticazione + http-basic + + + principal: autenticazione + sull'application server con identificazione tramite + principal + + + custom: metodo di autenticazione + fornito tramite estensione di GovWay + + + + Il flag Opzionale consente di non rendere + bloccante il superamento dell'autenticazione per l'accesso al servizio. + + + + Connettore: In questa sezione devono essere + specificati i riferimenti al servizio, al fine di rendere possibile il + corretto instradamento delle richieste inviate dai soggetti fruitori. + Questo connettore riferisce il servizio del dominio interno che si sta + erogando. + Le informazioni da fornire sono: + + Endpoint: la url per la consegna + delle richieste al servizio. + + + Autenticazione Http: credenziali da + fornire nel caso in cui il servizio richieda autenticazione + di tipo HTTP-BASIC. + + + Autenticazione Https: credenziali da + fornire nel caso in cui il servizio richieda autenticazione + di tipo HTTPS. + + + Proxy: nel caso in cui l'endpoint del + servizio sia raggiungibile solo attraverso un proxy, possono + essere indicati qui i relativi riferimenti. + + + Ridefinisci Tempi Risposta: permette + di ridefinire i tempi di risposta che sono stati configurati + a livello generale, nell'ambito del controllo del traffico + (vedi ) + + + + + + + + Completamento configurazione e indirizzamento del servizio + Dopo aver definito le API e registrato la relativa erogazione, come descritto + nelle sezioni precedenti, si dispone della configurazione di un servizio erogato + i cui riferimenti possono essere comunicati ai fruitori. + Per aggiungere ulteriori dettagli di configurazione, o semplicemente per + conoscere il giusto endpoint cui il fruitore deve indirizzare le richieste, si + procede dalla pagina di dettaglio dell'erogazione già creata. Il dettaglio + dell'erogazione si raggiunge andando alla sezione del menu Registro > + Erogazioni, cliccando sull'elemento visualizzato nell'elenco + delle erogazioni presenti nel registro (). +
+ Elenco Erogazioni presenti nel registro + + + + + + + + +
+ + + Le erogazioni in elenco sono visualizzate con un'icona colorata + affiancata al nome. L'icona di colore rosso indica che l'erogazione è + disabilitata. L'icona di colore giallo indica che solo alcuni gruppi di + risorse/azioni sono abilitati all'uso. L'icona verde indica lo stato + abilitato. + + Per la ricerca dell'elemento nell'elenco delle erogazioni è possibile + filtrare i dati visualizzati tramite la maschera di filtro che compare cliccando + sulla voce Erogazioni nell'intestazione dell'elenco ().
+ Filtro delle Erogazioni presenti nel registro + + + + + + + + +
+ + Il dettaglio dell'erogazione mostra i dati principali e con le icone "matita" + è possibile entrare sulle maschere di editing per effettuare delle modifiche. In + corrispondenza della API riferita, è possibile accedere al relativo dettaglio + aprendo un nuovo tab del browser (). +
+ Dettaglio dell'erogazione + + + + + + + + +
+ + La pagina di dettaglio dell'erogazione comprende inoltre i seguenti elementi: + + + Gestione Configurazione: link per accedere alla + configurazione specifica per l'aggiunta di ulteriori funzionalità + all'erogazione (vedi ). + + + + Gestione Gruppi Risorse/Azioni: link per + differenziare la configurazione specifica sulla base di diversi + gruppi di azioni/risorse, come meglio spiegato alla . + + + + Dal dettaglio dell'erogazione si ricava il valore URL + Invocazione che rappresenta l'endpoint da comunicare ai fruitori + per contattare il servizio. Questo dato rappresenta la URL + del servizio nel caso Soap o la Base URL nel caso Rest. + Per la selezione dell'operazione da invocare si distinguono i seguenti casi: + + + REST: Indipendentemente che l'API sia stata + configurata fornendo il relativo descrittore, WADL o OpenAPI, + l'identificazione dell'operation sarà sempre effettuata in + automatico dal contesto di invocazione. Non è quindi necessario + fornire ulteriori indicazioni. + + + + SOAP + + + + API con WSDL: l'operation viene + automaticamente identificata dal contesto di invocazione + grazie alle informazioni presenti nel descrittore. + + + + + API senza WSDL: l'operation viene + identificata inserendo il relativo identificativo nella + URL di invocazione + (<URL_Invocazione>/<Azione>). + Sono disponibili ulteriori metodi per + l'identificazione dell'operation nel caso SOAP, per i + cui dettagli si rimanda alla . + + + + + + + + + Condivisione dei dati di integrazione + Le richieste di erogazione, pervenute a GovWay, vengono elaborate e, nel + corso dell'operazione, vengono creati i riferimenti alle entità di + configurazione presenti nel registro. + GovWay comunica i dati di contesto ricavati, ai sistemi interlocutori, ed in + particolare: + + Tutti i dati dell'header di integrazione, relativi al messaggio + di richiesta, vengono inviati all'applicativo destinatario + (erogatore). I dati che compongono l'header di integrazione sono + quelli descritti nelle tabelle presenti alla . + + + Un sottoinsieme dell'header di integrazione, relativo al + messaggio di risposta, viene inviato al soggetto mittente + (fruitore). I dati inviati (sempre in riferimento alle tabelle della + ) sono: + + + GovWay-Message-ID + + + + + GovWay-Relates-To + + + + + GovWay-Conversation-ID + + + + + GovWay-Transaction-ID + + + + + + + + + + Errori Generati dal Gateway + La gestione dei casi di errore nelle comunicazioni mediate da un Gateway + devono tenere conto di ulteriori situazioni che possono presentarsi rispetto + alla situazione di dialogo diretto tra gli applicativi. Oltre agli errori + conosciuti dagli applicativi, e quindi previsti nei descrittori del servizio, + gli applicativi client possono ricevere ulteriori errori generati dal gateway. + Govway genera differenti errori a seconda se l'erogazione o la fruizione + riguarda una API di tipologia SOAP o REST. + + + REST: viene generato un oggetto + Problem Details come definito nella + specifica RFC 7807 (https://tools.ietf.org/html/rfc7807). Ulteriori + dettagli vengono descritti nella sezione . + + + + SOAP: viene generato un SOAPFault contenente un + actor (o role in SOAP 1.2) valorizzato con + http://govway.org/integration. + Nell'elemento fault string è presente il + dettaglio dell'errore mentre nell'elemento fault code + una codifica di tale errore. Ulteriori dettagli vengono + descritti nella sezione . + + + + + + + + + + + + Registrazione della fruizione + Nel processo di fruizione sono coinvolti i client (o applicativi) interni al + dominio che richiedono, tramite accesso sul gateway, un servizio erogato da un + soggetto di un dominio esterno. + In è illustrato graficamente il caso della + fruizione. +
+ Scenario di riferimento per la fruizione + + + + + + + + +
+ Analogamente a quanto descritto per le erogazioni, è possibile procedere con la + configurazione delle fruizioni accedendo alla sezione di menu Registro > + Fruizioni. + La configurazione delle fruizioni presenta maschere della GovWayConsole del tutto + analoghe al caso dell'erogazione. È quindi possibile seguire il processo di + configurazione attuando i medesimi passi, illustrati per le erogazioni, calandole + sul contesto delle fruizioni. + L'unica differenza, rispetto al processo di configurazione delle erogazioni, è + rappresentata dalla presenza del campo Soggetto Erogatore, da + selezionare come soggetto che eroga il servizio ().
+ Registrazione di una Fruizione + + + + + + + + +
+ + + Benché non vi siano differenze nelle modalità di configurazione del + Connettore, nel caso della fruizione questi consiste + nei dati di puntamento al servizio erogato sul dominio esterno. + + + Condivisione dei dati di integrazione + Le richieste di fruizione, pervenute a GovWay, vengono elaborate e, nel corso + dell'operazione, vengono creati i riferimenti alle entità di configurazione + presenti nel registro. + GovWay comunica i dati di contesto ricavati, ai sistemi interlocutori: + + + GovWay-Message-ID + + + + + GovWay-Relates-To + + + + + GovWay-Conversation-ID + + + + + GovWay-Transaction-ID + + + Per ulteriori dettagli si consiglia di consultare la sezione + . + + + Errori Generati dal Gateway + Analogamente a quanto descritto per le erogazioni, la gestione dei casi di + errore nelle comunicazioni mediate da un Gateway devono tenere conto di + ulteriori situazioni che possono presentarsi rispetto alla situazione di dialogo + diretto tra gli applicativi. Oltre agli errori conosciuti dagli applicativi, e + quindi previsti nei descrittori del servizio, gli applicativi client possono + ricevere ulteriori errori generati dal gateway. + Govway genera differenti errori a seconda se l'erogazione o la fruizione + riguarda una API di tipologia SOAP o REST. + + + REST: viene generato un oggetto + Problem Details come definito nella + specifica RFC 7807 (https://tools.ietf.org/html/rfc7807). Ulteriori + dettagli vengono descritti nella sezione . + + + + SOAP: viene generato un SOAPFault contenente un + actor (o role in SOAP 1.2) valorizzato con + http://govway.org/integration. + Nell'elemento fault string è presente il + dettaglio dell'errore mentre nell'elemento fault code + una codifica di tale errore. Ulteriori dettagli vengono + descritti nella sezione . + + + + + + + + + Configurazione Specifica + I passi di configurazione fin qui descritti, per la registrazione di erogazioni e + fruizioni, consentono di ottenere uno stato delle entità del registro pronto + all'utilizzo in numerose situazioni. + Nei casi in cui si abbia l'esigenza di aggiungere ulteriori elementi di + configurazione, sfruttando le ulteriori funzionalità messe a disposizione da GovWay, + si procede con le ulteriori configurazioni, disponibili a partire dall'erogazione o + fruizione già creata in precedenza accedendo tramite il link Gestione + Configurazione presente nel dettaglio dell'erogazione/fruizione. Le + sezioni successive descrivono le configurazioni specifiche attuabili nei vari + contesti. Tranne dove esplicitamente dichiarato, gli schemi di configurazione + descritti in seguito possono essere attuati sia sulle erogazioni che sulle + fruizioni. + + + Connettore + È possibile modificare le impostazioni del connettore al servizio + erogato/fruito (ad esempio per modificare l'endpoint o aggiungere il proxy) + seguendo il collegamento presente nella colonna Connettore + in corrispondenza della voce di erogazione/fruizione presente in elenco. I campi + del form sono uguali a quelli già descritti per la fase di creazione + dell'erogazione (). + + + Differenziare le configurazioni specifiche per risorsa/azione + Le configurazioni specifiche che andiamo a descrivere si possono differenziare + per sottoinsiemi delle azioni/risorse presenti nel servizio erogato/fruito. Il + sistema crea automaticamente una configurazione unica, valida per tutte le + azioni/risorse del servizio. Per intervenire su tale configurazione, o crearne + di nuove, sia accede al collegamento presente nella colonna + Configurazione, in corrispondenza della voce di + erogazione/fruizione in elenco. Le funzionalità di configurazione disponibili + per ciascun sottoinsieme di azioni/risorse sono raggruppabili in: + + Controllo Accessi: per configurare i criteri + di autenticazione, autorizzazione e gestione token delle richieste. + + + + Validazione: per configurare i criteri di + validazione dei messaggi in transito sul gateway. + + + Sicurezza Messaggio: per configurare le + misure di sicurezza applicate a livello del messaggio. + + + Tracciamento: per configurare specifiche + modalità di estrazione dati, dalle comunicazioni in transito, per + l'arricchimento della traccia prodotta. + + + MTOM: per configurare l'utilizzo del + protocollo ottimizzato per l'invio di attachment tra nodi + SOAP. + + + Registrazione Messaggi: consente di + ridefinire le politiche di archiviazione dei payload rispetto a + quanto previsto dalla configurazione di default (vedi ). + + + + Per creare un nuovo gruppo di configurazione, dopo aver seguito il + collegamento visualizza relativo all'erogazione/fruizione + selezionata, si preme il pulsante Aggiungi +
+ Aggiunta di un gruppo di configurazioni + + + + + + + + +
+ Compilare il form di creazione della nuova configurazione (): + + Azioni: selezionare dall'elenco le azioni + sulle quali si vuole abbia effetto la nuova configurazione. + + + Mode: effettuare la scelta tra + Eredita Da e Nuova. + Scegliendo la prima opzione, verrà creata una configurazione clone + di quella selezionata nell'elemento del form subito successivo + (Configurazione). Scegliendo la seconda opzione, si procederà alla + creazione di una nuova configurazione, specificando subito le + informazioni di Controllo degli Accessi e Connettore. + + + + + Dopo aver creato ulteriori configurazioni, si tenga presente che la + configurazione di default verrà applicata alle sole azioni per le quali non + è presente una regola di configurazione specifica. + + + È possibile disabilitare un'intera configurazione, senza la necessità di + eliminarla, utilizzando il collegamento presente nella colonna "Abilitato" + in corrispondenza dell'elemento di configurazione. Un successivo clic farà + tornare la configurazione nello stato abilitato. + + + + Controllo degli Accessi + Tramite questa funzionalità è possibile configurare i criteri di gestione + token, autenticazione e autorizzazione delle richieste in ingresso sul gateway. + Per aggiungere questa funzionalità si procede selezionando prima il + collegamento, presente nella colonna "Configurazione", relativo + all'erogazione/fruizione presente nell'elenco. Successivamente si utilizza il + collegamento, presente nella colonna "Controllo Accessi", relativamente alla + configurazione che si vuole modificare (). +
+ Controllo degli Accessi + + + + + + + + +
+ Le tre sezioni seguenti descrivono le modalità per configurare i tre aspetti + che compongono il controllo degli accessi. + + Gestione Token + Questa sezione consente di configurare il controllo degli accessi basato + su Bearer Token OAuth2. Facendo transitare lo stato su "abilitato" compare + l'elemento Policy (obbligatorio) per la selezione della + policy di gestione token che si vuole applicare. In questa lista a discesa + saranno visualizzate tutte le Token Policy che sono + state registrate in precedenza. Per le istruzioni sulla registrazione delle + Token Policy si faccia riferimento alla . + Una volta selezionata la policy compariranno sotto gli elementi per + stabilire le specifiche azioni da abilitare rispetto al totale di quelle + previste nella policy stessa ().
+ Configurazione della gestione token + + + + + + + + +
Supponendo che la policy copra tutti gli aspetti disponibili, le + opzioni configurabili sono le seguenti: + + + Token Opzionale: consente di non forzare i + richiedenti al passaggio del token, che rimane quindi + un'operazione opzionale. + + + + Introspection: consente di + abilitare/disabilitare l'operazione di Token Introspection, al + fine di validare il token ricevuto ed ottenere le + metainformazioni associate (ad esempio scope e riferimento al + possessore del token). Selezionando l'opzione + WarningOnly è possibile non rendere + bloccante l'evento di fallimento della validazione, ottenendo + come unico effetto l'emissione di un messaggio diagnostico di + segnalazione. + + + + User Info: consente di + abilitare/disabilitare l'operazione UserInfo al fine di ottenere + le informazioni di dettaglio dell'utente possessore del token. + Selezionando l'opzione WarningOnly è + possibile non rendere bloccante l'evento di fallimento della + validazione, ottenendo come unico effetto l'emissione di un + messaggio diagnostico di segnalazione. + + + + Token Forward: consente di + abilitare/disabilitare l'operazione di inoltro, al servizio + destinatario, del token ricevuto dal mittente. + + Le azioni che sono state abilitate saranno effettuate in + accordo a quanto configurato nella relativa Token Policy selezionata. + È disponibile la Token Policy Google + preconfigurata in modo da utilizzare i servizi di elaborazione token + esposti pubblicamente da Google e quindi: + + La Validazione JWT basata su Google - ID + Token + + + Il servizio di token introspection basato su + Google - TokenInfo + + + Il servizio di User Info basato su Google - + UserInfo + + + + + + + + Autenticazione + In questa sezione è possibile configurare il meccanismo di autenticazione + richiesto per l'accesso al servizio. Come mostrato in , si possono specificare: + + Il tipo di autenticazione, per il quale si procede come già + descritto per l'attività di creazione dell'erogazione nella + . + + + Se è stata attivata, al passo precedente, la gestione del + token sarà possibile aggiungere ulteriori criteri di + autenticazione basati sul contenuto del token ricevuto. In tal + caso è possibile autenticare la richiesta sulla base delle + seguenti metainformazioni presenti nel token: Issuer, ClientId, + Subject, Username, Email. + + i criteri di autenticazione possono essere attuati sia a + livello del trasporto che del token (se abilitata la gestione del token al + passo precedente).
+ Configurazione dell'autenticazione del servizio + + + + + + + + +
+ + + + Autorizzazione + L'autorizzazione è un ulteriore meccanismo per il controllo degli accessi + tramite il quale è possibile specificare con maggior dettaglio le richieste + che sono in grado di essere accettate per l'accesso al servizio. + I meccanismi supportati, per specificare i criteri di autorizzazione, sono + i seguenti: + + + Autorizzazione Puntuale: superato il + processo di autenticazione, saranno accettate le sole richieste + provenienti dai mittenti indicati singolarmente nella lista + fornita con il criterio. Dopo aver abilitato questa opzione, ed + aver confermato tramite il pulsante Invia, sarà possibile + fornire la lista dei mittenti autorizzati ad accedere al + servizio. + I mittenti che possono essere indicati sono Soggetti (solo + nel caso delle erogazioni) e Applicativi. Tali entità dovranno + essere precedentemente registrate sulla govwayConsole seguendo + le indicazioni fornite in e in . + + L'opzione di autorizzazione sui soggetti è disponibile + solo se è stata attivata l'autenticazione. + + + L'opzione di autorizzazione sugli applicativi, nel caso + di una erogazione, viene utilizzata per gestire l'accesso al + servizio da parte di applicativi interni al dominio di + GovWay. + + + + + Autorizzazione per Ruoli: consente di + concedere l'autorizzazione per il servizio solo ai richiedenti + in possesso di determinati ruoli nel proprio profilo. Dopo aver + barrato questa opzione, ed aver confermato tramite il pulsante + Invia, sarà possibile fornire una lista dei ruoli che devono + essere posseduti dal chiamante per poter accedere al servizio. + In particolare si dovrà anche specificare la + fonte di provenienza dei ruoli, che può + essere esterna, cioè proveniente dal + sistema che ha autenticato il chiamante, oppure + registro, cioè i ruoli che sono stati + censiti nel registro di GovWay e assegnati al soggetto + chiamante. Inoltre si deve scegliere l'opzione Ruoli + Richiesti per indicare se, in presenza di più di + un ruolo come criterio, il chiamante deve possedere "tutti" i + ruoli indicati o "almeno uno". + Per le indicazioni sul censimento dei ruoli fare riferimento + alla . + + + + Autorizzazione per Scope: criterio di + autorizzazione che verifica la corrispondenza tra gli scope + indicati e quelli estratti dal token presente nella richiesta + ricevuta. Una volta attivata l'opzione si deve effettuare una + scelta per l'elemento Scope Richiesti, tra + i valori "tutti" (tutti gli scope indicati devono essere + presenti nel token per superare l'autorizzazione) e "almeno uno" + (è richiesta la presenza di almeno uno scope tra quelli indicati + nella policy di autorizzazione). Dopo aver confermato la scelta + con il pulsante "Invia" verrà richiesto di inserire gli scope + tra quelli già censiti ed abilitati per l'uso nei contesti di + erogazione (o qualsiasi contesto). + + L'opzione di autorizzazione basata sugli scope è + disponibile solo se è stata preventivamente attivata la + Gestione Token e selezionata la relativa policy. + + + + + Autorizzazione per Token Claims: Se è stata + abilitata la gestione del token si ha la possibilità di + autorizzare le richieste inserendo i valori ammessi per i claims + contenuti nel token. La configurazione viene effettuata + inserendo nel campo di testo ciascun claim in una riga, facendo + seguire dopo l'uguale i valori ammessi separati da virgola. + + L'opzione di autorizzazione basata sui token è + disponibile solo se è stata preventivamente attivata la + Gestione Token e selezionata la relativa policy. + + + + + XACML-Policy: È possibile basare il + meccanismo di autorizzazione sulla valutazione di una policy + xacml selezionando la relativa opzione sulla lista "Stato". + Per le indicazioni di dettaglio sulla configurazione delle + xacml-Policy si faccia riferimento alla + + + + + Custom: Sulla lista "Stato", è possibile + selezionare questo metodo di autorizzazione eventualmente + fornito tramite estensione di GovWay. + + + + + + Creazione di un soggetto + Affinché possano essere utilizzate le funzionalità di autenticazione ed + autorizzazione, associate alle erogazioni, è necessario che vengano censiti + i soggetti fruitori che inviano le richieste di servizio. La registrazione + di un soggetto consente di assegnargli delle credenziali che lo identificano + ed eventuali ruoli provenienti dalla fonte "Registro". +
+ Creazione di un soggetto + + + + + + + + +
+ Per creare il soggetto posizionarsi nella sezione Registro > + Soggetti, quindi premere il pulsante + Aggiungi. Compilare il form come segue (): + + Nome: Il nome del soggetto. È necessario + che il nome indicato risulti univoco rispetto ai nomi già + presenti per la modalità operativa selezionata (in questo caso + API Gateway). + + + Tipologia: Indicare se si tratta di un + soggetto esclusivamente erogatore, esclusivamente fruitore o con + entrambi i ruoli. + + + Descrizione: Un testo di descrizione per + il soggetto. + + + Modalità di Accesso alla Porta: Sezione + presente solo nel caso il soggetto ricopra il ruolo di fruitore. + Tramite il campo Tipo si seleziona il tipo + di credenziali richieste per l'autenticazione del soggetto. In + base alla scelta effettuata saranno mostrati i campi per + consentire l'inserimento delle credenziali richieste. + + + + Dopo aver creato il soggetto è opzionalmente possibile assegnargli dei + ruoli, tra quelli che sono presenti nel registro e contrassegnati come + fonte registro. Per associare ruoli ad un soggetto + seguire il collegamento presente nella colonna Ruoli, + in corrispondenza del soggetto scelto. Premere quindi il pulsante + Aggiungi. Nel form che si apre () è presente una lista dalla + quale è possibile selezionare un ruolo alla volta, che viene aggiunto + confermando con il tasto Invia.
+ Assegnazione di ruoli ad un soggetto + + + + + + + + +
+ + + + Creazione di un applicativo + Affinché possano essere utilizzate le funzionalità di autenticazione ed + autorizzazione, associate alle fruizioni, è necessario che vengano censiti + gli applicativi, interni al dominio, che inviano le richieste di servizio. + La registrazione di un applicativo consente di assegnargli delle credenziali + che lo identificano ed eventuali ruoli provenienti dalla fonte + "Registro". +
+ Creazione di un applicativo + + + + + + + + +
+ Per registrare l'applicativo posizionarsi nella sezione Registro + > Applicativi, quindi premere il pulsante + Aggiungi. Compilare il form come segue (): + + Nome: Assegnare un nome all'applicativo. + È necessario che il nome indicato risulti univoco rispetto ai + nomi già presenti per la modalità operativa selezionata (in + questo caso API Gateway). + + + Modalità di Accesso alla Porta: Tramite + il campo Tipo si seleziona il tipo di + credenziali richieste per l'autenticazione dell'applicativo. In + base alla scelta effettuata saranno mostrati i campi per + consentire l'inserimento delle credenziali richieste. + + + + Dopo aver creato l'applicativo è opzionalmente possibile assegnargli dei + ruoli, tra quelli che sono presenti nel registro e contrassegnati come + fonte registro. Per associare ruoli ad un + applicativo seguire il collegamento presente nella colonna + Ruoli, in corrispondenza dell'applicativo scelto. + Premere quindi il pulsante Aggiungi. Nel form che si + apre è presente una lista dalla quale è possibile selezionare un ruolo alla + volta, che viene aggiunto confermando con il tasto + Invia. + + + Creazione di un ruolo + È possibile censire i ruoli che potranno essere utilizzati come criterio + di autorizzazione. Quelli contrassegnati come fonte + registro potranno essere associandoli ai soggetti. Quelli + invece contrassegnati come fonte esterna verranno + assegnati dinamicamente ai soggetti che si autenticano, sulla base di quanto + comunicato dal container dopo che l'utente ha effettuato l'autenticazione + esternamente. + Per creare un nuovo ruolo ci si posiziona nella sezione Registro + > Ruoli e si preme il pulsante + Aggiungi. +
+ Registrazione di un ruolo + + + + + + + + +
+ Compilare il form () nel seguente + modo: + + + Nome: identifica univocamente il ruolo. + + + + + Descrizione: rappresenta una descrizione + generica del ruolo. + + + + Fonte: la gestione del ruolo può essere + effettuata direttamente su GovWay (fonte: registro) dove può + essere assegnato ad un soggetto o applicativo. In alternativa + (fonte: esterna) la gestione può essere delegata all'Application + Server o a qualunque altra modalità che permetta al gateway di + accedere ai ruoli tramite la api + HttpServletRequest.isUserInRole(). In + questo caso il nome del ruolo deve corrispondere allo stesso + identificativo utilizzato nella configurazione esterna. + Se non viene specificata alcuna fonte il ruolo potrà essere + utilizzato per entrambe le modalità. + + + + Contesto: l'utilizzo del ruolo può essere + limitato ad un contesto di erogazione o fruizione di servizio + attraverso questa opzione. + + + Identificativo Esterno: Nei casi in cui + il ruolo provenga da un sistema esterno, è possibile che il suo + identificativo sia differente rispetto a quello indicato nel + contesto del Registro. In tal caso inserire in questo campo tale + identificativo esterno. + + + + + + Attribuzione dei Ruoli a Soggetti ed Applicativi + È possibile attribuire un ruolo ad un soggetto cliccando sulla voce + 'Ruoli' presente sia nell'elenco dei soggetti che nel dettaglio di un + singolo soggetto. L'attribuzione consiste nello scegliere uno dei ruoli + selezionabili per il soggetto tra quelli compatibili con il contesto di + erogazione di servizio e che prevedono una fonte di registrazione interna al + registro.
+ Attribuzione di un ruolo ad un soggetto + + + + + + + + +
+ + In uguale maniera è possibile attribuire un ruolo ad un applicativo di + tipologia Frutore cliccando sulla voce 'Ruoli' presente + nel dettaglio dell'applicativo. L'attribuzione consiste nello scegliere uno + dei ruoli selezionabili per il servizio applicativo tra quelli compatibili + con il contesto di fruizione di servizio e che prevedono una fonte di + registrazione interna al registro.
+ Attribuzione di un ruolo ad un applicativo + + + + + + + + +
+ + + + XACML-Policy + Questa tipologia di autorizzazione prevede di limitare l'accesso ai soli + applicativi o soggetti fruitori che soddisfino una determinata policy XACML. + La policy deve essere caricata nel contesto dell'autorizzazione sul + controllo degli accessi, come mostrato in .
+ Registrazione di una XACML-Policy per l'erogazione + + + + + + + + +
+ + In fase di autorizzazione, il gateway costruisce una XACMLRequest + contenente tutti i parametri della richiesta, comprese le informazioni + relative al chiamante (credenziali ed eventuali ruoli), e la valida rispetto + alla XACML-Policy associata all'erogazione. I parametri inseriti nella + XACMLRequest, che possono essere utilizzati per effettuare la verifica + all'interno di una XACML-Policy, sono i seguenti: + Parametri inseriti in una XACMLRequest + + + + + + Nome + Descrizione + + + + + + Sezione 'Action' + + + + org:govway:action:provider + Indica il soggetto erogatore del servizio + + + org:govway:action:service + Indica il servizio nel formato tipo/nome + + + org:govway:action:action + Nome dell'operazione del servizio invocata + + + org:govway:action:url + Url di invocazione utilizzata dal mittente + + + org:govway:action:url:parameter:NOME_PARAM + Tutti i parametri presenti nell'url di invocazione + saranno inseriti nella XACMLRequest con questo + formato + + + org:govway:action:transport:header:NOME_HDR + Tutti gli header http presenti nell'url di + invocazione saranno inseriti nella XACMLRequest con + questo formato + + + org:govway:action:soapAction + Valore della SOAPAction + + + org:govway:action:gwService + Ruolo della transazione (inbound/outbound) + + + org:govway:action:protocol + Modalità associata al servizio richiesto (es. + spcoop) + + + org:govway:action:token:audience + Destinatario del token + + + org:govway:action:token:scope + Lista di scopes + + + org:govway:action:token:jwt:claim:<nome>=<valore> + Tutti i claims presenti nel jwt validato + + + org:govway:action:token:introspection:claim:<nome>=<valore> + Tutti i claims presenti nella risposta del servizio + di introspection + + + + Sezione 'Subject' + + + + org:govway:subject:organization + Indica il soggetto fruitore + + + org:govway:subject:client + Identificativo del servizio applicativo + client + + + org:govway:subject:credential + Rappresenta la credenziale di accesso (username, + subject o il principal) utilizzata dal client per + richiedere il servizio + + + org:govway:subject:role + Elenco dei ruoli che possiede il client che ha + richiesto il servizio + + + org:govway:subject:token:issuer + Issuer del token + + + org:govway:subject:token:subject + Subject del token + + + org:govway:subject:token:username + Username dell'utente cui è associato il token + + + org:govway:subject:token:clientId + Identificativo del client che ha negoziato il + token + + + org:govway:subject:token:userInfo:fullName + Nome completo dell'utente cui è associato il + token + + + org:govway:subject:token:userInfo:firstName + Nome dell'utente cui è associato il token + + + org:govway:subject:token:userInfo:middleName + Secondo nome (o nomi aggiuntivi) dell'utente cui è + associato il token + + + org:govway:subject:token:userInfo:familyName + Cognome dell'utente cui è associato il token + + + org:govway:subject:token:userInfo:eMail + Email dell'utente cui è associato il token + + + org:govway:subject:token:userInfo:claim:<nome>=<valore> + Tutti i claims presenti nella risposta del servizio + di UserInfo + + + +
Di seguito un esempio di XACMLPolicy che autorizza le richieste dei + chiamanti che possiedono il ruolo 'Amministratore' ed uno tra i due ruoli + 'Operatore1' e 'Operatore2': + + <Policy PolicyId="Policy" + RuleCombiningAlgId="urn:oasis:names:tc:xacml:1.0:rule-combining-algorithm:permit-overrides" + xmlns="urn:oasis:names:tc:xacml:2.0:policy:schema:os" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="urn:oasis:names:tc:xacml:2.0:policy:schema:os http://docs.oasis-open.org/xacml/2.0/access_control-xacml-2.0-policy-schema-os.xsd"> + <Target /> + <Rule Effect="Permit" RuleId="ok"> + <Condition> + <Apply FunctionId="urn:oasis:names:tc:xacml:1.0:function:and"> + + <Apply + FunctionId="urn:oasis:names:tc:xacml:1.0:function:string-at-least-one-member-of"> + <SubjectAttributeDesignator + AttributeId="org:govway:subject:role" + DataType="http://www.w3.org/2001/XMLSchema#string" /> + <Apply FunctionId="urn:oasis:names:tc:xacml:1.0:function:string-bag"> + <AttributeValue DataType="http://www.w3.org/2001/XMLSchema#string">Amministratore</AttributeValue> + </Apply> + </Apply> + + <Apply + FunctionId="urn:oasis:names:tc:xacml:1.0:function:string-at-least-one-member-of"> + <SubjectAttributeDesignator + AttributeId="org:govway:subject:role" + DataType="http://www.w3.org/2001/XMLSchema#string" /> + <Apply FunctionId="urn:oasis:names:tc:xacml:1.0:function:string-bag"> + <AttributeValue DataType="http://www.w3.org/2001/XMLSchema#string">Operatore1</AttributeValue> + <AttributeValue DataType="http://www.w3.org/2001/XMLSchema#string">Operatore2</AttributeValue> + </Apply> + </Apply> + + </Apply> + </Condition> + </Rule> + <Rule Effect="Deny" RuleId="ko" /> + </Policy> + + + + + + Scope + Nella sezione Registro > Scope è possibile gestire + il censimento degli scope da utilizzare successivamente per le politiche di + autorizzazione nell'ambito del controllo degli accessi. + La maschera di creazione di uno scope è quella mostrata in .
+ Creazione di uno Scope + + + + + + + + +
I dati da fornire sono: + + + Nome: nome assegnato internamente allo + scope + + + + Descrizione: un testo di descrizione + + + + + Identificativo Esterno: nome originale + dello scope presente nel token + + + + Contesto: specifica se lo scope si utilizza + solo nei contesti di erogazione, fruizione o entrambe le + possibilità. + + + + + + + Validazione dei messaggi + Per attivare la validazione dei messaggi in transito sul gateway si accede al + collegamento presente nella colonna Validazione presente + tra gli elementi di configurazione della specifica erogazione/fruizione.
+ Validazione dei messaggi + + + + + + + + +
Compilare il form di configurazione (): + + Stato: Consente di abilitare/disabilitare la + funzionalità di validazione sulla voce di configurazione scelta. + L'opzione warnignOnly consente di attivare la + funzionalità di validazione evitando però che, se tale fase non + viene superata, venga bloccato il messaggio e restituito un errore. + In quest'ultimo caso, gli errori di validazione verranno segnalati + solo tramite l'emissione di opportuni messaggi diagnostici dal + servizio di tracciamento. + + + Tipo: Nel caso si sia abilitato il servizio + di validazione, questo campo consente di selezionare la metodologia + che si vuole utilizzare. I valori selezionabili da questo elenco + cambiano in base alla tipologia delle API cui fa riferimento + l'erogazione/fruizione. + + I tipi di validazione previsti sono: + + + Schemi XSD, la validazione si basa sugli schemi + xsd allegati alle API. Utilizzato per la validazione sintattica dei + messaggi XML sia nel caso Soap che Rest. + + + + Wsdl, la validazione si basa sull'interfaccia + wsdl fornita con la API. Questo tipo di validazione è più rigorosa + in quanto controlla non solo la conformità sintattica ma viene + validato il messaggio in transito verificando che sia idoneo al + PortType e Operation in uso. Questo tipo di validazione è + applicabile solo al caso Soap. + + Swagger 2.0 o OpenAPI 3.0, nei casi in cui si è + fornito un descrittore formale per una API Rest, la validazione sarà + effettuata utilizzando gli strumenti associati allo specifico + formato. + + + + Nel caso di servizi Soap, se i messaggi che transitanto sulla porta di dominio + possiedono il formato MTOM, per poterli validare è necessario attivare l'opzione + Accetta MTOM. Tale opzione normalizza i messaggi prima + di effettuarne la validazione e ripristina il formato originale una volta + completato il processo di validazione. + Si tenga presente che attivando la validazione dei messaggi, questa + riguarderà sia le richieste, inviate al servizio, che le conseguenti + risposte. + + + + + Rate Limiting + Questa sezione di configurazione, specifica per erogazioni e fruizioni (o + specifico gruppo di configurazione nell'ambito di un'erogazione/fruizione), + consente di attivare delle policy di rate limiting specifiche per l'istanza + configurata. + L'attivazione di policy di rate limiting rientra nell'ambito degli strumenti + per il controllo del traffico. La descrizione di dettaglio di questi strumenti è + presente nella , dove viene illustrato + il meccanismo per configurare le policy e più in dettaglio nella riguardo l'attivazione di policy + a valenza globale. + Sono presenti alcune policy di rate limiting preconfigurate e pronte all'uso. + L'utente può crearne di nuove seguendo le indicazioni presenti nella . Le policy preconfigurate sono le + seguenti: + + + NumeroRichieste-ControlloRealtimeGiornaliero: + La policy confronta il numero di richieste, sulla finestra + giornaliera corrente, della specifica istanza di servizio, con la + soglia stabilita. + + + + NumeroRichieste-ControlloRealtimeMinuti: La + policy confronta il numero di richieste, sulla finestra del minuto + corrente, della specifica istanza di servizio, con la soglia + stabilita. + + + + NumeroRichieste-ControlloRealtimeOrario: La + policy confronta il numero di richieste, sulla finestra oraria + corrente, della specifica istanza di servizio, con la soglia + stabilita. + + + + NumeroRichieste-RichiesteSimultanee: La policy + confronta il numero di richieste simultaneamente attive della + specifica istanza di servizio, con la soglia stabilita. + + + + OccupazioneBanda-ControlloRealtimeOrario: La + policy confronta l'occupazione di banda della specifica istanza di + servizio, sulla finestra oraria corrente, con la soglia stabilita. + + + + + TempoMedioRisposta-ControlloRealtimeOrario: La + policy confronta il tempo medio di risposta della specifica istanza + di servizio, sulla finestra oraria corrente, con la soglia + stabilita. + + + + + Header HTTP ritornati all'applicativo + L'attivazione di policy di Rate Limiting fa si che il Gateway generi gli + header http descritti nella sezione . + + Per attivare una nuova policy dalla sezione di rate limiting si procede + utilizzando il pulsante Aggiungi che apre il form di .
+ Attivazione di una policy di Rate Limiting + + + + + + + + +
Si compilano i campi seguenti: + + + Policy: la policy da attivare. Si compone di: + + + Identificativo: Identificativo + univoco assegnato automaticamente all'istanza di policy. + + + + + Policy: L'elemento del registro + delle policy che si vuole attivare. Inizialmente saranno + presenti solo le policy preconfigurate. Eventualmente + saranno presenti in seguito le policy definite + dall'utente + + + + Nome: Opzionale. Permette di + identificare l’istanza della policy tramite un nome + alternativo all’identificativo assegnato automaticamente + dal sistema. + + + + Descrizione: Il testo di + descrizione della policy. + + + + Stato: Lo stato dell'istanza di + policy una volta creata. Sono disponibili le seguenti + opzioni: + + + Abilitato: L'istanza di + policy è abilitata. Questo significa che le + violazioni rilevate saranno gestite in maniera + restrittiva (negazione del servizio). + + + + WarningOnly: L'istanza di + policy è abilitata in modalità WarningOnly. Questo + significa che le violazioni rilevate saranno solo + segnalate tramite messaggi diagnostici ma non ci + saranno ripercussioni sull'elaborazione della + richiesta. + + + + Disabilitato: L'istanza di + policy è disabilitata. + + + + + + + Ridefinisci Valori di Soglia: + Attivando questa opzione sarà possibile utilizzare una + soglia per l'istanza di policy differente rispetto al + valore di default previsto dalla policy d'origine. + + + + + + + + Filtro: Abilitando questa sezione dell'istanza + di policy è possibile indicare i criteri per stabilire quali + richieste, nell'ambito della istanza in fase di configurazione, sono + soggette alla policy che si sta istanziando. In assenza di filtro, + l'istanza della policy sarà valutata su tutte le richieste in + ingresso per la specifica istanza di servizio che si sta + configurando. + Per la creazione del filtro sono disponibili i seguenti campi: + + + Azione: Opzione per filtrare le + richieste in base all'azione invocata. + + + + Soggetto Fruitore: Opzione + disponibile per le erogazioni al fine di filtrare le + richieste di servizio in base al soggetto fruitore. + + + + + Applicativo Fruitore: Opzione + disponibile per le fruizioni al fine di filtrare le + richieste di servizio in base all'applicativo fruitore + + + + + Filtro per Chiave: Si tratta di + un'opzione avanzata che consente di filtrare le + richieste in ingresso sul gateway base ad una chiave che + può essere specificata in maniera personalizzata + effettuando una delle seguenti scelte per il campo + Tipologia: + + + HeaderBased: Occorre fornire + i dati “Nome” e “Valore”. La policy si applicherà + soltanto alle richieste che hanno, nell'header di + trasporto, una proprietà che corrisponde. + + + + URLBased: Occorre fornire i + dati “Espressione Regolare” e “Valore”. La policy + si applicherà soltanto alle richieste ove, + applicando l'espressione regolare alla URL di + invocazione, si ottiene un valore identico a + quello fornito. + + + + FormBased: Occorre fornire i + dati “Nome” e “Valore”. La policy si applicherà + soltanto alle richieste che contengono nella query + string un parametro corrispondente ai dati + forniti. + + + + SOAPActionBased: Occorre + fornire il dato “Valore”. + La policy si + applicherà soltanto alle richieste che si + presentano con una SOAPAction avente il valore + fornito. + + + + ContentBased: Occorre fornire + i dati “Espressione XPath” e “Valore”. La policy + si applicherà soltanto alle richieste dove, + applicando l'espressione XPath al messaggio di + richiesta, si ottiene un valore identico a quello + fornito. + + + + PluginBased: Occorre fonire i + dati “Tipo Personalizzato” e “Valore”. Il + parametro “Tipo Personalizzato” è una chiave, + registrata nella configurazione, cui corrisponde + una classe java che restituisce un valore da + confrontare con quello fornito. Per realizzare un + plugin con una logica di filtro personalizzata è + necessario fornire un'implementazione della + seguente interfaccia: + +package org.openspcoop2.pdd.core.controllo_traffico.plugins; +public interface IRateLimiting { + public String estraiValoreFiltro(Logger log,Dati datiRichiesta) throws PluginsException; + public String estraiValoreCollezionamentoDati(Logger log,Dati datiRichiesta) throws PluginsException; +} + + La classe realizzata viene successivamente + registrata tramite una entry nel file + className.properties di + GovWay: + +org.openspcoop2.pdd.controlloTraffico.rateLimiting.test=<fully qualified class name> + + La stringa <nome>, fornita in + configurazione, diventa utilizzabile come “Tipo + Personalizzato”. + + + + + + + + + + Criterio di Collezionamento dei Dati: In questa + sezione è possibile attivare opzionalmente alcuni criteri per il + raggruppamento dei dati utilizzati come indicatori di confronto per + l'applicabilità della policy. Ad esempio se si è attivata una policy + che limita a 20 il numero di richieste su una finestra di 5 minuti, + significa che al raggiungimento della ventunesima richiesta, nella + stessa finestra temporale, si otterrà una violazione della policy. + Aggiungendo un criterio di collezionamento per Azione, saranno + conteggiate separatamente le richieste in base alla specifica azione + invocata. In questo caso la policy risulterà violata solo al + raggiungimento della ventunesima richiesta, nella stessa finestra + temporale, relativa alla medesima azione. + È ammesso anche il raggruppamento su criteri multipli. La logica + è del tutto analoga a quella dell'operatore GROUP BY del linguaggio + SQL. + I criteri di raggruppamento selezionabili sono: + + + Azione + + + + + Soggetto Fruitore (caso erogazioni) + + + + + Applicativo Fruitore (caso + fruizioni) + + + + Raggruppamento per Chiave: le + richieste saranno raggruppate in base al valore di una + chiave personalizzata il cui valore viene fornito + secondo uno dei metodi selezionati tra i seguenti: + + + HeaderBased: La chiave è + presente nell'header di trasporto indicato nella + proprietà "Nome". + + + + URLBased: La chiave è + presente nella URL ricavandola tramite + l'espressione regolare fornita nell'elemento + seguente. + + + + FormBased: La chiave viene + fornita in modalità Form Encoded con il parametro + indicato nell'elemento "Nome". + + + + SOAPActionBased: La chiave + corrisponde al valore della SoapAction. + + + + ContentBased: La chiave è + presente nel body del messaggio e viene ricavata + tramite il valore Xpath fornito nell'elemento + seguente. + + + + PluginBased: La chiave viene + restituita tramite l'esecuzione di una classe il + cui nome viene fornito con il campo "Tipo + Personalizzato" + + + + + + + + + + + + Sicurezza a livello del messaggio + Tramite il collegamento Sicurezza Messaggio, presente + nella sezione di configurazione della specifica erogazione/fruizione, è + possibile impostare criteri di elaborazione dei messaggi in transito, attuati + dal gateway, al fine di gestire i meccanismi di sicurezza previsti a livello del + messaggio. + Il form presenta inizialmente lo Stato disabilitato. Per + abilitare la sicurezza, impostare il valore dello stato su abilitato e + confermare con il pulsante Invia. Appariranno gli elementi + Richiesta e Risposta, come nella + figura seguente.
+ Abilitazione Sicurezza Messaggio + + + + + + + + +
+ + Il form consente di selezionare uno schema di sicurezza, tra quelli + disponibili, da applicare al messaggio di richiesta ed a quello di risposta. Gli + schemi di sicurezza applicabili cambiano in base alla tipologia del messaggio + sul quale si applica. + Per la gestione della sicurezza sul messaggio di richiesta, nel caso di una + erogazione, il gateway agisce con il ruolo Receiver che + comporta la seguente casistica: + + + Nel caso del protocollo SOAP: + + + WSSec Signature, in ricezione si + attende un messaggio firmato; l'azione è quella di + verificare la firma presente + + + + WSSec Decrypt, il messaggio + ricevuto verrà decifrato + + + + WSSec SAML Token, si attende un + messaggio contenente una asserzione SAML; viene + effettuata la verifica dell'asserzione presente. + + + + WSSec Username Token, viene + effettuata la validazione del token di + autenticazione + + + + WSSec Timestamp, se è prevista una + scadenza all'interno del timestamp presente nel + messaggio, se ne verificherà la validità + + + + + + + Nel caso del protocollo REST + + + + JWT Decrypt: il messaggio JSON + ricevuto viene decifrato. + + + + JWT Verifier Signature: al + messaggio JSON ricevuto viene verificata la firma. + + + + + XML Decrypt: il messaggio XML + ricevuto viene decifrato. + + + + XML Verifier Signature: al + messaggio XML ricevuto viene verificata la firma. + + + + + + + + Per la gestione della sicurezza sul messaggio di risposta, nel caso di una + erogazione, il gateway agisce con il ruolo Sender che + comporta la seguente casistica: + + + Nel caso del protocollo SOAP: + + + WSSec Signature, il messaggio verrà + firmato + + + + WSSec Encrypt, il messaggio verrà + cifrato + + + + WSSec SAML Token, sul messaggio + verrà inserita una asserzione SAML + + + + WSSec Username Token, il messaggio + verrà arrichito di un token di autenticazione + + + + WSSec Timestamp, il messaggio verrà + arrichito di una informazione temporale (tipicamente + utilizzato insieme alla firma del messaggio) + + + + + + + Nel caso del protocollo REST: + + + JWT Encrypt: il messaggio JSON di + risposta viene cifrato prima dell'invio. + + + + JWT Signature: il messaggio JSON di + risposta viene firmato prima dell'invio. + + + + XML Encrypt: il messaggio XML di + risposta viene cifrato prima dell'invio. + + + + XML Signature: il messaggio XML di + risposta viene firmato prima dell'invio. + + + + + + + Si tenga presente che, nel caso di una fruizione, il ruolo del + gateway si inverte diventando Sender nel caso della + richiesta e Receiver nel caso della risposta. Gli + schemi di sicurezza disponibili, nel caso della fruizione, rimangono + quelli già descritti per Sender e Receiver. + + + + + Tracciamento + Il tracciamento è la funzionalità del gateway che comporta la registrazione + dei dati relativi alle comunicazioni in transito riguardanti i servizi erogati e + fruiti. Nella logica del gateway, tutte le informazioni che riguardano una + singola interlocuzione, a partire dalla richiesta pervenuta fino alla + conclusione con l'invio dell'eventuale risposta, sono riconducibili ad un'unica + entità denominata Transazione. + Una transazione registrata dal gateway ha la seguente struttura: + + + Dati di Identificazione Generale. Sono le + informazioni che identificano la comunicazione specifica in termini + dei soggetti coinvolti e del servizio richiesto: Soggetto Erogatore, + Soggetto Fruitore, Servizio, Azione, Esito, ... + + + + Dati della Richiesta. Sono le informazioni di + dettaglio relative alla richiesta: Identificativo del Messaggio, + Timestamp di ingresso, Timestamp di uscita, dimensioni del + messaggio, ... + + + + Dati della Risposta. Sono le medesime + informazioni già citate al punto precedente, ma relative alla + comunicazione di risposta. + + + + Traccia Richiesta. La traccia emessa dal + gateway con i dettagli relativi alla richiesta. + + + + Traccia Risposta. La traccia emessa dal gateway + con i dettagli relativi alla risposta. + + + + Messaggi Diagnostici. La sequenza dei messaggi + diagnostici, ordinati cronlogicamente, emessi dal gateway nel corso + dell'elaborazione dell'intera transazione. + + + + Fault di Ingresso. Viene registrato come Fault + di Ingresso l'eventuale messaggio di errore ricevuto dal gateway + durante l'invocazione di un servizio (interno o esterno al dominio + gestito). + + + + Fault di Uscita. Viene registrato come Fault di + Uscita l'eventuale messaggio di errore inoltrato dal gateway al + mittente della richiesta (interno o esterno al dominio gestito), + dopo aver ricevuto un fault dal servizio invocato. + + + + Parametri e Misurazioni. Sono i parametri e le + misurazioni che riguardano la transazione, come ad esempio: + l'identificativo della transazione, le url invocate, i tempi di + latenza, ... + + + + In questa sezione è possibile personalizzare la configurazione di default del + tracciamento definita in accordo a quanto descritto in . Le personalizzazioni inserite in questo + contesto avranno validità per le sole comunicazioni riguardanti la specifica + erogazione/fruizione ().
+ Tracciamento per la singola erogazione/fruizione + + + + + + + + +
+ + Le sezioni presenti nella pagina sono: + + + Transazioni Registrate: l'utente ha l'opzione + per mantenere il default definito nella sezione di configurazione + generale () oppure ridefinirlo. + + + + + Messaggi Diagnostici: l'utente ha l'opzione per + mantenere il default definito nella sezione di configurazione + generale () oppure ridefinire + il criterio per la sola memorizzazione su Database. + + + + Correlazione Applicativa: consente di impostare + delle regole per estrarre dai messaggi in transito, codici, + riferimenti, o altri contenuti al fine di arricchire i dati + tracciamento generati dal gateway (). + + + + + + Correlazione Applicativa + La funzione di Correlazione Applicativa consente al + gateway che elabora il messaggio di richiesta, di estrarre un identificatore + relativo al contenuto applicativo. L'identificatore, se presente, finisce + nei sistemi di tracciamento e diagnostici, a completamento delle + informazioni già presenti. I dati per configurare la correlazione + applicativa consistono in un insieme di regole per l'estrazione di tale + identificatore. + Per accedere alla configurazione della correlazione applicativa, per una + data erogazione/fruizione, si utilizza la sezione "Correlazione Applicativa" + presente nell'ambito della configurazione del tracciamento di una + fruizione/erogazione (). + Utilizzando il collegamento Regole, presente nel + riquadro della Richiesta o Risposta, si accede all'elenco delle regole di + correlazione applicativa presenti. Premere il pulsante + Aggiungi per aggiungere una nuova regola () + +
+ Creazione di una regola di correlazione applicativa + + + + + + + + + +
+ + Per la creazione di una regola di correlazione applicativa si devono + indicare i seguenti dati: + + Elemento: Questo dato serve per capire su + quali messaggi è applicabile la regola di correlazione + applicativa che si sta definendo. Lasciando il campo vuoto si + intende che la regola si applica a tutti i messaggi. In + alternativa è possibile indicare: + + Nome Azione o Risorsa: il + nome esatto dell'azione o della risorsa su cui verrà + applicativa la regola + + + LocalName dell'elemento xml: + in caso il messaggio sia un xml (soap o rest), è + possibile indicare il local name del root element + xml su cui verrà applicativa la regola + + + XPath o JSONPath: Espressione + che può rappresentare un XPath o JSONPath. Se + l'espressione ha un match con il contenuto la regola + verrà applicata + + + + + + + Modalità 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. La regola per l'estrazione dalla url + viene specificata tramite un'espressione regolare + inserita nel campo pattern. + + + + contentBased: Il valore viene + estratto direttamente dal messaggio applicativo. La + regola per l'estrazione dal messaggio è specificata + tramite un'espressione XPath o JSONPath inserita nel + campo pattern; + + + + + headerBased: Il valore viene + estratto dall'header di trasporto avente il nome + indicato nel campo successivo. + + + + inputBased: il valore viene + estratto dall'header di integrazione GovWay e presente + nel valore della proprietà + IDApplicativo. + + + + 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/JSONPath, nel caso di identificazione contentBased, + utilizzata per l'acquisizione dell'identificatore + applicativo. + + + + 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 con restituzione di un errore al + mittente; + + + + Riuso ID: opzione per + abilitare/disabilitare il riuso dell'identificatore del + messaggio (assegnato dal gateway) nel caso in cui vengano + inviati messaggi con identificatori applicativi già processati + in precedenza. + + + + + + + + + MTOM + Nei casi in cui il mittente e il destinatario si scambiano messaggi con + allegati (nell'ambito del protocollo SOAP), utilizzando il protocollo MTOM, + GovWay è in grado di gestire tali comunicazioni in modalità trasparente e quindi + senza alcun intervento. + In altre situazioni è possibile sfruttare le funzionalità di GovWay per + beneficiare delle ottimizzazioni del protocollo MTOM quando uno dei due + interlocutori non è in grado di supportare tale protocollo, oppure per + effettuare verifiche di congruità dei messaggi in transito basati su MTOM. + Nel caso di una erogazione, per il messaggio di richiesta, le opzioni + disponibili sono: + + + disable. Non viene svolta alcuna azione. + + + + + unpackaging. In questo scenario il client + fruitore invia dati binari nel formato MTOM ma l'erogatore non + supporta tale formato. Il gateway effettua la trasformazione del + messaggio inserendo i dati binari in modalità Base64 + encoded prima che venga inviato al destinatario. + Sulla risposta sarà effettuato il processo inverso. + + + + verify. Sia il fruitore che l'erogatore + utilizzano MTOM ma si vogliono validare i messaggi. Il gateway + effettua, tramite opportuni pattern xpath forniti, la validazione + dei messaggi al fine di verificare la conformità del formato del + messaggio rispetto a quanto atteso dall'erogatore. + + + + Sempre nel caso di una erogazione, per il messaggio di risposta, le opzioni + disponibili sono: + + + disable. Non viene svolta alcuna azione. + + + + + packaging. In questo scenario il client + fruitore invia dati binari nella modalità Base64 encoded ma + l'erogatore richiede il formato MTOM. Il gateway effettua la + trasformazione del messaggio secondo il protocollo MTOM prima che + venga inviato al destinatario. Sulla risposta sarà effettuato il + processo inverso. + + + + verify. Analogo a quanto descritto per il + messaggio di richiesta. + + + + Nota: Nel caso si utilizzi la validazione dei + contenuti, basata su xsd o wsdl, è possibile che la struttura MTOM non sia stata + prevista negli schemi e quindi faccia fallire l'esito della stessa. In questo + caso, quando si attiva la validazione è necessario abilitare l'opzione + Accetta MTOM/XOP-Message affinché il processo di + validazione tenga conto del formato MTOM. + + Nel caso di una fruizione, le opzioni di configurazione disponibili per + la richiesta diventano quelle per la risposta e viceversa. + + + + + Registrazione Messaggi + Nella è possibile fornire le + configurazioni per attivare il salvataggio dei messaggi in transito sul gateway. + In questa sezione si ha la possibilità di ridefinire le opzioni di + configurazione, stabilite a livello generale, al fine di personalizzare il + servizio di registrazione dei messaggi per la specifica configurazione + dell'erogazione/fruizione. + Per la descrizione delle opzioni di configurazione si faccia riferimento alla + sezione generale precedentemente indicata. + + + + + + + + + + + + + + + + + + + + + + + + Il Profilo "eDelivery" + In questa modalità operativa la govwayConsole consente di produrre configurazioni di + scenari di interoperabilità che si basano sullo standard europeo eDelivery. Per rendere + il trattamento dei messaggi conforme a tale standard, GovWay si interfaccia ad una + installazione del software Domibus (https://ec.europa.eu/cefdigital/wiki/display/CEFDIGITAL/Domibus). + + Il processo di configurazione rimane strutturalmente analogo a quanto già descritto + per la modalità API Gateway. Sono però presenti proprietà specifiche del contesto + eDelivery i cui valori devono essere foriniti affinché il dialogo con l'access point + Domibus possa essere realizzato correttamente. + Nel seguito andiamo a descrivere i passi di configurazione evidenziando, per + differenza con il caso API Gateway, gli elementi di eDelivery che dovranno essere + gestiti. Al termine della configurazione è necessario procedere con l'export dei dati in + formato PMODE. Il file prodotto è quello necessario per permettere + la configurazione dell'access point Domibus. + + + Passi preliminari di configurazione + Per gestire in maniera più semplice i passi di configurazione dei servizi + eDelivery è consigliabile impostare l'opportuna modalità operativa della + govwayConsole selezionando la voce eDelivery sul selettore di + modalità presente nella testata dell'applicazione. + Prima di procedere con la configurazione dei servizi si devono verificare i dati + relativi ai soggetti interlocutori. Nel caso del soggetto interno al proprio + dominio, i dati di configurazione possono essere gestiti alla sezione + Configurazione > Generale (). +
+ Configurazione delle Base URL eDelivery per il soggetto interno + + + + + + + + +
+ Sono presenti valori iniziali, inseriti dal processo di installazione, che devono + essere verificati ed eventualmente aggiornati: + + + Base URL Erogazione: Indirizzo pubblico del Domibus + per la ricezione dei messaggi sul canale eDelivery. + + + Base URL Fruizione: Indirizzo del servizio di GovWay + riservato ai client per l'invio di messaggi sul canale eDelivery. + + + Tramite il collegamento Visualizza Dati Soggetto è possibile + accedere alla conffigurazione del soggetto interno (). +
+ Configurazione delle proprietà eDelivery per il soggetto interno + + + + + + + + +
+ Le proprietà eDelivery da fornire sono le seguenti: + + + Party Info - Id: Identificativo del soggetto + utilizzato nel canale eDelivery. + + + Party Info - Type Name: Nome assegnato internamente + allo schema indicato nel Type Value. + + + Party Info - Type Value: Schema di generazione + riferito all'identificativo del soggetto eDelivery. + + + Party Endpoint - URL: Indirizzo pubblico del Domibus + per la ricezione dei messaggi sul canale eDelivery. + + + Party Endpoint - Common Name: Valore della omonima + proprietà del certificato utilizzato dall'access point Domibus cui + afferisce. Questo nome coincide con quello dell'access point. + + + + + Erogazione di servizi in modalità eDelivery + Configurare un'erogazione eDelivery permette ad un'applicazione interna di + ricevere i messaggi inviati da un generico access point eDelivery esterno. + Il primo passo di configurazione prevede che venga censito il soggetto esterno + mittente dei messaggi. La creazione di tale soggetto si realizza dalla sezione + Registro > Soggetti della govwayConsole, impostando le + proprietà eDelivery già descritte nella sezione precedente per il soggetto + interno. + Il passo successivo è quello di registrare le API corrispondenti al servizio + eDelivery alla sezione Registro > API. Le proprietà eDelivery, + presenti nel form di creazione, sono quelle mostrate in . +
+ Registrazione API eDelivery - Proprietà specifiche + + + + + + + + +
+ Le proprietà da specificare sono le seguenti: + + Service Info - Type: Identificativo assegnato + come tipo del servizio (opzionale). + + + Service Info - Name: Nome del servizio. + + + Payload Profiles - File: Campo per l'upload del + descrittore XML che rappresenta il formato dei messaggi inviati dal + mittente. Campo opzionale, utilizzabile per aggiungere nuovi profili + rispetto a quelli già presenti nell'installazione standard di Domibus. + Per la specifica del formato XML da adottare si consulti la + documentazione ufficiale di Domibus. + + + Properties - File: Campo per l'upload del + descrittore XML che definisce le proprietà custom che saranno presenti + nei messaggi inviati dal mittente. Campo opzionale, utilizzabile per + aggiungere nuove property rispetto a quelle già presenti + nell'installazione standard di Domibus. Per la specifica del formato XML + da adottare si consulti la documentazione ufficiale di Domibus. + + Dopo aver effettuato il salvataggio è necessario completare la + configurazione del servizio utilizzando il link presente nella colonna + Risorse o Servizi, a seconda che si + tratti di un servizio Rest o Soap, in corrispondenza dell'elemento presente + nell'indice dei servizi. Per ciascuna delle azioni/risorse elencate per il servizio + (o create, nel caso che, non disponendo del descrittore del servizio, si proceda con + la configurazione manuale delle azioni), si accede al dettaglio per completare la + configurazione delle proprerty eDelivery (). +
+ Proprietà eDelivery relative alle azioni delle API + + + + + + + + +
I valori da impostare nel form sono: + + Action Info - Name: Nome dell'azione. + + + Payload - Profile: Payload Profile, tra quelli + disponibili, da utilizzare per l'azione. + + + Payload - Compress: Indicare se l'invio del + messaggio farà uso di compressione dei dati. + + + + Dopo aver creato l'API si procede con la configurazione dell'erogazione alla + sezione Registro > Erogazioni della govwayConsole ().
+ Proprietà eDelivery relative all'erogazione del servizio + + + + + + + + +
L'unica impostazione eDelivery da fornire in questo contesto è: + + Security Profile: profilo di sicurezza adottato + dagli access point durante la comunicazione. E' necessario scegliere tra + i valori presenti, che corrispondono alle policy standard, già presenti + in Domibus con l'installazione. + + + + L'endpoint fornito alla voce Connettore sarà quello utilizzato da GovWay + per la consegna dei messaggi consegnati all'access point Domibus interno. + + + + Affinché le configurazioni apportate in modalità eDelivery possano essere + attuate sull'access point Domibus è necessario procedere alla generazione + del PMODE nel modo descritto alla + + + + + + Fruizione di servizi in modalità eDelivery + Configurare una fruizione eDelivery permette ad un'applicazione interna di + inviare messaggi da veicolare verso un generico access point eDelivery esterno. + Il processo di configurazione della fruizione eDelivery prevede inizialmente i + medesimi passi già descritti per l'erogazione al paragrafo . Dovranno quindi essere configurati i dati eDelivery + relativi ai soggetti interlocutori, interno ed esterno, dovranno inoltre essere + censite le API relative al servizio da fruire. + Dopo aver censito le API si procede con la configurazione della fruizione creando + un nuovo elemento nella sezione Registro > Fruizioni della + govwayConsole. Analogamente al caso dell'erogazione si dovrà selezionare la security + policy necessaria per gli scambi tra gli access point. + Affinché le configurazioni apportate in modalità eDelivery possano essere + attuate sull'access point Domibus è necessario procedere alla generazione + del PMODE nel modo descritto alla + + + + + Generazione del PMODE Domibus + Affinché il Domibus interno al proprio dominio sia in grado di recepire tutte le + configurazioni prodotte nella modalità eDelivery, è necessario che gli venga fornito + il relativo file PMODE, così come prevede la configurazione dell'access point + eDelivery. + Dopo aver ultimato le configurazioni dei servizi eDelivery, tramite la + govwayConsole, si procede all'esportazione del PMODE effettuando i seguenti passaggi + (): + + Selezionare la voce di menu Configurazione > + Esporta. + + + Selezionare la tipologia archivio + domibus-pmode. + + + Premere il pulsante Invia e salvare il file XML che viene + restituito. + + + Effettuare l'upload del file ottenuto sulla Domibus Console. + + +
+ Esportazione del PMODE + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + Il Profilo "SPCoop" + In questa modalità operativa la govwayConsole consente di produrre le configurazioni + per i servizi SPCoop, in accordo alla specifica di cooperazione applicativa della PA + italiana. I passi di configurazione, per erogazioni e fruizioni, presentano minime + differenze rispetto a quanto descritto per la modalità API Gateway. Nel seguito saranno + descritte tali differenze. + + Configurazione di un servizio SPCoop + Il primo passaggio per la configurazione di un servizio SPCoop è quello di creare + il relativo Accordo di Servizio. Questi viene creato registrando una nuova API + (sezione Registro > API). Come illustrato nelle figura + seguente, la particolarità di questa configurazione, rispetto a quanto descritto in + precedenza, risiede nella presenza del campo Soggetto + referente, nel quale deve essere selezionato uno dei soggetti + precedentemente registrati.
+ Creazione Accordo di Servizio SPCoop + + + + + + + + +
+ + Se non viene fornito un WSDL, relativo all'accordo di servizio, è necessario + definire manualmente l'interfaccia del servizio, analogamente a quanto descritto in + . In questo caso, l'aggiunta del servizio, + comprende i profili di collaborazione asincroni oltre alle caratteristiche + aggiuntive specifiche del protocollo SPCoop (vedi ). La + figura seguente mostra i dettagli di questo caso.
+ Aggiunta Servizio SPCoop + + + + + + + + +
+ + La registrazione di una nuova erogazione o fruizione, presenta le seguenti + differenze rispetto a quanto descritto per la modalità API Gateway: + + È presente il campo Tipo relativamente al + servizio + + + È presente il campo Versione Protocollo per + selezionare la versione della specifica SPCoop adottata. + + +
+ Creazione erogazione SPCoop + + + + + + + + +
+ + + + Profili Asincroni + + + Profilo di Collaborazione Asincrono Simmetrico + La registrazione di un profilo asincrono simmetrico prevede che vengano + correlati tra di loro due azioni di due servizi differenti presenti all'interno + del solito accordo di servizio parte comune (API). Di seguito un esempio di tale + configurazione.
+ Correlazione Asincrona Simmetrica + + + + + + + + +
+ + + Ruolo Fruitore + Per poter fruire di un servizio con il profilo asincrono simmetrico la + registrazione dell'applicativo fruitore deve prevedere, oltre alle normali + configurazioni, la definizione di un connettore attraverso il quale la PdD + consegnerà la risposta asincrona. Per definire tale connettore utilizzare la + sezione 'Risposta Asincrona' presente nell'elenco degli applicativi + relativamente al servizio desiderato. + + + + + Ruolo Erogatore + Per poter erogare un servizio con il profilo asincrono simmetrico non + sono richieste particolari configurazioni. Dovrà essere erogato il servizio + relativo alla richiesta e fruito il servizio su cui inviare la risposta. + + + + + Profilo di Collaborazione Asincrono Asimmetrico + La registrazione di un profilo asincrono asimmetrico prevede che vengano + correlati tra di loro due azioni, normalmente di uno stesso servizio, presenti + all'interno dell'accordo di servizio parte comune (API). Di seguito un esempio + di tale configurazione.
+ Correlazione Asincrona Asimmetrica + + + + + + + + +
+ + + Ruolo Fruitore + Per poter fruire un servizio con il profilo asincrono asimmetrico non + sono richieste particolari configurazioni. Dovrà essere fruito il servizio + su cui inviare la richiesta e richiedere l'esito della risposta. + + + Ruolo Erogatore + Per poter erogare un servizio con il profilo asincrono asimmetrico la + registrazione del servizio applicativo erogatore deve prevedere, oltre alle + normali configurazioni, la definizione di un connettore attraverso il quale + la PdD consegnerà il messaggio contenente la richiesta dello stato + dell'operazione (seconda fase del profilo asincrono asimmetrico). Per + definire tale connettore utilizzare la sezione 'Risposta Asincrona' presente + nell'elenco dei servizi applicativi relativamente al servizio desiderato. + + + + + + + + + Interfacce WSDL (concettuale, logico ed implementativo) + + 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 riepiloga i documenti necessari alla + descrizione formale di un accordo di servizio che possono essere associati agli + accordi parte comune e specifica se viene utilizzata la modalità avanzata della + console + + + Descrizione di un accordo di servizio + + + + + + + + + Nome Documento + + Accordo + + + + + + + + Specifica delle Interfacce + + + + + WSDL Definitorio + + Parte Comune + + + + WSDL Concettuale + + Parte Comune + + + + WSDL Logico Erogatore + + Parte Comune + + + + WSDL Logico Fruitore + + Parte Comune + + + + + + Specifica delle Implementazioni + + + + + WSDL Implementativo Erogatore + + Parte Specifica + + + + WSDL Implementativo Fruitore + + Parte Specifica + + + +
+ + + + Profili di gestione della busta eGov + + L'interfaccia completa fornisce la possibilità di + fruire/erogare di servizi SPCoop che non seguono le Linee Guida 1.1 ma si basano sul + documento e-Gov 1.1. Questa funzionalità è utile sia per backward compatibility in + quei domini dove i servizi non sono ancora stati adeguati al profilo descritto nelle + Linee Guida 1.1, sia per usufruire di servizi infrastrutturali quali + consegna affidabile, consegna in + ordine, conversazioni che non sono presenti nel + profilo Linee Guida 1.1. + + + Fruizione di un servizio + + Supponiamo di essere in un contesto dove vogliamo usufruire di un servizio + erogato da un soggetto la cui PdD non è ancora stata adeguata a quanto descritto + nelle Linee Guida 1.1. Per usufruire del servizio, il soggetto fruitore deve + inviare buste conformi al profilo e-Gov 1.1, nonostante la propria porta di + dominio sia già conforme alle Linee Guida 1.1. Per gestire tale contesto è + possibile definire il soggetto erogatore con profilo + eGov1.1. In un successivo momento, la PdD del soggetto + erogatore può iniziare ad adeguarsi alle Linee Guida 1.1. Supponiamo che + l'adeguamento sia incrementale, fornito per un servizio alla volta. Per + usufruire dei servizi erogati da tale soggetto, con la giusta modalita (Linee + Guida 1.1 o e-Gov 1.1) è possibile ridefinire il profilo di gestione + all'interno del servizio. + + + + Erogazione di un servizio + + Poniamoci in un contesto in cui la Porta di Dominio eroga dei servizi che + rispettano quanto descritto nelle Linee Guida 1.1. In questo contesto, i + soggetti di PdD che non si sono ancora adeguate alle linee guida, non potrebbero + usufruire dei servizi. La PdD può essere configurata, in modo da erogare i + servizi, per questi soggetti, secondo il profilo eGov 1.1. + Questa configurazione richiede che al soggetto fruitore venga associato un + profilo eGov 1.1. In un successivo momento, la PdD di un + soggetto fruitore può iniziare ad adeguarsi alle Linee Guida 1.1. Si creano + quindi due situazioni di transizione dove devono coesistere entrambe le + specifiche: + + Un soggetto fruisce per alcuni servizi erogati secondo le + specidiche e-Gov1.1, per altri secondo le Linee Guida 1.1 + + + Uno o più fruitori accedono al un servizio erogato secondo le + specidiche e-Gov1.1, altri secondo le Linee Guida 1.1 + + In entrmabi i casi, per erogare il servizio con la giusta + modalita (linee guida o e-gov 1.1) è possibile ridefinire il profilo + di gestione impostandolo nella lista dei fruitori del + servizio. + + + + Profilo di gestione e-Gov 1.1 + Il documento delle linee guida ha deprecato alcune opzioni al fine di snellire + la specifica. Per mantenere la conpatibilità con la vecchia versione viene + sempre offerta la possibilità di specificare tali opzioni all'interno degli + accordi di servizio. Tali funzionalità vengono impostate/validate all'interno + della busta e-Gov solo se il servizio viene fruito/erogato con profilo + eGov1.1. + + + Funzionalità eGov 1.1 + + + + + + + + + + Nome + + Default + + Funzionalità + + + + + + Filtro duplicati + + true + + Funzionalità di filtro delle buste duplicate (Imposta + l'attributo inoltro del profilo di trasmissione al valore + EGOV_IT_ALPIUUNAVOLTA). + + + + Conferma Ricezione + + false + + Funzionalità di consegna affidabile delle buste spcoop + attraverso l'utilizzo dei riscontri (Imposta l'attributo + confermaRicezione del profilo di trasmissione al valore + true). + + + + ID Collaborazione + + false + + Aggiunge un elemento Collaborazione alla busta (Diverse + istanze di cooperazione possono essere correlate in un'unica + conversazione). + + + + Consegna in ordine + + false + + Consegna in ordine delle buste (Richiede Filtro Duplicati e + Conferma Ricezione) + + + + Scadenza + + + + Assegna una scadenza temporale alla busta SPCoop + + + +
+ + Di seguito un esempio di creazione di un accordo di servizio che richiede + consegna affidabile tramite riscontri, filtro duplicati e id di collaborazione + per un servizio sincrono. + +
+ Controlli avanzati sulle informazioni eGov relative all'accordo di + servizio + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + Il Profilo "FatturaPA" + Il profilo "FatturaPA" consente di utilizzare GovWay come nodo di interconnessione al + Sistema di Interscambio (SdI), responsabile della gestione dei flussi di fatturazione + elettronica. + GovWay supporta la connessione al SdI attraverso lo scenario di interoperabilità su + rete Internet basato sull'accesso al servizio SdICoop. Il servizio + SdICoop prevede un protocollo di comunicazione, basato su SOAP, che veicola messaggi + (fatture, archivi, notifiche e metadati) secondo la codifica dettata dalle specifiche + tecniche (Per dettagli in merito si faccia riferimento alle Specifiche Tecniche SdI). + Il profilo FatturaPA di GovWay consente, ai sistemi di gestione delle fatture di un + ente, di non occuparsi della gestione del formato di scambio, previsto dal SdI, + mantenendo un grado di interfacciamento notevolmente semplificato. Più in dettaglio: + + I gestionali dell'ente, registrati come applicativi su GovWay, + inviano/ricevono le fatture e le notifiche, previste dal colloquio, nel + formato originario XML senza ulteriori complessità. + + + I metadati presenti nelle comunicazioni con il SdI vengono estratti ed + elaborati da GovWay e trasmessi ai gestionali dell'ente tramite appositi + Header di Integrazione SdI. + + + La produzione dei metadati SdI, nel caso delle comunicazioni in uscita + (fatturazione attiva), è a carico di GovWay che provvede anche a generare + gli identificativi univoci da associare ai messaggi da trasmettere al SdI. + + + + + Per la produzione delle configurazioni necessarie a rendere operativo GovWay sono + stati realizzati due wizard che guidano l'utente verso il corretto inserimento dei dati + necessari. Gli scenari di configurazione supportati sono due e riguardano i casi della + Fatturazione Passiva e Fatturazione + Attiva. + + Fatturazione Passiva + Nello scenario di fatturazione passiva si utilizza GovWay per la ricezione delle + fatture in arrivo dal SdI. GovWay attua la decodifica del messaggio SdI ricevuto, al + fine di estrarre i file fattura in esso contenuti e trasmetterli, nel formato + FatturaPA, all'applicativo registrato come destinatario. + Lo scenario complessivo, relativo alla Fatturazione Passiva, è quello illustrato + in .
+ Scenario di interoperabilità relativo alla Fatturazione Passiva + + + + + + + + +
Descriviamo per punti i passi significativi di questo scenario: + + + Servizio Ricezione Fatture. Per consentire a GovWay + di consegnare le fatture ricevute dal SdI è necessario esporre un + servizio i cui riferimenti per l'accesso dovranno essere configurati nel + contesto del Connettore RicezioneFatture, presente + nella configurazione di GovWay. + Le fatture vengono ricevute da GovWay formato codificato dal + protocollo SdI, e comprendono il lotto delle fatture, con i relativi + allegati, e un insieme di metadati che descrivono il contesto di + invocazione. GovWay si occupa di estrarre le informazioni presenti, + elaborando il messaggio SdI, provvedendo quindi a consegnare il lotto di + fatture al servizio destinatario, nel formato + FatturaPA attraverso l'invocazione di una HTTP + POST. I metadati raccolti dal messaggio SdI vengono forniti, nel + contesto della medesima richiesta, sotto forma di HTTP Headers (fare + riferimento alla ). + + + + Client Invio Notifica EC. I sistemi dell'ente, dopo + aver ricevuto le fatture, inviano le Notifiche di Esito + Committente, previste dal protocollo SdI, utilizzando un + apposito servizio di GovWay. La URL di invocazione di tale servizio sarà + disponibile al termine del processo di configurazione descritto più + avanti. GovWay provvede a codificare il messaggio SdI di richiesta + contenente il messaggio di notifica ricevuto dall'applicativo mittente. + I metadati prodotti per il messaggio SdI, unitamente all'identificativo + messaggio univoco generato, vengono restituiti all'applicativo mittente + sotto forma di HTTP Headers (fare riferimento alla ). + + + + Servizio Ricezione NDT. Per consentire a GovWay di + consegnare le eventuali Notifiche di Decorrenza + Termini è necessario esporre un servizio i cui + riferimenti per l'accesso dovranno essere configurati nel contesto del + Connettore NotificaDT, presente nella + configurazione di GovWay. + GovWay consegna le notifiche DT nel formato originale tramite una + HTTP POST, includendo come HTTP Headers i metadati estratti dal + messaggio SdI originariamente ricevuto (fare riferimento alla ). + + + + + + Header di Integrazione 'Ricezione Fattura + + + + + + Header + Descrizione + + + + + GovWay-SDI-FormatoArchivioBase64 + Indica se il file fattura è codificato in formato + Base64 + + + GovWay-SDI-FormatoArchivioInvioFattura + Indica se è stata utilizzata la modalità di firma CAdES o + XAdES (P7M o XML) + + + GovWay-SDI-FormatoFatturaPA + Indice di versione del formato FatturaPA adottato + + + GovWay-SDI-IdentificativoSdI + Identificativo assegnato dal SdI alla fattura + + + GovWay-SDI-MessageId + Identificativo assegnato alla fattura dall'ente + trasmittente + + + GovWay-SDI-NomeFile + Nome del file fattura + + + GovWay-SDI-NomeFileMetadati + Nome del file di metadati + + + GovWay-Transaction-ID + Identificativo della transazione assegnato da GovWay + + + +
+ + Header di Integrazione 'Invio Notifica EC' + + + + + + Header + Descrizione + + + + + GovWay-Transaction-ID + Identificativo della transazione assegnato da GovWay + + + +
+ + Header di Integrazione 'Ricezione Notifica DT' + + + + + + Header + Descrizione + + + + + GovWay-SDI-IdentificativoSdI + Identificativo assegnato dal SdI alla fattura + + + GovWay-SDI-NomeFile + Nome del file fattura + + + GovWay-Transaction-ID + Identificativo della transazione assegnato da GovWay + + + +
+ + Per produrre le configurazioni necessarie all'utilizzo dello scenario di + fatturazione passiva, è possibile utilizzare il wizard messo a disposizione per + semplificare l'attività di configurazione di GovWay. I passi da eseguire sono i + seguenti: + + Scaricare il govlet per la fatturazione passiva al seguente indirizzo + + + + + Avviare il govlet posizionandosi sulla sezione + Configurazione > Importa della GovWayConsole e + selezionare il file appena scaricato come oggetto da importare. + + + + Soggetto SDI: al primo step del wizard viene + richiesto di indicare, tra gli elementi presenti nella lista a discesa, + il soggetto interno destinatario delle fatture. Si tratta di un soggetto + appartenente al profilo "FatturaPA". + + + + Servizio SdIRiceviNotifica erogato dal Sistema di + Interscambio: al secondo step viene richiesto di indicare + la URL che corrisponde all'endpoint del servizio SdIRiceviNotifica, + necessario per l'invio delle Notifiche di Esito + Committente. + il valore suggerito dalla maschera di configurazione del + govlet fa riferimento alla url del sistema di produzione SDI. Se + si vuole configurare un servizio di test è necessario cambiare + tale valore ed impostare il riferimento all'ambiente di test + SDI. I certificati, sia per l'ambiente di test che di + produzione, devono essere stati inseriti nel truststore di + GovWay dopo averli prelevati all'indirizzo http://www.fatturapa.gov.it/export/fatturazione/it/normativa/f-3.htm + + + + + + + Credenziali per accesso URL NotificaEsito: al terzo + step viene richiesto di fornire il criterio di autenticazione utilizzato + dall'applicativo per inviare la notifica di esito committente. + + + + Applicativo per consegna FatturaPA: al quarto step + viene richiesto di fornire i dati di configurazione del connettore, + utilizzato da GovWay per la consegna delle fatture. La configurazione + del connettore comprende: endpoint, credenziali di autenticazione ed + eventualmente i riferimenti del proxy. + + + + Applicativo per consegna NotificaDecorrenzaTermini: + al quinto ed ultimo step viene richiesto di fornire i dati di + configurazione del connettore, utilizzato da GovWay per la consegna + della notifica di decorrenza termini. La configurazione del connettore + comprende: endpoint, credenziali di autenticazione ed eventualmente i + riferimenti del proxy. + + + + + Invio della Notifica di Esito Committente + Per l'invio della Notifica di Esito Committente l'applicativo mittente + utilizza una URL così composta: + http://<host-govway>/govway/sdi/out/xml2soap/<SoggettoSDI>/CentroServiziFatturaPA/SdIRiceviNotifica/1?NomeFile=<NomeFileFattura>&IdentificativoSdI=<identificativoSDI> + Dove: + + + host-govway: è l'hostname con cui è + raggiungibile l'istanza di Govway. + + + + SoggettoSDI: il soggetto interno destinatario + delle fatture, come configurato durante l'esecuzione del govlet di + fatturazione passiva. + + + + NomeFileFattura: è il nome del file che + contiene la fattura cui fa riferimento la notifica EC. + + + + identificativoSDI: è l'identificativo SDI che + fa riferimento al lotto della fattura ricevuta. + + + + La chiamata deve essere corredata dalle credenziali che sono state + indicate durante la configurazione tramite il relativo govlet. + + + + + + Fatturazione Attiva + Nello scenario di fatturazione attiva si utilizza GovWay per l'invio delle + fatture al SdI. GovWay attua la codifica dei file ricevuti al fine di produrre un + messaggio valido per l'invio al SdI. + Lo scenario complessivo, relativo alla Fatturazione Attiva, è quello illustrato + in .
+ Scenario di interoperabilità relativo alla Fatturazione Attiva + + + + + + + + +
Descriviamo per punti i passi significativi di questo scenario: + + + Client Trasmissione Fatture. I sistemi dell'ente + possono trasmettere le fatture al SdI tramite un apposito servizio di + ricezione di GovWay. La URL di invocazione di tale servizio sarà + disponibile al termine del processo di configurazione dello scenario di + fatturazione attiva descritto più avanti. Una volta ricevuta la fattura, + nel formato previsto da FatturaPA, GovWay provvede a codificare il + messaggio SdI di richiesta contenente la fattura da trasmettere. I + metadati prodotti per il messaggio SdI, unitamente all'identificativo + SdI, vengono restituiti all'applicativo mittente sotto forma di HTTP + Headers (fare riferimento alla ). + + + + + Servizio Ricezione Notifiche. I sistemi dell'ente + devono esporre un servizio adibilito alla ricezione delle notifiche che + il SdI invia successivamente alla trasmissione di una fattura. I + riferimenti per l'accesso a tale servizio dovranno essere configurati + nel contesto del Connettore NotificheSDI, presente + nella configurazione di GovWay. + GovWay consegna le notifiche, al servizio dell'ente, nel formato + originale tramite una HTTP POST, includendo come HTTP Headers i metadati + estratti dal messaggio SdI originariamente ricevuto (fare riferimento + alla ). + + + + + + Header di Integrazione 'Trasmissione Fatture' + + + + + + Header + Descrizione + + + + + GovWay-SDI-IdentificativoSdI + Identificativo assegnato dal SdI alla fattura + + + GovWay-SDI-NomeFile + Nome del file fattura + + + GovWay-Transaction-ID + Identificativo della transazione assegnato da GovWay + + + +
+ + Header di Integrazione 'Ricezione Notifiche' + + + + + + Header + Descrizione + + + + + GovWay-SDI-IdentificativoSdI + Identificativo assegnato dal SdI alla fattura + + + GovWay-SDI-NomeFile + Nome del file fattura + + + GovWay-Transaction-ID + Identificativo della transazione assegnato da GovWay + + + +
+ + Per produrre le configurazioni necessarie all'utilizzo dello scenario di + fatturazione attiva, è possibile utilizzare il wizard messo a disposizione per + semplificare l'attività di configurazione di GovWay. I passi da eseguire sono i + seguenti: + + Scaricare il govlet per la fatturazione attiva al seguente indirizzo + + + + + Avviare il govlet posizionandosi sulla sezione + Configurazione > Importa della GovWayConsole e + selezionare il file appena scaricato come oggetto da importare. + + + + Soggetto SDI: al primo step viene richiesto di + indicare, tra gli elementi presenti nella lista a discesa, il soggetto + interno mittente delle fatture. Si tratta di un soggetto appartenente al + profilo "FatturaPA". + + + + Servizio SdIRiceviFile erogato dal Sistema di + Interscambio: al secondo step viene richiesto di indicare + la URL che corrisponde all'endpoint del servizio SdIRiceviFile, erogato + dal SdI per la trasmissione delle fatture. + il valore suggerito dalla maschera di configurazione del + govlet fa riferimento alla url del sistema di produzione SDI. Se + si vuole configurare un servizio di test è necessario cambiare + tale valore ed impostare il riferimento all'ambiente di test + SDI. I certificati, sia per l'ambiente di test che di + produzione, devono essere stati inseriti nel truststore di + GovWay dopo averli prelevati all'indirizzo http://www.fatturapa.gov.it/export/fatturazione/it/normativa/f-3.htm + + + + + + + Credenziali per accesso URL RiceviFile: al terzo + step viene richiesto di fornire il criterio di autenticazione utilizzato + dall'applicativo per invocare la url del GovWay per la trasmissione + delle fatture. + + + + Applicativo per consegna Notifiche: al quarto ed + ultimo step viene richiesto di fornire i dati di configurazione del + connettore, utilizzato da GovWay per la consegna delle notifiche inviate + dal SdI, successivamente alla trasmissione di una determinata fattura. + La configurazione del connettore comprende: endpoint, credenziali di + autenticazione ed eventualmente i riferimenti del proxy. + + + + + Invio della fattura attiva + Per l'invio della fattura attiva l'applicativo mittente utilizza una URL così + composta: + http://<host-govway>/govway/sdi/out/xml2soap/<SoggettoSDI>/CentroServiziFatturaPA/SdIRiceviFile/1?Versione=<VersioneFatturaPA>&TipoFile=<TipoFile>&IdPaese=<IdPaese>&IdCodice=<IdCodice> + Dove: + + + host-govway: è l'hostname con cui è + raggiungibile l'istanza di Govway. + + + + SoggettoSDI: il soggetto interno destinatario + delle fatture, come configurato durante l'esecuzione. del govlet di + fatturazione passiva. + + + + Versione: versione della fattura che si sta + inviando: FPA12 (Fattura 1.2 per Pubbliche Amministrazione), FPR12 + (Fattura 1.2 per Privati), SDI11 e SDI10 (Fattura per Pubblica + amministrazione versione 1.1. e 1.0). + + + + TipoFile: tipo di fattura: P7M (Fattura + firmata) o ZIP (archivio di fatture). + + + + IdPaese e IdCodice: dati del trasmittente della + fattura. + + + + La chiamata deve essere corredata dalle credenziali che sono state + indicate durante la configurazione tramite il relativo govlet. + + + + + + + + + + Strumenti + + + Runtime + Questa sezione consente di visualizzare dati in tempo reale relativi al contesto + di esecuzione del gateway, con la possibilità di effettuare alcune modifiche di + stato. Le informazioni presenti sono: + + + Runtime: + + + Download: consente di effettuare il + download di un file di testo che contiene tutti i parametri + visualizzati nella pagina. + + + + ResetAllCaches: consente di effettuare + il reset contemporaneo di tutte le cache utilizzate dal + gateway. + + + + + + + Informazioni Generali: Informazioni sul prodotto e + sul software di base. + + + + Stato Servizi: Consente di abilitare/disabilitare + in tempo reale i servizi per l'elaborazione delle richieste in ingresso + intra ed extra dominio. + + + + Informazioni Diagnostica: Riferimenti ai file di + log attivi per il prodotto, con la possibilità di modificare in tempo + reale il livello di verbosità degli stessi. + + + + Informazioni Tracciamento: Riferimenti ai file + contenenti il tracciamento delle richieste in elaborazione sul gateway, + con la possibilità di abilitare/disabilitare le specifiche fonti. + + + + + Informazioni Database: Informazioni relative la + piattaforma database adottata. + + + + Informazioni SSL: Informazioni sulla configurazione + SSL. + + + + Informazioni Internazionalizzazione: Informazioni + sulla configurazione del servizio di internazionalizzazione. + + + + Informazioni Timezone: Timezone attivo. + + + + Informazioni Java Networking: Parametri di + configurazione inerenti la configurazione del networking a livello Java. + + + + + Informazioni Modalità Gateway: Contesti configurati + per ciascuna specifica modalità operativa. + + + + Cache: Parametri di configurazione di tutte le + cache adottate dal gateway, con la possibilità di effettuare il reset di + ciascuna singolarmente. + + + + Connessioni Attive: Evidenza in tempo reale delle + connessioni attive verso altri software a supporto (database, broker + jms, ecc.) + + + + Transazioni Attive: Riferimenti alle transazioni in + corso di elaborazione. + + + + Connessioni HTTP Attive: Evidenza in tempo reale + delle connessioni HTTP, aperte in uscita, per l'elaborazione delle + richieste in corso. + + + + + + + Auditing + + La funzionalità di auditing consente di tracciare il + comportamento degli utenti della govwayConsole, al fine di verificare le operazioni + eseguite e i loro effetti. + + Per gli aspetti di configurazione della funzionalità di auditing si rimanda alla + . + + In questa sezione descriviamo le interfacce della govwayConsole dedicate alla + consultazione delle informazioni raccolte tramite il servizio di auditing. + + Gli utenti della govwayConsole aventi il permesso [A] Auditing (vedi ) 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 . +
+ 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 + govwayConsole + + + + LOGOUT: disconnessione dalla + govwayConsole + + + + + + + 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 + govwayConsole. + + + + 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 ). +
+ 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 ). 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).
+ Dettaglio di una traccia di auditing + + + + + + + + +
+ + + + + + + Configurazione + Nella sezione del menu Configurazione si raggiungono le + funzionalità per modificare i parametri di configurazione del gateway. + + Generale + La sezione Configurazione > Generale consente di impostare i + parametri generali per le funzionalità di base del gateway (). In particolare è possibile: + + Attivare e configurare la modalità Multi-Tenant. Abilitando questa + modalità sarà ammessa la creazione di ulteriori soggetti interni al + dominio GovWay. + + + Configurare i profili fornendo i riferimenti ai servizi di base per + l'elaborazione dei messaggi ed al soggetto interno + + +
+ Maschera per l'impostazione dei parametri di configurazione + generale + + + + + + + + +
+ + + Multi-tenant + Per abilitare la modalità multi-tenant è sufficiente selezionare il valore + "abilitato" sull'elemento Stato. + Dopo aver abilitato l'opzione multi-tenant è possibile creare nuovi soggetti + interni al dominio, dalla . In questo + contesto, i soggetti avranno come elemento distintivo il dominio, che può essere + Interno o Esterno. + I dettagli sulla configurazione dell'opzione multi-tenant sono riportati + nella . + + + Profili + Per ciascuna delle modalità operative, attive sul gateway, è possibile + specificare i seguenti parametri: + + + Base URL Erogazione: Endpoint del servizio di + ricezione delle richieste di erogazione supportate dal gateway. + + + + + Base URL Fruizione: Endpoint del servizio di + ricezione delle richieste di fruizione supportate dal gateway. + + + + + Soggetto: Indicazione del soggetto interno che + eroga/fruisce i servizi che fanno riferimento agli endpoint di cui + sopra. Subito sotto il soggetto è presente un collegamento che porta + al form di editing del soggetto visualizzato. + + + + + + + Tracciamento + Accedendo la sezione Configurazione > Tracciamento si + possono configurare i dettagli per la registrazione delle informazioni inerenti gli + scambi sui servizi gestiti dal gateway. In particolare il gateway è in grado di + memorizzare le seguenti tipologie di informazioni: + + + Transazioni: tutte le proprietà inerenti il + contesto di invocazione dei servizi (dati di indirizzamento, esito, + tempi di elaborazione,...) + + + + Messaggi Diagnostici: tutte le informazioni + necessarie per comprendere la fase di elaborazione delle richieste e + indagare sulle anomalie occorse + + + + Messaggi Applicativi: salvataggio dei messaggi in + transito sulle singole comunicazioni + + + + In è mostrata la pagina di configurazione del + servizio di tracciamento.
+ Configurazione del servizio di tracciamento + + + + + + + + +
Vediamo il significato delle sezioni di questa pagina: + + + Transazioni Registrate: questa sezione consente di + specificare quali transazioni memorizzare nell'archivio di monitoraggio + in base all'esito rilevato in fase di elaborazione. Gli esiti sono + suddivisi nei seguenti gruppi: Completate con successo, Fault + applicativo, Fallite e Superamento Limite Richieste. Per ciascun esito è + possibile abilitare o disabilitare la registrazione. È possibile + inoltre, scegliendo l'opzione Personalizzato + specificare puntualmente quali esiti di dettaglio includere. + + + + Messaggi Diagnostici: questa sezione consente di + specificare il livello di verbosità dei messaggi diagnostici da + generare. Si può distinguere il livello di verbosità per il salvataggio + su Database e su File. + + + + Registrazione Messaggi: questa sezione consente di + abilitare e configurare la registrazione dei messaggi in transito sul + gateway durante l'elaborazione delle richieste e relative risposte. Una + volta abilitata l'opzione si possono configurare i dettagli della + funzionalità tramite il link Configurazione. + Dalla sottosezione di configurazione si può distinguere il criterio + di registrazione dei messaggi tra la Richiesta e la Risposta, + abilitando/disabilitando solo la comunicazione desiderata. Sia per la + Richiesta che per la Risposta, dopo aver optato per l'abilitazione della + registrazione, si distingue tra: + + + Ingresso: il messaggio di richiesta o + risposta nel momento in cui giunge sul gateway e quindi + prima che venga sottoposto al processo di elaborazione + previsto. + + + + Uscita: il messaggio di richiesta o + risposta nel momento in cui esce dal gateway, per + raggiungere il nodo successivo del flusso, e quindi dopo che + è stato sottoposto al processo di elaborazione previsto. + + + + + Per ciascuno dei messaggi, su cui è stata abilitata la registrazione, + è possibile scegliere quale elemento viene registrato: + + + Headers: vengono salvati gli header di + trasporto (HTTP HEADERS) associati al messaggio. + + + + Body: viene salvato il corpo del + messaggio. + + + + Attachments: vengono salvati gli + eventuali attachments presenti nel messaggio. + + + + + + + Le configurazioni effettuate in questa sezione della console hanno + valenza globale e quindi rappresentano il comportamento di default adottato + dal gateway nella gestione dei diversi flussi di comunicazione. Tale + comportamento può essere ridefinito puntualmente su ogni singola + erogazione/fruizione agendo sulla voce di configurazione + Tracciamento in quel contesto. + + + + + Controllo del Traffico + Accedendo la sezione Configurazione > Controllo del Traffico + si possono impostare i parametri di configurazione relativamente alla fuzionalità + che consente di stabilire le politiche di accesso alle risorse del gateway, + nell'ottica di amministrare le risorse applicative a disposizione, ottimizzando le + prestazioni e gestendo le situazioni di picco.
+ Maschera per l'impostazione dei parametri di controllo del + traffico + + + + + + + + +
La configurazione della funzionalità di controllo del traffico () si compone dei seguenti gruppi di + configurazioni: + + + Limitazione Numero di Richieste Complessive: + consente di fissare un numero limite, riguardo le richieste gestibili + simultaneamente dal gateway, bloccando le richieste in eccesso. + + + + Controllo della Congestione: consente di attivare + il rilevamento dello stato di congestionamento del gateway, in seguito + al superamento di una determinata soglia relativamente alle richieste + simultanee. + + + + Rate Limiting: sezione per l'impostazione di policy + al fine di attivare strategie di controllo del traffico con criteri di + selezione specifici della singola richiesta. + + + + Tempi Risposta: sezione per l'impostazione dei + valori limite relativi ai tempi di risposta dei servizi, sia nei casi di + erogazione che di fruizione. + + Le sezioni seguenti dettagliano questi elementi di configurazione. + + Limitazione Numero di Richieste Complessive + Il primo livello di configurazione, presente nella pagina di accesso, + consente di impostare i seguenti parametri: + + + Stato (abilitato | disabilitato | warningOnly): + Attiva il controllo sul numero di richieste simultanee in + elaborazione. Selezionando l'opzione abilitato + le richieste simultanee ricevute, che eccedono la soglia indicata + (parametro MaxRichiesteSimultanee) verranno + rifiutate restituendo al chiamante un errore. La tipologia di errore + restituita è configurabile tramite l’elemento Tipologia + Errore che appare solamente in caso di controllo + abilitato. + Il controllo sul numero di richieste simultanee in elaborazione + può anche essere attivato in modalità + WarningOnly dove, in caso il superamento + della soglia, genera solamente un messaggio diagnostico di livello + error e un evento che segnala l’accaduto. + + + + + Max Richieste Simultanee: Corrisponde al numero + massimo di richieste simultanee accettate. In genere è possibile + fornire un valore accurato dopo aver valutato la portata massima del + prodotto installato, in base alle risorse hardware disponibili e ai + parametri di dimensionamento delle risorse applicative (ad esempio: + numero connessioni al database, dimensioni della memoria java, ecc). + Al superamento di tale valore non verranno accettate ulteriori + richieste concorrenti, che verranno quindi rifiutate. Al verificarsi + di questa situazione il gateway emette un evento specifico. Queste + transazioni vengono marcate con esito Superamento Limite + Richieste e saranno registrate solamente se previsto + dalla configurazione (per default non vengono registrate). Per i + dettagli sulla configurazione delle transazioni da registrare in + base all'esito consultare . + + + + + Tipologia Errore e Includi + Descrizione Errore: Imposta il tipo di errore + restituito al chiamante nel caso di rifiuto dell'elaborazione per + superamento della soglia del numero massimo di richieste simultanee. + Le opzioni possibili sono le seguenti: + + + Fault: viene generato un messaggio + di Fault contenente un codice ed una descrizione + dell’errore rilevato nel caso l’elemento + Includi Descrizione Errore sia + abilitato, o un codice di errore generico altrimenti. + + + + + Http 429 (Too Many Requests) + + + Http 503 (Service Unavailable) + + + Http 500 (Internal Server Error) + + Viene generata una risposta HTTP con il codice + selezionato, contenente una pagina html di errore, se + l’elemento Includi Descrizione + Errore è abilitato, o una risposta http + vuota altrimenti. + + + + + + + Visualizza Informazioni Runtime: Selezionando + questo collegamento si apre una pagina () che mostra in + real-time le seguenti informazioni: + + + Richieste Attive: il numero di + richieste simultanee attualmente in corso di + elaborazione. + + + + Stato Gateway: indica se il gateway + ha raggiunto o meno lo stato di congestionamento, e + quindi superata la soglia sul numero massimo di + richieste simultanee. + L'indicatore è attivo solo nel caso in cui lo + stato della successiva opzione Controllo + della Congestione sia abilitato. + + + + + + Refresh: collegamento che consente + di aggiornare le informazioni presentate nello schermo. + + + +
+ Dati di congestionamento in tempo reale + + + + + + + + +
+ + + + + + + Controllo della Congestione + Questa sezione consente di impostare i parametri relativi al controllo della + congestione. Sono disponibili le seguenti opzioni: + + + Stato (abilitato | disabilitato): Attiva il + controllo sul numero di richieste simultanee al fine di individuare + lo stato di congestionamento. + + + + Soglia di Attivazione (%): Selezionando + l'opzione abilitato, al passo precedente, + questo elemento consente di indicare la soglia dello stato di + congestionamento. La soglia da indicare è in percentuale rispetto al + Numero Massimo Richieste Simultanee. Al superamento di tale soglia + si entra nello stato di congestionamento conseguente emissione di un + evento e un messaggio diagnostico al riguardo. + + + + Sulla base della percentuale indicata come soglia, una dicitura + riporta nella pagina il valore di congestionamento calcolato in base al + numero massimo di richieste simultanee. + +
+ Configurazione della soglia di congestionamento + + + + + + + + +
+ + + + Rate Limiting + Questa sezione consente di creare e attivare le policy di controllo del + traffico. Gli elementi di configurazione presenti sono: + + + Tipologia Errore e Includi + Descrizione Errore: Imposta il tipo di errore + restituito al chiamante nel caso venga rilevata una violazione delle + policy configurate: + + + Fault: viene generato un messaggio + di Fault contenente un codice ed una descrizione + dell’errore rilevato nel caso l’elemento + Includi Descrizione Errore sia + abilitato, o un codice di errore generico altrimenti. + + + + + Http 429 (Too Many Requests) + + + Http 503 (Service Unavailable) + + + Http 500 (Internal Server Error) + + viene generata una risposta HTTP con il codice + selezionato contenente una pagina html di errore se + l’elemento Includi Descrizione + Errore è abilitato, od una risposta http + vuota altrimenti. + + + + + + + Registro Policy: Consente di accedere al + Registro delle Policy per visualizzare, modificare e creare le + policy di controllo istanziabili per la configurazione del rate + limiting. Tra parentesi viene visualizzato il numero di policy + attualmente presenti nel registro. Questa funzionalità è descritta + nella . + + + + + Policy Globali: Consente di accedere al + Registro delle Policy Attivate in ambito globale, cioè operative sul + traffico complessivo che transita sul gateway. A queste policy si + aggiungono quelle eventualmente definite localmente nella + configurazione specifica di ciascuna erogazione/fruizione. + Tra parentesi viene visualizzato il numero di policy attualmente + attivate. Questa funzionalità è descritta nella . + + + + + Registro Policy + Il Registro delle Policy è il repository dove si possono creare le policy + di rate limiting che potranno essere successivamente istanziate. L'accesso + alla sezione è possibile grazie all'omonimo collegamento presente nella + sezione Rate Limiting della pagina principale del + controllo del traffico. + La pagina indice del Registro delle Policy mostra l'elenco delle policy + già presenti ().
+ Elenco delle Policy di Rate Limiting presenti nel + registro + + + + + + + + +
Tramite il pulsante “Aggiungi” è possibile aprire la pagina di + creazione di una policy di Rate Limiting ().
+ Maschera per la creazione di una policy di Rate Limiting + + + + + + + + +
Descriviamo nel seguito i dati che è necessario inserire per la + creazione di una policy. Si tenga presente che il sistema propone valori di + default per alcuni campi; tali valori cambiano in base alle scelte operate + sugli altri campi e possono essere considerati come “consigliati” in base + alla combinazione di scelte attuate. + + + Policy: In questa sezione sono presente i + dati che identificano la policy. + + + Nome: Nome assegnato alla + policy. Finché il campo non viene modificato + dall'utente, viene proposto automaticamente un nome + espressivo sulla base delle scelte operate sui + rimanenti elementi del form. + + + + Descrizione: Un testo di + descrizione riferito alla policy. Finché il campo + non viene modificato dall'utente, viene proposto un + testo automatico di descrizione sulla base delle + scelte operate sui rimanenti elementi del form. + + + + + Risorsa: Si seleziona la + risorsa che la policy deve monitorare al fine di + attuare le eventuali restrizioni. Sono disponibili + le seguenti risorse: + + + NumeroRichieste: La policy + effettua il controllo sul numero di richieste + gestite. Selezionando questa risorsa si + attiveranno i seguenti elementi per la + configurazione dei valori di soglia: + + + Simultanee + + + + + Modalità di Controllo + + + + + Numero Massimo di Richieste + + + + + Frequenza Intervallo + Osservazione + + + + + Intervallo Osservazione + + + + + Finestra Osservazione + + + + Se si attiva l'opzione “Simultanee” l'unico + campo visibile sarà: Numero Massimo di + Richieste + + + + + + + + OccupazioneBanda: La policy + effettua il controllo sulla banda occupata da e + verso le comunicazioni con il gateway. + Selezionando questa risorsa si attiveranno i + seguenti elementi per la configurazione dei valori + di soglia: + + + Modalità di Controllo + + + + + Tipo Banda + + + + + Occupazione Massima di Banda + (kb) + + + + + Frequenza Intervallo + Osservazione + + + + + Intervallo Osservazione + + + + + Finestra Osservazione + + + + + + + + TempoComplessivioRisposta: La + policy controlla la quantità di tempo + complessivamente impiegata dal gateway per la + ricezione delle risposte dai servizi invocati. + Selezionando questa risorsa si attiveranno i + seguenti elementi per la configurazione dei valori + di soglia: + + + Modalità di Controllo su Realtime (non + modificabile) + + + + + Tipo Latenza + + + + + Occupazione Massima di Tempo + (secondi) + + + + + Frequenza Intervallo + Osservazione + + + + + Intervallo Osservazione + + + + + Finestra Osservazione + + + + + + + + TempoMedioRisposta: La policy + controlla il tempo medio impiegato dal gateway per + la ricezione delle risposte dai servizi invocati. + Selezionando questa risorsa si attiveranno i + seguenti elementi per la configurazione dei valori + di soglia: + + + Modalità di Controllo + + + + + Tipo Latenza + + + + + Tempo Medio Risposta (ms) + + + + + Frequenza Intervallo + Osservazione + + + + + Intervallo Osservazione + + + + + Finestra Osservazione + + + + + + + + NumeroRichiesteCompletateConSuccesso + + + NumeroRichiesteFallite + + + NumeroFaultApplicativi + + La policy effettua il controllo sul numero + di richieste gestite dal gateway e terminate con + un esito che rientra nella casistica associata + alla risorsa selezionata (completate con successo, + fallite o fault applicativi). Selezionando questa + risorsa si attiveranno i seguenti elementi per la + configurazione dei valori di soglia: + + + Modalità di Controllo + + + + + Numero Massimo di Richieste + + + + + Frequenza Intervallo + Osservazione + + + + + Intervallo Osservazione + + + + + Finestra Osservazione + + + + + + + + + + + + + + Valori di Soglia: In questa sezione si + specificano i valori di soglia (già anticipati al punto + precedente), superati i quali, la policy risulta violata. Alcuni + campi presenti in questa sezione cambiano in base alla risorsa + monitorata. + + + Simultanee: Questa opzione è + presente solo per la risorsa “NumeroRichieste”. + Attivandola si specifica che il criterio restrittivo + entra in funzione al superamento di una soglia sul + numero di richieste simultaneamente in gestione. + + + + + Modalità di Controllo: + Rappresenta la modalità di raccolta dei dati di + traffico che saranno usati per la valutazione della + policy. Si può scegliere tra le seguenti opzioni: + + + Realtime: L'indicatore + utilizzato per valutare la policy viene calcolato + sulla base di dati raccolti in tempo reale durante + l'elaborazione. Questa modalità assicura la + massima accuratezza ma occorre tenere presenti le + seguenti restrizioni nell'uso: + + I dati “realtime” vengono raccolti in + maniera separata sui singoli nodi del cluster. + Quindi il controllo effettuato dalla policy + riguarderà il traffico sul singolo nodo. + + + Si possono impostare criteri di controllo + su grana temporale piccola: secondi, minuti, + orario, giornaliero. + + + + + + + Statistica: L'indicatore + utilizzato per valutare la policy viene calcolato + sulla base delle informazioni statistiche presenti + nel database di monitoraggio. L'accuratezza dei + dati utilizzati per la valutazione è subordinata + alla frequenza di aggiornamento dei dati + statistici sul database. In questa modalità: + + L'indicatore utilizzato per il confronto + con la soglia della policy è sempre complessivo + rispetto a tutti i nodi del cluster. + + + Si possono impostare criteri di controllo + con grana temporale ampia: orario, giornaliero, + settimanale, mensile. + + + Si può utilizzare la tipologia “finestra + scorrevole” come valore per la “Finestra + Osservazione”, che descriveremo poco più avanti. + + + + + + + + + + + Numero Massimo di Richieste: + Campo visibile solo per la risorsa monitorata + “NumeroRichieste”. Consente di specificare la soglia + per la policy. Quando il numero delle richieste, + conteggiate secondo la logica specificata nella + policy, supera questo valore, la policy risulta + violata. + + + + Tipo Banda: Campo visibile solo + per la risorsa monitorata “OccupazioneBanda”. + Consente di specificare la modalità di calcolo della + banda occupata per il confronto con la soglia + impostata nella policy. Sono disponibili le seguenti + opzioni: + + + Banda Interna: Ai fini del + conteggio dell'occupazione di banda (in KB) verrà + considerato il solo traffico relativo alle + comunicazioni con gli applicativi interni al + dominio. + + + + Banda Esterna: Ai fini del + conteggio dell'occupazione di banda (in KB) verrà + considerato il solo traffico relativo alle + comunicazioni con i servizi esterni al dominio. + + + + + Banda Complessiva: Ai fini + del conteggio dell'occupazione di banda (in KB) + verrà considerato tutto il traffico in entrata ed + uscita sul gateway. + + + + + + + Occupazione Massima di Banda + (kb): Campo visibile solo per la + risorsa monitorata “OccupazioneBanda”. Consente di + specificare la soglia per la policy. Quando la + banda, calcolata secondo la logica specificata nella + policy, supera questo valore, la policy risulta + violata. + + + + Tipo Latenza: Campo visibile + solo per le risorse monitorate + “TempoComplessivoRisposta” e “TempoMedioRisposta”. + Consente di specificare la logica di calcolo del + tempo di risposta sulla base delle due seguenti + opzioni: + + + Latenza Servizio: Per il + calcolo del tempo di risposta si considera + unicamente il tempo di attesa del gateway + dall'invio della richiesta alla ricezione della + risposta. + + + + Latenza Totale: Per il + calcolo del tempo di risposta si considera, oltre + alla latenza del servizio, anche il tempo di + elaborazione del gateway dal momento dell'ingresso + della richiesta fino all'uscita della risposta. + + + + + + + + Occupazione Massima di Tempo + (secondi): Campo visibile solo per la + risorsa monitorata “TempoComplessivoRisposta”. + Consente di specificare la soglia per la policy. + Quando la latenza complessiva, calcolata secondo la + logica specificata nella policy, supera questo + valore, la policy risulta violata. + + + + Tempo Medio Risposta (ms): + Campo visibile solo per la risorsa monitorata + “TempoMedioRisposta”. Consente di specificare la + soglia per la policy. Quando la latenza media, + calcolata secondo la logica specificata nella + policy, supera questo valore, la policy risulta + violata. + + + + Frequenza Intervallo + Osservazione + + + Intervallo Osservazione + + + Finestra Osservazione + + La composizione di questi 3 campi specifica in + quale intervallo temporale devono essere selezionati + i dati da utilizzare per calcolare l'indicatore che + deve essere confrontato con la soglia della policy. + I valori di “Frequenza Intervallo Osservazione” e + “Intervallo Osservazione” specificano la frequenza + di campionamento dei dati utilizzati per la + valutazione delle soglie. In particolare il valore + da specificare come Intervallo Osservazione è sempre + un numero intero (ad esempio inserendo 8 si + campioneranno i dati su finestre di 8 secondi, 8 + minuti, ecc, in base all'unità di misura indicata + per la frequenza). Il valore selezionato come + “Finestra Osservazione” individua l'esatto + intervallo utilizzato nella catena temporale ogni + volta che si valuta la policy per una specifica + richiesta di servizio. + Per comprendere la logica con cui viene calcolata + la finestra di osservazione è necessario introdurre + il concetto di Data Attivazione Policy. Si tratta + della data in cui la policy è stata applicata ad una + richiesta in transito sul gateway. A partire da + questa data vengono calcolate le finestre di + osservazione in base alla frequenza di campionamento + selezionata. + In Figura 8 è mostrato un confronto tra le + diverse finestre di osservazione su un campionamento + di 2 ore. La determinazione della finestra può + essere analogamente trasposta su altre frequenze di + campionamento. + Riepilogando: + + + Corrente: Indica che per il + calcolo dell'indicatore saranno utilizzati i dati + che rientrano nella finestra temporale in cui + ricade la richiesta in esame. + + + + Precedente: Indica che per il + calcolo dell'indicatore saranno utilizzati i dati + che rientrano nella finestra temporale precedente + a quella in cui ricade la richiesta in esame. + + + + + Scorrevole (disponibile solo nella + Modalità Controllo “Statistica”): + Indica che per il calcolo dell'indicatore saranno + utilizzati i dati che rientrano in una finestra + dinamica che ha come estremo superiore l'ora piena + subito precedente all'istante della richiesta in + fase di valutazione. + + +
+ Finestre di osservazione su un + campionamento di 2 ore + + + + + + + + +
+ + + + + + + + Applicabilità: Questa sezione della policy + consente di restringere l'applicabilità della policy sulla base + di alcuni criteri (). + Sono presenti i seguenti campi: + + + Condizionale: Se questa opzione + non è attiva, la policy si applica in maniera + incondizionata. Attivando l'opzione, la policy + risulterà applicabile sulla base dei criteri + specificati nei campi successivi. + + + + In presenza di Congestione del + Traffico: Attivando questa opzione la + policy risulta applicabile solo quando sussiste lo + stato di congestionamento. Affinché questo evento + venga rilevato è necessario che sia abilitato il + “Controllo della Congestione”, descritto in + precedenza, e che risulti superata la soglia + impostata sul numero di richieste simultanee. + + + + + In presenza di Degrado + Prestazionale: Attivando questa + opzione, la policy risulta applicabile solo in caso + si rilevi un degrado prestazionale sullo specifico + servizio corrispondente alla richiesta in gestione + sul gateway. Per la rilevazione del degrado + prestazionale si utilizzano le soglie “Tempo Medio + di Risposta” impostate sia per le fruizioni che per + le erogazioni. Come descritto in precedenza, tali + soglie vengono definite per default nella sezione + “Configurazione > Controllo del Traffico”, ma + possono essere ridefinite al livello del singolo + connettore. Per il calcolo del tempo medio di + risposta del servizio, da confrontare con la soglia + impostata, si utilizza il criterio definito con i + campi seguenti: + + + Modalità di Controllo + + + + + Tempo Medio Risposta + + + + + Frequenza Intervallo + Osservazione + + + + + Intervallo Osservazione + + + + + Finestra Osservazione + + + Per tutti questi campi valgono le + medesime descrizioni già riportate nella sezione + precedente “Valori di Soglia”. + + +
+ Opzioni per l'applicabilità di una policy di rate + limiting + + + + + + + + +
+ + Se si selezionano più opzioni di applicabilità queste + si considerano connesse secondo l'operatore logico AND. + + + + + + + + + Policy + Le policy di rate limiting vengono definite ed inserite nel Registro + delle Policy secondo le modalità descritte nella sezione precedente. Le + policy presenti nel Registro delle Policy non sono attive fino a quando non + vengono istanziate. + Dalla pagina Configurazione > Controllo del Traffico + selezionare il collegamento Policy, nella sezione + Rate Limiting, per accedere alle policy istanziate + ().
+ Elenco delle policy di Rate Limiting attivate + + + + + + + + +
La pagina indice delle Policy Istanziate mostra l'elenco delle + istanze già presenti e i pulsanti per le operazioni CRUD. + Tramite il pulsante Aggiungi è possibile aprire la + pagina che contiene il form di creazione di una nuova istanza di policy + ().
+ Creazione di una istanza relativa ad una policy di Rate + Limiting + + + + + + + + +
+ + Dalla pagina di creazione dell'istanza di policy il primo passo è quello + di selezionare la policy di origine tra quelle disponibili nel Registro + delle Policy. Una volta selezionata la policy è visibile come il sistema + assegni automaticamente un identificativo univoco per l'istanza e mostri + quindi i rimanenti campi per completare la configurazione. Di seguito si + descrivono in dettaglio tali sezione di configurazione. + + + Policy: la policy da attivare. Si compone + di: + + + Identificativo: Identificativo + univoco assegnato automaticamente all'istanza di + policy. + + + + Policy: La policy su cui è + basata l'istanza in fase di creazione. + + + + Nome: Opzionale. Permette di + identificare l’istanza della policy tramite un nome + alternativo all’identificativo assegnato + automaticamente dal sistema. + + + + Descrizione: Il testo di + descrizione della policy. + + + + Stato: Lo stato dell'istanza di + policy una volta creata. Sono disponibili le + seguenti opzioni: + + + Abilitato: L'istanza di + policy è abilitata. Questo significa che le + violazioni rilevate saranno gestite in maniera + restrittiva (negazione del servizio). + + + + WarningOnly: L'istanza di + policy è abilitata in modalità WarningOnly. Questo + significa che le violazioni rilevate saranno solo + segnalate tramite messaggi diagnostici ma non ci + saranno ripercussioni sull'elaborazione della + richiesta. + + + + Disabilitato: L'istanza di + policy è disabilitata. + + + + + + + Ridefinisci Valori di Soglia: + Attivando questa opzione sarà possibile utilizzare + una soglia per l'istanza di policy differente + rispetto a quella prevista dalla policy d'origine. + + + + + + + + Filtro: Abilitando questa sezione + dell'istanza di policy è possibile indicare i criteri per + stabilire quali richieste, in entrata sul gateway, sono soggette + alla policy che si sta istanziando. In assenza di filtro, + l'istanza della policy sarà valutata su tutte le richieste in + ingresso. + Per la creazione del filtro sono disponibili i seguenti campi + (): + + + Stato: Opzione per + abilitare/disabilitare il filtro. + + + + Ruolo Gateway: Opzione per + filtrare le richieste di servizio in base al ruolo + ricoperto dal gateway nella specifica richiesta: + Fruitore o Erogatore. + + + + Modalità: Opzione per filtrare + le richieste di servizio in base alla modalità + operativa. Nel caso si sia selezionata una singola + modalità (o se il gateway supporta una sola + modalità) viene visualizzato il valore attuale in + modo non modificabile. + + + + Ruolo Erogatore: Opzione per + filtrare le richieste di servizio in base al ruolo + posseduto dal soggetto erogatore. Tramite la lista è + possibile selezionare uno tra i ruoli censiti nel + registro. La selezione di un ruolo esclude la + possibilità di selezionare un soggetto erogatore. + + + + + Soggetto Erogatore: Opzione per + filtrare le richieste di servizio in base al + soggetto erogatore. Tramite la lista è possibile + selezionare uno tra i soggetti censiti nel registro. + La selezione di un soggetto esclude la possibilità + di selezionare un ruolo erogatore. + + + + Servizio: Opzione per filtrare + le richieste di servizio in base al servizio + invocato. Tramite la lista è possibile selezionare + uno tra i servizi censiti nel registro. Se è stato + selezionato un soggetto erogatore, saranno elencati + solo i servizi da esso erogati. Analogamente, se è + stata selezionata una modalità, saranno elencati + solo i servizi appartenenti a quella modalità. + + + + + Azione: Opzione per filtrare le + richieste di servizio in base all'azione invocata. + Tramite la lista è possibile selezionare una tra le + azioni censite nel registro. Se è stato selezionato + un servizio, saranno elencati solo le azioni ad esso + appartenenti. + + + + Applicativo Erogatore: Opzione + per filtrare le richieste di servizio in base + all'applicativo erogatore (opzione non disponibile + nel caso di una fruizione). Tramite la lista è + possibile selezionare uno tra gli applicativi + censiti nel registro. Se sono stati selezionati + servizi e/o soggetti, la lista presentata sarà + filtrata di conseguenza. + + + + Ruolo Fruitore: Opzione per + filtrare le richieste di servizio in base al ruolo + posseduto dal soggetto fruitore. Tramite la lista è + possibile selezionare uno tra i ruoli censiti nel + registro. La selezione di un ruolo esclude la + possibilità di selezionare un soggetto fruitore. + + + + + Soggetto Fruitore: Opzione per + filtrare le richieste di servizio in base al + soggetto fruitore. Tramite la lista è possibile + selezionare uno tra i soggetti censiti nel registro. + Se è stato selezionato un servizio, saranno elencati + solo i soggetti fruitori del medesimo. La selezione + di un soggetto esclude la possibilità di selezionare + un ruolo fruitore. + + + + Applicativo Fruitore: Opzione + per filtrare le richieste di servizio in base + all'applicativo fruitore (opzione non disponibile + nel caso di una erogazione). Tramite la lista è + possibile selezionare uno tra i servizi applicativi + censiti nel registro. Se sono stati selezionati + servizi e/o soggetti, la lista presentata sarà + filtrata di conseguenza. + + + + Filtro per Chiave: Si tratta di + un'opzione avanzata che consente di filtrare le + richieste in ingresso sul gateway base ad una chiave + che può essere specificata in maniera personalizzata + effettuando una delle seguenti scelte per il campo + Tipologia: + + + HeaderBased: Occorre fornire + i dati “Nome” e “Valore”. La policy si applicherà + soltanto alle richieste che hanno, nell'header di + trasporto, una proprietà che corrisponde. + + + + URLBased: Occorre fornire i + dati “Espressione Regolare” e “Valore”. La policy + si applicherà soltanto alle richieste ove, + applicando l'espressione regolare alla URL di + invocazione, si ottiene un valore identico a + quello fornito. + + + + FormBased: Occorre fornire i + dati “Nome” e “Valore”. La policy si applicherà + soltanto alle richieste che contengono nella query + string un parametro corrispondente ai dati + forniti. + + + + SOAPActionBased: Occorre + fornire il dato “Valore”. + La policy si + applicherà soltanto alle richieste che si + presentano con una SOAPAction avente il valore + fornito. + + + + ContentBased: Occorre fornire + i dati “Espressione XPath” e “Valore”. La policy + si applicherà soltanto alle richieste dove, + applicando l'espressione XPath al messaggio di + richiesta, si ottiene un valore identico a quello + fornito. + + + + PluginBased: Occorre fonire i + dati “Tipo Personalizzato” e “Valore”. Il + parametro “Tipo Personalizzato” è una chiave, + registrata nella configurazione, cui corrisponde + una classe java che restituisce un valore da + confrontare con quello fornito. Per realizzare un + plugin con una logica di filtro personalizzata è + necessario fornire un'implementazione della + seguente interfaccia: + +package org.openspcoop2.pdd.core.controllo_traffico.plugins; +public interface IRateLimiting { + public String estraiValoreFiltro(Logger log,Dati datiRichiesta) throws PluginsException; + public String estraiValoreCollezionamentoDati(Logger log,Dati datiRichiesta) throws PluginsException; +} + + La classe realizzata viene successivamente + registrata tramite una entry nel file + className.properties di + GovWay: + +org.openspcoop2.pdd.controlloTraffico.rateLimiting.test=<fully qualified class name> + + La stringa <nome>, fornita in + configurazione, diventa utilizzabile come “Tipo + Personalizzato”. + + + + È possibile specificare più di un criterio + di filtro; la logica applicata sarà quella + dell'operatore AND. + + + + +
+ Definizione del filtro per l'istanza della policy di + rate limiting + + + + + + + + +
+ + + + + Criterio di Collezionamento dei Dati: In + questa sezione è possibile attivare opzionalmente alcuni criteri + per il raggruppamento dei dati utilizzati come indicatori di + confronto per l'applicabilità della policy. Ad esempio se si è + attivata una policy che limita a 20 il numero di richieste su + una finestra di 5 minuti, significa che al raggiungimento della + ventunesima richiesta, nella stessa finestra temporale, si + otterrà una violazione della policy. + Aggiungendo un criterio di collezionamento per Soggetto + Erogatore, saranno conteggiate separatamente le richieste + destinate ad ogni singolo soggetto erogatore. In questo caso la + policy risulterà violata solo al raggiungimento della + ventunesima richiesta, nella stessa finestra temporale, + destinata al medesimo soggetto erogatore. + È ammesso anche il raggruppamento su criteri multipli. La + logica è del tutto analoga a quella dell'operatore GROUP BY del + linguaggio SQL. + I criteri di raggruppamento selezionabili sono (): + + + Ruolo (Fruitore/Erogatore) + + + + + Soggetto Erogatore + + + + + Servizio + + + + + Azione + + + + + Applicativo Erogatore + + + + + Soggetto Fruitore + + + + + Applicativo Fruitore + + + + + Raggruppamento per Chiave: le + richieste saranno raggruppate in base al valore di + una chiave personalizzata il cui valore viene + fornito secondo uno dei metodi selezionati tra i + seguenti: + + + HeaderBased: La chiave è + presente nell'header di trasporto indicato nella + proprietà "Nome". + + + + URLBased: La chiave è + presente nella URL ricavandola tramite + l'espressione regolare fornita nell'elemento + seguente. + + + + FormBased: La chiave viene + fornita in modalità Form Encoded con il parametro + indicato nell'elemento "Nome". + + + + SOAPActionBased: La chiave + corrisponde al valore della SoapAction. + + + + ContentBased: La chiave è + presente nel body del messaggio e viene ricavata + tramite il valore Xpath fornito nell'elemento + seguente. + + + + PluginBased: La chiave viene + restituita tramite l'esecuzione di una classe il + cui nome viene fornito con il campo "Tipo + Personalizzato" + + + + + +
+ Definizione del filtro per l'istanza della policy di + rate limiting + + + + + + + + +
+ + + + + + + Visualizzazione Statistiche Policy + Quando una policy è attivata si ha la possibilità di accedere ad una + finestra che fornisce una sintesi dei dati statistici legati + all'applicazione della policy in fase di controllo del traffico. + Per visualizzare questa finestra è sufficiente accedere all'elenco delle + policy attivate ed utilizzare il collegamento “Visualizza” nella colonna + “Runtime” (). +
+ Dati statistici relativi ad una policy di rate limiting + + + + + + + + +
Si noti che saranno visualizzati dei dati solo dopo la data di + attivazione della policy e cioè dopo che è transitata la prima richiesta cui + viene applicata la policy. + I dati statistici riportati sono i seguenti: + + + Criterio di Collezionamento dei dati: I + criteri di raggruppamento utilizzati dalla policy. + + + + Dati Generali: + + + Il numero istantaneo delle richieste + attive + + + + + la data di attivazione della policy (che + corrisponde alla data di primo utilizzo della + medesima) + + + + + + + + Dati collezionati per la risorsa + <nomeRisorsa>: dati di sintesi sulle + transazioni cui è stata applicata la policy. + + + + Sono inoltre disponibili i seguenti collegamenti: + + + Refresh: per aggiornare i dati + visualizzati. + + + + Reset Contatori: per azzerare i valori + visualizzati (solo nella modalità di controllo realtime). + + + + + + + + Tempi Risposta + In questa sezione vengono indicati i valori limite di default riguardo i + tempi di risposta dei servizi con cui il gateway interagisce durante + l'elaborazione delle richieste. Nel caso delle erogazioni, si tratta dei tempi + di risposta dei servizi interni, successivamente ad una richiesta di erogazione + dall'esterno. Nel caso delle fruizioni, si tratta dei tempi di risposta dei + servizi esterni, successivamente ad una richiesta di fruizione da parte di un + client interno al dominio. I tempi configurabili sono: + + + Connection Timeout (ms): Intervallo di tempo + atteso, sulle comunicazioni in uscita, prima di sollevare l'errore + Connection Timeout (scadenza del tempo di attesa per stabilire una + connessione). + + + + Read Timeout (ms): Intervallo di tempo atteso, + dopo aver stabilito una connessione in uscita, prima di sollevare + l'errore di Read Timeout (scadenza del tempo di attesa per ricevere + il payload dall'interlocutore). + + + + Tempo Medio di Risposta (ms): Valore di soglia + del tempo medio di risposta al fine di valutare la situazione di + Degrado Prestazionale, condizione per + l'applicabilità di eventuali politiche restrittive come documentate + più avanti. + + + + + + + Token Policy + Per poter definire politiche di controllo degli accessi basate sui Bearer Token è + necessario creare delle Token Policy da riferire nelle configurazioni degli + specifici servizi. La gestione delle Token Policy si effettua andando alla sezione + Configurazione > Token Policy della govwayConsole. Per + creare una nuova policy si utilizza il pulsante Aggiungi. Il + form di creazione appare inizialmente come quello illustrato in +
+ Informazioni generali di una Token Policy + + + + + + + + +
Inizialmente si inseriscono i dati identificativi: + + + Nome: nome univoco da assegnare alla policy + + + + Descrizione: testo di descrizione generale della + policy + + Al passo successivo si inseriscono le Informazioni Generali. Nella + sezione Token si specifica il tipo di token accettato e il + metodo di passaggio: + + + Posizione: indica la modalità di passaggio del + token da parte dell'applicativo richiedente. I valori possibili sono: + + + RFC 6750 - Bearer Token Usage: la + modalità di passaggio del token è una qualsiasi delle tre + previste dallo standard RFC 6750 (le tre opzioni successive + a questa). + + + + RFC 6750 - Bearer Token Usage (Authorization + Request Header Field): la modalità di + passaggio del token è quella che prevede l'inserimento + nell'header "Authorization" del messaggio di richiesta. Ad + esempio: + +GET /resource HTTP/1.1 +Host: server.example.com +Authorization: Bearer mF_9.B5f-4.1JqM + + + + + + RFC 6750 - Bearer Token Usage (Form-Encoded Body + Parameter): la modalità di passaggio del + token è quella di inserirlo nel body della richiesta, + eseguita con una POST, utilizzando il parametro + access_token, come ad esempio: + +POST /resource HTTP/1.1 +Host: server.example.com +Content-Type: application/x-www-form-urlencoded + +access_token=mF_9.B5f-4.1JqM + + + + + + RFC 6750 - Bearer Token Usage (URI Query + Parameter): la modalità di passaggio del + token è quella di utilizzare il parametro + access_token della Query String, + come ad esempio: + +GET /resource?access_token=mF_9.B5f-4.1JqM HTTP/1.1 +Host: server.example.com + + + + + + Header HTTP: la modalità di passaggio + del token è quella di inserirlo in un header http custom, il + cui nome deve essere fornito nel campo Nome Header + Http, che appare di seguito. + + + + Parametro URL: la modalità di passaggio + del token è quella di inserirlo in un parametro custom della + query string. Il nome del parametro deve essere fornito nel + campo Nome Parametro URL, che appare di + seguito. + + + + + + + Tipo: specifica il tipo di token che il gateway + attende di ricevere. I valori possibili sono: + + + JWS: un JSON Web Token di tipo + "Signed". + + + + JWE: un JSON Web Token di tipo + "Encrypt". + + + + Opaco: un generico token di tipo non + specificato. + + + + + Nella sezione Elaborazione Token si specificano + le azioni che si possono compiere durante la fase di elaborazione del token + ricevuto. Le opzioni disponibili sono: + + Validazione JWT + + + Token Introspection + + + OIDC - UserInfo + + + Token Forward + + Le sezioni successive dettagliano questi elementi. + + Validazione JWT + Nel caso in cui il token sia di tipo JWT (quindi JWE o JWS), questa opzione + attiva la validazione basata su tale standard ().
+ Dati di configurazione della validazione JWT + + + + + + + + +
I dati da inserire sono: + + + Claims Parser: indica il tipo di parser che + deve essere utilizzato per la validazione del token JWT. I valori + possibili sono: + + + RFC 7519 - JSON Web Token + + + + + OpenID Connect - ID Token + + + + + Google - ID Token + + + + + Personalizzato: nel caso del parser + personalizzato occorre fornire il relativo ClassName + della classe con la logica di parsing. + + + + + + + KeyStore: I parametri di configurazione del + keystore da utilizzare per il servizio di validazione. + + + + + + Token Introspection + Questa sezione consente di attivare la validazione del token ricevuto + attraverso un servizio di Token Introspection i cui dati di accesso devono + essere forniti in questo contesto (). +
+ Dati di puntamento al servizio di Token Instrospection + + + + + + + + +
Per il corretto puntamento al servizio di Token Introspection devono + essere forniti in prima istanza i parametri generali legati all'endpoint + riferito: + + + Connection Timeout: Tempo massimo in + millisecondi di attesa per stabilire una connessione con il server + di validazione token. + + + + Read Timeout: Tempo massimo in millisecondi di + attesa per la ricezione di una risposta dal server di validazione + token. + + + + Https: Parametri di configurazione nel caso in + cui il server di validazione token richieda un accesso Https. + + + + + Proxy: Parametri di configurazione nel caso in + cui il server di validazione token richieda l'uso di un proxy per + l'accesso. + + Successivamente devono essere forniti i dati di configurazione + specifici del servizio di Token Introspection: + + + Tipo: tipologia del servizio. A scelta tra i + seguenti valori: + + + RFC 7662 - Introspection: Servizio + di introspection conforme allo standard RFC 7662. + Richiede che vengano forniti i seguenti dati: + + + URL: endpoint del servizio di + introspection. + + + + Autenticazione Http Basic: + flag da attivare nel caso in cui il servizio di + introspection richieda autenticazione di tipo + HTTP-BASIC. In questo caso dovranno essere forniti + Username e Password nei campi successivi. + + + + Autenticazione Bearer: flag + da attivare nel caso in cui il servizio di + introspection richieda autenticazione tramite un + token. Quest'ultimo dovrà essere indicato nel + campo seguente. + + + + Autenticazione Https: flag da + attivare nel caso in cui il servizio di + introspection richieda autenticazione di tipo + Https. In questo caso dovranno essere forniti + tutti i dati di configurazione nei campi seguenti. + + + + + + + + Google - TokenInfo: Riferimento al + servizio di token introspection di Google. L'unico campo + da fornire in questo caso è la URL del servizio. Il + sistema precompila questo campo con il valore di default + https://www.googleapis.com/oauth2/v3/tokeninfo. + + + + + Personalizzato: Questa opzione + consente di configurare un servizio di Token + Introspection personalizzato ().
+ Configurazione personalizzata del servizio di + Token Instrospection + + + + + + + + +
I dati da fornire sono: + + + URL: la URL del servizio di + introspection. + + + + Http Method: Il metodo HTTP + che deve essere utilizzato per la chiamata al + servizio di introspection. + + + + Posizione Token: Il metodo di + passaggio del token al servizio di introspection. + Sono supportati i classici metodi: HTTP + Authorization Bearer, Header HTTP, Parametro URL e + Parametro Form-Encoded Body. Negli ultimi tre casi + sarà necessario fornire il nome dell'header o del + parametro. + + + + Claims Parser: Il metodo di + parsing dei claims che vengono restituiti dal + servizio di introspection. I valori possibili + sono: RFC 7662 - Introspection, Google - TokenInfo + e Personalizzato. In quest'ultimo caso si dovrà + fornire il ClassName della classe contenente la + logica di parsing. + + + + Autenticazione: Analogamente + a quanto visto in precedenza è necessario indicare + con il flag opportuno il tipo di autenticazione + richiesta dal servizio di introspection + personalizzato. + + + + + + + + + + + + OIDC - UserInfo + Sezione per attivare la richiesta al servizio di UserInfo per ottenere i dati + inerenti l'utente possessore del token ricevuto ().
+ Dati di puntamento al servizio di UserInfo + + + + + + + + +
Per il corretto puntamento al servizio di UserInfo devono essere + forniti in prima istanza i parametri generali legati all'endpoint riferito, che + sono in comune con quelli del servizio di Token Introspection, e quindi già + descritti in precedenza. + Successivamente si dovranno fornire i dati di configurazione specifici per il + servizio UserInfo, che sono: + + + Tipo: Si seleziona il tipo di servizio UserInfo + riferito. I valori possibili sono: + + + OpenID Connect - UserInfo: servizio + di UserInfo standard OpenID Connect. + + + + Google - UserInfo: servizio + UserInfo di Google. La URL di default del servizio viene + inserita automaticamente. + + + + Personalizzato: si consente di + fornire i dati di configurazione di un servizio + personalizzato di UserInfo. I dati di configurazione + sono gli stessi già descritti nel caso della + configurazione del servizio di Token Introspection + personalizzato. + + + + + + + URL: La URL del servizio di UserInfo. + + + + Autenticazione: La configurazione del metodo di + autenticazione, quando applicabile. + + + + + + Token Forward + Azione di elaborazione che consiste nell'inoltro del token ricevuto al + destinatario. Una volta attivata questa opzione, devono essere indicate le + seguenti informazioni: + + + Originale: opzione che consente di inoltrare il + token originale al destinatario. Attivando questo flag è necessario + specificare la modalità di inoltro a scelta tra le seguenti opzioni: + + + Come è stato ricevuto: Il token + viene inoltrato al destinatario utilizzando lo stesso + metodo con cui è stato ricevuto dal gateway. + + + + RFC 6750 - Bearer Token Usage (Authorization + Request Header Field): Il token viene + inoltrato al destinatario utilizzando l'header + Authorization presente nella richiesta HTTP. + + + + RFC 6750 - Bearer Token Usage (URI Query + Parameter): Il token viene inoltrato al + destinatario tramite parametro access_token della Query + String. + + + + Header HTTP: : Il token viene + inoltrato al destinatario utilizzando un header HTTP il + cui nome deve essere specificato nel campo seguente. + + + + + Parametro URL Il token viene + inoltrato al destinatario utilizzando un parametro della + Query String il cui nome deve essere specificato nel + campo seguente. + + + + + + + Informazioni Raccolte: opzione disponibile + quando è stata abilitata una delle azioni di validazione del token + (introspection, user info o validazione JWT), consente di veicolare + i dati ottenuti dal servizio di validazione, al destinatario. Una + volta attivato il flag è necessario specificare la modalità di + inoltro dei dati selezionando una tra le opzioni seguenti: + + + GovWay Headers: I dati raccolti dal + token vengono inseriti nei seguenti header HTTP: + +GovWay-Token-Issuer +GovWay-Token-Subject +GovWay-Token-Username +GovWay-Token-Audience +GovWay-Token-ClientId +GovWay-Token-IssuedAt +GovWay-Token-Expire +GovWay-Token-NotToBeUsedBefore +GovWay-Token-Scopes +GovWay-Token-FullName +GovWay-Token-FirstName +GovWay-Token-MiddleName +GovWay-Token-FamilyName +GovWay-Token-EMail + + + + + + GovWay JSON: I dati raccolti dal + token vengono inseriti in un oggetto JSON, il cui + JsonSchema è il seguente: + +{ + "required" : [ "id" ], + "properties": { + "id": {"type": "string"}, + "issuer": {"type": "string"}, + "subject": {"type": "string"}, + "username": {"type": "string"}, + "audience": {"type": "string"}, + "clientId": {"type": "string"}, + "iat": { + "type": "string", + "format": "date-time" + }, + "expire": { + "type": "string", + "format": "date-time" + }, + "expire": { + "type": "string", + "format": "date-time" + }, + "roles": { + "type": "array", + "items": {"type": "string"} + }, + "scope": { + "type": "array", + "items": {"type": "string"} + }, + "userInfo": { + "type": "object", + "properties": { + "fullName": {"type": "string"}, + "firstName": {"type": "string"}, + "middleName": {"type": "string"}, + "familyName": {"type": "string"}, + "email": {"type": "string"}, + }, + "additionalProperties": false + } + }, + "additionalProperties": false +} + + Il JSON risultante viene inserito nell'Header HTTP + GovWay-Token. + + + + GovWay JWS: I dati raccolti dal + token vengono inseriti in un oggetto JSON, come + descritto al punto precedente. In questo caso il token + JSON viene inserito successivamente in un JWT e quindi + firmato. Il JWS risultante viene inserito nell'Header + HTTP GovWay-JWT. + + + + JSON: Le informazioni ottenute dai + servizi di introspection, userinfo o il json estratto + dal token jwt dopo la validazione, vengono inseriti + negli header http o proprietà delle url indicati. + Le informazioni sono esattamente quelle + recuperate dai servizi originali (o presenti nel + token originale nel caso di validazione + jwt). + + + + + + JWS/JWE: Uguale alla modalità JSON + con la differenza che negli header http, o nelle + proprietà delle url, vengono inseriti dei JWT firmati + (caso JWS) o cifrati (caso JWE) contenenti al loro + interno il JSON. + + + + + + + + + + Utenti + La sezione Configurazione > Utenti è dedicata alla gestione + degli utenti dei cruscotti grafici govwayConsole e govwayMonitor. + Prima di descrivere le funzionalità relative alla gestione utenti è necessario + fare una premessa sull'organizzazione dei permessi che sono assegnabili ad un + utente. + Le funzionalità delle console grafiche sono partizionate in gruppi cui + corrispondono puntuali permessi che possono essere concessi agli utenti per + limitarne l'operatività. Vediamo quali sono i gruppi funzionali, e conseguentemente + i permessi associabili a ciascun utente: + + + Registro + + + Gestione API [S] - Gestione delle + entità di configurazione dei servizi, quali: API, + Erogazioni, Fruizioni, ecc. + + + + + + + GovWay Monitor + + + Monitoraggio [D] - Accesso alle + funzionalità di monitoraggio della console + govwayMonitor. + + + Reportistica [R] - Accesso alle + funzionalità di reportistica della console + govwayMonitor. + + + + + + + Strumenti + + + Auditing [A] - Accesso alle + funzionalità di consultazione delle tracce del servizio di + Auditing. + + + + + + + Configurazione + + + [C] - Accesso alle funzionalità di + configurazione. Queste funzionalità sono quelle presenti nel + menu di navigazione nel gruppo + Configurazione e riguardano: + tracciamento, controllo del traffico, import-export, + ecc. + + + [U] - Possibilità di gestire gli + utenti delle console. Gli utenti con questo permesso, sono + di fatto dei superutenti in quanto possono assumere + l'identità di un qualunque utente del sistema. + + + + + + + Altri Permessi (visibili solo configurazione specifica del + prodotto) + + + [P] - Gestione delle entità di + configurazione degli Accordi di Cooperazione e Servizi + Composti. + + + [M] - Accesso alle code messaggi sul + gateway. Questa autorizzazione consente ad esempio di + consultare i messaggi presenti nelle Message Box + dell'Integration Manager ed eventualmente effettuare delle + rimozioni. + + + + + + + L'applicazione, al termine dell'installazione, contiene una utenza (credenziali + indicate durante l'esecuzione dell'installer) che permette di effettuare tutte le + principali operazioni di gestione. + Gli utenti in possesso del permesso [U] possono creare dei nuovi utenti. La + maschera di creazione di un nuovo utente è quella mostrata in .
+ Creazione nuovo utente + + + + + + + + +
Le informazioni da inserire sono: + + + Informazioni Utente + + + + Nome + + + + + + + + Permessi di Gestione: sezione che consente di + assegnare i permessi all'utente e quindi decidere quali funzionalità + rendergli accessibili. + + + + Profilo di Interoperabilità: sezione che consente + di decidere quali, tra i profili disponibili, rendere accessibili + all'utente. + + + + Visibilità dati tramite govwayMonitor: questa + sezione è visibile solo se è stato abilitato uno dei permessi "GovWay + Monitor". In questo contesto è possibile stabilire la visibilità + dell'utente sulla console GovWay Monitor riguardo i seguenti: + + + Soggetti: opzione visibile solo se + attiva la modalità multi-tenant, consente di limitare la + visibilità delle entità di monitoraggio ai soli soggetti + interni indicati in una whitelist. Per configurare la + whitelist è necessario salvare l'utente da creare e + successivamente accedere in editing. In alternativa è + possibile attivare il flag "Tutti" per non assegnare + limitazioni. + + + + API: consente di limitare la visibilità + delle entità di monitoraggio alle sole API indicate in una + whitelist. Per configurare la whitelist è necessario salvare + l'utente da creare e successivamente accedere in editing. In + alternativa è possibile attivare il flag "Tutti" per non + assegnare limitazioni. + + + + + + + Modalità Interfaccia: opzione per decidere quale + modalità, tra standard e avanzata, è quella di default per l'utente. + + + + + Password: sezione per l'impostazione della password + dell'utente. + + + + La pagina indice della sezione Utenti visualizza gli utenti già presenti nel + sistema con i relativi permessi e i link per modificarli o assumerne l'identità + ()
+ Lista degli utenti + + + + + + + + +
+ + + + + Importa + L'importazione di entità nel registro può essere effettuata tramite la sezione + accessibile con la voce di menu Importa presente nella sezione + Configurazione. + Il form che compare per l'importazione è quello riportato in . I passi da eseguire sono i seguenti: + + Selezionare la modalità cui fanno riferimento le entità contenute + nell'archivio da importare. + + + In base alla modalità selezionata potrebbero essere richieste + ulteriori informazioni. Ad esempio, per il protocollo SPCoop, verrà + richiesto quale tipo di archivio si vuole importare, a scelta tra: + + + spcoop: il formato standard basato + sulle specifiche SPCoop + + + + govlet: il formato di govway. Gli + archivi con tale formato sono ottenibili o attraverso + un'esportazione effettuabile tramite govwayConsole o + scaricando le govlets disponibili sul sito del progetto che + permettono di pre-configurare GovWay per uno specifico + servizio + + + + + + + Validazione Documenti (disponibile solamente con + interfaccia in modalità avanzata, per default è abilitato): Se attivato, + questo flag indica che i documenti presenti nell'archivio vengono + validati prima di essere importati (es. wsdl, xsd ...). + + + + Aggiornamento: Se attivato, questo flag indica che + l'archivio da importare costituisce un aggiornamento del registro + attuale. + + + Selezionare dal filesystem il file che corrisponde all'archivio che + deve essere importato. + + +
+ Importazione di entità nel registro + + + + + + + + +
+ + + + + Esporta + L'esportazione dei dati di configurazione dalla govwayConsole è possibile nei + modi seguenti: + + Selezionando singolarmente le entità di configurazione da esportare, + come ad esempio "Erogazioni" o "API", e premendo il pulsante + Esporta (). +
+ Esportazione di singole entità del registro + + + + + + + + +
+ Dopo aver selezionato il pulsante "Esporta", una seconda maschera + () riporta le seguenti + informazioni: + + Profilo Interoperabilità: indicazione + del profilo cui fa riferimento l'esportazione. + + + Tipologia archivio: se previsto, fa + selezionare la tipologia di archivio da produrre. Il default + è il formato Govlet standard di + esportazione di Govway. + + + Includi elementi riferiti: include + nell'archivio di esportazione anche gli elementi di + configurazione riferiti da quelli selezionati. + + + +
+ Esportazione di entità nel registro + + + + + + + + +
+ + + Tramite la voce di menu Configurazione > Esporta + che presenta le opzioni mostrate in . +
+ Esportazione di entità nel registro + + + + + + + + +
+ Le opzioni presenti sono: + + Profilo Interoperabilità: indica + quale profilo riguarda l'esportazione che si sta + effettuando + + + Tipologia Archivio: nei casi che lo + prevedono, consente di specificare il formato dell'archivio + di esportazione da produrre. + + + Modalità: consente di specificare + cosa esportare tra le seguenti possibilità: + + Esportazione completa: + esportazione dell'intero repository di + configurazione (limitatamente al profilo di + interoperabilità selezionato, se diverso da + "Tutti"). + + + Registro: esporta solo le + entità del registro (erogazioni, fruizioni, api, + ecc) + + + Configurazione: esporta + solo le entità della sezione Configurazione (token + policy, tracciamento, ecc). + + + + + + + + + + + Il formato dell'archivio prodotto come risultato dell'esportazione dipende dalla + modalità cui fanno riferimento le entità selezionate. + + + + Auditing + In questa sezione descriviamo le modalità di configurazione del servizio di + auditing, al fine di definire quali informazioni devono essere tracciate, con che + formato e con che livello di dettaglio. + Gli utenti con permesso [C] Configurazione (vedi ) + 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. + Se la maschera si presenta come in il servizio di + auditing è disabilitato e quindi nessun dato verrà tracciato. +
+ Servizio di auditing disabilitato + + + + + + + + + + +
+ Modificando lo Stato del servizio di auditing in Abilitato appariranno ulteriori campi nel form (vedi + ) per effettuare le impostazioni. + +
+ 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 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 (http://www.json.org) 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 è mostrata la maschera per la creazione di un nuovo + filtro di auditing. +
+ Creazione di un filtro per il servizio di auditing + + + + + + + + + + +
+ Facendo riferimento alla 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 govwayConsole 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 govwayConsole (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. + + + + + + + + + + + Funzionalità Avanzate + + + Configurazione manuale delle interfacce + Nel caso non si disponga del descrittore della API, è possibile in alternativa + fornire manualmente la specifica delle interfacce. Dopo aver salvato la nuova API, + senza aver fornito il descrittore delle interfacce, si procede individuando il nuovo + elemento nella lista delle API presenti e cliccando sul collegamento presente nella + colonna Servizi, nel caso SOAP, o Risorse + nel caso REST. + Nel caso SOAP, si procede aggiungendo il nuovo servizio tramite il pulsante + Aggiungi. Il form da compilare è quello mostrato nella + figura seguente.
+ Aggiunta di un servizio alla API SOAP + + + + + + + + +
I dati da fornire sono i seguenti: + + Nome del servizio + + + Descrizione del servizio + + + Profilo di collaborazione del servizio, a scelta + tra oneway e sincrono + + + ID Collaborazione. Flag per consentire di + specificare nelle richieste un valore che identifica una + conversazione. + + + Riferimento ID Richiesta. Flag per consentire di + specificare nelle richieste un identificativo relativo ad un messaggio + precedente. + + Al passo successivo, utilizzando il collegamento nella colonna + Azioni, relativamente al servizio appena creato, si procede + con l'aggiunta delle azioni. Il form da compilare è quello mostrato nella figura + seguente.
+ Aggiunta di un'azione alla API SOAP + + + + + + + + +
I dati da fornire sono i seguenti: + + Nome dell'azione + + + Profilo. Si può scegliere se utilizzare le + impostazioni già fornite a livello del servizio, oppure ridefinirle + indicando nuovamente Profilo di collaborazione, ID Collaborazione e + Riferimento ID Richiesta. + + + + Nel caso REST, si procede aggiungendo la nuova risorsa tramite il pulsante + Aggiungi. Il form da compilare è quello mostrato nella + figura seguente.
+ Aggiunta di una risorsa alla API REST + + + + + + + + +
I dati da fornire sono i seguenti: + + HTTP Method relativo alla risorsa (GET, POST, + DELETE, ecc.) + + + Path della risorsa + + + Nome della risorsa + + + Descrizione della risorsa + + + ID Collaborazione. Flag per consentire di + specificare nelle richieste un valore che identifica una + conversazione. + + + Riferimento ID Richiesta. Flag per consentire di + specificare nelle richieste un identificativo relativo ad un messaggio + precedente. + + + + + + + Modalità di identificazione dell'azione + Nel contesto dei servizi Soap, sia erogazioni che fruizioni, si ha la possibilità + di selezionare una tra diverse opzioni che riguardano la modalità di identificazione + dell'azione. Dopo aver acceduto la sezione URL di Invocazione, + relativamente alla fruizione o erogazione, si può selezionare una tra le seguenti + opzioni: + + + content-based (Soap e Rest): il dato viene ricavato + dal messaggio di richiesta utilizzando come criterio l'espressione XPath + indicata nel campo Pattern sottostante. + + + + header-based (Soap e Rest): il dato viene ricavato + da un valore passato come Http Header. Il campo sottostante consente di + specificare il nome di tale header. + + + + input-based (Soap e Rest): il dato viene ricavato + dall'header di integrazione fornito con il messaggio di richiesta. Per + conoscere come gli applicativi client forniscono tale informazione + vedere la sezione + + + + + interface-based (Soap e Rest): il dato viene + ricavato in automatico sulla base delle informazioni fornite con la + richiesta (messaggio e parametri) confrontandole con la descrizione + dell'interfaccia del servizio. + + + + url-based (Soap): il dato viene ricavato + dinamicamente dalla url di invocazione utilizzando come criterio + l'espressione regolare inserita nel campo Pattern + sottostante. + + + + soap-action-based (Soap): Questa opzione consente + di ricavare il dato dal campo SoapAction presente + nell'header di trasporto delle comunicazioni SOAP. + + + + Attivando il flag Force interface, in caso di fallimento + dell'identificazione dell'azione nella modalità prevista al passo precedente, si + tenterà di utilizzare la modalità "interface-based" come seconda opzione. + Il campo Azioni illustra l'elenco delle azioni presenti per + semplice comodità. + + + + Modalità Avanzata + L'interfaccia della govwayConsole, fin qui descritta, fa riferimento + all'operatività nella modalità standard. La modalità standard + prevede varie semplificazioni, sulle opzioni visualizzate nelle schermate, mirate al + compimento delle operazioni di uso comune. + Nel caso si avesse la necessità di ricorrere a configurazioni più specifiche, non + contemplate nella modalità standard, è possibile passare alla visualizzazione + dell'interfaccia nella Modalità Avanzata utilizzando la voce + omonima del menu a discesa che compare selezionando l'icona in alto a destra (nella + testata della govwayConsole). + Operando in modalità avanzata, in ciascuno dei contesti di configurazione già + descritti in questo manuale, compariranno opzioni aggiuntive per le quali sono + previsti valori di default nel caso della modalità standard. + Nella modalità avanzata sarà disponibile la funzionalità aggiuntiva + Elimina, presente nel menu di Configurazione, che consente + di utilizzare package di esportazione per l'eliminazione selettiva di entità dal + registro. + + Non tutte le funzionalità disponibili in modalità avanzata sono descritte nel + presente manuale. + + + + Multi-Tenant + I processi di configurazione, descritti in questo manuale, sono ottimizzati + nell'ottica di mantenere sempre sottinteso il soggetto interno al dominio. In tal + senso, le fruizioni e le erogazioni si intendono sempre in soggettiva riguardo un + singolo soggetto interno amministrato dall'utente in sessione. + + Multi-tenant è un'opzione che consente di estendere l'ambito + delle configurazioni prodotte dalla govwayConsole a più di un soggetto interno al + dominio. Tale opzione si attiva nella configurazione generale (). + Per gestire la compresenza di più soggetti interni al dominio, per la + configurazione di erogazioni e fruizioni, è possibile scegliere quali soggetti + interni rendere ammissibili (): + + + Fruizioni (Soggetto Erogatore) + + + + Tutti: indica che tutti i soggetti + interni, censiti nel registro di GovWay, sono selezionabili + come soggetto erogatore, in una fruizione. + + + + Escludi Soggetto Fruitore: indica che + tutti i soggetti interni, tranne il soggetto fruitore, sono + selezionabili come soggetto erogatore, in una fruizione. + + + + + Solo Soggetti Esterni: indica che il + soggetto erogatore di una fruizione deve essere un soggetto + esterno. + + + + + + + Erogazioni (Soggetti Fruitori) + + + + Tutti: indica che tutti i soggetti + interni, censiti nel registro di GovWay, sono selezionabili + come soggetti fruitori, in una erogazione. + + + + Escludi Soggetto Erogatore: indica che + tutti i soggetti interni, tranne il soggetto erogatore, sono + selezionabili come soggetti fruitori, in una erogazione. + + + + + Solo Soggetti Esterni: indica che i + soggetti fruitori di una erogazione devono essere soggetti + esterni. + + + + + + +
+ Elementi di configurazione della modalità multi-tenant + + + + + + + + +
+ + L'utente che ha l'opzione multi-tenant attiva, visualizza sulla testata un menu a + discesa che consente di selezionare l'utente interno al dominio sul quale vuole + operare (). Se viene selezionato un soggetto dalla + lista, l'operatività sulla console risulterà identica alla situazione con un unico + soggetto interno. Selezionando l'opzione "Tutti" sarà richiesto nei singoli contesti + di specificare il soggetto interno. +
+ Selezione del soggetto operativo in modalità multi-tenant + + + + + + + + +
+ + + Header di Integrazione + In base alle configurazioni prodotte per i servizi, è previsto in diverse + situazioni che gli applicativi scambino dei dati con il gateway. + Nel caso degli applicativi server lo scopo è quello di ricevere dal gateway i + metadati che riguardano la richiesta gestita. + Per gli applicativi client tale scambio si rende necessario al fine di fornire al + gateway specifici parametri necessari a elaborare la richiesta. + Per consentire lo scambio di tali informazioni, funzionali all'integrazione tra + applicativi e gateway, sono previste alcune strutture dati, che indichiamo di + seguito con il termine Header di Integrazione, che possono + essere trasmesse in differenti modalità: + + Trasporto: le informazioni sono contenute + nell'header di trasporto + + + Url Based: le informazioni sono incapsulate nella + url + + + SOAP: le informazioni sono incluse in uno + specifico header SOAP proprietario di GovWay + + + WS-Addressing: le informazioni sono incluse in un + header SOAP secondo il formato standard WS-Addressing + + + + Nel seguito descriviamo le strutture degli header di integrazione attive per + default con l'installazione del prodotto. Tali strutture variano in funzione del + ruolo dell'applicativo. Per l'applicativo client è possibile fornire informazioni al + gateway tramite le modalità Trasporto e Url + Based. L'applicativo server, invece, riceve le informazioni dal + gateway solamente tramite la modalità Trasporto. + + + Scambio di informazioni nella richiesta inoltrata dal gateway al + server + Le informazioni fornite dal gateway all'applicativo erogatore, sia per quanto + concerne fruizioni che per erogazioni, sono riassunte nella tabella . + + Scambio di informazioni nella richiesta inoltrata dal gateway al + server + + + + + + Nome Header Trasporto + Descrizione + + + + + GovWay-Message-ID + Identificativo del messaggio assegnato da GovWay + + + GovWay-Relates-To + Identificativo del messaggio riferito + + + GovWay-Conversation-ID + Identificativo della conversazione + + + GovWay-Transaction-ID + Identificativo della transazione assegnato da GovWay + + + +
+ Inoltre, solamente per quanto concerne le erogazioni, all'applicativo interno + al dominio vengono inoltrate ulteriori meta-informazioni riguardanti la + transazione gestita sul gateway descritte nella tabella . + Scambio di informazioni nella richiesta inoltrata dal gateway al + server per una Erogazione + + + + + + Header + Descrizione + + + + + GovWay-Sender-Type + Codice che identifica il tipo del mittente + + + GovWay-Sender + Identificativo del mittente + + + GovWay-Provider-Type + Codice che identifica il tipo del destinatario + + + GovWay-Provider + Identificativo del destinatario + + + GovWay-Service-Type + Codice che identifica il tipo del servizio + + + GovWay-Service + Identificativo del servizio + + + GovWay-Service-Version + Progressivo di versione del servizio + + + GovWay-Action + Identificativo dell'azione + + + GovWay-Application-Message-ID + Identificativo del messaggio assegnato + dall'applicativo + + + GovWay-Application + Identificativo dell'applicativo + + + +
+ + + + + Scambio di informazioni tra gateway e la risposta ritornata al client + Le informazioni fornite dal gateway all'applicativo fruitore, sia per quanto + concerne fruizioni che per erogazioni, sono riassunte nella tabella . + Scambio di informazioni tra gateway e la risposta ritornata al + client + + + + + + Nome Header Trasporto + Descrizione + + + + + GovWay-Message-ID + Identificativo del messaggio assegnato da GovWay + + + GovWay-Relates-To + Identificativo del messaggio riferito + + + GovWay-Conversation-ID + Identificativo della conversazione + + + GovWay-Application-Message-ID + Identificativo del messaggio assegnato dall'applicativo + (solo nel caso di Fruizione) + + + GovWay-Transaction-ID + Identificativo della transazione assegnato da + GovWay + + + +
+ All'applicativo client vengono inoltre forniti ulteriori header http generati + se l'applicativo erogatore non è disponibile o se sono stati attivati meccanismi + di Rate Limiting (). + + + + + + + Nome Header Trasporto + Descrizione + Motivazione + + + + + Retry-After + Indica al client il numero di secondi dopo i quali + ripresentarsi poichè il servizio contattato non è al momento + disponibile. + Le principali cause della generazione di tale header sono + imputabili alla non raggiungibilità un applicativo + erogatore, alla violazione di politiche di RateLimiting o a + quando un servizio è temporaneamente disabilitato + + + X-RateLimit-Limit + Indica il numero massimo di richieste + effettuabili + Rate-Limiting attivato con policy di tipo + 'NumeroRichieste-ControlloRealtime*' () + + + X-RateLimit-Remaining + Numero di richieste rimanenti prima del prossimo + reset + Rate-Limiting attivato con policy di tipo + 'NumeroRichieste-ControlloRealtime*' () + + + X-RateLimit-Reset + Numero di secondi mancante al prossimo reset + Rate-Limiting attivato con policy di tipo + 'NumeroRichieste-ControlloRealtime*' () + + + GovWay-RateLimit-ConcurrentRequest-Limit + Indica il numero massimo di richieste concorrenti + inviabili + Rate-Limiting attivato con policy di tipo + 'NumeroRichieste-RichiesteSimultanee' () + + + GovWay-RateLimit-ConcurrentRequest-Remaining + Indica il numero massimo di richieste concorrenti ancora + inviabili + Rate-Limiting attivato con policy di tipo + 'NumeroRichieste-RichiesteSimultanee' () + + + GovWay-RateLimit-BandwithQuota-Limit + Indica la massima banda occupabile + Rate-Limiting attivato con policy di tipo + 'OccupazioneBanda-*' () + + + GovWay-RateLimit-BandwithQuota-Remaining + Indica la banda ancora occupabile prima del prossimo + reset + Rate-Limiting attivato con policy di tipo + 'OccupazioneBanda-*' () + + + GovWay-RateLimit-BandwithQuota-Reset + Numero di secondi mancante al prossimo reset + Rate-Limiting attivato con policy di tipo + 'OccupazioneBanda-*' () + + + GovWay-RateLimit-AvgTimeResponse-Limit + Tempo medio di risposta atteso + Rate-Limiting attivato con policy di tipo + 'TempoMedioRisposta-*' () + + + GovWay-RateLimit-AvgTimeResponse-Reset + Numero di secondi mancante al prossimo reset + Rate-Limiting attivato con policy di tipo + 'TempoMedioRisposta-*' () + + + GovWay-RateLimit-TimeResponseQuota-Limit + Tempo complessivo di risposta occupabile + Policy creata con risorsa di tipo + 'TempoComplessivioRisposta' () + + + GovWay-RateLimit-TimeResponseQuota-Remaining + Tempo di risposta ancora occupabile prima del prossimo + reset + Policy creata con risorsa di tipo + 'TempoComplessivioRisposta' () + + + GovWay-RateLimit-TimeResponseQuota-Reset + Numero di secondi mancante al prossimo reset + Policy creata con risorsa di tipo + 'TempoComplessivioRisposta' () + + + GovWay-RateLimit-RequestSuccessful-Limit, + GovWay-RateLimit-RequestFailed-Limit, + GovWay-RateLimit-Fault-Limit + Indica il numero massimo di richieste + effettuabili + Policy creata rispettivamente con risorsa di tipo + 'NumeroRichiesteCompletateConSuccesso', + 'NumeroRichiesteFallite' e 'NumeroFaultApplicativi' () + + + GovWay-RateLimit-RequestSuccessful-Remaining, + GovWay-RateLimit-RequestFailed-Remaining, + GovWay-RateLimit-Fault-Remaining + Numero di richieste rimanenti prima del prossimo + reset + Policy creata rispettivamente con risorsa di tipo + 'NumeroRichiesteCompletateConSuccesso', + 'NumeroRichiesteFallite' e 'NumeroFaultApplicativi' () + + + GovWay-RateLimit-RequestSuccessful-Reset, + GovWay-RateLimit-RequestFailed-Reset, + GovWay-RateLimit-Fault-Reset + Numero di secondi mancante al prossimo reset + Policy creata rispettivamente con risorsa di tipo + 'NumeroRichiesteCompletateConSuccesso', + 'NumeroRichiesteFallite' e 'NumeroFaultApplicativi' () + + + + + + + + + Scambio di informazioni nella richiesta del client verso il gateway + Le informazioni che possono essere fornite dal client al gateway sono + riassunte nella tabella e riguardano + le modalità Trasporto e Url Based + attive di default. + Scambio di informazioni nella richiesta del client verso il + gateway + + + + + + + Nome Header Trasporto + Nome Url Property + Descrizione + + + + + GovWay-Action + govway_action + Identificativo dell'azione invocata. Tale informazione + deve essere fornita dal client se il servizio è stato + configurato in modalità di identificazione dell'azione + input-based. () + + + GovWay-Relates-To + govway_relates_to + Identificativo di un precedente messaggio a cui la + richiesta in essere si riferisce. () + + + GovWay-Conversation-ID + govway_conversation_id + Identificativo di una conversazione a cui la richiesta in + essere si riferisce () + + + +
+ + + + + Altri header di Integrazione + Per attivare differenti header di integrazione è richiesto l'accesso alla + govwayConsole in modalità avanzata (). + + Gli header di trasporto relativi alle funzionalità di Rate-Limiting e + Service-Unavailable, descritti nella sezione , vengono generati + solamente nella modalità Header HTTP. + + A partire dall'erogazione o fruizione già creata in precedenza accedendo + tramite il link Gestione Configurazione presente nel dettaglio + dell'erogazione/fruizione è possibile accedere a configurazioni specifiche come + descritto in . Accedendo in modalità avanzata + compare una sezione precedentemente non documentata denominata Opzioni + Avanzate. All'interno di tale sezione è possibile agire sulla + configurazione della voce Metadati nella sezione + Integrazione. In tale campo, per default non impostato, + è possibile attivare gli header di integrazione desiderati utilizzando le + seguenti keyword separate da virgola: + Per ogni tipo di header di integrazione descritto di seguito, esiste + una modalità normale ed una estesa (suffisso 'Ext'). Le due modalità si + differenziano poichè nella modalità non estesa non vengono generati gli + header nella richiesta inoltrata al server in una fruizione e quelli + generati nella risposta ritornata al client in una erogazione. + + + + trasporto o + trasportoExt: header di trasporto descritti + nelle precedenti sezioni. + + + urlBased o urlBasedExt: + le informazioni precedentemente descritte vengono aggiunte alla url + tramite i parametri descritti nella tabella + + Informazioni generate dal gateway nella url della + richiesta inoltrata al server + + + + + + Nome Query URL Parameter + Descrizione + + + + + govway_message_id + Identificativo del messaggio assegnato da + GovWay + + + govway_relates_to + Identificativo del messaggio riferito + + + govway_conversation_id + Identificativo della conversazione + + + govway_transaction_id + Identificativo della transazione assegnato da + GovWay + + + govway_sender_type + Codice che identifica il tipo del + mittente + + + govway_sender + Identificativo del mittente + + + govway_provider_type + Codice che identifica il tipo del + destinatario + + + govway_provider + Identificativo del destinatario + + + govway_service_type + Codice che identifica il tipo del + servizio + + + govway_service + Identificativo del servizio + + + govway_service_version + Progressivo di versione del servizio + + + govway_action + Identificativo dell'azione + + + govway_application_message_id + Identificativo del messaggio assegnato + dall'applicativo + + + govway_application + Identificativo dell'applicativo + + + +
+ + + Esiste una terza versione + urlBasedOnlyRead che permette di + attivare la lettura delle informazioni impostate + dall'applicativo client ma non genera header verso l'applicativo + server. + + + + + soap o soapExt: le + informazioni precedentemente descritte vengono incluse come + attributi in uno specifico header SOAP proprietario di GovWay che + possiede il nome integration associato al + namespace http://govway.org/integration. Di + seguito un esempio di tale header: + <gw:integration + ... + transactionId="a2c6fd66-ec0b-407c-8a21-25b4920e7c73" + SOAP_ENV:actor="http://govway.org/integration" + SOAP_ENV:mustUnderstand="0" + xmlns:SOAP_ENV="http://schemas.xmlsoap.org/soap/envelope/" + xmlns:gw="http://govway.org/integration"/> + Nella tabella + vengono descritti i nome degli attributi. + Informazioni generate dal gateway nell'header soap + proprietario di GovWay + + + + + + Nome Attributo + Descrizione + + + + + messageId + Identificativo del messaggio assegnato da + GovWay + + + relatesTo + Identificativo del messaggio riferito + + + conversationId + Identificativo della conversazione + + + transactionId + Identificativo della transazione assegnato da + GovWay + + + senderType + Codice che identifica il tipo del + mittente + + + sender + Identificativo del mittente + + + providerType + Codice che identifica il tipo del + destinatario + + + provider + Identificativo del destinatario + + + serviceType + Codice che identifica il tipo del + servizio + + + service + Identificativo del servizio + + + serviceVersion + Progressivo di versione del servizio + + + action + Identificativo dell'azione + + + applicationMessageId + Identificativo del messaggio assegnato + dall'applicativo + + + application + Identificativo dell'applicativo + + + +
+ + Utilizzabile solamente con API di tipologia SOAP + + + + + wsa o wsaExt: + all'interno del messaggio Soap vengono generati gli header + To, From, + Action, MessageID e + RelatesTo associati al namespace + http://www.w3.org/2005/08/addressing. I + valori utilizzati per i vari header sono i seguenti: + + To, + http://<providerType>_<provider>.govway.org/services/<serviceType>_<service>/<serviceVersion> + + + From, + http://[<application>.]<senderType>_<sender>.govway.org + + + Action, + http://<providerType>_<provider>.govway.org/services/<serviceType>_<service>/<serviceVersion>/<action> + + + MessageID, uuid:<messageId> in + caso di Messaggio di Protocollo (restituzione di una + risposto lato PD o in caso di consegna tramite PA), + uuid:<applicationMessageId> in caso di Messaggio di + Integrazione (invocazione lato PD o lettura risposta + lato PA, es. per correlazione applicativa) + + + RelatesTo, + uuid:<relatesTo> + + + + Utilizzabile solamente con API di tipologia SOAP + + + + + + + + + + Errori Generati dal Gateway + La gestione dei casi di errore nelle comunicazioni mediate da un Gateway devono + tenere conto di ulteriori situazioni che possono presentarsi rispetto alla + situazione di dialogo diretto tra gli applicativi. Oltre agli errori conosciuti + dagli applicativi, e quindi previsti nei descrittori del servizio, gli applicativi + client possono ricevere ulteriori errori generati dal gateway. + Govway genera differenti errori a seconda se l'erogazione o la fruizione riguarda + una API di tipologia SOAP (sezione ) o REST + (sezione ). + Per entrambe le tipologie, all'interno dell'errore generato, viene ritornato al + client un codice di errore che rappresenta una classificazione interna a GovWay + dell'errore avvenuto. Nella sezione vengono + riportate due tabelle che descrivono cosa rappresentano tali codici. + + + REST Problem Details (RFC 7807) + Quando il Gateway non può completare con successo la gestione della + transazione in corso genera un oggetto Problem Details come + definito nella specifica RFC 7807 (https://tools.ietf.org/html/rfc7807). + Di seguito viene riportato un esempio di tale oggetto: + { + "type": "https://httpstatuses.com/401", + "title": "Unauthorized", + "status": 401, + "detail": "Token non valido", + "govway_status": "integration:GOVWAY-444" +} + + L'elemento type presenta sempre il suffisso + https://httpstatuses.com/ seguito poi dal codice http + ritornato al client, riportato anche nell'elemento status. + L'elemento title contiene invece la descrizione http del + codice ritornato al client. + Nell'elemento detail sono presenti informazioni di + dettaglio sull'errore avvenuto, errore codificato dal codice presente + nell'elemento govway_status. (Per ulteriori dettagli sul + codice consultare la sezione ). + La casistica dei possibili errori generati dal gateway viene riportata nella + tabella . + Casistica Problem Details per API REST + + + + + + HTTP Status + Descrizione + + + + + 401 + Rientrano in questa casistica gli errori avenuti durante + le fasi di autenticazione degli applicativi () e di verifica del token + OAuth () + + + 403 + In questa categoria rientrano errori avvenuti durante la + fase di autorizzazione descritta nella sezione + + + 404 + Identifica la richiesta di una erogazione o fruizione + inesistente + + + 400 + L'errore occorso è imputabile ai dati forniti dal client + (es. messaggio non valido in caso di validazione + attiva) + + + 429 + Identifica una violazione della politica di Rate Limiting + () + + + 503 + Rientrano in questa casistica gli errori causati da una + irraggiungibilità dell'applicativo indirizzato dal Gateway o + una temporanea sospensione della erogazione/fruzione + + + 500 + Qualsiasi altro errore + + + + +
+ + + HTTP Content Negotiation + L'oggetto Problem Details generato dal Gateway + possiede per default il formato json. + Viene utilizzato il formato xml (Appendice 'A' del + RFC 7807) solamente se la richiesta presenta anch'essa tale formato. + Un applicativo client può indicare al Gateway quale formato desidera + attraverso l'header http Accept. + + + + + SOAP Fault + Per le API di tipologia SOAP, sia in erogazione che in fruizione, quando il + Gateway non può completare con successo la gestione della transazione in corso + genera un SOAPFault contenente un actor (o role in SOAP 1.2) valorizzato con + http://govway.org/integration. + Di seguito viene riportato un esempio di tale oggetto: + <?xml version="1.0" encoding="UTF-8"?> +<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> + <SOAP-ENV:Body> + <SOAP-ENV:Fault> + <faultcode xmlns:integration="http://govway.org/integration/fault">integration:GOVWAY-403</faultcode> + <faultstring>Identificazione dinamica dell'azione associata alla porta delegata fallita</faultstring> + <faultactor>http://govway.org/integration</faultactor> + <detail> + <problem xmlns="urn:ietf:rfc:7807"> + <type>https://httpstatuses.com/500</type> + <title>Internal Server Error</title> + <status>500</status> + <detail>Identificazione dinamica dell'azione associata alla porta delegata fallita</detail> + <govway_status>integration:GOVWAY-403</govway_status> + </problem> + </detail> + </SOAP-ENV:Fault> + </SOAP-ENV:Body> +</SOAP-ENV:Envelope> + + L'elemento fault string contiene informazioni di + dettaglio sull'errore avvenuto, errore codificato dal codice presente + nell'elemento fault code. (Per ulteriori dettagli sul + codice consultare la sezione ). + Il SOAP Fault contiene all'interno dell'elemento detail + un oggetto Problem Details simile a quanto descritto nella + sezione utile a comprendere il codice di + errore ed il dettaglio attraverso una modalità alternativa alla lettura degli + elementi fault string e fault code + (che varia a seconda della versione SOAP utilizzata). + + + + Codici di Errore + Di seguito vengono riportate le casistiche di errore che possono avvenire sul + Gateway, con i relativi codici utilizzati all'interno dei formati di errore come + descritto nelle sezioni e . + Configurazioni Avanzate + Alcuni degli errori riportati sono scaturiti da funzionalità + disponibili nel Gateway attraverso configurazioni avanzate non descritte + nel presente manuale. + + + + + + + + Codice + Descrizione + + + + + integration:GOVWAY-401 + Identifica la richiesta di una erogazione o fruizione + inesistente + + + integration:GOVWAY-402 + Rientrano in questa casistica gli errori avenuti durante + la fase di autenticazione di una fruizione () + + + integration:GOVWAY-403 + Azione non identificabile tramite i meccanismi + configurati. () + + + integration:GOVWAY-404 + Rientrano in questa casistica gli errori avenuti durante + la fase di autorizzazione di una fruizione () + + + integration:GOVWAY-405 + Servizio richiesto non esistente (richiede una + configurazione non documentata) + + + integration:GOVWAY-406 + Indica che non sono disponibili messaggi (richiede + accesso alla MessageBox via Integration Manager, + configurazione non documentata) + + + integration:GOVWAY-407 + Il messaggio richiesto non esiste (richiede accesso alla + MessageBox via Integration Manager, configurazione non + documentata) + + + integration:GOVWAY-408 + Indica che non esiste una API utilizzabile per correlare + la richiesta con una precedente transazione (es. utilizzato + con i profili asincroni descritti nella sezione ) + + + integration:GOVWAY-409 + Indica che non è possibile correlare la richiesta con una + precedente transazione (es. utilizzato con i profili + asincroni descritti nella sezione ) + + + integration:GOVWAY-410 + L'API invocata possiede il profilo asincrono + simmetrico e la configurazione della + fruizione non presenta meccanismi di autenticazione + dell'applicativo client. L'identificazione di un applicativo + fruitore è fondamentale nel profilo asincrono + simmetrico per consegnare la risposta () + + + integration:GOVWAY-411 + Indica una configurazione errata dove l'applicativo + mittente non possiede una configurazione per la spedizione + della risposta asincrona e l'API possiede il profilo + asincrono simmetrico () + + + integration:GOVWAY-412 + L'API è stata invocata senza fornire il riferimento ad un + messaggio attualmente in carico sul Gateway, mentre la + configurazione lo richiede. richiede una configurazione non + documentata) + + + integration:GOVWAY-413 + L'API è stata invocata fornendo il riferimento ad un + messaggio attualmente in carico sul Gateway, mentre la + configurazione non lo richiede. richiede una configurazione + non documentata) + + + integration:GOVWAY-414 + L'API invocata è stata configurata con un profilo + differente da oneway e richiede la + funzionalità di consegna in ordine + () + + + integration:GOVWAY-415 + L'API invocata è stata configurata per utilizzare la + funzionalità di consegna in ordine ma + non presenta altre caratteristiche obbligatorie con questa + funzionalità (es. + confermaRicezione,filtroDuplicati,collaborazione) () + + + integration:GOVWAY-416 + Rientrano in questa casistica gli errori avenuti durante + la fase di correlazione applicativa della richiesta () + + + integration:GOVWAY-417 + Tale errore viene sollevato se l'interfaccia API e/o gli + schemi associati (xsd,json,yaml) contengono errori che non + ne consentono l'utilizzo durante la validazione dei + contenuti () + + + integration:GOVWAY-418 + La validazione dei contenuti ha rilevato una richiesta + non conforme all'interfaccia API () + + + integration:GOVWAY-419 + La validazione dei contenuti ha rilevato una risposta non + conforme all'interfaccia API () + + + integration:GOVWAY-420 + Viene sollevato questo errore se un applicativo invoca + una fruizione di una API fornendo un messaggio contenente + già un header di protocollo. (es. se viene inviato un + messaggio contenente un'header eGov () + + + integration:GOVWAY-421 + Indica che il messaggio di richiesta fornito via + Integration Manager non è un messaggio SOAP Valido + (configurazione non documentata) + + + integration:GOVWAY-422 + Il messaggio di richiesta presente nell'http body + (Accesso al servizio out/xml2soap) o il messaggio indicato + nella richiesta via IntegrationManager (Accesso al servizio + via Integration Manager con imbustamento SOAP) non è + utilizzabile, tramite la funzionalità di + Imbustamento, per ottenere un messaggio SOAP valido + (configurazione non documentata) + + + integration:GOVWAY-423 + L'azione identificata tramite i meccanismi configurati + non risulta esistere all'interno dell'API invocata. () + + + integration:GOVWAY-424 + La funzionalità avanzata Allega + Body ha generato un errore (configurazione + non documentata) + + + integration:GOVWAY-425 + La funzionalità avanzata Scarta + Body ha generato un errore (configurazione + non documentata) + + + integration:GOVWAY-426 + Errore generico che può avvenire durante la + gestione della richiesta, dovuto comunque a dati forniti + nella richiesta stessa (es. Valore SOAPAction + scorretto) + + + integration:GOVWAY-427 + Indica che il Gateway ha rilevato la presenza di + SOAPHeader Element che non è in grado di processare e che + richiedono obbligatoriamente il processamento + (mustUnderstand=1 e actor non presente) + + + integration:GOVWAY-428 + Rientrano in questa casistica gli errori avenuti durante + la fase di autorizzazione del contenuto (configurazione non + documentata) + + + integration:GOVWAY-429 + Errore che viene ritornato dal Gateway se la richiesta + presenta un header http Content-Type + non supportato (per API SOAP) + + + integration:GOVWAY-430 + Errore che viene ritornato dal Gateway se rileva una + busta soap che possiede un namespace differente da quello + atteso per la versione SOAP corrispondente al + Content-Type (per API SOAP) + + + integration:GOVWAY-431 + Rientrano in questa casistica gli errori avvenuti durante + il recupero delle credenziali fornite tramite un Proxy + (configurazione non documentata) + + + integration:GOVWAY-432 + Errore che viene ritornato dal Gateway se la richiesta + presenta un contenuto malformato (es. xml malformato in una + API SOAP) + + + integration:GOVWAY-433 + Indica che la richiesta non presenta un header http + Content-Type (obbligatorio in API + SOAP) + + + integration:GOVWAY-434 + Rientrano in questa casistica gli errori avenuti durante + la fase di correlazione applicativa della risposta () + + + integration:GOVWAY-435 + L'errore viene sollevato se viene rilevata una + configurazione Local Forward non + corretta (configurazione non documentata) + + + integration:GOVWAY-436 + L'errore viene sollevato se viene rilevato un tipo di + fruitore non supportato dalla modalità di utilizzo del + Gateway fruita (configurazione non documentata) + + + integration:GOVWAY-437 + L'errore viene sollevato se viene rilevato un tipo di + erogatore non supportato dalla modalità di utilizzo del + Gateway fruita (configurazione non documentata) + + + integration:GOVWAY-438 + L'errore viene sollevato se viene rilevato un tipo di + servizio non supportato dalla modalità di utilizzo del + Gateway fruita (configurazione non documentata) + + + integration:GOVWAY-439 + L'errore viene sollevato se viene rilevata una + configurazione che richiede una funzionalità non + supportata nella modalità di utilizzo del Gateway + (configurazione non documentata) + + + integration:GOVWAY-440 + Errore che viene ritornato dal Gateway se la risposta + presenta un contenuto malformato (es. xml malformato in una + API SOAP) + + + integration:GOVWAY-441 + La richiesta indirizza una configurazione non invocabile + direttamente, configurazione creata tramite le indicazioni + descritte nella sezione + + + integration:GOVWAY-442 + La richiesta pervenuta sul Gateway non presenta un + riferimento ad una precedente transazione, mentre la + configurazione lo richiede (). Nell'installazione + di default del Gateway, l'errore indicato non viene mai + sollevato poichè non è obbligatorio fornire il riferimento + ad una precedente transazione. + + + integration:GOVWAY-443 + L'errore viene ritornato dal Gateway se non viene + rilevato un token durante l'invocazione di una fruizione + () + + + integration:GOVWAY-444 + L'errore viene ritornato dal Gateway se viene rilevato un + token non valido durante l'invocazione di una fruizione + () + + + integration:GOVWAY-445 + Rientrano in questa casistica gli errori avenuti durante + la fase di autorizzazione di una fruizione, riguardanti la + gestione di un token () + + + integration:GOVWAY-446 + Il Gateway ritorna tale codice se la fruizione o + l'erogazione invocata risulta sospesa + + + integration:GOVWAY-450 + La richiesta pervenuta sul Gateway non indirizza una + erogazione specifica e non è utilizzabile per identificarne + alcuna (configurazione non documentata) + + + integration:GOVWAY-451 + Il soggetto invocato non esiste (configurazione non + documentata) + + + integration:GOVWAY-452 + Indica che il messaggio ricevuto è già stato gestito in + precedenza (es. filtro duplicati attivo descritto nella + sezione ) + + + integration:GOVWAY-453 + L'applicativo erogatore associato all'erogazione non + esiste (configurazione non documentata) + + + integration:GOVWAY-454 + Viene sollevato questo errore se il messaggio ritornato + come risposta dall'applicativo erogatore, in una erogazione, + contiene già un header di protocollo. (es. se viene + ritornato un messaggio contenente un'header eGov () + + + integration:GOVWAY-455 + L'errore indica che la richiesta presenta al suo interno + degli identificativi di API differenti da quelli + dell'erogazione invocata (es. busta eGov contiene dei dati + di servizio non allineati all'erogazione invocata) + + + integration:GOVWAY-500 + Errore generico + + + integration:GOVWAY-516 + Errore ritornato dal gateway se non riesce ad inoltrare + il messaggio all'endpoint configurato + + + integration:GOVWAY-517 + Errore ritornato dal gateway se non viene ritornata una + risposta dall'endpoint contattato e il profilo ne prevede + una (es. profilo sincrono nelle API SOAP) + + + integration:GOVWAY-518 + Indica che l'applicativo erogatore ha ritornato un + SOAPFault (API SOAP) + + + integration:GOVWAY-537 + La richiesta pervenuta è già presente in + carico sul Gateway ed è attualmente in fase di processamento + (configurazione non documentata) + + + integration:GOVWAY-538 + La richiesta asincrona pervenuta è già + presente in carico sul Gateway ed è attualmente in fase di + processamento (configurazione non documentata) + + + integration:GOVWAY-539 + La ricevuta della richiesta asincrona pervenuta è + già presente in carico sul Gateway ed è attualmente + in fase di processamento (configurazione non + documentata) + + + integration:GOVWAY-CC00 + Errore generico avvenuto durante la gestione del + Controllo del Traffico () + + + integration:GOVWAY-CC01 + Il Gateway ha rilevato il superamento del massimo numero + di richieste simultanee configurato () + + + integration:GOVWAY-CP00 + Indica che la funzionalità di Rate-Limiting ha rilevato + una policy sconosciuta () + + + integration:GOVWAY-CP01 + Indica che la funzionalità di Rate-Limiting ha rilevato + una violazione di una policy di tipo + 'NumeroRichieste-RichiesteSimultanee' (). Il + codice di errore può presentare il suffisso + -CC se la policy è configurata + insieme a controlli di congestione e/o il suffisso + -DP se configurata con meccanismi + di degrado. + + + integration:GOVWAY-ERR-CP01 + Errore emerso durante la gestione da parte del Gateway + della policy di Rate-Limiting di tipo + 'NumeroRichieste-RichiesteSimultanee' (). + + + integration:GOVWAY-CP02 + Indica che la funzionalità di Rate-Limiting ha rilevato + una violazione di una policy di tipo + 'NumeroRichieste-ControlloRealtime*' (). Il codice di + errore può presentare il suffisso -CC + se la policy è configurata insieme a controlli di + congestione e/o il suffisso -DP se + configurata con meccanismi di degrado (). + + + integration:GOVWAY-ERR-CP02 + Errore emerso durante la gestione da parte del Gateway + della policy di Rate-Limiting di tipo + 'NumeroRichieste-ControlloRealtime*' (). + + + integration:GOVWAY-CP03 + Indica che la funzionalità di Rate-Limiting ha rilevato + una violazione di una policy di tipo 'OccupazioneBanda-*' + (). Il + codice di errore può presentare il suffisso + -CC se la policy è configurata + insieme a controlli di congestione e/o il suffisso + -DP se configurata con meccanismi + di degrado (). + + + integration:GOVWAY-ERR-CP03 + Errore emerso durante la gestione da parte del Gateway + della policy di Rate-Limiting di tipo 'OccupazioneBanda-*' + (). + + + integration:GOVWAY-CP04 + Indica che la funzionalità di Rate-Limiting ha rilevato + una violazione di una policy di tipo + 'TempoComplessivioRisposta' (). Il + codice di errore può presentare il suffisso + -CC se la policy è configurata + insieme a controlli di congestione e/o il suffisso + -DP se configurata con meccanismi + di degrado. + + + integration:GOVWAY-ERR-CP04 + Errore emerso durante la gestione da parte del Gateway + della policy di Rate-Limiting di tipo + 'TempoComplessivioRisposta' (). + + + integration:GOVWAY-CP05 + Indica che la funzionalità di Rate-Limiting ha rilevato + una violazione di una policy di tipo 'TempoMedioRisposta-*' + (). Il + codice di errore può presentare il suffisso + -CC se la policy è configurata + insieme a controlli di congestione e/o il suffisso + -DP se configurata con meccanismi + di degrado. + + + integration:GOVWAY-ERR-CP05 + Errore emerso durante la gestione da parte del Gateway + della policy di Rate-Limiting di tipo 'TempoMedioRisposta-*' + (). + + + integration:GOVWAY-CP06 + Indica che la funzionalità di Rate-Limiting ha rilevato + una violazione di una policy di tipo + 'NumeroRichiesteCompletateConSuccesso' (). Il + codice di errore può presentare il suffisso + -CC se la policy è configurata + insieme a controlli di congestione e/o il suffisso + -DP se configurata con meccanismi + di degrado. + + + integration:GOVWAY-ERR-CP06 + Errore emerso durante la gestione da parte del Gateway + della policy di Rate-Limiting di tipo + 'NumeroRichiesteCompletateConSuccesso' (). + + + integration:GOVWAY-CP07 + Indica che la funzionalità di Rate-Limiting ha rilevato + una violazione di una policy di tipo + 'NumeroRichiesteFallite' (). Il + codice di errore può presentare il suffisso + -CC se la policy è configurata + insieme a controlli di congestione e/o il suffisso + -DP se configurata con meccanismi + di degrado. + + + integration:GOVWAY-ERR-CP07 + Errore emerso durante la gestione da parte del Gateway + della policy di Rate-Limiting di tipo + 'NumeroRichiesteFallite' (). + + + integration:GOVWAY-CP08 + Indica che la funzionalità di Rate-Limiting ha rilevato + una violazione di una policy di tipo + 'NumeroFaultApplicativi' (). Il + codice di errore può presentare il suffisso + -CC se la policy è configurata + insieme a controlli di congestione e/o il suffisso + -DP se configurata con meccanismi + di degrado. + + + integration:GOVWAY-ERR-CP08 + Errore emerso durante la gestione da parte del Gateway + della policy di Rate-Limiting di tipo + 'NumeroFaultApplicativi' (). + + + protocol:GOVWAY-109 + Rientrano in questa casistica gli errori avenuti durante + la fase di autenticazione di una erogazione, se non vengono + rilevate credenziali () + + + protocol:GOVWAY-117 + Rientrano in questa casistica gli errori avenuti durante + la fase di autenticazione di una erogazione, se vengono + rilevate credenziali non corrette () + + + protocol:GOVWAY-1350 + Rientrano in questa casistica eventuali errori generici + avenuti durante la fase di autorizzazione di una erogazione + () o sicurezza del + messaggio () + + + protocol:GOVWAY-1351 + L'errore viene ritornato dal Gateway se viene rilevato + che il messaggio presenta al suo interno un mittente + differente da quello identificato dalle credenziali + (configurazione non documentata) + + + protocol:GOVWAY-1352 + Rientrano in questa casistica gli errori avenuti durante + la fase di autorizzazione di una erogazione, quando la + richieste non viene autorizzata () + + + protocol:GOVWAY-[1353-1354] + L'errore viene ritornato dal Gateway se viene rilevato + che la firma della busta, prevista dalla modalità + utilizzata, non è rispettivamente valida o presente + (configurazione non documentata) + + + protocol:GOVWAY-1355 + L'errore viene ritornato dal Gateway se viene rilevato + che la firma del messaggio non è valida () + + + protocol:GOVWAY-1356 + L'errore viene ritornato dal Gateway se viene rilevato + che il messaggio non è firmato () + + + protocol:GOVWAY-[1357-1360] + L'errore viene ritornato dal Gateway se viene rilevato + che la firma degli allegati non sono valide o presenti + (configurazione non documentata) + + + protocol:GOVWAY-1361 + L'errore viene ritornato dal Gateway se viene rilevato + che la cifratura del messaggio non è valida () + + + protocol:GOVWAY-1362 + L'errore viene ritornato dal Gateway se viene rilevato + che il messaggio non è cifrato () + + + protocol:GOVWAY-[1363-1364] + L'errore viene ritornato dal Gateway se viene rilevato + che le cifrature degli allegati non sono valide o presenti + (configurazione non documentata) + + + protocol:GOVWAY-1365 + L'errore viene ritornato dal Gateway se viene rilevato + che il messaggio non contiene l'attesa configurazione di + sicurezza () + + + protocol:GOVWAY-1366 + L'errore viene ritornato dal Gateway se non viene + rilevato un token durante l'invocazione di una erogazione + () + + + protocol:GOVWAY-1367 + L'errore viene ritornato dal Gateway se viene rilevato un + token non valido durante l'invocazione di una erogazione + () + + + protocol:GOVWAY-1368 + Rientrano in questa casistica gli errori avenuti durante + la fase di autorizzazione di una erogazione, riguardanti la + gestione di un token () + + + protocol:GOVWAY-[1-6] + Rientrano in questa casistica gli errori generici + avvenuti durante il processamento e la validazione di una + richiesta di erogazione + + + protocol:GOVWAY-[51-60] + Gli errori che rientrano in questa casistica vengono + generati durante la validazione della richiesta se sono + presenti informazioni non valide per quanto concerne gli + attributi mustUnderstand e + actor di un header SOAP (es. busta + egov nella modalità descritta in ) + + + protocol:GOVWAY-[100-120] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sul mittente (es. busta egov in + ) + + + protocol:GOVWAY-[150-170] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sul destinatario (es. busta egov + in ) + + + protocol:GOVWAY-[200-205] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sul profilo di collaborazione (es. + busta egov in ) + + + protocol:GOVWAY-[250-265] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sul servizio (es. busta egov in + ) + + + protocol:GOVWAY-[300-315] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sulla correlazione asincrona (es. + busta egov in ) + + + protocol:GOVWAY-[350-355] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sulla collaborazione (es. busta + egov in ) + + + protocol:GOVWAY-[400-406] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sull'azione (es. busta egov in + ) + + + protocol:GOVWAY-[450-455] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sulla correlazione asincrona per + quanto riguarda l'azione (es. busta egov in ) + + + protocol:GOVWAY-[500-506] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sull'identificativo messaggio (es. + busta egov in ) + + + protocol:GOVWAY-[550-556] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sul riferimento messaggio (es. + busta egov in ) + + + protocol:GOVWAY-[600-610] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sull'ora registrazione (es. busta + egov in ) + + + protocol:GOVWAY-[650-661] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sulla scandenza (es. busta egov in + ) + + + protocol:GOVWAY-[700-717] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sul filtro duplicati e sulla + conferma della ricezione (es. busta egov in ) + + + protocol:GOVWAY-[750-766] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sulla consegna in ordine (es. + busta egov in ) + + + protocol:GOVWAY-[800-817] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sul servizio applicativo + + + protocol:GOVWAY-[850-879] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sui riscontri (es. busta egov in + ) + + + protocol:GOVWAY-[900-971] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sulla lista trasmissioni (es. + busta egov in ) + + + protocol:GOVWAY-[1000-1035] + Errore rilevato durante la validazione della richiesta + che riguarda informazioni sulla lista eccezioni (es. busta + egov in ) + + + protocol:GOVWAY-[1300-1329] + Errore rilevato durante la validazione del messaggio per + quanto concerne la parte di SOAPFault previsto dal + protocollo (es. busta egov errore in ) + + + protocol:GOVWAY-[1400-1404] + Errore rilevato durante la validazione del messaggio per + quanto concerne la parte di attachments previsto dal + protocollo (es. busta egov con attachments, ) + + + protocol:GOVWAY-2000 + Errore generico rilevato durante la validazione del + messaggio + + + + + + + + + + + + Connettori + I connettori rappresentano le entità di configurazione che consentono a GovWay di + indirizzare le comunicazioni verso gli attori dei flussi di erogazione/fruizione + gestiti. Nel nostro contesto possiamo distinguere due tipologie di comunicazioni: + + GovWay ---> Applicativo Esterno, nel caso di + fruizioni + + + GovWay ---> Applicativo Interno, nel caso di + erogazioni + + + + I connettori di GovWay permettono di configurare differenti aspetti della + comunicazione http: + + + Autenticazione http: tale funzionalità permette di + impostare delle credenziali http basic (username e password). + + + + Autenticazione https: se l'utente lo desidera può + personalizzare tutti gli aspetti che riguardano una comunicazione sicura + su https. + + + + Proxy: è possibile configurare un proxy http che + media la comunicazione. + + + + Ridefinisci Tempi Risposta: permette di ridefinire + i tempi di risposta che sono stati configurati a livello generale, + nell'ambito del controllo del traffico (vedi ). + + + + Attivando la modalità avanzata dell'interfaccia saranno + inoltre disponibili le seguenti opzioni: + + + + + Data Transfer Mode: tramite questa configurazione è + possibile indicare se la comunicazione deve avvenire in modalità + transfer-encoding-chunked (streaming) o content length fisso. + + + + Redirect: tramite questa configurazione è possibile + indicare se un eventuale redirect ritornato dal server contattato deve + essere seguito o meno. + + + + Debug: è possibile abiltare un log verboso di tutta + la comunicazione. + + + + La govwayConsole, tramite l'interfaccia in modalità + avanzata, consente anche di configurare le comunicazioni + attraverso connettori non basati sul protocollo HTTP (o HTTPS). GovWay offre + built-in i seguenti ulteriori connettori: + + + JMS: connettore basato sul protocollo JMS + + + + File: connettore che permette di serializzare il + messaggio di richiesta su FileSystem ed opzionalmente generare una + risposta. + + + + 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 + + + Nel seguito vengono descritte alcune funzionalità specifiche dei + connettori HTTP e HTTPS. Inoltre viene fornita una descrizione del connettore + built-in JMS. + + Connettore Http + Quando si configura l'autenticazione per un connettore è possibile scegliere + la modalità di autenticazione HTTP-BASIC. Tale funzionalità permette di + impostare delle credenziali (username e password) che verranno iniettate nella + comunicazione http tramite header 'Authorization'. + +
+ Dati di configurazione di un'autenticazione Http + + + + + + + + +
+ + + + Autenticazione Https + Il connettore HTTPS permette di personalizzare i parametri SSL per ogni + connessione che utilizza questo protocollo. + 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. + + + + +
+ Dati di configurazione di un'autenticazione Https + + + + + + + + +
Facendo riferimento alla maschera raffigurata in 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. + + + + Tipo (solo se Dati di Accesso + ridefiniti) (jks, pkcs12, jceks, bks, + uber e gkr): Tipologia del Keystore (default: jks) + + + + + Password (solo se Dati di Accesso + ridefiniti): Password per l'accesso al + Keystore + + + + Password Chiave + Privata: Password per accedere alla chiave + privata presente nel keystore. + + + + Algoritmo: Algoritmo di + firma utilizzato (default: SunX509) + + + + + + + + + Proxy + Funzionalità che consente di configurare un proxy http che media la + comunicazione. Oltre ai classici parametri hostname e porta, è possibile anche + indicare delle credenziali http basic (username e password) che verranno + iniettate nella comunicazione http tramite header 'Proxy-Authorization'. + +
+ Dati di configurazione di un Proxy Http + + + + + + + + +
+ + + + Configurazione Http Avanzata + Richiede accesso alla govwayConsole in modalità avanzata + + Tramite questa sezione è possibile indicare sia quale modalità di + comunicazione (streaming o meno) deve essere utilizzata, sia se deve avvenire + una eventuale gestione dei redirect http. + +
+ Configurazione http avanzata + + + + + + + + +
Facendo riferimento alla maschera raffigurata in andiamo a descrivere il significato dei + parametri: + + + Data Transfer Mode tramite questa + configurazione è possibile indicare se la comunicazione deve + avvenire in modalità transfer-encoding-chunked (streaming) o con + content length fisso. + + + Modalità Data Transfer + (default, content-length, transfer-encoding-chunked): + indica il tipo di trasferimento dati; scegliendo la voce + default verrà utilizzato il comportamento configurato a + livello globale nel file govway.properties tramite le + opzioni: + + org.openspcoop2.pdd.connettori.inoltroBuste.httpTransferLength + + + org.openspcoop2.pdd.connettori.consegnaContenutiApplicativi.httpTransferLength + + + + + + + Chunk Length (Bytes) + (presente solamente se la modalità è + transfer-encoding-chunked): indica la dimensione in + bytes di ogni singolo http chunk. + + + + + + + Redirect tramite questa configurazione è + possibile indicare se un eventuale redirect ritornato dal server + contattato deve essere seguito o meno. + + + Gestione Redirect + (default, abilitato, disabilitato): consente di + personalizzare il comportamento sul singolo connettore; + scegliendo la voce default verrà utilizzato il + comportamento configurato a livello globale nel file + govway.properties tramite le opzioni: + + org.openspcoop2.pdd.connettori.inoltroBuste.followRedirects + + + org.openspcoop2.pdd.connettori.consegnaContenutiApplicativi.followRedirects + + + + + + + Massimo Numero di + Redirect (presente solamente se la + gestione redirect è abilitata): indica il massimo numero + di redirect seguiti. + + + + + + + + + Debug + Richiede accesso alla govwayConsole in modalità avanzata + (). + Se viene abilitato il debug, GovWay produce un log verboso di tutta la + comunicazione nel file + + + /var/log/govway/govway_connettori.log + + (assumendo che /var/log/govway sia la + directory di logging configurata) + +
+ Debug + + + + + + + + +
+ + + + Connettore JMS + Il connettore JMS consente di configurare i parametri per abilitare la + comunicazione tra GovWay e gli applicativi attraverso il protocollo JMS. + In è mostrata la maschera di + configurazione del connettore JMS. +
+ Dati di configurazione di un connettore JMS + + + + + + + + + + +
+ In riferimento alla 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 + + + + Send As (TextMessage/BytesMessage): + Si sceglie la codifica del messaggio da inviare tramite broker JMS, + tra TextMessage e BytesMessage. + + + + 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 + + + + Connection Factory: Identificatore + della risorsa JNDI per la creazione di una connessione verso il + 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 + + + + + + + Connettore File + Il connettore permette di serializzare la richiesta su FileSystem ed + opzionalmente di generare una risposta. + Il connettore File supporta: + + + Richiesta, è possibile serializzare + il messaggio di richiesta su file-system fornendo un path che può + contenere anche parti dinamiche risolte a runtime da GovWay. È + permesso anche abilitare l'eventuale sovrascrittura del file, se + risulta già esistente, e la creazione automatica delle directory + padre, se non esistono. + + + + Risposta, è opzionale; se abilitata + permette di generare una risposta costruita utilizzando il contenuto + di un file indirizzabile a sua volta tramite gli stessi meccanismi + dinamici della richiesta. Il file contenente la risposta può essere + eliminato una volta consumato (opzione configurabile). L'utente può + inoltre indicare un tempo di attesa (ms) qualora il file non sia + immediatamente disponibile. + + + + +
+ Dati di configurazione di un connettore File + + + + + + + + +
Facendo riferimento alla maschera raffigurata in andiamo a descrivere il significato dei + parametri: + + + Richiesta + + + + File: indirizzo su + file-system (path) dove verrà serializzato il messaggio + di richiesta. È possibile fornire delle macro per creare + dei path dinamici (per ulteriori dettagli vedi sezione + 'Informazioni Dinamiche'). + + + + File Headers + (opzionale): indirizzo su file-system (path) dove + verranno serializzati gli header di trasporto associati + alla richiesta. È possibile fornire delle macro per + creare dei path dinamici (per ulteriori dettagli vedi + sezione 'Informazioni Dinamiche'). + + + + Overwrite If Exists + (true/false): abilita l'eventuale sovrascrittura del + file, se risulta già esistere. + + + + AutoCreate Parent + Directory (true/false): abilita la + creazione automatica delle directory padre, se non + esistono. + + + + + + + Risposta (Opzionale) + + + + Generazione + (true/false): abilita la generazione di una risposta. + Tutte le successive opzioni della sezione 'Risposta' + sono configurabili solamente se la generazione è + abilitata. + + + + File: indirizzo su + file-system (path) dove verrà letto il messaggio di + risposta. È possibile fornire delle macro per creare dei + path dinamici, come descritto più avanti al punto + "Informazioni Dinamiche". + + + + File Headers + (opzionale): indirizzo su file system (path) dove + verranno letti gli header di trasporto da associare alla + risposta. E' possibile fornire delle macro per creare + dei path dinamici, come descritto più avanti al punto + "Informazioni Dinamiche". + + + + Delete After Read + (true/false): abilita l'eventuale eliminazione del file + una volta utilizzato per la generazione della risposta. + + + + + Wait Time If Not Exists + (ms) (opzionale): indica un tempo di + attesa (ms) qualora il file per la generazione della + risposta non sia immediatamente disponibile. + + + + + + + Informazioni Dinamiche. Per creare dei path + dinamici rispetto alla transazione in corso di elaborazione, possono + essere utilizzate le seguenti macro: + + + {date:FORMAT} indica la + data di elaborazione del messaggio. Il formato fornito + deve essere conforme a quanto richiesto dalla classe + java 'java.text.SimpleDateFormat'. Ad esempio: + {date:yyyyMMdd_HHmmssSSS}. + + + + {transaction:id} indica + l'identificativo della transazione (UUID). + + + + {busta:FIELD} permette + di utilizzare informazioni di protocollo riguardanti la + transazione in corso. Il valore 'FIELD' fornito deve + rappresentare un field valido all'interno della classe + di openspcoop 'org.openspcoop2.protocol.sdk.Busta'. Ad + esempio per ottenere il mittente della busta usare + {busta:mittente}. + + + + + + + + + + + + + Correlazione tra transazioni differenti + + Richiede accesso alla govwayConsole in modalità avanzata + (). + + Come descritto anche nella sezione , durante la + configurazione di un API di tipo SOAP o REST è possibile specificare i parametri + descritti di seguito rispettivamente in un servizio/azione o in una risorsa. + + ID Collaborazione. Flag per consentire di + specificare nelle richieste un valore che identifica una + conversazione. + + + Riferimento ID Richiesta. Flag per consentire di + specificare nelle richieste un identificativo relativo ad un messaggio + precedente. + + + + + Tali parametri consentono agli applicativi client di fornire tali informazioni + tramite gli header di integrazione descritti nella sezione + + Le informazioni fornite saranno associate alla traccia della transazione gestita, + e quindi utilizzabili in fase di monitoraggio tramite le modalità di ricerca basate + su identificativi descritte nella Guida alla Console di Monitoraggio. + + + + + Autenticazione e Autorizzazione Principal (Security Constraint) + + In precedenza, relativamente alla configurazione del controllo degli accessi, ed + in particolare del meccanismo di autenticazione, si è indicata anche la possibilità + di utilizzare il tipo principal. Questa configurazione richiede + che l'autenticazione sia delegata all'application server o qualunque altra modalità + che permetta a GovWay di accedere al principal tramite la api + HttpServletRequest.getUserPrincipal(). + + In precedenza, relativamente all'autorizzazione, si è descritta la possibilità di + utilizzare ruoli con fonte esterna. Questa fonte richiede che + la gestione dei ruoli sia delegata all'Application Server o a qualunque altra + modalità che permetta a GovWay di accedere ai ruoli tramite la api + HttpServletRequest.isUserInRole(). + + Le modalità di configurazione di utenti e ruoli sull'application server variano in + funzione della versione utilizzata e pertanto si rimanda alla documentazione del + prodotto. + È inoltre richiesto che l'applicazione utente sia protetta tramite un + security-constraint. A tale scopo l'installazione di GovWay + dispone di un contesto built-in govwaySec (definito nel war + govwaySec.war/WEB-INF/web.xml) protetto tramite security constraint con metodo di + autenticazione HTTP-BASIC: + + <security-constraint> + <web-resource-collection> + <web-resource-name>AuthenticationContainer</web-resource-name> + <url-pattern>/*</url-pattern> + </web-resource-collection> + <auth-constraint> + <role-name>*</role-name> + </auth-constraint> + </security-constraint> + + ... + + <security-role> + <role-name>*</role-name> + </security-role> + + <login-config> + <auth-method>BASIC</auth-method> + </login-config> + + + + Se si intende utilizzare una configurazione differente di quella built-in si deve + procedere con la modifica di tale descrittore web.xml presente all'interno + dell'archivio. + + + Con questo tipo di configurazione, le URL che gli applicativi devono invocare + devono essere adeguate sostituendo il contesto govway con + govwaySec. + + + + + + +
diff --git a/resources/doc/src/manualeUtente/cover/cover.pdf b/resources/doc/src/manualeUtente/cover/cover.pdf new file mode 100644 index 0000000000..59b5eac235 Binary files /dev/null and b/resources/doc/src/manualeUtente/cover/cover.pdf differ diff --git a/resources/doc/src/manualeUtente/figure/API-list.png b/resources/doc/src/manualeUtente/figure/API-list.png new file mode 100644 index 0000000000..725f1f2eeb Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/API-list.png differ diff --git a/resources/doc/src/manualeUtente/figure/API-new.png b/resources/doc/src/manualeUtente/figure/API-new.png new file mode 100644 index 0000000000..63073f799d Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/API-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/API_new.jpg b/resources/doc/src/manualeUtente/figure/API_new.jpg new file mode 100644 index 0000000000..4985f3002a Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/API_new.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/AggiungiAccordoSPCoop.png b/resources/doc/src/manualeUtente/figure/AggiungiAccordoSPCoop.png new file mode 100644 index 0000000000..793eff3ad7 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AggiungiAccordoSPCoop.png differ diff --git a/resources/doc/src/manualeUtente/figure/AggiungiAzione.png b/resources/doc/src/manualeUtente/figure/AggiungiAzione.png new file mode 100644 index 0000000000..8257bc32de Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AggiungiAzione.png differ diff --git a/resources/doc/src/manualeUtente/figure/AggiungiPddEsterna.jpg b/resources/doc/src/manualeUtente/figure/AggiungiPddEsterna.jpg new file mode 100644 index 0000000000..ae60139492 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AggiungiPddEsterna.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/AggiungiPortType.png b/resources/doc/src/manualeUtente/figure/AggiungiPortType.png new file mode 100644 index 0000000000..640a6f211b Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AggiungiPortType.png differ diff --git a/resources/doc/src/manualeUtente/figure/AggiungiPortTypeSPCoop.png b/resources/doc/src/manualeUtente/figure/AggiungiPortTypeSPCoop.png new file mode 100644 index 0000000000..068cab14c5 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AggiungiPortTypeSPCoop.png differ diff --git a/resources/doc/src/manualeUtente/figure/AggiungiRisorsaREST.png b/resources/doc/src/manualeUtente/figure/AggiungiRisorsaREST.png new file mode 100644 index 0000000000..796f9ca1f1 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AggiungiRisorsaREST.png differ diff --git a/resources/doc/src/manualeUtente/figure/AggiungiScope.png b/resources/doc/src/manualeUtente/figure/AggiungiScope.png new file mode 100644 index 0000000000..0c77774b48 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AggiungiScope.png differ diff --git a/resources/doc/src/manualeUtente/figure/AggiungiServizioApplicativo.jpg b/resources/doc/src/manualeUtente/figure/AggiungiServizioApplicativo.jpg new file mode 100644 index 0000000000..4f01e7b735 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AggiungiServizioApplicativo.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/AggiungiUtente.png b/resources/doc/src/manualeUtente/figure/AggiungiUtente.png new file mode 100644 index 0000000000..3f6bc0c576 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AggiungiUtente.png differ diff --git a/resources/doc/src/manualeUtente/figure/Applicativo-new.png b/resources/doc/src/manualeUtente/figure/Applicativo-new.png new file mode 100644 index 0000000000..eef43e63a8 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Applicativo-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/ArchitetturaFunzionaleGovWay.jpg b/resources/doc/src/manualeUtente/figure/ArchitetturaFunzionaleGovWay.jpg new file mode 100644 index 0000000000..7919def581 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ArchitetturaFunzionaleGovWay.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/AuditingQueryDetail.jpg b/resources/doc/src/manualeUtente/figure/AuditingQueryDetail.jpg new file mode 100644 index 0000000000..c14240b7db Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AuditingQueryDetail.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/AuditingQueryResult.jpg b/resources/doc/src/manualeUtente/figure/AuditingQueryResult.jpg new file mode 100644 index 0000000000..36511c1102 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AuditingQueryResult.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/AuditingQuerySearch.jpg b/resources/doc/src/manualeUtente/figure/AuditingQuerySearch.jpg new file mode 100644 index 0000000000..5174a4b3f9 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AuditingQuerySearch.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/AuditingSetupDisabled.jpg b/resources/doc/src/manualeUtente/figure/AuditingSetupDisabled.jpg new file mode 100644 index 0000000000..d94576e05e Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AuditingSetupDisabled.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/AuditingSetupEnabled.jpg b/resources/doc/src/manualeUtente/figure/AuditingSetupEnabled.jpg new file mode 100644 index 0000000000..47bdc03bf1 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AuditingSetupEnabled.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/AuditingSetupFilter.jpg b/resources/doc/src/manualeUtente/figure/AuditingSetupFilter.jpg new file mode 100644 index 0000000000..8e40192265 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AuditingSetupFilter.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/Autenticazione.png b/resources/doc/src/manualeUtente/figure/Autenticazione.png new file mode 100644 index 0000000000..ee1d4c1906 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Autenticazione.png differ diff --git a/resources/doc/src/manualeUtente/figure/AutenticazioneHTTP.jpg b/resources/doc/src/manualeUtente/figure/AutenticazioneHTTP.jpg new file mode 100644 index 0000000000..2548b24155 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/AutenticazioneHTTP.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/Autorizzazione.png b/resources/doc/src/manualeUtente/figure/Autorizzazione.png new file mode 100644 index 0000000000..a20f821a88 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Autorizzazione.png differ diff --git a/resources/doc/src/manualeUtente/figure/Config-new.png b/resources/doc/src/manualeUtente/figure/Config-new.png new file mode 100644 index 0000000000..5b2c32ba82 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Config-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/ConfigurazioneGenerale.png b/resources/doc/src/manualeUtente/figure/ConfigurazioneGenerale.png new file mode 100644 index 0000000000..5062c18f70 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ConfigurazioneGenerale.png differ diff --git a/resources/doc/src/manualeUtente/figure/ConfigurazioneRegistro.jpg b/resources/doc/src/manualeUtente/figure/ConfigurazioneRegistro.jpg new file mode 100644 index 0000000000..65f3279611 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ConfigurazioneRegistro.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/ConnettoreFILE.jpg b/resources/doc/src/manualeUtente/figure/ConnettoreFILE.jpg new file mode 100644 index 0000000000..110dd8d767 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ConnettoreFILE.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/ConnettoreHTTPS.jpg b/resources/doc/src/manualeUtente/figure/ConnettoreHTTPS.jpg new file mode 100644 index 0000000000..10aa254bda Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ConnettoreHTTPS.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/ConnettoreJMS.jpg b/resources/doc/src/manualeUtente/figure/ConnettoreJMS.jpg new file mode 100644 index 0000000000..dcbf65eb8f Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ConnettoreJMS.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloAccessi.png b/resources/doc/src/manualeUtente/figure/ControlloAccessi.png new file mode 100644 index 0000000000..d818946b95 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloAccessi.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloAccessiFruizione.png b/resources/doc/src/manualeUtente/figure/ControlloAccessiFruizione.png new file mode 100644 index 0000000000..349b34736d Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloAccessiFruizione.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-Applicabilita.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Applicabilita.png new file mode 100644 index 0000000000..ce886694da Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Applicabilita.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-Collezionamento.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Collezionamento.png new file mode 100644 index 0000000000..cf589f4dbc Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Collezionamento.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-Congestione.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Congestione.png new file mode 100644 index 0000000000..b9ddcc5e05 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Congestione.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-Filtro.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Filtro.png new file mode 100644 index 0000000000..71378d340a Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Filtro.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-Finestre.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Finestre.png new file mode 100644 index 0000000000..5ccefed996 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Finestre.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-Policy-list.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Policy-list.png new file mode 100644 index 0000000000..6351852170 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Policy-list.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-Policy-new.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Policy-new.png new file mode 100644 index 0000000000..fcbb3065bc Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Policy-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-RegistroPolicy-list.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-RegistroPolicy-list.png new file mode 100644 index 0000000000..affcd917fe Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-RegistroPolicy-list.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-RegistroPolicy-new.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-RegistroPolicy-new.png new file mode 100644 index 0000000000..8d373f60e5 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-RegistroPolicy-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-Runtime.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Runtime.png new file mode 100644 index 0000000000..9ceb00b235 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-Runtime.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico-StatistichePolicy.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico-StatistichePolicy.png new file mode 100644 index 0000000000..5d389fe766 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico-StatistichePolicy.png differ diff --git a/resources/doc/src/manualeUtente/figure/ControlloTraffico.png b/resources/doc/src/manualeUtente/figure/ControlloTraffico.png new file mode 100644 index 0000000000..ebfb293c39 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ControlloTraffico.png differ diff --git a/resources/doc/src/manualeUtente/figure/CorrelazioneApplicativa-new.png b/resources/doc/src/manualeUtente/figure/CorrelazioneApplicativa-new.png new file mode 100644 index 0000000000..1da9b24b33 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/CorrelazioneApplicativa-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/DebugConnettore.jpg b/resources/doc/src/manualeUtente/figure/DebugConnettore.jpg new file mode 100644 index 0000000000..517caad4f2 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/DebugConnettore.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/DettaglioErogazione.png b/resources/doc/src/manualeUtente/figure/DettaglioErogazione.png new file mode 100644 index 0000000000..9876643b03 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/DettaglioErogazione.png differ diff --git a/resources/doc/src/manualeUtente/figure/DettaglioMessaggio.jpg b/resources/doc/src/manualeUtente/figure/DettaglioMessaggio.jpg new file mode 100644 index 0000000000..9f3905cf45 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/DettaglioMessaggio.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/ElencoFruitoriServizio.jpg b/resources/doc/src/manualeUtente/figure/ElencoFruitoriServizio.jpg new file mode 100644 index 0000000000..482c1baff2 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ElencoFruitoriServizio.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/ElencoUtenti.png b/resources/doc/src/manualeUtente/figure/ElencoUtenti.png new file mode 100644 index 0000000000..188b9212d4 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ElencoUtenti.png differ diff --git a/resources/doc/src/manualeUtente/figure/Erogazione-new.png b/resources/doc/src/manualeUtente/figure/Erogazione-new.png new file mode 100644 index 0000000000..e6a6e2b9de Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Erogazione-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/ErogazioneRateLimiting_Aggiungi.png b/resources/doc/src/manualeUtente/figure/ErogazioneRateLimiting_Aggiungi.png new file mode 100644 index 0000000000..0480f99a67 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ErogazioneRateLimiting_Aggiungi.png differ diff --git a/resources/doc/src/manualeUtente/figure/ErogazioneSPCoop.png b/resources/doc/src/manualeUtente/figure/ErogazioneSPCoop.png new file mode 100644 index 0000000000..5966e7683b Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ErogazioneSPCoop.png differ diff --git a/resources/doc/src/manualeUtente/figure/ErogazioneScenario.jpg b/resources/doc/src/manualeUtente/figure/ErogazioneScenario.jpg new file mode 100644 index 0000000000..341fedf1da Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ErogazioneScenario.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/Esportazione.png b/resources/doc/src/manualeUtente/figure/Esportazione.png new file mode 100644 index 0000000000..83d9c339c5 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Esportazione.png differ diff --git a/resources/doc/src/manualeUtente/figure/Esportazione2.png b/resources/doc/src/manualeUtente/figure/Esportazione2.png new file mode 100644 index 0000000000..965661fa81 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Esportazione2.png differ diff --git a/resources/doc/src/manualeUtente/figure/Esportazione3.png b/resources/doc/src/manualeUtente/figure/Esportazione3.png new file mode 100644 index 0000000000..3395e6cbd0 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Esportazione3.png differ diff --git a/resources/doc/src/manualeUtente/figure/FasiProcessamento.jpg b/resources/doc/src/manualeUtente/figure/FasiProcessamento.jpg new file mode 100644 index 0000000000..25f9e2356d Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/FasiProcessamento.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/FiltroErogazioni.png b/resources/doc/src/manualeUtente/figure/FiltroErogazioni.png new file mode 100644 index 0000000000..a4397e18eb Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/FiltroErogazioni.png differ diff --git a/resources/doc/src/manualeUtente/figure/Fruizione-new.png b/resources/doc/src/manualeUtente/figure/Fruizione-new.png new file mode 100644 index 0000000000..97ab96b324 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Fruizione-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/FruizioneScenario.jpg b/resources/doc/src/manualeUtente/figure/FruizioneScenario.jpg new file mode 100644 index 0000000000..cacfd205d2 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/FruizioneScenario.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/GestioneToken.png b/resources/doc/src/manualeUtente/figure/GestioneToken.png new file mode 100644 index 0000000000..95ff2a0986 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/GestioneToken.png differ diff --git a/resources/doc/src/manualeUtente/figure/Govway-FatturazioneAttiva.jpg b/resources/doc/src/manualeUtente/figure/Govway-FatturazioneAttiva.jpg new file mode 100644 index 0000000000..828035fa6a Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Govway-FatturazioneAttiva.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/Govway-FatturazionePassiva.jpg b/resources/doc/src/manualeUtente/figure/Govway-FatturazionePassiva.jpg new file mode 100644 index 0000000000..6725325930 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Govway-FatturazionePassiva.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/Govway.vsd b/resources/doc/src/manualeUtente/figure/Govway.vsd new file mode 100644 index 0000000000..5bf9c00424 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Govway.vsd differ diff --git a/resources/doc/src/manualeUtente/figure/IdentificazioneAzioneSoap1.png b/resources/doc/src/manualeUtente/figure/IdentificazioneAzioneSoap1.png new file mode 100644 index 0000000000..2dd13cb580 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/IdentificazioneAzioneSoap1.png differ diff --git a/resources/doc/src/manualeUtente/figure/IdentificazioneAzioneSoap2.png b/resources/doc/src/manualeUtente/figure/IdentificazioneAzioneSoap2.png new file mode 100644 index 0000000000..5e7c60a71b Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/IdentificazioneAzioneSoap2.png differ diff --git a/resources/doc/src/manualeUtente/figure/IdentificazioneRisorsaRest.png b/resources/doc/src/manualeUtente/figure/IdentificazioneRisorsaRest.png new file mode 100644 index 0000000000..7896331752 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/IdentificazioneRisorsaRest.png differ diff --git a/resources/doc/src/manualeUtente/figure/Importazione.png b/resources/doc/src/manualeUtente/figure/Importazione.png new file mode 100644 index 0000000000..cb8a4121b9 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Importazione.png differ diff --git a/resources/doc/src/manualeUtente/figure/ImportazioneAS.jpg b/resources/doc/src/manualeUtente/figure/ImportazioneAS.jpg new file mode 100644 index 0000000000..93766d1456 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ImportazioneAS.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/InvocazioneServizioAvanzata.jpg b/resources/doc/src/manualeUtente/figure/InvocazioneServizioAvanzata.jpg new file mode 100644 index 0000000000..3543f47fae Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/InvocazioneServizioAvanzata.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/ListaErogazioni.png b/resources/doc/src/manualeUtente/figure/ListaErogazioni.png new file mode 100644 index 0000000000..94e47b8134 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ListaErogazioni.png differ diff --git a/resources/doc/src/manualeUtente/figure/Menu-Utenti.jpg b/resources/doc/src/manualeUtente/figure/Menu-Utenti.jpg new file mode 100644 index 0000000000..a325bbaf4a Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Menu-Utenti.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/MonitoraggioApplicativo.jpg b/resources/doc/src/manualeUtente/figure/MonitoraggioApplicativo.jpg new file mode 100644 index 0000000000..1e8059e13b Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/MonitoraggioApplicativo.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/MonitoraggioApplicativoFiltra.jpg b/resources/doc/src/manualeUtente/figure/MonitoraggioApplicativoFiltra.jpg new file mode 100755 index 0000000000..6967e6bf57 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/MonitoraggioApplicativoFiltra.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/Multi-Tenant-Config.png b/resources/doc/src/manualeUtente/figure/Multi-Tenant-Config.png new file mode 100644 index 0000000000..4e0c42be30 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Multi-Tenant-Config.png differ diff --git a/resources/doc/src/manualeUtente/figure/Multi-Tenant.png b/resources/doc/src/manualeUtente/figure/Multi-Tenant.png new file mode 100644 index 0000000000..0061108d3b Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Multi-Tenant.png differ diff --git a/resources/doc/src/manualeUtente/figure/OIDCUserInfo.png b/resources/doc/src/manualeUtente/figure/OIDCUserInfo.png new file mode 100644 index 0000000000..6ddb35836a Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/OIDCUserInfo.png differ diff --git a/resources/doc/src/manualeUtente/figure/OpzioniAvanzateHttp.jpg b/resources/doc/src/manualeUtente/figure/OpzioniAvanzateHttp.jpg new file mode 100644 index 0000000000..2ec5e9b134 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/OpzioniAvanzateHttp.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/ProxyHTTP.jpg b/resources/doc/src/manualeUtente/figure/ProxyHTTP.jpg new file mode 100644 index 0000000000..79063f3e1d Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ProxyHTTP.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/Runtime.png b/resources/doc/src/manualeUtente/figure/Runtime.png new file mode 100644 index 0000000000..20459ab02f Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Runtime.png differ diff --git a/resources/doc/src/manualeUtente/figure/Ruoli-new.png b/resources/doc/src/manualeUtente/figure/Ruoli-new.png new file mode 100644 index 0000000000..2edea1a9f1 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Ruoli-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/SicurezzaMessaggio.png b/resources/doc/src/manualeUtente/figure/SicurezzaMessaggio.png new file mode 100644 index 0000000000..34bc60a46d Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/SicurezzaMessaggio.png differ diff --git a/resources/doc/src/manualeUtente/figure/Soggetto-new.png b/resources/doc/src/manualeUtente/figure/Soggetto-new.png new file mode 100644 index 0000000000..00d87550d9 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Soggetto-new.png differ diff --git a/resources/doc/src/manualeUtente/figure/SoggettoCredenziali.jpg b/resources/doc/src/manualeUtente/figure/SoggettoCredenziali.jpg new file mode 100644 index 0000000000..7fee4aa8d8 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/SoggettoCredenziali.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/SoggettoRuoli.png b/resources/doc/src/manualeUtente/figure/SoggettoRuoli.png new file mode 100644 index 0000000000..51d36e1e61 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/SoggettoRuoli.png differ diff --git a/resources/doc/src/manualeUtente/figure/TokenForward.png b/resources/doc/src/manualeUtente/figure/TokenForward.png new file mode 100644 index 0000000000..d2ef307dee Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/TokenForward.png differ diff --git a/resources/doc/src/manualeUtente/figure/TokenIntrospection.png b/resources/doc/src/manualeUtente/figure/TokenIntrospection.png new file mode 100644 index 0000000000..99691db679 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/TokenIntrospection.png differ diff --git a/resources/doc/src/manualeUtente/figure/TokenIntrospectionCustom.png b/resources/doc/src/manualeUtente/figure/TokenIntrospectionCustom.png new file mode 100644 index 0000000000..4539a11b75 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/TokenIntrospectionCustom.png differ diff --git a/resources/doc/src/manualeUtente/figure/TokenPolicy-generale.png b/resources/doc/src/manualeUtente/figure/TokenPolicy-generale.png new file mode 100644 index 0000000000..96be7211fb Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/TokenPolicy-generale.png differ diff --git a/resources/doc/src/manualeUtente/figure/Tracciamento.png b/resources/doc/src/manualeUtente/figure/Tracciamento.png new file mode 100644 index 0000000000..66e0c615ff Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Tracciamento.png differ diff --git a/resources/doc/src/manualeUtente/figure/TracciamentoServizio.png b/resources/doc/src/manualeUtente/figure/TracciamentoServizio.png new file mode 100644 index 0000000000..ba2112d054 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/TracciamentoServizio.png differ diff --git a/resources/doc/src/manualeUtente/figure/Validazione.png b/resources/doc/src/manualeUtente/figure/Validazione.png new file mode 100644 index 0000000000..017a664728 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/Validazione.png differ diff --git a/resources/doc/src/manualeUtente/figure/ValidazioneJWT.png b/resources/doc/src/manualeUtente/figure/ValidazioneJWT.png new file mode 100644 index 0000000000..001dcb36fa Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/ValidazioneJWT.png differ diff --git a/resources/doc/src/manualeUtente/figure/aaCorrelazione.png b/resources/doc/src/manualeUtente/figure/aaCorrelazione.png new file mode 100644 index 0000000000..e355218f0c Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/aaCorrelazione.png differ diff --git a/resources/doc/src/manualeUtente/figure/aaSA.jpg b/resources/doc/src/manualeUtente/figure/aaSA.jpg new file mode 100644 index 0000000000..0cc330f833 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/aaSA.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/aaSA2.jpg b/resources/doc/src/manualeUtente/figure/aaSA2.jpg new file mode 100644 index 0000000000..85879f5aeb Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/aaSA2.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/addRuoloSA.jpg b/resources/doc/src/manualeUtente/figure/addRuoloSA.jpg new file mode 100644 index 0000000000..62278290c5 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/addRuoloSA.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/addRuoloSoggetto.jpg b/resources/doc/src/manualeUtente/figure/addRuoloSoggetto.jpg new file mode 100644 index 0000000000..f0387b7037 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/addRuoloSoggetto.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/asCorrelazione.png b/resources/doc/src/manualeUtente/figure/asCorrelazione.png new file mode 100644 index 0000000000..30370457ce Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/asCorrelazione.png differ diff --git a/resources/doc/src/manualeUtente/figure/asSA.jpg b/resources/doc/src/manualeUtente/figure/asSA.jpg new file mode 100644 index 0000000000..14ad6c812a Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/asSA.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/asSA2.jpg b/resources/doc/src/manualeUtente/figure/asSA2.jpg new file mode 100644 index 0000000000..d1feb7806a Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/asSA2.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/creazioneEnteEsterno.jpg b/resources/doc/src/manualeUtente/figure/creazioneEnteEsterno.jpg new file mode 100644 index 0000000000..621e5eb3ea Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/creazioneEnteEsterno.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/custom_properties_soapui.jpg b/resources/doc/src/manualeUtente/figure/custom_properties_soapui.jpg new file mode 100644 index 0000000000..819d49d6cb Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/custom_properties_soapui.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/edev-BaseURL-SoggettoInterno.png b/resources/doc/src/manualeUtente/figure/edev-BaseURL-SoggettoInterno.png new file mode 100644 index 0000000000..15305fee41 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/edev-BaseURL-SoggettoInterno.png differ diff --git a/resources/doc/src/manualeUtente/figure/edev-DatiSoggettoInterno.png b/resources/doc/src/manualeUtente/figure/edev-DatiSoggettoInterno.png new file mode 100644 index 0000000000..a143f170d1 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/edev-DatiSoggettoInterno.png differ diff --git a/resources/doc/src/manualeUtente/figure/edev-api-azione.png b/resources/doc/src/manualeUtente/figure/edev-api-azione.png new file mode 100644 index 0000000000..8a7c056292 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/edev-api-azione.png differ diff --git a/resources/doc/src/manualeUtente/figure/edev-api-props.png b/resources/doc/src/manualeUtente/figure/edev-api-props.png new file mode 100644 index 0000000000..2cc26b7549 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/edev-api-props.png differ diff --git a/resources/doc/src/manualeUtente/figure/edev-erogazione.png b/resources/doc/src/manualeUtente/figure/edev-erogazione.png new file mode 100644 index 0000000000..0c88e6e120 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/edev-erogazione.png differ diff --git a/resources/doc/src/manualeUtente/figure/edev-pmode.png b/resources/doc/src/manualeUtente/figure/edev-pmode.png new file mode 100644 index 0000000000..b8e272f689 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/edev-pmode.png differ diff --git a/resources/doc/src/manualeUtente/figure/erogazione_soapui.jpg b/resources/doc/src/manualeUtente/figure/erogazione_soapui.jpg new file mode 100644 index 0000000000..99c3697e1f Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/erogazione_soapui.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/fruizione_soapui.jpg b/resources/doc/src/manualeUtente/figure/fruizione_soapui.jpg new file mode 100644 index 0000000000..47d8161341 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/fruizione_soapui.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/funzionalitaEGovDeprecate.jpg b/resources/doc/src/manualeUtente/figure/funzionalitaEGovDeprecate.jpg new file mode 100644 index 0000000000..fe2b0ef1f1 Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/funzionalitaEGovDeprecate.jpg differ diff --git a/resources/doc/src/manualeUtente/figure/profiloInteroperabilita.png b/resources/doc/src/manualeUtente/figure/profiloInteroperabilita.png new file mode 100644 index 0000000000..ef67662f4f Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/profiloInteroperabilita.png differ diff --git a/resources/doc/src/manualeUtente/figure/xacmlPolicyAdd.png b/resources/doc/src/manualeUtente/figure/xacmlPolicyAdd.png new file mode 100644 index 0000000000..8384385ede Binary files /dev/null and b/resources/doc/src/manualeUtente/figure/xacmlPolicyAdd.png differ diff --git a/resources/doc/src/releaseNotes/Makefile b/resources/doc/src/releaseNotes/Makefile new file mode 100644 index 0000000000..08f8c72952 --- /dev/null +++ b/resources/doc/src/releaseNotes/Makefile @@ -0,0 +1,5 @@ +include ../core/makefile/env +include ../core/makefile/commons + +SOURCE_NAME=ReleaseNotes +SOURCE_FILE=${SOURCE_NAME}.xml diff --git a/resources/doc/src/releaseNotes/ReleaseNotes.xml b/resources/doc/src/releaseNotes/ReleaseNotes.xml new file mode 100644 index 0000000000..f8575d9992 --- /dev/null +++ b/resources/doc/src/releaseNotes/ReleaseNotes.xml @@ -0,0 +1,197 @@ + + + +
+ + Release Notes del prodotto GovWay + Release Notes + + 2005-2018 + + + Link.it srl + + + +
Link.it SRL Via S. Martino,51 + I-56125 Pisa + ITALY + e-mail: info@link.it +
+ + + Versione 3.0.1 + In questa sezione sono descritte le principali nuove funzionalità e i problemi + risolti nella versione 3.0.1 di GovWay. Per un elenco dettagliato dei problemi risolti e + per maggiori dettagli sulle funzionalità si può invece far riferimento al + file ChangeLog di questa versione. + + Nuova funzionalità Multi-Tenant + Semplificata drasticamente la gestione in modalità multi-tenant, prima + possibile esclusivamente in maniera analoga alla precedente modalit di gestione + della Console OpenSPCoop. + + Attivazione: possibile attivare la modalit + multi-tenant direttamente dalla console di gestione, tramite la sezione + 'Configurazione - Generale'. + + + Selezione del dominio: possibile selezionare il + soggetto su cui operare direttamente dalla testata delle console di + configurazione e monitoraggio. + + + Comunicazioni interne al dominio gestito: + possibile abilitare la gestione multi-tenant in modo da permettere + interazioni tra soggetti fruitori ed erogatori entrambi appartenente al + dominio interno. + + + + + + Revisione dei formati di errore generati dal Gateway + I formati dei messaggi di errore generati dal Gateway sono ora conformi a quanto + previsto dall'RFC 7807 e dalle specifiche AGID "MI 2018". Sono stati inoltre + uniformati i messaggi di errore ritornati nelle erogazioni e nelle fruizioni. + Per le API di tipologia REST viene generato un oggetto Problem + Details come definito nella specifica RFC 7807 + (https://tools.ietf.org/html/rfc7807). Le casistiche di errore + supportate sono le seguenti: + + 401: rientrano in questa castistica gli errori + avenuti durante le fasi di autenticazione degli applicativi e di + verifica del token OAuth + + + 403: identifica un'autorizzazione fallita + + + 404: richiesta una erogazione o fruizione + inesistente + + + 400: l'errore occorso imputabile ai dati + forniti dal client (es. messaggio non valido in caso di validazione + attiva) + + + 429: identifica una violazione della politica di + Rate Limiting + + + 503: rientrano in questa casistica gli errori + causati da una irraggiungibilit dell'applicativo indirizzato dal + Gateway o una temporanea sospensione della erogazione/fruzione + + + 500: qualsiasi altro errore + + Nell'elemento detail presente il dettaglio + dell'errore mentre nell'elemento govway_status una codifica in + GovWay di tale errore. + Per le API di tipologia SOAP, sia in erogazione che in fruizione, viene generato + un SOAPFault contenente un actor valorizzato con + http://govway.org/integration. Nell'elemento + fault string presente il dettaglio dell'errore mentre + nell'elemento fault code una codifica in GovWay di tale + errore. + + + + Nuove funzionalità di Identificazione e Autorizzazione + Per le API erogate da Soggetti interni ora permesso l'accesso anche da parte di + applicativi (interni al dominio gestito) e non solo di Soggetti (esterni al dominio + gestito). + + + Miglioramenti alle Console di Gestione e Monitoraggio + Sono state apportate le seguenti migliorie: + + Restyling grafico del men in testata: + perfezionata la gestione delle informazioni relative all'utente + collegato, alle modalit di utilizzo e, se attivato il multi-tenant, al + soggetto gestito. + + + Nuova presentazione delle API: completo restyling + delle modalit di visualizzazione e di editing delle API + registrate. + + + + + + Miglioramenti all'Installer + Sono state apportati i seguenti miglioramenti all'Installer binario: + + Aggiornamento; L'Installer pu ora gestire anche + l'aggiornamento del Software rispetto ad una precedente versione gi + installata. + + + SQL; corretti gli script sql, prodotti + dall'installer, che causavano errori se utilizzati sui seguenti + database: + + SQLServer, si otteneva il messaggio + di errore: Introducing FOREIGN KEY constraint 'fk_...' on + table '...' may cause cycles or multiple cascade + paths + + + MySQL, venivano segnalati diversi + errori come il seguente: CONSTRAINT unique_... UNIQUE (...), + - ERROR 1071 (42000): Specified key was too long; max key + length is 767 bytes + + + + + + + + + + Versione 3.0 + Il software GovWay l'evoluzione della Porta di Dominio OpenSPCoop, e riparte quindi + dalla versione 3.0, riprendendo il precedente versionamento del software + OpenSPCoop. + GovWay recepisce le tante innovazioni dell'interoperabilit applicativa intervenute + nelle normative italiana ed europea e negli standard internazionali. Il cambio di nome + del progetto da OpenSPCoop a GovWay stato necessario per svincolare il prodotto da uno + standard ormai deprecato come SPCoop, mantenendo per il focus sulle funzioni di API + Gateway verticalizzato sulle forti peculiarit della Pubblica Amministrazione italiana. + Avremmo voluto pubblicare la nuova versione contestualmente al rilascio delle nuove + linee guida di AGID, annunciate nel piano triennale per fine 2017. Il ritardo di questa + specifica (alla data di rilascio sono disponibili i soli primi due capitoli + introduttivi) ci ha convinti a rilasciare GovWay nella nostra "interpretazione" + dell'attuale versione della nuova specifica, in attesa di poterci adeguare alla versione + definitiva non appena disponibile. + Oltre al nuovo modello di interoperabilit (MI2018), Govway supporta nativamente: + + + tutti i pi recenti standard internazionali (i nuovi servizi RESTful, la + gestione dei Token, in particolare per AUTH2 e OIDC, ed in generale tutte le + ultime specifiche relative all'API Management); + + + le normative dell'interoperabilit europea, basate sul "building block" + eDelivery del progetto CEF (Connecting European Facilities), utilizzate per gli + scambi applicativi trans-europei; + + + la retrocompatibilit con SPCoop, ancora molto utilizzato e quindi per il + momento sicuramente imprescindibile come protocollo di interoperabilit nella + Pubblica Amministrazione Italiana. + + + infine GovWay introduce infine il concetto di "govlet", connettori pronti per + i principali servizi della PA italiana. Al momento sono disponibili govlet per + SIOPE+, PagoPA e Fatturazione Elettronica, tutti scaricabili dal sito + govway.org, ma la libreria di govlet in rapida evoluzione. + + + +
diff --git a/resources/doc/src/releaseNotes/cover/cover.pdf b/resources/doc/src/releaseNotes/cover/cover.pdf new file mode 100644 index 0000000000..8d273e3002 Binary files /dev/null and b/resources/doc/src/releaseNotes/cover/cover.pdf differ