Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Download the PadConnectorManager https://www.stepoverinfo.net/download.php?file=PadConnectorManagerPadConnector_3.0.5-and-Manager-1.0.04.zip and extract it on the server ( for example inside . You can optional copy the PadConnectorManager1.x folder into the inetpub folder )of your IIS.

Requirements

The PadConnectorManager is an ASP.NET Core application that has to be hosted by IIS. To install it in IIS, some Windows features and modules may be required.

The PadConnector also requires the Windows Authentication roll of the IIS. You can install this feature with the Server Manager. It listed in the Server Roles list under “Web Server (IIS) / Security / Windows Authentication”, make sure this option is enabled, otherwise the IIS doesn´t return the user account name and a linking to the user specific port is not possible.

...

...

Installation of the required certificates

You also need to install the SignSocket.StepOver.com certificate for the HTTPS communication . You can download it under https://www.stepoverinfo.net/signsocket.stepover.com.pfx . After the download double-click on the signsocket.stepover.com.pfx and select as storage location the “local maschine”. Confirm the Import in the next step and use the password “signsocket57357”. Select the “Web Hosting” as store location for the certificate.

...

Confirm the location and the overview and the certificate import should be finished.

of the IIS and the StepOver Software Root CA 4096 for the browser. You can both certificates inside the download package with a batch for the installation. This importCertificates.bat needs to started as Administrator for the Installation, otherwise it will fail.

If you want to install the certificates manually you can do this with the certificate manager (MMC). The signsocket_keystore.pfx needs to be imported under Web Hosting, the password for the import is “signsocket57357”. The SWRootCertificateStepOverEuropa4096.der needs to be installed as Trusted Root and also under Web Hosting.

...

Installation of PadConnectorManager inside IIS

...

You also need to disable the Idle-Time-out for the Padconnector-Manager, because otherwise the IIS will stop the Manager process after 20min of idling and with that the existing User/Port Mapping list. Go to the Application Pool, select the PadConnectorManager and then “Advanced Settings..”. Under Process Model, you will find the Idle-Time-out option, which has a default value of 20. You need to set it to 0 and confirm with OK.image-20241031-143246.pngImage Removed

...

Configuration

...

Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath=".\PadConnectorManager.exe" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
	  <cors enabled="true" failUnlistedOrigins="true">
			<add origin="https://websignatureoffice.com"
                 allowCredentials="true"
                 maxAge="120"> 
                <allowHeaders allowAllRequestedHeaders="true"/>
                <allowMethods>
                     <add method="GET" />
                </allowMethods>
            </add>
			<add origin="https://www.websignatureoffice.com"
                 allowCredentials="true"
                 maxAge="120"> 
                <allowHeaders allowAllRequestedHeaders="true"/>
                <allowMethods>
                     <add method="GET" />
                </allowMethods>
            </add>
            <add origin="https://dev.webso.stepover.de"
                 allowCredentials="true"
                 maxAge="120"> 
                <allowHeaders allowAllRequestedHeaders="true"/>
                <allowMethods>
                     <add method="GET" />
                </allowMethods>
            </add>
        </cors>
    </system.webServer>
  </location>
</configuration>
<!--ProjectGuid: A1685A1F-7177-4E9A-8AC3-9B8F4D35F131-->

...

If you want to check for active users you can use the /dump Endpoint

...

...

Start up from PadConnector

When using the PadConnector Setup, a Service for the Startup of the PadConnector will be installed. But in a multi-user environment we have to start it inside the user-session, because only there is the device available. For that the PadConnector\run\PadConnectorConsole.exe can be used. With the exec from the same folder you can start it without the visible console.

Code Block
"c:\…\PadConnector\run\exec.exe" "c:\…\PadConnector\run\PadConnectorConsole.exe"

Add this to your login script for all users which should use the padconnector.

Additional Information for Integrator

...