Install the Okta Hyperspace Agent

During this task we will install the Okta Hyperspace agent.

Tasks

Determine the client secret and id

  1. Org admins will need to request Okta Support provide the download link for the Okta Hyperspace Agent.
    For the agent version history, see Okta Hyperspace Agent Version History.
  2. Sign in to your Okta tenant as an admin.
  3. Navigate to the Epic Hyperspace EPCS (MFA) application.
  4. Select the General tab.
    This tab contains the Okta URL, client id and client secret required by the agent install.
    Keep this tab open as these values are required in later steps.
    Info

    Note

    When prompted the Okta URL must be entered as either: https://<<YOUR OKTA ORG>>.okta.com or https://<<YOUR OKTA ORG>>.oktapreview.com.

Install the agent

Interactively

Install the agent interactively on the machine that will host the agent.

  1. Download the HyperSpace Agent MSI file and unzip.
  2. Execute the OktaHyperspaceAgent.msi, accepting all defaults.
  3. When promoted enter the URL, client id and client secret as shown in the General tab of the Epic Hyperspace EPCS (MFA) application.

Silently

  1. Download and install the Microsoft Visual C++ redistributable libraries as described at https://www.microsoft.com/en-us/download/details.aspx?id=48145.
  2. Download the HyperSpace Agent MSI file and unzip.
  3. Open a command prompt and change directory to the location where the MSI was downloaded and unzipped.
  4. Execute the MSI installer using a command similar to:
    msiexec /qb /log log.txt /i OktaHyperspaceAgent.msi CLIENT_ID="ClientID" CLIENT_SECRET="ClientSecret" OKTA_URL="Url"
    Where:
    Url, ClientId and ClientSecret values are as shown in the General tab of the Epic Hyperspace EPCS (MFA) application.


Info

Note

If the version of Okta installed Epic.Core.Authentication.dll is older then the EPIC library Epic.Core.Authentication.dll replace the Okta version with the newer EPIC DLL.

The default location for the plugin install file is typically : c:\Program Files (x86)\Okta\OktaHyperspaceLoginDevice\