FAQ

¿Cómo puedo acceder a los métodos del Servicio Web de Firma Biométrica?


Se realiza de la siguiente forma:

Por ejemplo

¿Cómo realizo el posicionamiento de la firma a través del Servicio Web de Firma Biométrica?


Hay una serie de parámetros para indicar como se posiciona la firma. Se encuentran en el punto 4.3.3.2 del manual para el método signedPDFFromApplication, y en el 4.3.2.2 para el método signedPDF.

Para un posicionamiento manual y fijo hay que indicar los siguientes parámetros:

- widgetPage, página donde va a estar la firma.

- widgetX, desplazamiento en horizontal desde el vértice inferior izquierdo.

- widgetY, desplazamiento en vertical desde el vértice inferior izquierdo.

por ejemplo,

 <widgetPage>1</widgetPage > 
 <widgetX>100</widgetX> 
 <widgetY>100</widgetY>


Para realizar un posicionamiento buscando una cadena de texto del formulario, se tendrían que indicar los siguientes parámetros:

- widgetAutoPosActivate, para activar este posicionamiento.

- widgetAutoPosText , texto a buscar.

- widgetAutoPosDesfaseX , desplazamiento en horizontal desde el texto.

- widgetAutoPosDesfaseY , desplazamiento en vertical desde el texto.

por ejemplo,

 <widgetAutoPosActivate>1</widgetAutoPosActivate> 
 <widgetAutoPosText>@@firma@@1@@</widgetAutoPosText>
 <widgetAutoPosDesfaseX>0</widgetAutoPosDesfaseX>  
 <widgetAutoPosDesfaseY>0</widgetAutoPosDesfaseY>

Por último, ambos posicionamientos deben tener definido el tamaño del widget de firma, siempre en relación 4:1, definido por los siguientes parámetros:

- widgetAncho

- widgetAlto

por ejemplo,

 <widgetAncho>80</widgetAncho> 
 <widgetAlto>20</widgetAlto>

¿Cómo puedo emular el pad de firma si no tengo una tableta Wacom?

En el fichero de configuración ecoSignatureJWS.ini hay que modificar los siguientes valores:

mouseMode=1
typeTablet=0

y guardar.

De esa forma podremos realizar la firma con el ratón.

¿Cómo se instalan los drivers de una tableta Wacom?

Para la correcta instalación de los drivers, lo mejor es hacerla SIEMPRE con la tableta desconectada. Desde el siguiente enlace se pueden descargar los drivers de las tabletas

https://www.wacom.com/es-co/support/product-support/drivers

S el sistema operativo es Windows 7 y el tipo de tableta es una DTU, una vez instalados estos drivers, se deberá instalar el DisplayLink, se trata de otro paquete de drivers necesarios para el correcto funcionamiento de la pantalla. Para realizar la descarga, este es el enlace: https://www.displaylink.com/downloads/file?id=1326

En ambos casos, al terminar la instalación de todos los drivers, será necesario calibrar la tableta, para ello abriremos las Propiedades de la tableta Wacom:

En la pestaña “Calibrar”, pincharemos en el botón correspondiente y llevaremos a cabo la calibración del dispositivo.

Configuración DTU

En el fichero de configuración ecoSignatureJWS.ini, será necesario añadir ciertos parámetros. A continuación, los más relevantes:

;Configuración de ejemplo para dispositivos WACOM DTU

;Puede ver todos los parámetros de configuración en el fichero ecoSignature_Completo.ini
;(Booleano) Visualización de documento antes de ser firmado. Por defecto 0.
showPDF=1
showPDFMonitorNum=1
;Licencia
;Mediante nombre de archivo de fichero en servidor, contenido en la carpeta "JWS/ecoBiometricJWS/"
license=serverlic.lic
;Entrada y salidas del documento
reason=El documento no ha sido modificado desde que se firmo
contact=edatalia@edatalia.es +34 943 440 710
;Dispositivo de captura biométrica
;(Booleano) Modo mouse (1) o no (0) booleano. Por defecto 0.
mouseMode=0
;(Entero) Selección del tipo de tableta. Entero, 0: STU-520,STU-530. 1: STU-430. 2: Stylus. Por defecto 0 (STU-520,STU-530). Por defecto 0.
typeTablet=2
; Empleo de plantillas
;(Cadena de texto) Si ebp-use-internal está a 0, url de donde se coge el EBP
ebp-url=../config/ebp/edatalia_sinBotones.ebp
;(Cadena de texto) Variables a mostrar en la plantilla EBP
ebp-variables=AreaFirma=Confirmo que los datos consignados en este formulario son ciertos y que tengo autorización bastante para la firma de esta solicitud. Acepto y firmo:|||LOPD=De acuerdo a la normativa vigente sobre LOPD, Ud. acepta que sus datos personales sean gestionados por nuestra organización para mejorar la calidad del servicio. Estos datos no seran facilitados a organizaciones fuera de nuestro grupo corporativo sin su aceptación expresa.
;(Booleano) Activación/Desactivación de botones de texto. Por defecto 1.
jwsBtnReset=0
jwsBtnCancel=0
jwsBtnSign=0
jwsForzarNumMonitor=1
;Ventana Controller
;Aparición de una segunda ventana copia de la captura de firma para en casos multimonitor (como las DTU) para que tanto el firmante como el controlador de la firma puedan ver y operar sobre el funcionamiento y/o aceptación de la firma
;(Booleano) Activa o desactiva la ventana “controller”. Por defecto 0.
jwsControllerEnable=1
;(Booleano) Si está activo mostrará la ventana controller con estilo "diálogo" (bordes + cruz para cerrar/cancelar ventana), sino será una ventana sin bordes. Por defecto 1.
jwsControllerShowBorderClose=1

¿Existe algún parámetro en el fichero de configuración para mostrar un botón de imprimir cuando se visualiza el documento en la pantalla del usuario (ecoSignatureJWS.ini)?

¿Existe algún parámetro en el fichero de configuración para mostrar un botón de imprimir cuando se visualiza el documento en la pantalla del usuario (ecoSignatureJWS.ini)?

No, no existe un botón como tal, pero se puede simular el comportamiento a través de configuración. A continuación configuramos el programa para que una vez firmado el documento se abra directamente con Adobe Reader, (o el programa que ejecutemos por defecto para abrir un fichero pdf) y desde ahí se podría enviar a la impresora:

;Guarda en local el documento pdf firmado. Por defecto 0
saveInLocal=1
;Ruta donde se guarda en local el documento pdf firmado. Solo aplica si saveInLocal=1

A tener en cuenta:
·          si está vacío, se descarga el documento a temporales.
·          si éste es inexistente, mal formado, no accesible, se descarga el documento a temporales.
·          la ruta debe existir, se usan "/" en lugar de "\". Ejemplo: "C:/Temp/".

saveInLocalPath=C:/Temp/

;Nombre (incluyendo la extensión .pdf) para el fichero que se va a generar/guardar en local. Solo aplica si saveInLocal=1.

Si no se incluye, el nombre por defecto será "JWS_PDF_Signed.pdf".
saveInLocalName=documentoA_signed.pdf

;Ejecuta o no el documento pdf firmado con la aplicación que esté asociada para ello. Por defecto 0. Solo aplica si saveInLocal=1
executeInLocal=1

Si un documento tiene que llevar dos firmas, si sólo firma uno de ellos ¿el documento se queda cifrado o a posteriori se puede volver a firmar?

Siempre y cuando la primera firma no está certificada, será posible firmarlo de nuevo:

;Firma PDF Certificada (MDP)
certificatePDF= 0


¿Existe alguna manera de poder modificar algún dato de un documento ya firmado? O ¿se puede hacer una copia de un documento firmado y modificarlo? (necesitan poder ‘Revocar’ un documento firmado (fecha-hora de la revocación))

Los documentos firmados, no son modificables, en ese caso se rompería la firma.

Otra cosa es firmarlo varias veces consecutivas, ya que mediante Adobe podemos ver siempre la versión correspondiente a cada firma, pero las modificaciones, tal como te indicaba antes, romperían las firmas anteriores.


Tenemos un problema con las actualizaciones de java, ya que cuando existe alguna actualización de java las tablets dejan de funcionar. Se soluciona actualizando java en los equipos que tienen la tablet, el problema es que los usuarios no son administradores y requiere que tengamos que conectarnos a cada equipo y realizar esa actualización.

Lo más sencillo en este caso sería deshabilitar las actualizaciones automáticas de Java.

El proceso a seguir sería: en el menú de inicio de Windows, escribir Configurar Java, en el Panel de Control de Java, ir a la pestaña Actualizar, una vez allí encontraréis la opción para deshabilitar las actualizaciones automáticas.


Error -10 en ecoSignature Tablet

Este error se debe a que el documento pdf a firmar es un formulario editable, para poder llevar a cabo la firma será necesario descativar el renderizador PDFIUM de ecoSignature Tablet y pasar a trabajar con OCX.

Para desactivar PDFIUM bastará con añadir en la sección [ecoBio_General] del fichero de configuración .ini el siguiente parámetro:

  • PDFIUM=0


Uso Chrome, he instalado el Helper y firmar.online no lo detecta.

Durante al instalación del Helper, es necesario escribir en un fichero concreto de Chrome, de modo que si se encuentra en uso no es posible hacerlo y el Helper no se llega a integrar con el navegador, el instalador intenta cerrar Chrome, pero no siempre le es posible, por lo que no permite la integración.

Para solucionarlo:

- Desinstalar el Helper y reiniciar el ordenador

- SIN abrir Chrome, incluso asegurarse con el Administrador de Tareas que no hay procesos Chrome.exe en marcha

- Instalar de nuevo el Helper

- Para más seguridad, volver a reiniciar

Caracteres especiales en JWS

En referencia a la integración de vuestro software ecoSignatureJWS​ en nuestra aplicación Java nos ha surgido una duda. Al tener seleccionada la opción de generar el fichero JNLP en el servidor para hacer uso del software ecoSignatureHelper los caracteres especiales tales como tildes y símbolos no se muestran correctamente ni en la tableta ni en la previsualización en Java Web Start. Al generar el fichero JNLP en local los caracteres sí aparecen correctamente.

¿​A qué puede deberse y cómo solucionamos este este comportamiento?

Finalmente hemos podido solucionar el problema de los caracteres especiales cambiando la codificación del texto generado del JNLP a UTF-8 antes de pasarlo a base64 y mandárselo al servidor con la llamada Ajax.

ecoSignature Tablet - Especificar un certificado con contraseña en el fichero de configuración .ini

Dentro de la sección [ecoBio_General] del .ini:

[ecoBio_General]

..../....

;Ruta del certificado, (si está en la carpeta del ejecutable del programa bastará con poner el nombre del fichero con la extensión, de lo contrario la ruta completa

PFX_RUTA=certificado.pfx

;PFX_RUTA=C:/Ejemplo de Ruta/certificado.pfx

;La contraseña se especifica en Base64, (no ponerla entrecomillada)

PFX_PW=xxxxxxxxx

..../....

Solamente hay que indicar el nombre o la ruta del certificado con el que se desea realizar la firma y el password en Base64, sin entrecomillar .