Page tree
Skip to end of metadata
Go to start of metadata

 

 

Using SimpleSigner over TCP Network with Startparameter

Parameter
Usage
 
tcp- This parameter defines TCP address and port of the remote client.

Address and port should be entered directly after the net- parameter.

tcp-192.168.5.66:8888

Note: the SimpleSigner still trys to Access the Config.ini, to solve this you can copy the config.ini into the Installation Folder with the IP 0.0.0.0

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

 


Server configuration

 

General

In case the application is running on the same system where the pad is connected, we can access the signature pad by USB. But in case the application can´t have a direct access to the USB device, which is the case by RemoteDesktop and Citrix, we are forwarding all device requests to our Client Component. This Component will execute the requests and will send the results back to the server application.

We designed the remote component/layer in the way, that the main application don´t need to be modified in case the signature device is not local connected. Therefor we are tunnelling our device-communication between our SOPAD.dll (High Level Pad Comunication) and the SOPADCOM.dll (USB-Level), which means we are replacing the normal SOPADCOM.dll on the server with mediator version. This version takes care that the signature pad request will be forwarded to the client (by TCP or Citrix), where the local SOPADCOM.dll will perform the request.

Which Type of communication is used dependents by the DLL Version which is used from the Application. This means you need already to decide by the installation which communication type you want to use.

Configuration

Because the Communication is controlled / initialize by the Server it means the remote components needs to know where the client system is. For TCP it means the server needs the client-IP and Port, these information needs to be configured inside the config.ini

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

You need to replace the IP address (0.0.0.0) with the one of the client. Additional to the IP and the port there are settings for logging, but this should only be enabled in case of a problem.

 

There are 2 ways to use the config.ini, in case you place it into the same folder where the executable file of the application is, all users which are using the application will use the same TCP Settings. In case one of our products is being used, you need to place the INI in the installations folders next to the executable files (SOSigOffice.exe, SimpleSigner.exe). In case you used the DeviceAPI with your own Software you need to place the INI in the Folder of your own executable file. 

In case of an Multi-User System you should use the second option and place the config.ini into the user folder (C:\Users\<USER>\AppData\Roaming\StepOver\TCPIpExtension), on that way every user can have different TCP-Settings for the same Application.

 

You need to create this Config.ini by your own (create a textfile with the values below and save it under the name config.ini) or you can use the RDP-IPConfig tool. The Setup is not creating the config.ini.

RDP-IPConfig Tool

Because the Client-IP can be dynamic we created a small tool which can be used to set / update the config.ini. The tool will check the network status for open RDP Sessions to identify the Client-IP and will write it into the user folder. This means the tool works only when the TCP Session is active, for example you can start it automatically with the login of the user (or run it manually). This tool is optional and not required for the TCP Solution.

https://www.stepoverinfo.net/download.php?file=RDP-IPConfig-Set_V3.zip

 

optional Parameters:

ParameterInfo

 

-save2config=<saveToPath>

To set a different save path of the config.ini

-basicconfig=<path>

config.ini which should be used as Basic (it will be copied to AppData)
-useExternalIPtry to read the external IP

Problems / Errors

In case the Server can´t find the Configuration file (config.ini) or establish the connection to the client. It will show the following message.

possible Problems

  • missing config.ini, please check if the file exist and has the correct Client values
  • blocking firewall, wrong Client-IP or other network issues. To figure out where the problem is you can use telnet service from the server side to check if you can connect to the TCP-Client.

 

In case the Client is not activated there will an Demo Message each time when you start a signature.

 

 

Access Violation of BEX or APPCRASH occurrs on Windows Server 2008 R2 with Terminal Service.

  • Right click on my computer
  • go to properties
  • click on advanced system settings
  • under performance, click settings
  • click the Data Execution Prevention tab, and then click Turn on DEP for all programs and services except those I select.
  • click Add, browse to the executable file for the program and add it.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 


Windows client configuration

General

For the communication from the Server Application to the signature Pad on the client a an additional software on client is necessary. This software is our TCP-Client, which needs to be running in background on the Client System to wait until the server application request the usage of the signatur pad. The TCP-Client is listening on a specific port (default is 8888). The Setup is not adding any firewall rules, please take care that the defined port is opened.

 

Setup

You can download the current Client under the follwoing link:

https://www.stepoverinfo.net/download.php?key=tcp-client

 

Requirements:  

 

Setup Parameter:

ParameterInformation
/SILENTInstructs Setup to be silent
/VERYSILENTInstructs Setup to be silent (the installation progress window is not displayed)
/LANG=languageSpecifies the language to use. Values: GERMAN and ENGLISH
/LOGCauses Setup to create a log file in the user's TEMP directory detailing file installation
/HELPShows a summary of this information.

The setup allows to enable a start of the TCP-Client with Windows, please note that after the installation the client will not be automatically. You have to start it manually with the SoTcpClientManager.exe inside the Installation folder or you can find a shortcut in the startmenü of windows. You can also restart the system if you enabled the start with Windows. 

License

The TCP solution requires and extra License for each client. The License Code must be entered and activated on the client.

 

 In case the Client is not activated there will an Demo Message each time when you start a signature.

 

 

 

 

 

 


Linux client configuration

Overview of Server TCO Client Linux

The TCP/IP application for organizing access to StepOver signature devices by Network is called sotcp under Linux.

Configuration of sotcp

 

SYNOPSIS

sotcp [ --hostname=<hostname/IPaddress>--port=<service/port>  

DESCRIPTION

sotcp is the TCP/IP application for organizing access to StepOver signature devices by network. Application is using for network communication with StepOver signature devices from remote computer. It can be used with eSignatureOffice.

sotcp is listening specified by -p port number for remote request form application.  

OPTIONS

-h, --help Display a short usage description, including all available options and examples.

-n, --hostname=Specify IP address or hostname of interface for listening.

-p, --port=Specify a port number or service name for listening.

-v, --version Displays the version number of sotcp to stdout.

EXAMPLES

sotcp -p 8888

sotcp --hostname=192.168.117.142 --port=8888

sotcp -n mypc.stepover.de -p 8888

sotcp -n localhost -p 9977  

 

IGEL Configuration

http://edocs.igel.com/index.htm#10202853.htm

  • No labels