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
Go to the API Settings in Okta
Open the Tokens tab then click on “Create Token”
Name your token and select “Any IP” for the Origin then click “Create token”
Copy your token and paste it in AirMason and connect.
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
Log into your admin dashboard and click Integrations
Locate Okta and click Connect
Enter your domain and API key you got in step 1 and click Connect to Okta
Step 3: Assign employees to the application
Log into your Okta admin account and navigate to Applications
Select the "AirMason - SSO Integration" application
Click on the "Assignments" tab
Assign all the employees that need to access AirMason
Testing Okta SSO as employee:
Go to your Employee Portal URL. It should show you login page for viewing your handbooks
Click on "Login with Okta"
It should take you to login using Okta SSO credentials (if you are not logged in)
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).