Setting up authentication with Okta

The following guide will assist you in configuring your application to use Okta for authentication.

Configure a new application in Okta

1. Log into the Okta admin console with administrative credentials, select Applications then Applications

2. Click Add application, then Create app integration

3. Select Open ID Connect as the sign in method and and Web application as the application type

4. Enter Lithnet Access Manager or another suitable application name and optionally provide a logo

5. Ensure that authorization code is the selected grant type

6. For the sign in redirect URI, enter the base URL where your Lithnet Access Manager app is hosted followed by /auth/ (eg https://accessmanager.lithnet.local/auth/)

7. Set the sign out redirect URI to your base URL, and append /auth/logout to the end of it (eg https://accessmanager.lithnet.local/auth/logout)

8. Assign the appropriate users to the app and save the new app

9. From the new app page, copy the client ID and client secret value for use later in the setup process

10. Select Directory from the main menu bar, and select Profile editor. Find the Lithnet Access Manager app in the list, and click the Profile button

11. Click Add attribute and create a new attribute called upn, of data type string. Select both the attribute required and User personal check boxes

12. Click the Mappings button. Find the UPN value, and map it to the okta attribute that contains the Active Directory UPN (eg aduser.userPrincipalName)

Configure Lithnet Access Manager

1. Open the Lithnet Access Manager Service configuration tool

2. Go to the Authentication page and select OpenID Connect as the authentication provider

3. Enter the URL of your okta tenant in the Issuer/Authority field

4. Enter the client ID and secret obtained from the Okta setup process

Enable multi-factor authentication

We strongly recommend to modify your application sign-on policy to require multi-factor authentication for the use of this app.