Desktop Agent Installation

Advanced Client Features

DMS Mobile DESK is based on web technologies, making it usable on any device with a web browser. However, some optional features require deeper integration with the operating system than PWAs currently allow. For these use cases, DMS Mobile DESK can work together with a client-side desktop agent. This is where the STP.Documents Desktop Agent comes in. The Desktop Agent should not be confused with the On-premise Agent used on the server side.

The Desktop Agent starts a local web server and listens for requests at http://localhost:18090. When DMS Mobile DESK is launched in the browser on the same desktop, it connects automatically and can send requests to this local web server.

To ensure that the Desktop Agent only accepts requests from DMS Mobile DESK and not from arbitrary or potentially malicious websites, the origins (URLs without HTTP path) of allowed websites must be explicitly authorized. These must be specified in the CORS (Cross Origin Resource Sharing) settings in the appsettings.json file of the Desktop Agent.

{
    ...
    "CorsOrigins": [
        "https://my-tenant.stp-cloud.de"
    ],
    ...
}

The Desktop Agent uses the dedicated port 18090 and therefore cannot be run on terminal servers with a shared port range.

Installation

Starting with Desktop Agent v1.0.11, installation is performed via a Windows installer. During installation, “Install for me only” should be selected so that DMS Mobile DESK can only access the user’s own context. Afterwards, the user’s tenant is entered and the installation is completed. The Desktop Agent then runs in the background and is automatically restarted at system startup. To verify successful installation, open http://localhost:18090 in your browser. The status and correct version number of the Desktop Agent should be displayed there.
During the first signature process, the SecSigner is initialized. The CallSecSignerDLL64.dll file from the SecSigner installation directory (path stored in appsettings.json) is copied into the Desktop Agent’s directory. If SecSigner is updated, the Desktop Agent detects this and copies the CallSecSignerDLL64.dll file again into its directory.

The Desktop Agent is currently only supported on Windows.

Update to a New Version

Starting with Desktop Agent v1.0.11, installation and updates are performed via the Windows installer. To update from an earlier version, the previous Desktop Agent must first be uninstalled manually (see Uninstallation). Future updates will then follow the “Next, next, finish” scheme.

Uninstallation

Starting with Desktop Agent v1.0.11, uninstallation is performed via the Windows installer. An earlier version of the Desktop Agent must be uninstalled manually. Since it was an executable file, it can simply be removed.