Manual para el lanzamiento por protocolo de ecoSignatureJWS Desktop

Sobre este documento #

Este documento tiene el objetivo de mostrar los pasos a seguir para realizar el lanzamiento de ecoSignature Java Web Start (JWS de ahora en adelante) Desktop mediante protocolo, (desde una URL), mostrando la configuración de los posibles parámetros con los que podemos invocar a la aplicación y la construcción del fichero de configuración de parámetros pasado en la llamada a la solución, para la realización del firmado.

Introducción #

Los requisitos mínimos del funcionamiento de ecoSignature JWS son:
Para poder realizar el lanzamiento mediante protocolo, será necesaria la actualización de los componentes de firma de ecoSignatureJWS Desktop a la versión 1.4.1 (parte local) y la descarga de lla parte servidora ecoSignatureJWS Desktop  Protocolo v1.0.

• puesto cliente: PC de eFirma
  • Dispositivos hardware para captura biométrica: Wacom STU (430, 520, 530), Wacom DTU (1031, 1141) y Pencil-Stylus.
  • Puesto PC:
    • Sistema operativo Windows 7 o superior.
    • Sistema operativo Linux Ubuntu 14.04 32 ó 64 bits o superior. (Recomendable 16.04+ 64 bits).
  • Java 1.7+.

Para tabletas STU y DTU por favor consultar el siguiente enlace.

Nota

Se debe estar familiarizado con la solución ecoSignature JWS Desktop y estar desplegada en el PC local

  #

Instalación en Pc local del caso de uso #

El primer paso será realizar la descarga de los componentes:
Por un lado el programa, la parte local, y por otro la parte servidora.
La segunda contiene dos carpetas:

• Server
• Local

La carpeta Local la añadiremos a la carpeta de la aplicación y dejaremos todo en C:/edatalia del siguiente modo:

Por lo tanto, ahora en C:/edatalia tendremos las dos carpetas:

• Protocolo Desktop
• Lanzamiento Desktop

Lo primero será coger el fichero ecoSignatureJWS.ini de la carpeta Local y lo pasaremos a la carpeta Lanzamiento Desktop sobreescribiendo el que ya contiene.
Ahora realizaremos el registro de la aplicación. Para ello ejecutaremos el fichero RegEdit.reg de la carpeta Local que hemos añadido a la carpeta Lanzamiento Desktop.

Nota

Podemos utilizar cualquier otra ubicación del equipo para la carpeta Lanzamiento Desktop, así como cualquier otro nombre, pero si lo hacemos, deberemos editar el fichero RegEdit.reg indicando la ruta correcta del fichero .exe que lanza la aplicación:

Windows Registry Editor Version 5.00 [HKEY_CLASSES_ROOT\ecosignaturejwsdesktop] @="URL:ecosignaturejwsdesktop" "Content Type"="text/plain" "URL Protocol"="" [HKEY_CLASSES_ROOT\ecosignaturejwsdesktop\DefaultIcon] @="\"C:\\edatalia\\Lanzamiento_Desktop\\ecoSignatureJWS_Desktop.exe\",1" [HKEY_CLASSES_ROOT\ecosignaturejwsdesktop\shell] [HKEY_CLASSES_ROOT\ecosignaturejwsdesktop\shell\open] [HKEY_CLASSES_ROOT\ecosignaturejwsdesktop\shell\open\command] @="\"C:\\edatalia\\Lanzamiento_Desktop\\ecoSignatureJWS_Desktop.exe\" \"protocol=1\" \"%1\""

Ficheros de configuración .ini (carpeta ini de Protocolo Desktop) #

Protocolo Normal: #

; Documento a firmar remotePdf-url=http://localhost:80/pdf/ecoSignatureJWS.pdf
; Envío de documento firmado a servidor
send-activate=1 send-url=http://localhost:80/results.aspx
; Contiene en base 64 el nombre de los ficheros que se generan en servidor
send-extra-b64=bW9kb19ub3JtYWw=
; Url de intermediario desktop-url=http://localhost:80
; Captura de firma a través del mouse
mouseMode=1

Protocolo Panel de Terminalista con STU: #

; Datasheet o panel de terminalista signatures-input-xml=http://localhost:80/xml/datasheetSTU.xml
; Envío de documento firmado a servidor
send-activate=1 send-url=http://localhost:80/results.aspx
; Contiene en base 64 el nombre de los ficheros que se generan en servidor
send-extra-b64=bW9kb19wYW5lbF90ZXJtaW5hbGlzdGFfc3R1
; Url de intermediario desktop-url=http://localhost:80

Protocolo Panel de Terminalista con DTU: #

; Datasheet o panel de terminalista signatures-input-xml=http://localhost:80/xml/datasheetDTU.xml
; Envío de documento firmado a servidor
send-activate=1 send-url=http://localhost:80/results.aspx
; Contiene en base 64 el nombre de los ficheros que se generan en servidor
send-extra-b64=bW9kb19wYW5lbF90ZXJtaW5hbGlzdGFfZHR1
; Url de intermediario desktop-url=http://localhost:80

  #

Fichero index.html (de la carpeta Protocolo Desktop) #

var urlServiceREST = 'http://localhost:80/';
var ID;
var href;
var URLGetStatus;
var stop; // Controla el polling al servicio
function launchDesktop(element,evt){
evt.preventDefault();
stop = false;
ID = newGuid();
if (element.id == "desktop_normal")
href = "ecosignaturejwsdesktop://ini=http://localhost:80/ini/protocol_normal.ini&id="+ID;
else if (element.id == "desktop_panel_stu")
href = "ecosignaturejwsdesktop://ini=http://localhost:80/ini/protocol_datasheet_stu.ini&id="+ID;
else if (element.id == "desktop_panel_dtu")
href = "ecosignaturejwsdesktop://ini=http://localhost:80/ini/protocol_datasheet_dtu.ini&id="+ID;

  #

Instalación del servidor IIS #

Llegados a este punto, ya podemos pasar a instalar y configurar el servidor IIS:

Panel de control/Programas/Activar o desactivar las características de Windows

Habilitar todos los check de Internet Information Services:
Ahora para poder acceder al IIS, crear en el escritorio el acceso directo a:
C:\Windows\System32\inetsrv\InetMgr.exe
Una vez allí configuramos un nuevo sitio con las siguientes características:

IMPORTANTE: En la configuración avanzada del Grupo de Aplicaciones, deberemos dar permiso para lanzar aplicaciones, desde la configuración avanzada de ProtocoloDesktop, dándole el valor True:

Ya tenemos el IIS configurado, a partir de ahora ya podemos ir al navegador y lanzar ecoSignature Desktop mediante protocolo:

Escogemos el enlace con el que queremos trabajar y automáticamente se lanzará la aplicación: