Installation and Configuration
HYPR Workforce Access for Windows can be installed silently or using the installer user interface. Administrative access to the target workstation is required and a new registry key will be created by a successful installation.
The HYPR Workforce Access Client can be installed on the command line using msiexec.
Command Line Parameters
|The application ID as specified in the Control Center||A character array [0..256]||No default. Mandatory Field.|
|The URI of the Control Center. Replace your.domain.here with your domain in the example URI below:|
This URI must end in /rp
|A character array [0..256]||No Default. Mandatory Field.|
|The email address where support requests will be mailed||A valid email address||No Default. Optional.|
|The SHA1 or SHA256 PIN Hash of the server SSL certificate. This serves as the Public Key Pinning value.||A SHA1 hash of the server SSL certificate.||No Default. Mandatory.|
|Certificate template name||A valid certificate template name||Default is |
|Installation Token used for endpoint protection||A valid InstallToken generated in the Control Center||No Default. Mandatory.|
|Company logo displayed in the app.||Path to an image||HYPR Images are set by default. Optional.|
|Custom background image displayed in the app.||Path to an image||HYPR Images are set by default. Optional.|
You can learn more about additional parameters that could be configured during the installation in this page.
From a command prompt with administrative privileges
msiexec.exe /qn /i .\EmployeeAccess.msi HYPRAPPID="WindowsUnlock" HYPRRP="https://my.host.com/rp" HYPRSUPPORT="[email protected]" HYPRHASH="abcdef...fedcba" HYPRTEMPLATE="HYPRUser" HYPRINSTALLTOKEN="c8d2rf05b-b6db-4bc3-ateb-abb6302c48fd" HYPRCUSTOMLOGO="C:\\foo\\bar" HYPRCUSTOMBACKGROUND="C:\\foo\\bar"
The Alternate Subject Name must include the User Principal Name (UPN) in the certificate template
Default user template
Userwill be used if
HYPRTEMPLATEparameter wasn't specified
The installer file name shall not be changed unless otherwise noticed by HYPR.
Installer user interface
Rather than performing a silent install, you can use the installer wizard provided by HYPR. Double click the .msi installer provided to you by HYPR. You will see the installer user interface Window
- Click Next
- Accept the End User Agreement Terms
- Enter installation parameters
- If any of the parameters do not meet their required criteria, a warning message will pop up.
Certificate Template can be left blank to make use of default user templates or if you're deploying HYPR in a non-domain joined environment.
- Click Install
When the installation finishes, you'll be prompted to restart the workstation to complete the installation if necessary.
Upgrading without reboot
When upgrading, a workstation reboot is only required for major updates. HYPR will notify customers about versions that will require a reboot.
The installation adds a new HYPR key to the Windows Registry at the following location:
HKEY_LOCAL_MACHINE\SOFTWARE\HYPR Workforce Access
These registry values are required for normal functioning of the application.
|The application ID specified during installation. If you do not specify one this will be blank. This can be updated afterwards by an admin.|
|A unique identifier for the workstation. This should never be changed|
|SHA1 hash of the server SSL certificate|
|The URI as provided by the installer|
|The support email for your organization|
|Certificate template name|
|The text message displayed on the login screen when the user clicks "Don't have your phone?"|
Updated 6 months ago