Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- documentazione_3di_riservata:docway4:firma_medas [2021/10/19 13:54] – francesco.chiarello
+++ documentazione_3di_riservata:docway4:firma_medas [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1
@@ Linea 1: / Linea 1: @@
-====== FIRMA DIGITALE MEDAS ======
-**Versione**: x.0\\
-**Rilascio**: 30/09/2021\\
-**Aggiornamento** Integrazione Firma Remota OTP.\\
-===== Requisiti =====
-Per utilizzare l'integrazione della Firma Digitale ScrybaSign sviluppato da Medas all'interno di DocWay4 è necessario installare e configurare il webservice **ScrybaWS** sviluppato da 3DI.
-Il webservice **ScrybaWS**, opportunamente configurato, si interfaccia con il servizio di Medas  (ScrybaSign), che espone le funzionalità di:
-  * Firma Remota OTP
-  * Recupero documenti firmati
-  * Cancellazione documenti firmati
-Per la **Firma Remota OTP** è necessario possedere delle credenziali abilitate da Medas.
-===== ScrybaWS =====
-Il webservice è sviluppato in tecnologia JAVA ed è accessibile mediante chiamata SOAP.
-Si occupa sostanzialmente della gestione della firma, occupandosi dello scambio di dati con ScrybaWS e il broker, offrendo principalmente espone 2 metodi:
-  * firmaDocumenti: invocato da DocWay, avvia il processo di Firma dei files di un documento;
-  * pollingDocumenti: invocato da DocWay, si occupa di effettuare il polling dei documenti firmati per recuperarne il contenuto e aggiornare il documento in base alla politica stabilita (APPEND | OVERWRITE | VERSIONING)
-E' necessario configurare un parametro all'interno del web.xml:
-  * **suffissoNomeFile**: specifica il suffiso da dare ai file firmati
-===== Configurazione =====
-Per attivare la funzionalità di Firma Digitale Medas in DocWay è necessario configurare alcuni parametri presenti nel file **it.highwaytech.apps.xdocway.properties**:
-^ Property                            ^ **Descrizione**                                                 ^ Valore                           ^ Ambiente di test                                               ^
-| abilitaFirmaMedas                 | attiva/disattiva il servizio di Firma Digitale Remota con OTP  | si/no                            | si                                                             |
-| scrybaWs                           | Url per accesso al ws ScrybaWS                                 |                                  | http://localhost:8080/ScrybaWS/services/scrybaSoap  |
-| scryba.sessionUrlBase                       | Url per la costruzione dei link verso le sessioni di firma Scryba | | https://scrybasign.test.medas-solutions.it/ScrybaSignServer/sign/session/        |
-| scryba.extraWayWsUrl               | parametro 3diws                                                 |                                  | http://localhost:8080/3diws/services/eXtraWay                                                      |
-| scryba.xwHost                      | parametro 3diws                                                 |                                  | xwee-test                                                      |
-| scryba.xwPort                      | parametro 3diws                                                 |                                  | 4859                                                           |
-| scryba.xwUser                      | parametro 3diws                                                 |                                  | 3diws                                                          |
-| scryba.xwPassword                  | parametro 3diws                                                 |                                  | reader                                                         |
-| scryba.xwAuthUser                  | parametro 3diws                                                 |                                  | 3diws                                                          |
-| scryba.xwPnumber                   | parametro 3diws                                                 |                                  | 1                                                          |
-| scryba.xwAuthPassword              | parametro 3diws                                                 |                                  | admin                                                          |
-| scryba.tipoRiconsegna              | comportamento per aggiornamento file firmato sul documento      | OVERWRITE\\ APPEND\\ VERSIONING  | APPEND                                                         |
-| scryba.processId                   | parametro concordato con Medas                              |                                  | TEST                                                  |
-| scryba.docType                     | parametro concordato con Medas  |                   | TEST2 |
-| scryba.padesPage                   | firma PADES: pagina su cui apporre il glifo della firma                              | LAST \\ FIRST                                 | LAST                                                        |
-| scryba.padesLeftX                  | firma PADES: coordinata sx per il glifo    | | 150 |
-| scryba.padesLeftY                  | firma PADES: coordinata sx per il glifo    | | 10  |
-| scryba.padesRightX                 | firma PADES: coordinata dx per il glifo    | | 185 |
-| scryba.padesRightY                 | firma PADES: coordinata dx per il glifo    | | 20  |
-| scryba.pdfProfile                  | firma PADES: profilo PDF | BASIC\\ PADESBES | PADESBES |
-In base alle esigenze del cliente, è possibile modificare anche alcuni parametri nel file **it.highwaytech.apps.generic.properties**:
-| showAlwaysSignatureButton                  | Consente di visualizzare il pulsante di firma per i documenti sempre, anche quando non sono stati marcati documenti nel libro firma | si\\ no | si |
-Questi invece i parametri dell'applicazione ScrybaWS, definiti in **medas.scryba.properties**:
-| medasScrybaWSUrl                  | Url del servizio Scryba su cui fare le chiaamte | | https://scrybasign.test.medas-solutions.it/ScrybaSignServer/services/utils/v2?wsdl |
-| medasScrybaWSProtocol             | Protocollo usato per le chiamate | HTTP\\ HTTPS | HTTPS |
-| medasScrybaBasicAuthUsername      | Utente per la BASIC Authentication | | docWayBA |
-| medasScrybaBasicAuthPassword      | Password per la BASIC Authentication | | 887885d54af1 |
-| medasScrybaCertPath               | Path interno del certificato Scryba | | /medas.sk.jks |
-| medasScrybaCertPassPhrase         | Passphrase del certificato | | temporary65 |
-==== Configurazione Firma Remota OTP ====
-Per utilizzare il servizio di Firma Remota OTP, oltre a configurare l'applicativo DocWay4 e il webService ScrybaWS come illustrato nei paragrafi precedenti, è necessario che l'utente abbia delle credenziali abilitate al servizio di MEDAS.
-Tale credenziale viene inviata in automatico da DocWay durante la richiesta di firma.
-E' necessario quindi aggiornare nell'ACL le credenziali degli utenti abilitati, mediante la sezione //Firma Remota// della Persona Interna.
-Per l'ambiente di test utilizzare \\
-PROVIDER: **Medas**\\
-USERNAME: **MDSTST55M55N555M**\\
-PASSWORD (da usare nel processo di firma): **temporary65**
-Durante il processo di firma è richiesto un codice OTP.\\
-L'**OTP** è generato randomicamente al telefono configurato per quel certificato... chiedere a Medas di cambiarlo, nel caso di test.\\
-===== Utilizzo =====
-==== Firma Remota OTP ====
-Se abilitata, accanto a ciascun allegato, appare il tastino con la penna che consente di Firmare (PADES o CADES) mediante il servizio remoto con OTP. Inoltre, se sono presenti documenti nel libro firma, o se showAlwaysSignatureButton=si, sarà presenta il tasto FIRMA REMOTA che firmerà **tutti** i documenti nel libro firma (se valorizzato) o **tutti** i documenti allegati. Da tenere presente che
-  * firma CADES: firma tutti i documenti in modalità CADES
-  * firma PADES (selezionabile solo se presente **almeno** un pdf): firma tutti i pdf modalità in modalità PADES, gli altri in modalità CADES