Configuración y uso en TCP/IP

Visión general

Si no está ejecutando eSignatureOffice en el mismo ordenador al que está conectado el dispositivo de firma, puede utilizar este tipo de conexión, ya sea a través de Internet o de su propia red cerrada.

Si tanto el software como el dispositivo de firma se utilizan en el mismo ordenador, este uso funciona sin problemas, ya que el sistema operativo proporciona y gestiona la conexión. Sin embargo, si el dispositivo de firma está en otro lugar totalmente diferente (y, por tanto, conectado a otro ordenador), eSignatureOffice no podría localizar el dispositivo de firma adecuado.

Por eso, el emparejamiento de sistemas servidor y cliente ofrece nuevas oportunidades: el ordenador en el que está instalado eSignatureOffice es siempre el servidor, mientras que el ordenador al que está conectado el dispositivo de firma es siempre el cliente.

En el siguiente esquema se puede ver cómo es la estructura general del sistema, cada una de cuyas partes se explica en este manual.

En el lado del servidor, se instala la versión TCP de eSignatureOffice y debe colocarse correctamente el archivo de configuración config.ini correspondiente. El servidor se comunica a través de una conexión TCP con el cliente, en el que sólo hay que instalar la herramienta StepOver TCP Extension. Opcionalmente, puede utilizar la herramienta IPconfig de StepOver Remote Desktop para facilitar su uso. La tableta de firmas está conectado a este cliente.

Instalación en el servidor

La instalación en el servidor es similar a la habitual Instalación de eSignatureOffice, excepto el paso 5, por supuesto, en el que hay que seleccionar la 3ª opción «TCP/IP».

Además, el servidor debe cumplir los siguientes requisitos del sistema:

System requirements

Visual C++ Redistributable for Visual Studio 2015 - 32Bit / x86

Asegúrese de instalar la versión de 32 bits, aunque su Windows sea de 64 bits.

https://www.microsoft.com/en-US/download/details.aspx?id=48145

Universal C RunTime

Normalmente se instala mediante una actualización de Windows. Sólo tiene que instalarlo manualmente si aparece un mensaje de error que indica que «api-ms-win-crt-stdio-l1-1-0.dll no se ha encontrado».

https://support.microsoft.com/en-us/help/2999226/update-for-universal-c-runtime-in-windows

Instalación en el cliente

En el lado del cliente, en lugar de eSignatureOffice, debe instalarse el StepOver TCP client, cuya versión más reciente puede descargarse siempre desde: https://www.stepoverinfo.net/download.php?key=tcp-client

Al igual que en el lado del servidor, el lado del cliente debe cumplir los siguientes requisitos del sistema:

System requirements

Visual C++ Redistributable for Visual Studio 2015 - 32Bit / x86

Asegúrese de instalar la versión de 32 bits, aunque su Windows sea de 64 bits.

https://www.microsoft.com/en-US/download/details.aspx?id=48145

Universal C RunTime

Normalmente se instala mediante una actualización de Windows. Sólo tiene que instalarlo manualmente si aparece un mensaje de error que indica que «api-ms-win-crt-stdio-l1-1-0.dll no se ha encontrado».

https://support.microsoft.com/en-us/help/2999226/update-for-universal-c-runtime-in-windows

Instalación del software cliente (Extensión TCP)

1. Después de iniciar el archivo de instalación, tienes que seleccionar tu idioma para el proceso de instalación.

2. La siguiente pantalla ofrece 2 opciones adicionales para personalizar su configuración.

La primera opción «Crear un acceso directo en el escritorio» hace exactamente lo que dice: crea un enlace en su escritorio, que puede utilizar más tarde para iniciar directamente el Cliente de Extensión TCP.

La segunda opción llamada «Crear entrada de inicio automático» se asegurará de que la Extensión TCP se inicie automáticamente junto con Windows.

3. Compruebe y confirme los ajustes seleccionados.

4. Listo.

La instalación de la extensión TCP en el cliente se ha completado y ahora puede ir al paso de configuración.

Configuración

Configurar la conexión es la parte más compleja de la configuración de la conexión servidor-cliente.

Aquí es importante crear el archivo config.ini, en el que hay que escribir la dirección (= dirección IP) del ordenador con el dispositivo de firma (= el cliente).

Entrada	Explicación
[server]	Esta entrada mostrará que este archivo .ini debe guardarse y utilizarse en el lado del servidor. El lado del cliente tiene su propio archivo config.ini, que se configura automáticamente.
ip=0.0.0.0	Esta entrada es utilizada en la búsqueda de dispositivos de eSignatureOffice para buscar el ordenador en la dirección IP indicada y buscar allí los dispositivos conectados. Normalmente, éste es el único valor que debe modificarse.
port=8888	Este es el puerto por defecto, en el que tiene lugar la comunicación entre las partes. Si quieres cambiar este puerto, tienes que cambiarlo al mismo puerto en los archivos config.ini del cliente y del servidor. Por favor, asegúrese de que el puerto designado no está bloqueado por su firewall .
logEnabled=0	Cambie este valor de 0 a 1 para habilitar la creación de archivos de registro (logs). Esta opción sólo debe activarse si encuentra problemas o errores y si necesita esos registros para resolverlos.
logLevel=0	Este valor determina el nivel de detalle de los archivos de registro (logs) creados. Los valores permitidos son 0,1 y 2. Cuanto mayor sea el valor, más detallados serán los archivos de registro, pero también se necesitarán más recursos del sistema.
logLenMax=2048	Este es el tamaño máximo del archivo de registro (log) en kilobytes.
logFile=C:\temp\logs\soClient.log	Aquí se indica la ruta y el nombre del archivo de registro (log). Asegúrese de que la carpeta designada ya existe, ya que eSignatureOffice no puede crear carpetas.

Atención

En el lado del cliente, la Extensión TCP también crea un archivo config.ini. Este archivo muestra en la primera línea la entrada «[client]» y generalmente no debería cambiarse (excepto quizás el número de puerto, si es necesario), porque está gestionado por el propio programa.

Configuración paso a paso:

A continuación se muestran los pasos básicos para configurar su sistema:

1. Crear el config.ini para el servidor con la siguiente plantilla

Crea un nuevo archivo de texto y copia en él el siguiente texto:

[server]
ip=0.0.0.0
port=8888
[Common]
logEnabled=0
logLevel=1
logLenMax=2048
logFile=C:\temp\logs\soClient.log

2. Escribe la IP del cliente en config.ini

Cambie la línea «ip=0.0.0.0» y sustituya los cuatro ceros por la IP del ordenador de destino (entonces se parece a «ip=192.168.0.1»). Si no está seguro de cuál es la IP correcta del ordenador de destino, pregunte a su departamento informático o a sus compañeros.

3. Guarde el archivo config.ini en la carpeta correcta del servidor.

Asegúrese de que el archivo se guarda no sólo con el nombre correcto, sino también con la extensión correcta.

Hay dos posibilidades diferentes para la carpeta de guardado correcta: o tiene la misma configuración para todos los usuarios de Windows o configuraciones separadas para cada usuario:

a) Misma configuración para todos los usuarios: Guarde el archivo config.ini terminado en la carpeta de instalación de eSignatureOffice, que es la misma carpeta en la que se encuentra el archivo ejecutable de eSignatureOffice SOSigOffice.exe.

b) Configuración separada para cada usuario: Guarde el archivo config.ini en la siguiente carpeta específica del usuario: «C:\Users\<USUARIO>\AppData\Roaming\StepOver\TCPIpExtension».

La 2ª opción es especialmente útil, si cada usuario está iniciando sesión en el servidor con una Conexión de Escritorio Remoto y luego utiliza el dispositivo de firma, que está conectado a su propio ordenador. De esta manera, siempre se utilizará la IP correcta.

4. Listo.

Ahora puede conectar el dispositivo de firma al ordenador cliente e iniciar eSignatureOffice en el ordenador servidor. Se encontrará el dispositivo, aunque no esté conectado directamente al ordenador servidor.

Más opciones, información y solución de problemas

En esta parte del manual encontrará información adicional que no tiene cabida en ninguno de los demás capítulos.

Herramienta RDP IPconfig

Como la IP del cliente a veces también puede ser dinámica, hemos desarrollado una pequeña herramienta para ayudarle escribiendo automáticamente la IP correcta en el config.ini. Esto funciona comprobando constantemente el estado de la red para conexiones abiertas de Escritorio Remoto y luego escribiendo la IP encontrada en el archivo de configuración específico del usuario.

Esto significa que...

Esta herramienta sólo ayuda si hay una sesión TCP abierta.
Múltiples usuarios diferentes pueden conectarse al servidor vía conexión remota y su respectivo config.ini es escrito en su respectiva ruta de usuario.

Puede iniciar esta herramienta automáticamente, por ejemplo, cuando un usuario se está registrando (instrucciones aquí) o puede iniciarlo manualmente. Además, es completamente opcional y no es necesario para utilizar esta solución TCP.

La puede descargar aquí: https://www.stepoverinfo.net/download.php?file=RDP-IPConfig-Set_V3.zip

Parámetros de inicio opcionales para la herramienta RDP IPconfig Tool:

Parámetro	Descripción
-save2config=<saveToPath>	Introduzca aquí una ruta alternativa para guardar el archivo config.ini.
-basicconfig=<path>	Introduzca la ruta a un archivo config.ini ya existente, que se copiará en la carpeta appdata.
-useExternalIP	Indica al programa que intente leer la IP externa en lugar de la IP interna (=WAN IP en lugar de LAN IP).

Configuración de IP y puerto mediante parámetro de inicio

Desde la versión 6.2 de eSignatureOffice puede utilizar un parámetro de inicio para indicar al programa qué IP y puerto debe utilizar para su conexión tcp.

Parámetro

Descripción

-tcp=<IP>:<port>

Utilice este parámetro junto con la IP del cliente-pc en su red, seguido de dos puntos, seguido del puerto sobre el que debe realizarse la comunicación. Por defecto, es el puerto 8888. Por favor, tenga cuidado de escribir siempre este puerto en la llamada al parámetro, incluso si desea utilizar el puerto por defecto.

ejemplo: "-tcp=192.168.0.1:8888"

Con este método no tiene que configurar el archivo config.ini manualmente, porque eSignatureOffice comprobará al iniciarse si el archivo existe y también puede crearlo usted mismo, si no existe. Pero tenga en cuenta que, dependiendo de la ruta de instalación, es posible que necesite derechos de administrador, ya que el archivo config.ini debe copiarse en la ruta de eSignatureOffice.

La clave de licencia correcta

En caso de que esté intentando registrar su producto, pero reciba la notificación para comprobar su clave de licencia, es posible que haya intentado utilizar la clave de licencia para una versión estándar de eSignatureOffice en lugar de una clave de licencia para una versión específica de TCP.

Por tanto, compruebe la última cadena de números de su clave de licencia y asegúrese de que contiene «017». Si no contiene esta secuencia de números, pero nos ha pedido una licencia TCP, envíenos un correo electrónico a info@stepover.de y, si es posible, indíquenos el número de documento de su factura o de su confirmación de pedido.

Problemas / Solución del problema

Descripción del problema	Posible causa y soluciones
Si el servidor no puede encontrar el archivo de configuración (config.ini) o no puede conectarse con el cliente, se mostrará el siguiente mensaje de error.	a) Falta el archivo config.ini. Por favor, asegúrese de que el archivo existe realmente y que contiene los datos correctos del cliente. b) Un firewall está bloqueando la conexión, la IP incorrecta está escrita en el config.ini o hay cualquier otro problema con su conexión de red. Para averiguar el origen del problema, puede utilizar el servicio Telnet en el lado del servidor para comprobar si puede conectarse al cliente TCP.
Si aún no se ha activado la licencia del cliente, se mostrará el siguiente mensaje al inicio de cada proceso de firma.	En cuanto se inicia la extensión TCP en el cliente, se muestra la solicitud para activar la licencia del producto. Por favor, introduzca la clave de licencia que le hemos enviado directamente o a través de su proveedor de servicios. Las claves de licencia de StepOver para programas compatibles con TCP contienen siempre la combinación «017» en la última cadena de números. Por lo tanto, por favor, asegúrese de que también está utilizando una clave, que coincida con su versión de software.
Se produce una violación de acceso por excepción de desbordamiento del búfer (abreviado BEX) o se finaliza el programa mientras se utiliza Windows Server 2008 R2 con Terminal Service.	Haga clic con el botón derecho en «Mi PC» en el Explorador de Windows. Haga clic en «Propiedades». Haga clic en la parte izquierda en «Configuración avanzada del sistema» Vaya a «Rendimiento» y haga clic en «Configuración». Vaya a la pestaña Prevención de ejecución de datos y, a continuación, haga clic en «Activar DEP para todos los programas y servicios excepto los que yo seleccione». Haga clic en «Añadir...» para abrir un cuadro de diálogo de selección de archivos, en el que deberá seleccionar el archivo SOSigOffice.exe de la carpeta de instalación de eSignatureOffice.
Mensaje de error, que no se pudo encontrar el archivo «api-ms-win-crt-stdio-l1-1-0.dll».	Este archivo forma parte de la biblioteca universal C RunTime, que normalmente se instala mediante Windows Update. Si su sistema no ha instalado las actualizaciones necesarias hasta ahora, tendrá que instalar la biblioteca C RunTime usted mismo: https://support.microsoft.com/en-us/help/2999226/update-for-universal-c-runtime-in-windows