Skip to main content

How to connect Okta SSO: One-click setup

Rose Lunn avatar
Written by Rose Lunn
Updated over a week ago

To integrate Okta with AirMason, you need to be added as a collaborator on the account. If you don’t have access, contact the account owner or admin to grant you the required permissions for IT integration. For instructions on adding a new collaborator, refer to this guide.


Step 1: Getting the API Key

  1. Go to the API Settings in Okta

  2. Open the Tokens tab then click on “Create Token”

  3. Name your token and select “Any IP” for the Origin then click “Create token”

  4. Copy your token and paste it in AirMason and connect.

  5. A new App will be created in Okta. No user will be able to sign in until you assign them the newly created app.


Step 2: Getting Okta set up on AirMason

  1. Log into your admin dashboard and click Integrations

  2. Locate Okta and click Connect

  3. Enter your domain and API key you got in step 1 and click Connect to Okta

Step 3: Assign employees to the application

  1. Log into your Okta admin account and navigate to Applications

  2. Select the "AirMason - SSO Integration" application

  3. Click on the "Assignments" tab

  4. Assign all the employees that need to access AirMason


Testing Okta SSO as employee:

  1. Go to your Employee Portal URL. It should show you login page for viewing your handbooks

  2. Click on "Login with Okta"

  3. It should take you to login using Okta SSO credentials (if you are not logged in)

  4. Once you log in, it should bring you back to AirMason and you should be able to view handbooks you've access to (similar to what is shown below).

Did this answer your question?