enaio® webclient als Desktop-Anwendung installieren

enaio® webclient bietet als Standard den Download von enaio® webclient als Desktop-Anwendung, enaio-webclient-app.exe, über das Benutzermenü an.

Die Installation kann nur für den Benutzer oder global für alle Benutzer durchgeführt werden. Eine globale Installation erfordert administrative Rechte.

Bei der Installation kann der Pfad angegeben werden.

Wenn nach einem Patch von enaio® webclient ebenfalls ein Patch von enaio® webclient als Desktop-Anwendung vorliegt, dann wird beim Start von enaio® webclient als Desktop-Anwendung die Aktualisierung automatisch durchgeführt. Für globale Installationen muss hierfür ein Benutzer mit administrativen Rechten enaio® webclient als Desktop-Anwendung einmalig starten.

Die Download-Funktion aus enaio® webclient kann über folgenden Parameter deaktiviert werden:

config.webclient.featureSwitches.desktopApp.download

Installation - Voraussetzung

Voraussetzung für die Installation von enaio® webclient als Desktop-Anwendung ist das Microsoft Visual C++ Redistributable Package sowie das .NET Framework in der mit dem Betriebssystem kompatiblen Sprache. Sollten diese Systemvoraussetzungen nicht bereits automatisch vorhanden sein, stehen alle notwendigen Installationsressourcen im Bereich 'Prerequisites' des Service Portals zur Verfügung.

Mit vorherigen Versionen von enaio® webclient wurde in enaio® webclient als Desktop-Anwendung das verwendete Electron-Framework aktualisiert. Damit wurde auch der vom Electron-Framework verwendete Chromium-Browser aktualisiert. Durch dieses Chromium-Update wurden die von allen Browser-Herstellern beschlossenen, verstärkten Sicherheitsmaßnahmen umgesetzt, die CORS-Angriffe vereiteln sollen und das Übertragen von Anmeldeinformationen über nicht verschlüsselte Wege in produktiven Umgebungen verhindern sollen. Aus diesem Grund werden NTLM-Anmeldungen in enaio® webclient als Desktop-Anwendung seitdem nur noch auf verschlüsselten HTTPS-Verbindungen unterstützt. Für eine NTLM-Anmeldung muss also enaio® gateway für HTTPS konfiguriert werden. Eine Anmeldung mit BASIC_AUTH auf unverschlüsselten HTTP-Verbindungen ist zu Testzwecken weiterhin möglich.

Administrative Installation

In vorherigen Versionen wurde ein MSI-Paket für die administrative Installation zur Verfügung gestellt. Mit dieser Version steht nur noch der NSIS Installer enaio-webclient-app.exe zur Verfügung. Der NSIS Installer ermöglicht für benutzerspezifische Installationen ebenfalls eine Profilverteilung über die Konfigurationsdatei init-profiles.json.

Administrative Installation per NSIS Installer

Der NSIS Installer enaio-webclient-app.exe zur administrativen Installation von enaio® webclient als Desktop-Anwendung per Kommandozeile befindet sich unter den Installationsdaten im Verzeichnis \Frontend\Webclient-Desktop-App\.

Installationsparameter für enaio-webclient-app.exe

Parameter	Funktion
/S	Silent Mode
/CurrentUser	benutzerspezifische Installation Benutzerspezifische Installationen werden in folgendes Verzeichnis installiert: C:\Users\<Benutzername>\AppData\Local\Programs\enaio webclient
/AllUsers	globale Installationen
/P	optionale Anwendungsparameter
/D	Zielverzeichnis für globale Installation Ein Zielverzeichnis wird für globale Installationen benötigt.

Beispiel: enaio-webclient-app.exe /S /AllUsers /P=--disable-accelerated-2d-canvas /D=C:\enaio\webclient

Die Angabe des Zielverzeichnisses für globale Installationen muss an letzter Stelle stehen.

Für benutzerspezifische Installationen ist eine Profilverteilung möglich.

Falls im Verzeichnis des NSIS Installer enaio-webclient-app.exe eine Konfigurationsdatei init-profiles.json vorliegt, dann werden bei der Installation die Profile für das Verbinden und Anmelden aus der Konfigurationsdatei automatisch eingebunden.

Für globale Installationen ist eine Profilverteilung nicht möglich.

Parameter der Konfigurationsdatei init-profiles.json:

profiles	Mehrere Profile können angegeben werden.
activate	true / false Falls mehrere Profile diese Eigenschaft haben, dann wird das letzte aus der Konfiguration im Dialog vorausgewählt.
url	URL zu enaio® gateway Für die Anmeldung 'OIDC_GATEWAY' die URL zu enaio® service-manager mit dem Service 'gateway-ng' mit Port.
username	Benutzername Sinnvollerweise nur für DEMO-Installationen
password	unverschlüsseltes Passwort Sinnvollerweise nur für DEMO-Installationen
autologin	true / false 'Automatisch einloggen' aktivieren / deaktivieren
authType	KERBEROS_SYSTEM für die Kerberos-Anmeldung mit dem momentan angemeldeten Windows-Benutzer KERBEROS_USERNAME für die Kerberos-Anmeldung mit einem gewählten Benutzer und Passwort NTLM_SYSTEM für die NTLM-Anmeldung mit dem momentan angemeldeten Windows-Benutzer NTLM_USERNAME für die NTLM-Anmeldung mit einem gewählten Benutzer und Passwort BASIC_AUTH für die Anmeldung mit enaio®-Daten OIDC_GATEWAY für die Anmeldung über den Service 'gateway-ng'

Eine Konfigurationsdatei, die Sie als Vorlage verwenden können, steht zum Download bereit:

init-profiles.json

Service 'gateway-ng'

Der Service 'gateway-ng' kann für die Authentifizierungsmethode OAuth2/ OIDC für enaio® webclient und enaio® webclient als Desktop-Anwendung zusätzlich zu enaio® gateway eingebunden werden.

Für die Verbindung von enaio® webclient als Desktop-Anwendung erstellen Sie ein Profil mit folgenden Daten:

url	URL zu enaio® service-manager mit dem Service 'gateway-ng' mit Port.
username	ohne Benutzername
password	ohne Passwort
autologin	false
authType	OIDC_GATEWAY

Deinstallation

Installationen deinstallieren Sie über die Windows-Systemsteuerung.

Patches

Die Aktualisierung kann über den NSIS Installer enaio-webclient-app.exe durchgeführt werden.

Wenn nach einem Patch von enaio® webclient ebenfalls ein Patch von enaio® webclient als Desktop-Anwendung vorliegt, dann wird beim Start von enaio® webclient als Desktop-Anwendung die Aktualisierung automatisch durchgeführt.

Für globale Installationen muss hierfür ein Benutzer mit administrativen Rechten enaio® webclient als Desktop-Anwendung einmalig starten.