Set up Hideez Client app
Hideez Client App – Setting up Hideez Client
The installation package comes in two forms:
Bootstrapper (.exe)
MSI package (.msi)
You can find the .exe installation file here and .msi installation files here - x86, x64.
Bootstrapper
Bootstrapper is a special application that is used to install prerequisites that are required by the installed application.
The Hideez Client Bootstrapper contains:
Two Hideez Client MSI. One for 32-bit architecture and one for 64-bit architecture
Two C++ 2015-2019 Redistributables. One for 32-bit architecture and one for 64-bit architecture
.NET Framework 4.7.2 web installer
The bootstrapper automatically determines the architecture of the system (32-bit or 64-bit) and installs the respective components without the need for user input on the matter.
Setup interface
To proceed with the installation, check the I agree to the license terms and conditions checkbox.
IMPORTANT: Please, notice that Internal Bluetooth option is supported only for Windows 10 version 1903 (2019) and later. In earlier versions, Hideez Key works only with the Hideez dongle.
You need to select the Enterprise version option and specify the Use Windows 10 Bluetooth option if you will use the built-in Bluetooth or Use an external Hideez dongle if you will be using the dongle. Here you have to provide the HES address. In addition, you can choose the language required. Choose desired options and click the "Apply" button.
In case you did not provide the HES address during the installation, you need to enter HES address in the 'Settings' section.
And save it by clicking the 'Save' button.
Then the server indicator becomes yellow and you will need to approve the workstation on HES. Then you will have to click the "Reconnect' button:
MSI Package
Installation from an MSI file does not install additional components. They must be installed separately, but the MSI file can be used in automatic installation scripts.
System modifications by MSI package
During installation the package will make the following modifications to the system:
Application is installed under the following path %ProgramFiles%\Hideez\Client\
A new registry key is created under HKLM\SOFTWARE\Hideez\Client
A registry value client_hes_address (type REG_SZ) is created under HKLM\SOFTWARE\Hideez\Client and contains Hideez Enterprise Server address
A custom Hideez CSR driver is installed on all compatible devices
A new folder is created in the following location %ProgramData%Microsoft\Windows\Start Menu\Programs\Hideez and contains a shortcut to the Hideez Client executable file
A registry value Hideez Client is created under HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Run and contains a path to the application executable file clientsetup.exe from the installation folder
The application is added to the Programs and Features table in Windows
If installed using Bootstrapper, the entry is called Hideez Client
If installed using MSI, the entry is called Hideez Client Update <version>, where <version> is changed based on assembly version
If Hideez Client application is running during the installation process, the installer will try to stop services and client application without asking for additional user input.
Both installation options (Bootstrapper and MSI package) support the transfer of parameters from the command line:
| Argument | Description |
|---|---|
-standalone | Set application mode to Standalone |
-enterprise | Set application mode to Enterprise |
-dongle | Set connection type to External Bluetooth dongle |
-winradio | Set connection type to Windows internal Bluetooth |
-loc= | Set application localization by specifying culture after = Supported cultures: en-US, uk-UA For example: -loc=en-US, -loc=uk-UA |
-server= | Set connection address to Enterprise server after = For example: -server=https://address.com |
-silent, -s | Skip the configuration window in attentive installation |
The parameters are not mandatory. The installation can be performed without specifying parameters.
If no arguments were specified, installation defaults to Standalone mode.
If no connection type was specified, it defaults to WinRadio in Standalone mode only.
Enterprise mode is not affected by this rule and permits no connection modes, which limits client application usage with the mobile authenticator.
If multiple application modes were specified, Enterprise mode takes higher priority.
If multiple connection types were specified, both will be enabled, but application stability is not guaranteed.
If multiples of the same parameter are specified, only the first one is considered.
Example of setup with parameters
MSI
The following line is executed from the command line terminal:
The execution of this line will result in the silent installation of a standalone version with an external dongle connection type and English localization. The installed application will then try to connect to the Hideez Enterprise Server at the following address: http://192.168.10.249/
Note: For the quiet (silent) installation, the command must be executed with administrator permissions.
Bootstrapper
The following line is executed from the command line terminal:
The execution of this line will result in the silent installation of a standalone version with an external dongle connection type and English localization. The installed application will then try to connect to the Hideez Enterprise Server at the following address: http://192.168.10.249/
