Installing enaio® webclient as a desktop application

By default, enaio® webclient allows users to download enaio® webclient as a desktop application, enaio-webclient-app.exe, via the user menu.

It can be installed for the user only or globally for all users. Global installation requires administrator rights.

The path can be specified during installation.

If there is also an update for enaio® webclient as a desktop application after enaio® webclient has been updated, then an update will be performed automatically when enaio® webclient as a desktop application is started.

The enaio® webclient download feature can be disabled via the following parameter:

config.webclient.featureSwitches.desktopApp.download

Installation Requirements

Before installing enaio® webclient as a desktop application, the Microsoft Visual C++ Redistributable Package and the .NET framework must be installed in the version corresponding to your operating system language. All necessary installation resources are available in the 'Prerequisites' area of the Service Portal if these system requirements are not already automatically present.

In previous versions of enaio® webclient, the Electron framework used was also updated in enaio® webclient as a desktop application. The Chromium browser used by the Electron framework has also been updated. This Chromium update has also implemented the enhanced security measures adopted by all browser manufacturers, which are intended to prevent CORS attacks and the transmission of login information via non-encrypted channels in production environments. For this reason, NTLM logins in enaio® webclient as a desktop application are now only supported on encrypted HTTPS connections. For an NTLM login, enaio® gateway must therefore be configured for HTTPS. Logging in with BASIC_AUTH on unencrypted HTTP connections is still possible for test purposes.

Installing as an Administrator

In previous versions, an MSI package was made available for installation as an administrator. With this version, only the NSIS installer enaio-webclient-app.exe is available. The NSIS installer also allows you to allocate profiles for user-specific installations via the init-profiles.json configuration file.

Installing as an Administrator via NSIS Installer

The NSIS installer enaio-webclient-app.exe used to install enaio® webclient as a desktop application as an administrator via the command line is located in the installation data in the \Frontend\Webclient-Desktop-App\ directory.

Installation Parameters for enaio-webclient-app.exe

Parameter	Function
/S	Silent mode
/CurrentUser	User-specific installation User-specific installations are installed in the following directory: C:\Users\<user name>\AppData\Local\Programs\enaio webclient
/AllUsers	Global installations
/P	Optional application parameters
/D	Target directory for global installation A target directory is required for global installations.

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

The target directory for global installations must be specified last.

Profile allocation is possible with user-specific installations.

If an init-profiles.json configuration file is available in the enaio-webclient-app.exe directory, the profiles for connecting and logging in are automatically integrated from the configuration file.

Profile allocation is possible with global installations.

Parameters of the init-profiles.json Configuration File:

profiles	Multiple profiles can be specified.
activate	true/false If several profiles have this property, the most recent one from the configuration is preselected in the dialog.
url	URL to enaio® gateway For the 'OIDC_GATEWAY' login: the URL to enaio® service-manager with the 'gateway-ng' service with port.
username	User name Useful only for DEMO installations
password	Unencrypted password Useful only for DEMO installations
autologin	true/false Enable/disable 'Log in automatically'
authType	NTLM_SYSTEM for Windows login BASIC_AUTH for login using enaio® data OIDC_GATEWAY for login via the 'gateway-ng' service An NTLM_SYSTEM login with automatic login enabled allows the Windows user to login automatically.

A configuration file, which you can use as a template, is available for download:

init-profiles.json

'gateway-ng' Service

The 'gateway-ng' service can be integrated for OAuth2/OIDC authentication for enaio® webclient and enaio® webclient as a desktop application.

To connect enaio® webclient as a desktop application, create a profile using the following data:

url	URL to enaio® service-manager with the 'gateway-ng' service with port.
username	without user name
password	without password
autologin	false
authType	OIDC_GATEWAY

Uninstalling

Install/uninstall from the Windows Control Panel.

Updating

Updates can be carried out via the NSIS installer enaio-webclient-app.exe.

enaio® webclient as a desktop application will be automatically updated for users following the enaio® webclient update.