Questa è una vecchia versione del documento!
FIRMA DIGITALE UNIMATICA
Versione: x.0
Rilascio: 27/09/2019
Aggiornamento Integrazione Firma Remota OTP.
Requisiti
Per utilizzare l'integrazione della Firma Digitale all'interno di DocWay4 è necessario installare e configurare il webservice UniservWS sviluppato da 3DI.
Il webservice UniservWS, opportunamente configurato, si interfaccia con il servizio di Unimatica (Uniserv_WS20), che espone le funzionalità di:
- Firma Digitale con dispositivo
- Firma Remota OTP
Per la Firma Digitale con dispositivo è necessario scaricare e installare l'applet UniletApp. Per la Firma Remota OTP è necessario possedere delle credenziali abilitate su HSM di Unimatca.
UniservWS
Il webservice è sviluppato in tecnologia JAVA ed è accessibile mediante chiamata SOAP. Principalmente espone 2 metodi:
- ConsegnaFirmabili: invocato da DocWay per avviare il processo di Firma dei files;
- ConsegnaFirmati: risposta di callback invocato dai ws Uniserv_WS20 per la consegna dei file firmati digitalmente
E' necessario configurare i parametri all'interno del web.xml per garantire la corretta comunicazione tra UniservWS e Uniserv_ws20:
- unimaticaUniservWsEndpoint: specificare l'endpoint del servizio Uniserv_WS20 esposto da Unimatica.
Per l'ambiente di test → https://web1.unimaticaspa.it/uniserv-test-na/services/uniservService20.
- trediRiconsegnaWSEndpoint: specificare l'url di UniservWS accessibile da esterno. Questo è l'endpoint che verrà utilizzato da Unimatica per la chiamata di callback.
Per l'ambiente di test → http://docway-test.bo.priv:8080//UniservWS/services/enteSoap20.
Configurazione
Per attivare la funzionalità di Firma Digitale Unimatica in DocWay è necessario configurare alcuni parametri presenti nel file it.highwaytech.apps.xdocway.properties:
| Property | Descrizione | Valore | Ambiente di test |
|---|---|---|---|
| abilitaFirmaUniserv | attiva/disattiva il servizio di Firma Digitale con dispositivo | si/no | no |
| abilitaFirmaRemotaUniserv | attiva/disattiva il servizio di Firma Digitale Remota con OTP | si/no | no |
| uniservWs | Url per accesso al ws UniservWS | http://docway-test.bo.priv:8080/UniservWS/services/enteSoap20 | |
| uniserv.wsUrl | Url per accesso al ws 3diws | http://docway-test.bo.priv:8080/3diws/services/eXtraWay | |
| uniserv.xwHost | parametro 3diws | xwee-test | |
| uniserv.xwPort | parametro 3diws | 4859 | |
| uniserv.xwUser | parametro 3diws | 3diws | |
| uniserv.xwPassword | parametro 3diws | reader | |
| uniserv.xwAuthUser | parametro 3diws | 3diws | |
| uniserv.xwAuthPassword | parametro 3diws | admin | |
| uniserv.tipoRiconsegna | comportamento per aggiornamento file firmato sul documento | OVERWRITE APPEND VERSIONING | APPEND |
| uniserv.idEnte | parametro concordato con Unimatica | 3DInformatica | |
| uniserv.idApplicazione.dispositivo | parametro concordato con Unimatica | default | |
| uniserv.idApplicazione.remota | parametro concordato con Unimatica | firmaRemota |
Configurazione Firma Remota OTP
Per utilizzare il servizio di Firma Remota OTP, oltre a configurare l'applicativo DocWay4 e il webService UniserWS come illustrato nei paragrafi precedenti, è necessario che l'utente abbia delle credenziali abilitate al servizio di Unimatica.
Tale credenziale viene inviata in automatico da DocWay durante la richiesta di firma.
E' necessario quindi aggiornare nell'ACL le credenziali degli utenti abilitati, nella sezione Firma Remota delle Persona Interna.