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.
Employee Portal URL:
In this article, we'll be referencing this URL at a couple of places. You can figure out what to use there by going to Manage Organization > Employee Portal
If you've custom domain setup on AirMason
- then your Employee Portal URL will be your custom domain (Eg: handbooks.johnsmithweb.com)
- otherwise it will be books.airmason.com/<company-handle>, where <company-handle> is company handle that you've set up. (Eg: books.airmason.com/johnsmith)
Step 1: Getting the API Key
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
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
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).
