Installation and Configuration

macOS

Configuration

Starting with version 6.12.0 customers need to create the hypr.json file with all client specific parameters. Follow steps below to create it:

Step 1: Create the file with name hypr.json

Example:

touch hypr.json

Step 2: Put hypr.json and installer in same folder

Step 3: Set your configuration parameters in the hypr.json

Configuration Parameters

Parameter

Description

Type

Example

appId

Name of your Application in the HYPR Control Center

Required

AcmeMacOSApp

pinningHash

SHA256 PIN of the Control Center Domain

Required

KeM8XnCIy8+Cxm+HKTEOBZr1g3F8odQNHTH+vdu7RWc=

rpUrl

URL of your HYPR tenant with added /rp path

Required

https://acme.hypr.com/rp

supportEmail

Email address of your support team managing the HYPR.

Required

[email protected]

certificateTemplate

Name of your Certificate Template in the Microsoft Security Authority. This is a required parameter if you're using the domain-joined computer.

Optional

AcmeMacOSUser

installToken

Installation Token used for endpoint protection

Required

6a74ce20-2c1e-4c7d-ae9d-14be27e2c197

version

HYPR Installer Version. Must be set to 4

Required

Example

Installation

📘

Config file must be in the same folder with an installer

Please make sure to place the installer package in the same folder with hypr.json

Option 1: Via User Interface

Step 1: Double click on WorkforceAccess-<VERSION>.dmg disk image (DMG) and copy the installer package.

Step 2: Put the installer package in the same folder with created hypr.json file.

📘

DMG Distribution Option

Alternatively, you can create a new .dmg where the hypr.json is put inside the dmg, next to the pkg files

Step 3: Double click on WorkforceAccess-<VERSION>-Installer.pkg to begin installation.

Step 4: Complete installation and restart the computer

Option 2: Via Terminal

Step 1: Double click on WorkforceAccess-<VERSION>.dmg disk image (DMG) and copy the installer package.

Step 2: Put the installer package in the same folder with created hypr.json file.

Step 3: Open terminal 

Step 4: Execute code below

installer -pkg ~/Downloads/WorkforceAccess-<VERSION>-installer.pkg -target ~/Applications/

Modifying App Configuration

Option 1: Manually

Step 1: open /Library/HYPR/HyprOneService.plist
This file is protected from edits by non-admin users, so you will need to edit it with sudo

Using vi

sudo vi /Library/HYPR/HyprOneService.plist

Using nano

sudo nano /Library/HYPR/HyprOneService.plist

Step 2: Modify the file according your configuration

Step 3: Reboot computer to apply changes

Option 2: Using CMD

Info.plist can also be modified using the shell script if you would like to apply changes automatically for selected users.

Example

#! /bin/bash

PLIST_FILE=/Library/HYPR/HyprOneService.plist

# Customize the configuration.
defaults write $PLIST_FILE ApplicationId "NAME OF YOUR APP IN CONTROL CENTER"
defaults write $PLIST_FILE RelyingPartyPins "<COMMA DELIMITED LIST OF PINS>"
defaults write $PLIST_FILE RelyingPartyUrl "https://CONTROL_CENTER_URL/rp"
defaults write $PLIST_FILE SupportEmail "SUPPORT EMAIL"

# Convert the configuration file to XML.
plutil -convert xml1 $PLIST_FILE

Deployment Best Practices

Installing with JAMF/JAMF Connect
JAMF Connect is not officially supported, but we advise our customers to use the terminal option of the installation that can be potentially used with JAMF and other software distribution tools.

Use Sudo for Installation/Uninstallation
Installing/Uninstalling a product requires admin privileges. Please ensure to use sudo when distributing the package to users

An alternative method to uninstall the application

  1. Delete the /Applications/Workforce Access.app folder (must be root).
  2. Wait for 3 minutes. The uninstaller will be invoked.