- Sobre este documento
- Introducción
- Idioma del programa
- Configuración General
- Uso de estilo Windows Metro
- Mostrar licencia
- Abrir PDF
- Permiso Drag&Drop
- Sobreescribir PDF
- Propiedades de la firma
- Configuración de Certificados
- Certificación de firma
- Opciones de impresión
- Posicionamiento de la zona a firmar
- Ajustes de ventana de firma
- Atajos de teclado
- Configuración de fondo de la zona a firmar
- Mostrar plantilla
- Búsqueda de texto en formularios
- Configuración de log
- Parámetros para Adonis Wacom DTU-1031
- Firma sin biometría
- Firma de PDF protegido con contraseña
- Ruta fichero firmado
- AutoClose
- AutoSave
- AutoSign
- Parámetros impresora virtual
- Tamaño del área de firma
- Información a mostrar en el Widget de firma
- Posicionamiento de la firma mediante coordenadas fijas
- Posicionamiento de la firma a partir de una cadena de texto
- Opciones para la pantalla del controlador
- Mostrar u ocultar los botones
- Configuración de los botones físicos de la tableta DTU
- Reconocimiento de bordes de firma
- Configuración de variables
- Nombre final del documento firmado
- Configuración del sellado de tiempo
- Sincronización horaria
- Activar
- Validación online del certificado de firma
- Firma longeva
- Opciones de la firma
- Adobe Reader
- Algoritmo
- Firma avanzada en PDF
- Envío por email del documento firmado
- Envío de direcciones al gestor de correo
- Parámetros para invocar ecoSignature Tablet de manera externa (.bat)
- Ejemplo fichero ecoSignature.ini
Sobre este documento #
Este documento contiene el manual de usuario de las versiones de 32 y 64 bits de ecoSignature Tablet 2.1.60 para su uso con diferentes modelos de tabletas Wacom, (STU-430, STU-520, STU-540, DTU-1031, DTU-1141) y dispositivos con pantalla táctil Windows 8.1 o superior.
Para realizar la instalación de ecoSignature Tablet en Windows 7 y versiones superiores, información sobre la activación de licencia y modos de funcionamiento, consultar la Guía de instalación de ecoSignature Tablet.
Introducción #
ecoSignature Tablet es la solución de escritorio para firma digital de documentos tanto manuscrita como con certificado digital.
Esta aplicación es compatible con tabletas Wacom STU, Wacom DTU y dispositivos con pantalla táctil Windows 8.1 o superior.
La configuración general de la solución se realiza a través del fichero de configuración ecoSignature.ini, el cual por defecto se encuentra, dependiendo de la versión instalada, en la siguiente carpeta:
- Para versión v3.1.13.166 y posteriores se locliza en C:\ProgramData\Edatalia\ecoSignatureTablet
- Hasta la versión v2.7.70.107 incluída:
- Para 32 bits: C:\Program Files (x86)\ecoSignature Tablet
- Para 62 bits: C:\Program Files\ecoSignature Tablet
Se puede invocar a ecoSignature con el fichero de configuración por defecto o desde otras aplicaciones seleccionando otros ficheros de configuración.
Todas las opciones que podemos modificar del programa se encuentran en el fichero ecoSignature_completo.ini.
>> Nota
Estos parámetros sirven tanto para la aplicación ecoSignature Tablet, en su versión standalone, como para la versión SDK. En los diferentes capítulos de este artículo, se describen los posibles parámetros de configuración que se presentan diferenciados por secciones.
>> Nota
Para comentar una línea del fichero bastará con ponerle por delante un «;» (;AutoSave=1)
Idioma del programa #
Se define la sección en el archivo de configuración [Idioma], en la cual solo se define un único parámetro relacionado con el idioma de la aplicación .
Idioma: Selección de idioma de la aplicación.
Posibles valores de configuración:
0 Castellano. Es el valor por defecto.
1 Inglés (traducido automáticamente con robot traductor)
2 Francés (traducido automáticamente con robot traductor).
Configuración:
Code=0
>> Nota
Se recomienda no modificar
Configuración General #
Se define la sección del archivo de configuración [ecoBio_General], en la cual encontraremos los parámetros generales de la aplicación. Dicha sección puede contener los siguientes parámetros:
Uso de estilo Windows Metro #
Valor booleano, que define el uso o no del estilo Windows Metropolis en la aplicación. El estilo Windows Metro es el interfaz gráfico de Windows 8 y sucesivos.
Por defecto está activado (=1).
Configuración:
Usar_Estilo_Metro=1
>> Nota
En las tablets si el programa tarda en arrancar puedes probar desactivando (=0) la opción.
Éstas características, pueden ser emuladas en el ordenador:
- Gesto de Panning: pulsar el ratón con click izquierdo y desplazarlo como si fuera el dedo.
- Gesto de Zoom: pulsar tecla Control + rueda de desplazamiento del ratón.
- Gesto de Press And Tap: pulsar con click derecho en cualquier X,Y del documento.
Otras características adicionales (Solo tablets) – Resumen de características nuevas (gestos inyectados al componente de renderización de pdf’s):
- Gesto de Panning: desplazar el documento con un dedo en dirección, (izquierda↔derecha y arriba ↕ abajo).
Importante: este gesto no funciona con PDF/A ni en tablet ni en “emulado ordenador”. - Gesto de Zoom: zoom en el documento con 2 dedos, pellizcando para alejar y estirando para acercar.
- Gesto de Press And Tap: presionar con el dedo en algún lugar del documento, permite realizar firmas en esa X,Y
>> Nota
Para la impresión de un documento siempre utiliza el estilo Windows Metropolis.
Mostrar licencia #
Valor booleano que si está activado (=1) muestra la pantalla de licencia cuando arranca la aplicación. Por defecto está desactivado (=0).
Configuración:
Mostrar_Pantalla_Licencia=1
>> Nota
Parámetro útil si hay problemas de licencia.
Abrir PDF #
Selección de apertura de documento PDF, dependiendo del tipo de tableta Wacom que tengamos seleccionada, que refleja el comportamiento del explorador al abrir un documento PDF.
Posibles valores de configuración:
2 usar los diálogos nativos de Vista/7/8 (Valor por defecto).
Dan problemas de centrado en la Adonis.1 usar diálogo de apertura de Vista/7/8.
No se centra en la Adonis, pero si aparece ahí.0 usar diálogo de apertura de XP.
Se centra correctamente en la pantalla de la Adonis.
Configuración:
Usar_Nuevo_Dialogo_Abrir=1
>> Nota
Dejar el valor por defecto, a no ser que se tenga una tableta Adonis, en cuyo caso el valor a configurar sería “0”.
Permiso Drag&Drop #
Valor booleano que si está activado (=1) permite drag&drop de ficheros PDF en el explorador de windows. Actúa como cargar el PDF con el fichero que se tira en la ventana.
Por defecto activado (=1).
Configuración:
PermitirDrop=1
Sobreescribir PDF #
Valor booleano que si está activado (=1), en la carpeta de destino, si existe un documento que se llama igual al que tenemos lo sobrescribe, en cambio si no está activado (=0), crea una copia del documento ya existente. Por defecto activado (=1).
Configuración:
Sobreescribir_Si_Existe_Destino=0
Propiedades de la firma #
En este apartado se presentan cuatro parámetros para la configuración de los datos de por quién queremos que quede firmado el documento
(Datos de la empresa).
Configuración:
Autor=Signed by ecoSignature
Razon=Estoy de acuerdo con el contenido del documento
Localizacion=www.edatalia.com
Contacto=edatalia@edatalia.com +34 943 440 710
Configuración de Certificados #
En este apartado se presentan los posibles parámetros de configuración de todo lo relacionado con certificados.
Validación de certificado #
Valor booleano que si está activado (=1) valida el certificado antes de firmar (para OCSP u otros motivos).
Por defecto está desactivado (=0).
Configuración:
Validar_Cert= 0
Tipo de certificado #
Selección del tipo de certificado.
Por defecto ecoSignature Tablet trae embedido y ofuscado un certificado de firma perteneciente a Edatalia. En el caso de querer utilizar un certificado personalizado, el primer paso será el de deshabilitar el certificado embebido, para ello utilizaremos el parámetro
;Si =0 (por defecto), se usa el .pfx embebido que es el nuestro de edatlia (embebido, cifrado y ofuscado)
;Si =1 se usará el certificado que configure el cliente (.pfx, cryptoapi, etc…)
UsarCertExterno=1
Una vez deshabilitado el certificado embebido, mediante el parámetro Tipo_Cert y con los siguientes valores de configuración, podremos seleccionar el tipo de certificado utilizado para firmar:
0: PFX (parámetros relacionados PFX_Ruta, PFX_PW).
1: CryptoAPI (parámetro relacionado CryptoAPI_SHA1).
2: CryptoAPI (búsqueda por CA, parámetros CryptoAPI_Issuer_O y opcionalmente CryptoAPI_Subject_O y CryptoAPI_Subject_OU).
Configuración:
Tipo_Cert=0
Posibles configuraciones:
- Si Tipo_Cert=0 se presentan dos parámetros configurables:
- PFX_RUTA= ruta donde hemos colocado el certificado.
Se recomienda dejar el certificado en la carpeta de instalación de ecoSignature Tablet.
Ejemplo:
PFX_RUTA=C:\Program Files\ecoSignature Tablet\prueba.pfx - PFX_PW= si nuestro certificado posee clave, se la indicamos aquí en Base64 .
Para transformar a Base 64 visitar la siguiente dirección: http://www.motobit.com/util/base64-decoder-encoder.asp
Si no indicamos aquí la contraseña y el PFX posee contraseña, en el momento de firmar nos pediría la clave.
Ejemplo:
PFX_PW=ZWRhdGFsaWE=
- PFX_RUTA= ruta donde hemos colocado el certificado.
- Si Tipo_Cert=1
Se accede al certificado del CryptoAPI con la “huella digital” informada en el parámetro CryptoAPI_SHA1.
La huella digital se debe informar sin espacios.
Ejemplo:
CryptoAPI_SHA1=40b4c66a97b382d296fffbf3184a4f81696ca50e - Si Tipo_Cert=2
Se firma con el primer certificado encontrado en el CryptoAPI. Se permite filtrar por:- CryptoAPI_Issuer_O (obligatorio): emisor del certificado (Organization(O)).
- CryptoAPI_Subject_O (opcional): sujeto del certificado (Organization(O)).
- CryptoAPI_Subject_OU (opcional): sujeto del certificado (OrganizationUnit(OU)).
Ejemplo:
CryptoAPI_Issuer_O=FNMT<br>CryptoAPI_Subject_O=FNMT<br>CryptoAPI_Subject_OU=70300
Certificación de firma #
Valor booleano que si está activado (=1) certifica la firma.
Por defecto está desactivado (=0).
Configuración:
Certificar=0
Opciones de impresión #
En este apartado se presentan los diferentes parámetros de configuración relacionados con la impresión.8.1. Impresión
Valor booleano que si está activado (=1) imprime el documento firmado en el momento en que se acepta la firma. Por defecto desactivado (=0).
Configuración:
Imprimir=0
Orientación de impresión #
Selección de la orientación del documento a la hora de imprimir.
Posibles valores de configuración:
-1 : no especificada, es la mejor opción, imprime el documento tal y como es. (Valor por defecto).
0 : orientación vertical.
1 : orientación horizontal.
Configuración:
Imprimir_Orientacion=-1
Ajuste de márgenes en impresión #
Valor booleano que si está activado (=1) ajusta la impresión a los márgenes del folio. Por defecto activado (=1).
Configuración:
Imprimir_AjustarAMargenes=1
Impresión de PDF como imagen #
Valor booleano que si está activado (=1) imprime el documento como si fuese una imagen.
Por defecto desactivado (=0).
Configuración:
Imprimir_ComoImagen=0
Número de copias #
Selección del número de copias a sacar por la impresora.
Entero, por defecto presenta un valor de 1.
Configuración:
Imprimir_Copias=1
Nombre de impresora #
Selección del nombre de la impresora (windows) a usar. Si no se especifica o se deja vacío se usa la impresora marcada como activa default en windows.
Configuración:
Imprimir_NombreImpresora=...
>> Nota
Todas estas opciones de impresión, si no vamos a imprimir, o si alguna no vamos a utilizar, poniendo un punto y coma (;) delante del comando se desactivan.
Posicionamiento de la zona a firmar #
En la sección esta sección se presentan los diferentes parámetros de configuración relacionados con el posicionamiento de la zona a firmar.
Pantalla dividida #
Valor booleano que si está activado (=1) no permite el sobre posicionamiento de la zona de firma con el documento, es decir, la pantalla aparece dividida en dos, en la parte izquierda aparece el documento a firmar y en la parte derecha la zona de firma.
Por defecto está desactivado (=0).
Configuración:
PantallaFirmaDocked=1
Ajustes de ventana de firma #
A continuación se muestran los diferentes parámetros para el ajuste y posicionamiento de la ventana de firma, así como los atajos de teclado para sus botones.
Ajustar ventana #
Valor booleano que si está activado (=1) ajusta la ventana de firma de forma que no se sobreponga a la ventana donde irá la firma y quede centrada.
Por defecto está activado (=1).
Configuración:
AjustarVentanaFirma=0
>> Nota
Este parámetro solamente se tiene en cuenta si PantallaFirmaDocked está desactivado (=0)
Posición fija de la ventana de firma (Sólo para DTU) #
Valor booleano que si está activado (=1) ajusta la ventana de firma de forma que quede fija.
Por defecto está desactivado (=0).
Configuración:
PosicionVentanaFirma=1
>> Nota
Este parámetro solamente se tiene en cuenta si PantallaFirmaDocked está desactivado (=0).
Posición personalizada de la ventana de firma (Sólo para DTU) #
PosicionVentanaFirmaFija_X=212
PosicionVentanaFirmaFija_Y=1530
PosicionVentanaFirmaFija_Ancho=650
PosicionVentanaFirmaFija_Alto=260
Estos parámetros solamente se tendrán en cuenta si AjustarVentanaFirma está desactivado (=0) y PosicionVentanaFirmaFija está activado (=1)
Por defecto, la Wacom DTU1141, en vertical, tiene una resolución de 1080×1920:
Resolucion_X=1080
Resolucion_Y=1920
Si dejamos los valores por defecto de PosicionVentanaFirmaFija_Ancho=650 y PosicionVentanaFirmaFija_Alto=260 y cambiamos el Ancho y Alto, hay que recordar que guarden la relación de aspecto 650/260, además será necesario cambiar los cálculos posteriores.
Teniendo en cuenta que hay un MARGEN_X=6 y un MARGEN_Y=130 (ya que PosicionVentanaFirmaFija_Ancho y PosicionVentanaFirmaFija_Alto son las medidas del área de firma exclusivamente, y hay unos bordes que incrementan X en 6 píxeles, e Y en 130 -para botones, títulos, etc-)
PosicionVentanaFirmaFija_X=0=PosicionVentanaFirmaFija_Y será arriba del todo a la izquierda respecto al monitor en el que se esté ejecutando ecoSignature Tablet
Si queremos que aparezca debajo del todo (eje Y) y centrada (eje X):
X=(Resolucion_X/2)-(PosicionVentanaFirmaFija_Ancho/2)-(MARGEN_X/2)=(1080/2)-(650/2)-(6/2)=540-325-3=212
Y=(Resolucion_Y)-(PosicionVentanaFirmaFija_Alto)-MARGEN_Y=(1920)-(260)-(130)=1530
Atajos de teclado #
Aceptar = Control + A
Cancelar = Control + C
Reiniciar Firma = Control + R
Carga doble #
Valor booleano que si está activado (=1) carga el documento 2 veces, resolviendo un problema puntual de carga de documentos.
Si está desactivado (=0) solamente carga una vez el pdf. Por defecto está desactivado (=0).
Configuración:
Carga_Doble=0
Configuración de zoom del PDF #
Selección del modo de zoom del documento PDF a cargar, es la manera que queremos que nos aparezca el pdf cuando lo cargamos en la aplicación.
Posibles valores de configuración:
0 : Zoom al ancho (valor por defecto).
1 : Zoom a toda la página.
2 : Zoom manual controlado por el parámetro de configuración “Zoom”.
3 : Zoom al tamaño actual del PDF.
Configuración:
ModoZoom=0
>> Nota
Si ModoZoom=2, se debe especificar el parámetro “Zoom”. Estas dos opciones van juntas. Ejemplo: ModoZoom=2 y Zoom=100
Ejemplos:
- ModoZoom=0
- ModoZoom=1
- ModoZoom=2 y Zoom=130
- ModoZoom=3
Configuración de fondo de la zona a firmar #
Se presentan los posibles parámetros de configuración del fondo de la zona a firmar.
Visionado de pdf de fondo #
Valor booleano que si está activado (=1) nos permite ver el PDF a través del área de firma, es decir, se muestra la imagen del fondo sobre el que se está firmando.
Por defecto está desactivado (=0).
Configuración:
Fondo_PDF_Firma=0
Opacidad #
Selección del grado de transparencia de la imagen de fondo sobre la que se está firmando, de 0 a 255.
Por defecto presenta un valor de 64.
Configuración:
Fondo_PDF_Firma_Opacidad=64
>> Nota
Para que este parámetro tenga efecto Fondo_PDF_Firma=1. Ejemplo: Fondo_PDF_Firma=1 y Fondo_PDF_Firma_Opacidad=64
Mostrar plantilla #
Valor booleano que si está activado (=1) provoca que en la plantilla de firma manuscrita se muestre la plantilla EBP (sin botones).
Por defecto está desactivado (=0).
Configuración:
Mostrar_EBP=0
Búsqueda de texto en formularios #
Valor booleano que si está activado (=1) permite la búsqueda de textos dentro de los formularios en los pdfs. Si se activa el programa funciona más lento.
Por defecto está desactivado (=0).
Configuración:
VariablesBuscarProfundo=0
Configuración de log #
Se presentan los parámetros relacionados con la muestra de errores.
Mostrar errores en diálogos #
Valor boolenao que si está activado (=1) nos muestra como cuadros de diálogo los mensajes de error que aparecen en el log.
Por defecto está desactivado (=0).
Configuración:
Mostrar_Errores_Dialogo=0
>> Nota
No tocar si todo está funcionando correctamente.
Nivel de log #
Selección del nivel de log.
Posibles valores de configuración:
0 : muestra todos.
1 : muestra sólo errores. (Valor por defecto).
Configuración:
Nivel_Log=0
Inicio de log #
Valor booleano que si está activado (=1) fuerza a empezar de cero un log en cada ejecución de la app. Por defecto está desactivado (=0).
Configuración:
Nuevo_Log=0
>> Nota
Para poder visualizar el log del ecoSignature Tablet, tendríamos que ir a la carpeta Documents de nuestro usuario, es decir: C:\Users\mi_usuario\Documents\ecoSignature_LOG.txt
Parámetros para Adonis Wacom DTU-1031 #
Se presentan los parámetros relacionados con la rotación de la pantalla de la tableta Adonis.
Rotar pantalla
Valor booleano que si está activado (=1) nos permite rotal la pantalla 90º en el momento que se va a realizar la firma.
Por defecto está desactivado (=0)
Configuración:
Rotar90=0
Restaurar rotación #
Valor booleano que si está activado (=1) nos permite restaurar la rotación de la pantalla, si hemos rotado la pantalla al usar la aplicación, al salir de ella volver a dejarla con la misma rotación que estaba anteriormente.
Por defecto está desactivado (=0).
Configuración:
RestaurarRotar=0
Firma sin biometría #
Se presentan los parámetros relacionados con la firma de documentos sin biometría.
Solo firma #
Valor booleano que si está activado (=1) activa el modo firma o Just Signature en el que no se requiere dispositivo de firma biométrica ni se incluye información biométrica en la firma.
Por defecto está desactivado (=0).
Configuración:
jsigMode=0
Imagen del Widget #
Se indica la imagen en formato JPEG (en Base 64) que se visualiza en el Widget.
Configuración:
jsigJPG=...
>> Nota
Solo aplica para firma electrónica sin biometría. El tamaño de JPEG debe coincidir con el tamaño del Widget.
Otros parámetros #
Este grupo de parámetros permite diferenciar el certificado para la firma manuscrita y la firma electrónica sin biometría.
Las variables se comportan igual que en el grupo de parámetros para firma biométrica, por lo que también incluimos aquí el parámetro que es el que deshabilitará el certificado embebido y ofuscado que contiene ecoSignature Tablet por defecto:
jsigUsarCertExterno=1
Estas se diferencian en el prefijo del parámetro “jsig…”.
Configuración:
jsigTipo_Cert=tipo Certificado (0:PFX, 1:CryptoAPI especificando un certificado, 2:CryptoAPI filtrando por CA).
jsigPFX_RUTA= ruta del certificado pfx para firma sin biometría. (jsigTipo_Cert=0).
jsigPFX_PW=password del certificado en Base 64. (jsigTipo_Cert=0).
jsigCryptoAPI_SHA1=“huella digital” del certificado. (jsigTipo_Cert=1).
jsigCryptoAPI_Issuer_O=(obligatorio): emisor del certificado (Organization(O)). (jsigTipo_Cert=2).
jsigCryptoAPI_Subject_O= ( opcional): sujeto del certificado (Organization(O)). (jsigTipo_Cert=2).
jsigCryptoAPI_Subject_OU= ( opcional): sujeto del certificado (OrganizationUnit (OU)). (jsigTipo_Cert=2).
jsigValidar_Cert=certifica la firma.
>> Nota
Si no se informan, se toman los valores relativos al certificado definido para firma biométrica.
Firma de PDF protegido con contraseña #
Se indica la clave para firmar un PDF protegido con contraseña.
Configuración:
PDF_PW=...
Ruta fichero firmado #
Indica la ruta donde se deja el fichero firmado.
Configuración:
OutDir= c:\temp
AutoClose #
Valor booleano que si está activado (=1) cierra la aplicación cuando se acepte la primera firma.
Por defecto está desactivado (=0).
Configuración:
AutoClose=1
AutoSave #
Valor booleano que si está activado (=1) produce que se autoguarde automáticamente el documento PDF con la aceptación de cada firma.
Por defecto está desactivado (=0).
Configuración:
AutoSave=1
AutoSign #
Valor booleano que si está activado (=1) inicia la firma automáticamente nada más abrir el documento PDF según la posición configurada en el fichero de configuración “.ini”.
Por defecto está desactivado (=0).
Configuración:
AutoSign=1
Parámetros impresora virtual #
Se presentan dos parámetros relacionados con la impresora virtual que hacen referencia al mantenimiento de los ficheros “.ini” y “.pdf” generados en el proceso de impresión de documento.
Estos ficheros se encuentran en la ruta:
32 bits: c:\Archivos de programa(X86)\ecosignature Tablet\VPD\ecoSignatureFirmaManuscritaOutput\
64 bits: c:\Archivos de programa\ecosignature Tablet\VPD\ecoSignatureFirmaManuscritaOutput\
Fichero de configuración (“.ini”) #
Valor booleano que si está activado (=1) elimina el fichero de configuración “.ini” generado en el proceso de impresión.
Por defecto está desactivado (=0).
Configuración:
Override_noDelete_Printer_Ini=1
Documento pdf generado #
Valor booleano que si está activado (=1) elimina el documento pdf generado en el proceso de impresión.
Por defecto está desactivado (=0).
Configuración:
Override_noDelete_Printer_Pdf=1
Tamaño del área de firma #
Se define la sección en el archivo de configuración [Firma_DND_TamPredef], en la cual se indica el tamaño predefinido de la ventana de posicionamiento de firma (cuadro verde del drag&drop del área de firma) a través de los parámetros “Anchura” y “Altura”.
Configuración:
Anchura=...
Altura=...
>> Nota
Se recomienda mantener la relación de aspecto del Widget (y de área de firma de la plantilla EBP para la STU).
Información a mostrar en el Widget de firma #
Se define la sección en el archivo de configuración [Widget], en la cual se presentan los diferentes parámetros relacionados con el Widget, dicha sección puede contener los siguientes parámetros:
Sellado de tiempo #
Valor booleano que si está activado (=1) coge el tiempo del PC al firmar el documento.
Por defecto está desactivado (=0).
Configuración:
TimeStampLocal=1
Estirar fondo #
Valor booleano que si está activado (=1) estira el fondo de la imagen para que sea más “real”, si está desactivado (=0) la firma queda reducida.
Por defecto está activado (=1).
Configuración:
FondoEstirado=0
>> Nota
Se recomienda FondoEstirado activado (=1) y en la sección [ecoBio_Tableta] Filtrar_Reconocer_Bordes_Firma desactivado (=0).
Texto personalizado #
Variable que nos permite la personalización del texto que aparece en el Widget.
Configuración:
TextoCustom= [Texto Línea o variable]
Se disponen de las siguientes variables:
Nombre de firmador: ##CERT_COMMON_NAME##
Propiedades básicas del certificado: ##CERT_COMMON_PROPS##
Información de clave pública: ##CERT_PUBLIC_INFO##
Fecha/Hora del sello de tiempo: ##TIMESTAMP## .
Ejemplo:
TextoCustom=Firmado electronicamente el: ##TIMESTAMP##
Firma en todas páginas #
Valor booleano que si está activado (=1) introduce el grafo en todas las páginas del documento en la misma posición.
Por defecto está desactivado (=0).
Configuración:
AllPages=0
Posicionamiento de la firma mediante coordenadas fijas #
Se define la sección en el archivo de configuración [Firma_PosPredef], en la cual se presentan los parámetros relacionados con la posición predefinida de la firma. Esta sección se debe de utilizar cuando se sabe el lugar concreto en el que se debe firmar el documento.
Se permite definir:
- La posición predefinida (parámetros “I zquierda” y “ Arriba” ), cuando se firma sin arrastrar el área de firma mediante drag&drop. (Tamaño estándar para un PDF DIN/A-4 Total Alto: 842. Se indica la medida desde la parte inferior (abajo).
- Anchura y altura de la firma (parámetros “ Anchura ” y “ Altura ”).
- Número de página (parámetro “Pagina”).
Configuración
[Firma_PosPredef]
Izquierda= 300
Arriba= 200
Anchura= 200
Altura= 100
Pagina= 1
A tener en cuenta:
- Para la STU el tamaño debería mantener la relación de aspecto del área de firma del EBP.
- Para la DTU el tamaño debería mantener la relación de aspecto de 2:1 (y el widget).
Posicionamiento de la firma a partir de una cadena de texto #
Se define la sección en el archivo de configuración [Modulo_Posicion_Widget_Str], en la cual se presentan los parámetros relacionados con la posición de la firma en base a una cadena de caracteres , dicha sección puede contener los siguientes parámetros:
Activar módulo #
Valor booleano que si está activado (=1) activa el módulo de posicionamiento del widget de firma en base a un string (expresión regular activada). Por defecto está desactivado (=0).
Configuración:
Activado=1
>> Nota
Si esta opción está activada (=1) se anulan las opciones vistas anteriormente de la sección “Posición predefinida de la firma”.
Búsqueda en todo el documento #
Valor booleano que si está activado (=1) busca la cadena de caracteres en todo el pdf, si está desactivado (=0) solo busca en la página indicada en el parámetro “Pagina_A_Buscar”.
Por defecto está activada (=1).
Configuración:
AutoPagina=1
Página a buscar #
Valor entero en el que concretamos en que página del pdf tiene que buscar la cadena de caracteres (índice en base 1), siempre que la opción anterior “AutoPagina” esté desactivada (=0).
Configuración:
Pagina_A_Buscar=3
>> Nota
Poner 9999 para indicar que la firma se ubica en la última página del PDF.
Búsqueda de cadena #
En este parámetro definimos la cadena de caracteres a buscar para introducir la firma, que se sitúa al inicio de la posición en la que se encuentre la cadena de caracteres.
Configuración:
Cadena_A_Buscar=Por favor, firme aquí:
Si vamos a firmar diferentes documentos con la misma configuración, cabe también la posibilidad de indicar diferentes cadenas, aunque para poder utilizar esta funcionalidad, será imprescindible que desactivemos la renderización mediante PDFIUM, indicando en la sección [ecoBio_General] del fichero de configuración el parámetro PDFIUM=0.
Pongamos por ejemplo que la cadena a buscar en el documento Ejemplo1.pdf es “Firma del Cliente“, mientras que si vamos a firmar el documento Ejemplo2.pdf, necesitamos buscar la cadena de texto “Firmado por:“. Pero solamente tenemos un fichero de configuración, de modo que , o modificamos los documentos para que la cadena de texto a buscar sea la misma en ambos, o indicamos el siguiente valor en el parámetro Cadena_a_buscar:
Cadena_A_Buscar=Firma del Cliente|Firmado por:
De este modo el programa buscará ambas cadenas y posicionará en la que encuentre, siempre teniendo en cuenta que un mismo documento no puede tener ambas, ya que en ese caso posicionaría en la primera de ellas e igual no es la que necesitamos.
>> Nota
Se permiten expresiones regulares de forma que se puede poner “Cadena a buscar” y nos situaría la firma en la C ó “Cadena a buscar(r)” y nos la situaría en la r. No usar \b en las expresiones regulares.
Posicionamiento respecto a la búsqueda de cadena #
Se definen dos parámetros para el posicionamiento respecto a la cadena de caracteres del pdf en la que se sitúa la firma. Indican el número entero de unidades de desfase (positivo o negativo) en el eje X e Y desde el vértice inferior izquierdo de la página.
Configuración:
Desfase_X=40
Desfase_Y=100
Opciones para la pantalla del controlador #
Se define la sección en el archivo de configuración [Win_Firma_Controller], donde se permite el control de la pantalla de firma solo para tabletas DTU , para las tabletas STU esta función está integrada en la plantilla EBP.
Dicha sección puede contener los siguientes parámetros:
Control de pantalla #
Valor booleano que si está activado (=1) activa el control de uso de la pantalla de firma del operador cuando la Adonis está conectada, si ésta no está conectada, éstas preferencias no se usarán. Por defecto está desactivado (=0).
Configuración:
Activado=1
Posicionamiento de controlador #
Si se especifica un número diferente de 0, significa el índice del monitor en el cual se desea posicionar la ventana del controlador, sino será en el monitor por defecto de Windows.
Configuración:
Flotar_Monitor=0
Coordenadas de controlador #
Indican la posición X e Y sobre el monitor especificado en Flotar_Monitor (píxeles). Por defecto presentan un valor de 0.
Configuración:
Flotar_X=0
Flotar_Y=0
Posición anterior #
Valor booleano que si está activado (=1) recuerda las últimas propiedades de firma introducidas sobre el diseño que se guardan en el registro de Windows bajo el actual usuario en “Software\edatalia\ecoSignature Tablet\Win_Firma_Controller\”.
Por defecto está activado (=1).
Configuración:
Recordar_Anterior_Posicion=1
>> Nota
Si está activado (=1) las propiedades especificadas en la sección [Win_Firma_Controller] de Flotar_X y Flotar_Y solo son usadas si no existen en el registro de Windows.
Botonera en Adonis #
Valores booleanos que si están activados (=1) muestra el/los botón/es correspondiente/s en la Adonis. Por defecto están activados (=1).
Configuración:
Btn_Adonis_Firmar=0
Btn_Adonis_Cancelar=0
Btn_Adonis_Reiniciar=0
>> Nota
Si los tres botones no son visibles la barra entera de botones inferior no es visible.
Botonera en la pantalla de firma copia
Valores booleanos que si están activados (=1) muestra el/los botón/es correspondiente/s en la pantalla de firma (la Win_Firma_Controller de copia). Por defecto están activados (=1).
Configuración:
Btn_Controller_Firmar=1
Btn_Controller_Cancelar=1
Btn_Controller_Reiniciar=1
>> Nota
Si los tres botones no son visibles la barra entera de botones inferior no es visible.
Mostrar u ocultar los botones #
Se define la sección en el archivo de configuración [BtnVisible] , la cual permite la modificación de los diferentes botones para que aparezcan o no que posee la barra de ecoSignature Tablet .
Dicha sección puede contener los siguientes parámetros:
Ocultar toda la barra de botones #
Valor booleano que si está desactivado (=0) oculta completamente la barra de botones.
Por defecto está activado (=1).
Configuración:
Barra=0
Firma manuscrita #
Valor booleano que si está desactivado (=0) oculta el botón de “Firma manuscrita”.
Por defecto está activado (=1).
Configuración:
BtnFirma=0
Firma sin biometría #
Valor booleano que si está desactivado (=0) oculta el botón de “Firma electrónica”.
Por defecto está activado (=1).
Configuración:
BtnFirmaJS=0
Cargar PDF a firmar #
Valor booleano que si está desactivado (=0) oculta el botón de “Cargar PDF”.
Por defecto está activado (=1).
Configuración:
BtnCargar=0
En el modo de impresión no existe este botón.
Guardar PDF firmado #
Valor booleano que si está desactivado (=0) oculta el botón de “Guardar”.
Por defecto está activado (=1).
Configuración:
BtnGuardar=0
Imprimir PDF #
Valor booleano que si está desactivado (=0) oculta el botón de “Imprimir”.
Por defecto está activado (=1).
Configuración:
BtnImprimir=0
En el modo de impresión no existe este botón.
Enviar Email #
Valor booleano que si está desactivado (=0) oculta el botón de “Enviar Email”.
Por defecto está desactivado (=0).
Configuración:
BtnSendMail=0
Sólo será visible si BtnSendMail=1 y en la sección [SendMail] Activate=1
Buscar texto en el PDF
Valor booleano que si está desactivado (=0) oculta el botón de “Buscar”, para la búsqueda de cadena de caracteres en el documento pdf.
Por defecto está activado (=1).
Configuración:
BtnBuscar=0
Página anterior
Valor booleano que si está desactivado (=0) oculta el botón “Anterior Pág.”, para ir a la página anterior en el PDF.
Por defecto está activado (=1).
Configuración:
BtnAnterior=0
Si el PDF contiene solamente una página, este botón se hace invisible automáticamente, independientemente del valor asignado.
Página siguiente #
Valor booleano que si está desactivado (=0) oculta el botón “Siguiente Pág.”, para ir a la página siguiente en el PDF.
Por defecto está activado (=1).
Configuración:
BtnSiguiente=0
Si el PDF contiene solamente una página, este botón se hace invisible automáticamente, independientemente del valor asignado.
Miniaturas #
Valor booleano que si está desactivado (=0) oculta el botón de total de páginas (se muestra el número de página/número de páginas totales) del documento pdf y de acceso a la vista en miniatura.
Por defecto está activado (=1).
Configuración:
BtnMiniaturas=0
Zoom + #
Valor booleano que si está desactivado (=0) oculta el botón “Acercar”, para hacer más grande (acercar) el documento pdf (Zoom+). Por defecto está activado (=1).
Configuración:
BtnAcercar=0
Zoom – #
Valor booleano que si está desactivado (=0) oculta el botón “Alejar”, para hacer más pequeño (alejar) el documento pdf (Zoom-). Por defecto está activado (=1).
Configuración:
BtnAlejar=0
Información de la aplicación #
Valor booleano que si está desactivado (=0) oculta el botón “Información”, donde se encuentra la información de la versión del programa, si se encuentra registrado y la carga de licencia.
Por defecto está activado (=1).
Configuración:
BtnInfo=0
Cierre de la aplicación #
Valor booleano que si está desactivado (=0) oculta el botón de cerrar la aplicación.
Por defecto está activado (=1).
Configuración:
BtnCerrar=0
Color de botones #
Indica el color que presentan los botones (de firma manuscrita y firma sin biometría) cuando situamos el ratón encima de ellos.
Posibles valores de configuración:
-1 : rojo. (Valor por defecto).
0 : verde
1 : azul.
Configuración:
FixColorModo=-1
>> Nota
Para integración de la dll, se recomienda Barra=0 y BtnCerrar=0
Configuración de los botones físicos de la tableta DTU #
Se define la sección en el archivo de configuración [ExpressKeys], en la cual se permite la configuración de los cuatro botones físicos para tableta Wacom DTU .
Configuración:
1. Con estas opciones se configura como actúan los diferentes botones físicos de los que dispone la tableta Wacom DTU:
Key0= ….
Key1= ….
Key2= ….
Key3= ….
Se enumeran las operaciones disponibles:
-1: Nada (dejar sin asignar esa tecla y que adopte su comportamiento por defecto).
0 : Cargar PDF (como el botón de ecoSignature).
1 : Guardar PDF (como el botón de ecoSignature).
2 : Anterior página (como el botón de ecoSignature).
3 : Siguiente página (como el botón de ecoSignature).
4 : Acercar vista (como el botón de ecoSignature).
5 : Alejar vista (como el botón de ecoSignature).
6: Firmar (muestra en la pantalla la caja de añadir nueva firma permitiendo moverla y redimensionarla).
7: Firmar automático (crea una nueva firma e inmediatamente inicia la captura de la firma – posición y dimensiones fijas -).
8 : Cerrar aplicación.
9 : Imprimir PDF (como el botón de ecoSignature).
10 : Buscar en PDF (como el botón de ecoSignature).
11 : Scroll abajo.
12 : Scroll arriba.
Ejemplo:
Key0=6
Key1=1
Key2=1
Key3=8
2. Cuando se configuran los botones para que actúen de diferente manera a como vienen de fábrica, se puede cambiar también la forma en la que actúan cuando se encuentran en otras pantallas:
EKey0= ….
EKey1= ….
EKey2= ….
EKey3= ….
Se enumeran las operaciones disponibles en otras pantallas como de creación de firma, cuando la anterior operación es distinta a -1:
0 : Reiniciar firma.
1 : Cancelar firma/cerrar el diálogo actual.
2 : Aceptar firma.
Ejemplo:
EKey0=0
EKey1=1
EKey1=2
EKey1=2
Tipo de tableta y aspecto de la firma y configuración de las plantillas (para Wacom STU) #
Se define la sección en el archivo de configuración [ecoBio_Tableta], en la cual se permite la configuración de tipo de tableta y aspecto de la firma y la configuración de plantilla EBP (solo para STU).
Tipo de tableta y aspecto de la firma #
Se presentan los diferentes parámetros relacionados con la configuración del tipo de tableta y del aspecto de la firma:
Tipo de tableta #
Se indica el tipo de tableta.
Posibles valores de configuración:
0 : Automático. (Valor por defecto).
1 : Tabletas Wacom DTU.
2 : Tabletas Wacom STU-430 y STU-530.
3 : Stylus.
Configuración:
Tipo_Tableta=2
Modo ratón #
Valor booleano que si está activado (=1) fuerza a que ecoSignature Tablet utilice el ratón en vez de la tableta para el proceso de firmado.
Por defecto está desactivado (=0).
Configuración:
ForceMouse=1
>> Nota
Si este parámetro existe no se hace caso a lo que se haya pasado por la línea de comandos.
Reconocimiento de bordes de firma #
Valor booleano que si está activado (=1) no reconoce el tamaño de la firma, sino que el tamaño de la firma es el área a firmar, ya sea más pequeña o más grande que esta área. Si está desactivado (=0) se coge como imagen para el widget el total de la zona de área de firma especificada.
Por defecto está activado (=1).
Configuración:
Filtrar_Reconocer_Bordes_Firma=0
Mínimo de puntos #
Indica el mínimo número de puntos que ha de tener la firma para ser válida, de lo contrario la firma se reinicia.
Por defecto presenta un valor de 40 puntos.
Configuración:
Minimo_Puntos=40
Mínima presión #
Indica la presión mínima que se ha de realizar al firmar para que se reconozcan los puntos.
Configuración:
Min_Pres=10
Velocidad de firma #
Valor booleano que si está activado (=1) nos permite ver la velocidad en la que se ha firmado en colores. Por defecto está desactivado (=0).
Configuración:
Imagen_Velocidad=1
Presión de firma #
Se presentan una serie de parámetros relacionados con la presión de la firma:
Presión en color #
Valor booleano que si está activado (=1) nos permite ver la presión con la que se ha firmado en colores. Por defecto está desactivado (=0).
Configuración:
Imagen_Presion_Color=1
Anchura en la presión #
Valor booleano que si está activado (=1) muestra la anchura de la firma en relación a la presión con la que realizamos el firmado en cada momento.
Por defecto está desactivado(=0).
Configuración:
Imagen_Presion=1
Anchura del lápiz #
Indica la anchura en píxeles del lápiz para la máxima presión.
Por defecto presenta un valor de 10.
Configuración:
Imagen_Presion_MaxLapiz=5
Filtrado de presiones #
Se presentan dos parámetros para el filtrado de presiones.
Configuración:
Imagen_Filtrar_Presiones= filtrado en la imagen de presiones pequeñas (1:activado, 0: desactivado).
Imagen_Filtrar_Presion_Minima= indica que presiones filtramos menores al valor introducido que representa el porcentaje sobre la presión máxima (rango [0:100]).
Tiempo de detección de trazo #
Se presentan dos parámetros para control de tiempos en la trazada de la firma, con el que se controla el tiempo que queremos que transcurra para que nos permita la detección de un nuevo trazo.
Configuración:
Imagen_Tiempo_Nuevo_Trazo_Activar= : (1: activado, 0: desactivado).
Imagen_Tiempo_Nuevo_Trazo= : tiempo para detectar nuevo trazo.
Configuración de plantilla EBP (solo para STU) #
Se presentan los diferentes parámetros relacionados con la configuración de la plantilla EBP solo para STU.
Ruta plantilla #
Se indica la ruta a la plantilla EBP (*.ebp).
Configuración:
Plantilla= ....
Plantilla430=. ... → para tableta Wacom STU-430
>> Nota
Si no se especifica la ruta absoluta de la plantilla, ésta se busca en el directorio de instalación:
32 bits: c:\Archivos de programa(X86)\ecosignature Tablet\
64 bits: c:\Archivos de programa\ecosignature Tablet\
Ruta plantilla posterior al firmado #
Valor booleano que si está activado (=1) cuando acabemos de firmar, en la tableta aparece la plantilla indicada en los parámetros “ Plantilla_Idle” y “ Plantilla_Idle430” dependiendo el modelo de tableta. Por defecto está desactivado (=0).
Configuración:
Mostrar_Plantilla_Idle=1
Plantilla_Idle= ....
Plantilla_Idle430=. ... → para tableta Wacom STU-430
Color lápiz #
Indica el color del lápiz.
Posibles valores de configuración:
$0000 : negro.
$FFFF : blanco.
Configuración:
Lapiz_Color=$0000
>> Nota
Sólo funciona con la antigua tableta Wacom STU-520. No funciona con las demás tabletas, donde siempre se ve en negro.
Configuración de variables #
Se define la sección en el archivo de configuración [ecoBio_Variables] , en la cual se configuran las variables denominadas ecoBio_Variables.
Las ecoBio_Variables se pueden mostrar en la tableta, si la plantilla EBP tiene la variable correspondiente y se almacena en los metadatos biométricos.
Configuración:
Nombre_variable=Valor_variable
Ejemplos:
Titulo=Firma digital manuscrita Subtitulo=Tipo de documento a firmar Nombre=Nombre y apellidos del firmante AreaFirma=Acepto el contenido del documento y firmo:
Las ecoBio_Variables definidas en esta sección pueden ser referenciadas desde otras secciones del fichero de configuración a través de la expresión: ##Nombre_variable## .
Ejemplo:
[ecoBio_Variables] D1=Dir1 D2=Dir2\Dir3 [ecoBio_General] OutDir=c:\temp\##D1##\##D2## → equivalente a: OutDir=c:\temp\Dir1\Dir2\Dir3
Las ecoBio_Variables permiten la búsqueda en el documento pdf a través de expresiones regulares siguiendo el siguiente formato:
Nombre_variable=@Numero_pagina,“Expresion_regular”, Ocurrencia donde:
Numero_pagina: indica el número de página donde buscar la variable. Si se indica (0) se busca en todas las páginas del documento.
Expresion_regular: indica la expresión regular a usar, SIEMPRE entre comillas
Ocurrencia: indica el número de ocurrencia si es que se han encontrado múltiples resultados.
Ejemplos:
EnConcepto=@0,"\b[0-9]{8}[A-Za-z][ ]+([A-Za-záéíóúÁÉÍÓÚÑñ0-9 ]+)NOMBRE",1 RazonSocial=@0,"\bDOMICILIO SOCIAL[ ]+(\S+(?:[ ]\S+)*)",1 Trabajador=@0,"\bFECHA DE NACIMIENTO[ ]+(\S+(?:[ ]\S+)*)",1 Representante=@0,"\bEN CONCEPTO\(1\)[ ]+(\S+(?:[ ]\S+)*)",1 FECHA=@0,"\bFECHA: ([A-Za-z0-9 ]+)Nº DE ALBARAN\b",1 ALBARAN=@0,"\bNº DE ALBARAN ([A-Za-z0-9]{3}?[ ][A-Za-z0-9]+)[ ]{2}",1 NOMBRE=@0,"\bNOMBRE: ([A-Za-záéíóúÁÉÍÓÚÑñ0-9 ]+)CIF",1 APELLIDOS=@0,"\bAPELLIDOS: ([A-Za-záéíóúÁÉÍÓÚÑñ0-9]+)\b",1 IMPORTE=@0,"\bTOTAL[ ]+([0-9,. €]+)\b",1
Existe un parámetro “ Mostrar_Variables_Resueltas ”, que nos permite o no mostrar las variables resueltas, solamente para las tabletas Wacom DTU. Los posibles valores de configuración son:
-1 : no mostrar ventana de variables resueltas.
0 : mostrar ventana de variables resueltas en la DTU.
1 : mostrar ventana de variables resueltas en la pantalla principal del controlador.
Configuración:
Mostrar_Variables_Resueltas=0
Nombre final del documento firmado #
Se define la sección en el archivo de configuración [Renombrado_PDF], en la cual se presentan l os parámetros relacionados con el renombramiento del documento pdf ya firmado , dicha sección puede contener los siguientes parámetros:
Activar #
Valor booleano que si está activado (=1) indica la activación del módulo y en consecuencia el renombramiento del fichero, que contiene el documento firmado, en la ruta de salida.
Por defecto está desactivado (=0).
Configuración:
Activado=1
Nombre final del fichero #
Se indica el nombre del fichero resultante a guardar.
Se pueden usar las variables descritas en la sección “ecoBio_Variables” especificadas entre “##” o se pueden usar otras nuevas variables automáticas definidas a continuación:
##PDFFileName## : nombre del pdf original (con extensión).
##PDFFileNameNoExt## : nombre del pdf original (sin extensión).
##PDFExt## : extensión del pdf original (sin incluir el punto).
##V_FECHA## : fecha actual del PC local, usando el formato definido en la variable “ Formato_Fecha ” que se define en el siguiente punto.
Configuración:
Nombre_Final= ….
Ejemplos:
Nombre_Final=##ALBARAN##_##FECHA##_##PDFFileNameNoExt##_##V_FECHA##.##PDFExt## Nombre_Final=##PDFFileNameNoExt##_##V_FECHA##.##PDFExt##
Fecha #
Se indica el formato de la fecha/hora: yyyymmdd (año+mes+día → insertar ceros si hace falta).
Configuración:
Formato_Fecha= ….
Ejemplo:
Formato_Fecha=yyyymmdd
Configuración del sellado de tiempo #
Se define la sección en el archivo de configuración [SelloTSP], que permite la incorporación de un sello de tiempo externo a la firma electrónica. Dicha sección puede contener los siguientes parámetros:
Activar sello de tiempo seguro #
Valor booleano que si está activado (=1) indica el deseo de sello de tiempo seguro.
Por defecto está desactivado (=0).
Configuración:
Activado=1
Petición de respuesta firmada de sellado #
Valor booleano que si está activado (=1) indica la petición de la respuesta firmada.
Por defecto está desactivado (=0).
Configuración:
Firmar=1
>> Nota
Se recomienda que esté activado (=1).
Url de servicio TSP
Indica la url de servicio TSP.
Configuración:
URL= ….
Ejemplos:
URL=http://psis.catcert.net/psis/catcert/tsp
URL= http://tsa.izenpe.com
URL= http://ocsp.izenpe.com:8093 (aunque en la url aparece ocsp es un servicio TSP).
Error #
Valor booleano que si está activado (=1) indica que se aborte la firma.
Por defecto está activado (=1).
Configuración:
Error=1
Credenciales de usuario #
Se indica el usuario y la contraseña del servicio TSP si se poseen.
Configuración:
User_TSP= ....
Pw_TSP= ....
Sincronización horaria #
Se define la sección en el archivo de configuración [NTP]. Se define NTP como un protocolo básico de sincronización de hora, es el sistema que por ejemplo actualiza el reloj de windows.
>> Nota
NO TIENE VALIDEZ LEGAL (es el TSP el que tiene validez legal), pero es interesante que se use cuando no se usa TSP, ya que en lugar de coger la hora local del PC para la firma, se coge la del NTP.
Activar #
Valor booleano que si está activado (=1) indica la sincronización de la hora con un servicio NTP. Por defecto está desactivado (=0).
Configuración:
Activado=1
Url de servicio NTP #
Indica la url de servicio NTP.
Configuración:
URL= ….
Ejemplo:
URL=hora.roa.es → es el más fiable de España
Validación online del certificado de firma #
Se define la sección en el archivo de configuración [OCSP]. Se define OCSP como la validación online de certificados .
>> Nota
TIENE VALIDEZ LEGAL. Usando TSP+OCSP se consiguen firmas PAdES-XL, también llamadas longevas o perdurables en el tiempo que son las más robustas desde el punto de vista legal.
Activar #
Valor booleano que si está activado (=1) permite incorporar la validación del certificado en el momento de la firma OCSP.
Por defecto está desactivado (=0).
Configuración:
Activado=1
Firmar #
Valor booleano que si está activado (=1) permite firmar la petición OCSP con un certificado.
Es para temas de autentificación con servidores OCSP y no suele ser necesario activarlo.
Por defecto está desactivado (=0).
Configuración:
Firmar=0
Url automática #
Valor booleano que si está activado (=1) indica que si está disponible la url del OCSP en el certificado firmador sea usada. Por defecto está activado (=1).
Configuración:
URL_Automatica=1
Url del OCSP #
Indica la url del OCSP en caso que URL_Automatica=0 o que el certificado no contenga la url de OCSP.
Configuración:
URL= ….
Ejemplo:
URL=http://ocsp.dnie.es
Autoridad certificadora en el PFX #
Indica la CA si no se dispone de ella en el PFX, pero es recomendable que el PFX contenga la cadena completa de validación del certificado.
Configuración:
Ruta_ca= ….
Ruta de certificado #
Indica la ruta del certificado que firma el OCSP si Firmar=1.
Configuración:
Ruta_firma= ...
>> Nota
No suele necesitarse.
Credenciales de usuario #
Se indica el usuario y la contraseña de la autentificación en el OCSP (en vez de firmar con un PFX).
Configuración:
User_OCSP= ....
Pw_OCSP= ...
>> Nota
Comentario sobre PAdES-LTV: Para que no pesen tanto las firmas PAdES, queda la posibilidad de optimizar el espacio que se reserva para las CRL’s. Se presenta un nuevo parámetro: [OCSP]. LTV_Buffer. Para firmar sin LTV (PAdES-XL), activamos el TSP y el OCSP pero pondremos el buffer a cero para que no se incorporen las CRLs en la firma.
[TSP].Activo=1
[OCSP].Activo=1
[OCSP].LTV_Buffer=0
Firma longeva #
Se define la sección en el archivo de configuración [F_Firma], la cual presenta un único parámetro relacionado con la firma longeva.
Tipo TSP
Indica que el sello de tiempo pedido nos genere firmas XL (longevas si hay TSP+OCSP).
Configuración:
Tipo_TSP=3 → Firma longeva PDF LTV PAdES-XL
>> Nota
Se recomienda no modificar.
Opciones de la firma #
Se define la sección en el archivo de configuración [Firma], la cual da propiedades extra al Widget. Dicha sección puede contener los siguientes parámetros:
Visibilidad de grafo #
Valor booleano que si está activado (=1) indica que la firma sea visible. Si está desactivado no se muestra por tanto el grafo en el documento pdf.
Por defecto está activado (=1).
Configuración:
Visible=1
>> Nota
Aunque el grafo no sea visible en el documento pdf, los datos biométricos si que se encuentran incrustados. Es utilizado para crear firmas invisibles.
Adobe Reader #
Valor booleano que si está activado (=1) indica en un futuro a Adobe Reader que use el almacén de windows para verificar certificados. Por defecto está activada (=1).
Configuración:
Almacen=1
>> Nota
Se recomienda no modificar.
Algoritmo #
Indica el algoritmo de hash que usa el sellado de tiempo seguro.
Posibles valores de configuración:
- 1 : significa SHA1.
- Otros valores hasta SHA2-512 que es el más robusto (Valor por defecto).
Configuración:
Algoritmo=2
>> Nota
Se recomienda Algoritmo=2.
Firma avanzada en PDF #
Valor booleano que si está activado (=1) activa el uso de PAdES (firma avanzada en PDF).
Por defecto está desactivado (=0).
Configuración:
PAdES=1
>> Nota
Se recomienda que este parámetro esté activado, salvo que los Adobe Reader destino sean versiones menores de 8.0.
Envío por email del documento firmado #
Se encuentra definido en la sección [SendMail].
Activación envío por email #
Valor booleano que si está activado (=1) indica que se activa el módulo de envío de email
Por defecto está desactivado (=0).
Configuración:
Activate=1
Activación envío automático #
Valor booleano que indica si se envía email (intent) una vez finaliza la acción de guardar.
Por defecto está desactivado (=0).
Configuración:
AutoSend=1
Para #
Cadena de caracteres: PARA del email, se pueden especificar varios separados por “;”
Configuración:
To=test@edatalia.com
En Copia #
Cadena de caracteres: CC del email, se pueden especificar varios separados por “;”
Configuración:
CC=test@edatalia.com
Con copia oculta #
Cadena de caracteres: BCC del email, se pueden especificar varios separados por “;”
Configuración:
BCC= ##VAR1##@##VAR2##test.com
Asunto #
Cadena de caracteres: Sujeto del email
Configuración:
Subject= PRUEBA ##VAR1## áéíóú.IP: ##LOCALIP##. COMPUTERNAME: ##COMPUTERNAME##. USERNAME: ##USERNAME##. USERDOMAIN: ##USERDOMAIN##
Cuerpo email #
Path al fichero de texto plano que contiene el cuerpo del Email
Configuración:
Body=C:\test.dat
>> Nota
Si no se especifica ruta, será un fichero al lado del ejecutable.
Envío de direcciones al gestor de correo #
Entero.
Por defecto = 0
0: se envían direcciones de email separadas al gestor de correo
1: se envían direcciones de email juntas al gestor de correo.
Configuración:
SeparatorStrategy=0
>> Nota
Para el uso de Thunderbird ha de ser =1
Parámetros para invocar ecoSignature Tablet de manera externa (.bat) #
-file
“-file=’c:\documento.pdf’”
Inicia la aplicación cargando directamente el pdf que se está pasando por parámetro como fichero en ruta física.
-conf
“-conf=’c:\ecoSignature.ini’”
Inicia la aplicación cargando como fichero de configuración el apuntado en lugar del ecosignature.ini por defecto.
-debug
Inicia la aplicación en modo “debug”, en este modo, aparece una barra de estado donde aparecen las X,Y,Presiones del lápiz de la tableta.
Si existe algún problema con coordenadas, sería interesante apuntar la X mínima, máxima y lo mismo con las Y: (Xmin, Xmax, Ymin, Ymax) y comunicarlo a soporte@edatalia.com junto con la máxima información de la pegatina trasera de la tableta.
-forcemouse
Inicia la aplicación en “modo mouse” o “modo ratón”, en éste modo, no se mirará si existe tableta conectada.
ecoSignaure funcionará directamente en modo ratón para mostrar la funcionalidad completa de la aplicación.
Las diferencias con respecto a usar tabletas, además de las evidentes, es que no se captura la presión del ratón por razones obvias, así que cuando el ratón está sin pulsar tiene un 0 de presión y cuando está pulsado un 1023.
-autosign
Inicia la firma automáticamente, nada más abrir el documento PDF, según la posición especificada en el fichero de “configuracion.ini”.
-autosave
Produce que se autoguarde automáticamente el documento PDF con la aceptación de cada firma el documento.
-autoclose
Cierra la aplicación cuando se acepta la primera firma.
-delete
Borra el fichero original una vez firmado.
-outdir
“-outdir=’c:\salida’”
Deja los ficheros firmados en la ruta especificada.
-opendir
“-opendir=’c:\directorio_entrada\’”
Especifica ésta ruta como ruta predeterminada para el cuadro de diálogo de abrir fichero PDF.
-canceldir
”-canceldir='[ruta_salida]’”
Indica la ruta de salida para los ficheros cancelados en la firma.
-errordir
“-errordir='[ruta_salida]’”
Indica la ruta de salida para los ficheros que han dado error en la firma.
-var
“-var=’NombreVariable=Valor’”
Indica los valores para las variables que pueda contener el fichero de plantilla EBP.
El formato ha de ser el mismo que si se especificasen éstas variables en el fichero de configuración (conf.ini).
-ini
“-ini='[seccion]Parametro=Valor’”
Permite modificar por parámetros la configuración del .ini que se carga (conf.ini).
Se soportan múltiples parámetros “-ini=” uno por parámetro a cambiar de la configuración.
Ejemplo: “-ini='[ecoBio_General]jsigMode=0′”.
Ejemplo: “-ini='[ecoBio_Tableta]Plantilla=C:\ecoSignature\Originales\plantilla.ebp’”
-nowarningmouse
No muestra advertencia si se va a usar en “modo ratón”
Ejemplo
::Variables de ecoSignature
::****************************
SET PROGRAMA="C:\Program Files (x86)\ecoSignature Tablet\ecoSignature_Tablet.exe"
SET CONFIGURACION="-conf='C:\ecoSignature\Originales\ecoSignature_LOPD.ini'"
SET FICHERO="-file='C:\ecoSignature\Originales\ecoSignature_LOPD.pdf'"
SET Directorio_Salida="-outdir='C:\ecoSignature\Firmados'"
SET Guardar="-autosave=1"
SET Cerrar="-autoclose"
::*********************SET Visualizacion en Tableta Wacom STU530
SET Plantilla="-ini='[ecoBio_Tableta]Plantilla=C:\ecoSignature\Originales\default.ebp'".
SET Titulo="-var='Titulo=Protección de datos de carácter personal LOPD'"
::*********************LLAMADA PARA FIRMAR DOCUMENTO PDF
%PROGRAMA% %FICHERO% %CONFIGURACION% %Directorio_Salida% %AutoSign% %Guardar% %cerrar% %Titulo% %Plantilla%
:: -forcemouse
Se soportan múltiples parámetros “-var=”” uno por variable.
Ejemplo:
“-var=’Titulo=Firma digital manuscrita'”
Si la cadena contiene una expresión regular, sustituir la comilla doble por
`SET FIRMANTE=”-var=’FIRMANTE=@0,`NIF[ ]+([A-Za-z ]+)[ ]`,1′”
Si la cadena contiene caracteres especiales, cambiar el charset chcp 65001
SET FIRMANTE=”-var=’FIRMANTE=@0,`NIF[ ]+([A-Za-záéíóúÁÉÍÓÚÑñ0., ]+)[ ]`,1′”
Ejemplo fichero ecoSignature.ini #
El fichero de configuración que viene por defecto en el programa y que deberemos editar para cambiar su comportamiento es el siguiente:
[ecoBio_General]
Autor=Signed by ecoSignature
Razon=Estoy de acuerdo con el contenido del documento
Localizacion=www.edatalia.com
Contacto=edatalia@edatalia.com +34 943 440 710
PFX_RUTA=cert.pfx
[Widget]
TimeStampLocal=1
TextoCustom=<?xml version="1.0" encoding="ISO-8859-1" ?><Line Size="4">Documento firmado digitalmente el: ##TIMESTAMP##</Line>
[Firma_PosPredef]
Pagina=1
Izquierda=50
Arriba=200
Anchura=160
Altura=40
[ecoBio_Variables]
AreaFirma=Por favor, firme aquí:
[SelloTSP]
Activado=0
URL=http://tsa.izenpe.com
[OCSP]
Activado=0
URL_Automatica=1
LTV_Buffer=1
[ecoBio_Tableta]
ForceMouse=0
Tipo_Tableta=2