Installation des Desktop-Agents

Erweiterte Client-Funktionen

DMS Mobile DESK basiert auf Webtechnologien und ist daher auf jedem Gerät mit Webbrowser nutzbar. Einige optionale Funktionen erfordern jedoch eine tiefere Integration ins Betriebssystem, als PWAs derzeit ermöglichen. Für diese Anwendungsfälle kann DMS Mobile DESK mit einem Desktop-Agenten auf der Client-Seite zusammenarbeiten. Hier kommt der STP.Documents Desktop Agent ins Spiel. Der Desktop Agent darf nicht mit dem On-premise Agent verwechselt werden, der auf der Serverseite eingesetzt wird.

Der Desktop Agent startet einen lokalen Webserver und lauscht auf Anfragen unter http://localhost:18090. Wird DMS Mobile DESK im Browser auf demselben Desktop gestartet, erfolgt die Verbindung automatisch und Anfragen können an diesen lokalen Webserver gesendet werden.

Damit der Desktop Agent nur Anfragen von DMS Mobile DESK und nicht von beliebigen oder potenziell schädlichen Webseiten akzeptiert, müssen die Ursprünge (URLs ohne HTTP-Pfad) der erlaubten Webseiten explizit autorisiert werden. Diese müssen in den CORS-Einstellungen (Cross Origin Resource Sharing) in der Datei appsettings.json des Desktop Agenten angegeben werden.

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

Der Desktop Agent verwendet den dedizierten Port 18090 und kann daher nicht auf Terminalservern mit gemeinsam genutztem Portbereich betrieben werden.

Installation

Ab Desktop Agent v1.0.11 erfolgt die Installation über einen Windows-Installer. Während der Installation sollte „Nur für mich installieren“ ausgewählt werden, damit DMS Mobile DESK nur auf den eigenen Benutzerkontext zugreifen kann. Anschließend wird der eigene Mandant eingetragen und die Installation abgeschlossen. Der Desktop Agent läuft dann im Hintergrund und wird beim Systemstart automatisch neu gestartet. Um die erfolgreiche Installation zu überprüfen, öffnen Sie http://localhost:18090 im Browser. Dort sollten der Status und die korrekte Versionsnummer des Desktop Agenten angezeigt werden.
Beim ersten Signaturvorgang wird der SecSigner initialisiert. Die Datei CallSecSignerDLL64.dll aus dem SecSigner-Installationsverzeichnis (Pfad in appsettings.json hinterlegt) wird in das Verzeichnis des Desktop Agenten kopiert. Wird SecSigner aktualisiert, erkennt der Desktop Agent dies und kopiert die CallSecSignerDLL64.dll erneut in sein Verzeichnis.

Der Desktop Agent wird derzeit nur unter Windows unterstützt.

Update auf eine neue Version

Ab Desktop Agent v1.0.11 erfolgen Installation und Updates über den Windows-Installer. Für ein Update von einer früheren Version muss der bisherige Desktop Agent zunächst manuell deinstalliert werden (siehe Deinstallation). Zukünftige Updates laufen dann nach dem „Weiter, weiter, fertig“-Prinzip ab.

Deinstallation

Ab Desktop Agent v1.0.11 erfolgt die Deinstallation über den Windows-Installer. Eine frühere Version des Desktop Agenten muss manuell entfernt werden. Da es sich um eine ausführbare Datei handelte, kann sie einfach gelöscht werden.