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 | si |
abilitaFirmaRemotaUniserv | attiva/disattiva il servizio di Firma Digitale Remota con OTP | si | no | si |
uniservWs | Url per accesso al ws UniservWS | Stringa | http://mbernardini.3di.it/UniservWS/services/enteSoap20 |