Skip to main content

Locations Manager OpenID Okta Guide

Raise a support ticket

OVERVIEW​

To use Okta Open ID with Locations Manager you are required to register the application on Okta Admin page. The registration will be used to acquire an access token to requests to access the Locations Manager API.

REGISTER AN APPLICATION IN OKTA​

  1. After logging in to Okta, navigate to the Okta Admin page (https://xxx-admin.okta.com/admin/dashboard).

    2024-01-18_9-15-48.png

  2. Navigate to the Applications page

    2024-01-18_9-13-53.png

  3. Click Create App Integration

    2024-01-18_9-18-56.png

  4. For the Sign-in method select OIDC - OpenID Connect

    2024-01-18_9-19-58.png

  5. For the Application Type select Single-Page Application then click Next

    2024-01-18_9-22-21.png

  6. Enter the details below then click Save

    NAMEVALUE
    Grant typeAuthorizaztion Code
    App Integration NameLocations Manager
    Sign-in redirect URIsThe URL of Locations Manager
    Sign-out redirect URIsThe URL of Locations Manager
    Controlled accessAllow everyone in your organization to access
    Enable immediate accessEnabled

    image.png

    2024-01-18_9-33-46.png

GATHERING APP DETAILS​

Please follow the steps below to retrieve the Application ID, Authority URL and Redirect URL on the Okta Application Dashboard. These values are required for the installation.

CLIENT ID​

The Client ID can be found in the Client Credentials section of the General Tab of your Okta application

image.png

AUTHORITY URL​

The Authority URL can be found by clicking your user name and copying the value above the My Settings link. you must add https:// to the copied value when configuring Locations Manager.

2024-01-18_9-58-04.png

REDIRECT URL​

The URL of Locations Manager supplied in the Sign-in redirect URIs field

image.png

VALUES REQUIRED FOR INSTALLATION​

The following values will be required for the installation of Locations Manager. Please ensure that the person responsible for the installation has these values.

  • Redirect URI
  • Application ID
  • Authorization URL
NameDescription
Redirect URIThe URI where Okta will send the authentication payload upon successful authentication.
Application IDApplication's unique identifier on Okta.
Authorization URLhttps://{Okta Domain}

CONFIGURATION​

The Authentication tab allows you to specify the authentication method for Locations Manager, and is available within the admin section of Locations Manager

2024-01-18_11-03-21.png

To enable Okta Open ID Authentication:

  1. Set the Type field to OKTA

  2. Enter the values for all the provided fields

  3. Click on the Save button

  4. Navigate to the Locations Manager application in IIS

  5. Ensure Anonymous Authentication is the only authentication method enabled for Locations Manager

    2024-01-18_11-13-30.png

  6. Perform an app pool restart for Locations Manager