To integrate G-Suite 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)
Setting up AirMason app on G-Suite:
Login into https://admin.google.com/ac/home using google admin account
Then follow these steps to create Google saml app
Go to “Apps” > “Web and mobile apps”
Click Add App and click Add custom SAML app
App details
App name = AirMason
App Icon
Click on image to download and save the AirMason logo
Click continue
Google Identity Provider details
Click continue
Service provider details
ACS URL and Entity ID is your https://Employee Portal URL/gg_sso/saml2
NAME ID should match the following image
Click continue
Attributes
Match your mapping with the following image:
Click Finish
Once the app is created, go to “User access” and select employees you want to give access to.
Connecting G-Suite SSO app to AirMason:
Go to G-Suite app and click on "DOWNLOAD METADATA" button
1.1. Your browser URL should be looking something like this:
https://admin.google.com/u/1/ac/apps/saml/587527004653 . In this example URL, 587527004653 is AppID. Copy your AppID from your URL (we would be using it later)
1.2. From the download metadata page, copy your Entity ID and Certificate
1.3. From your Entity ID field, copy idpid. If Entity ID looks like this https://accounts.google.com/o/saml2?idpid=C03e14v76 then C03e14v76 is idpid.
Now, login to airmason.com and go to Integrations page
Select GSuite app from SSO applications and click on Connect and set the following params:
3.1. Issuer URL as Entity ID value from Step 1.2.
3.2. Certificate as Certificate value from Step 1.2.
3.3. SAML 2.0 Endpoint as https://accounts.google.com/o/saml2/initsso?idpid=<idpid>&spid=<AppID>&forceauthn=false (replace <AppID> with your AppID value from step 1.1. and <idpid> with your app's idpid from step 1.3.). Your final URL should look something like this:
https://accounts.google.com/o/saml2/initsso?idpid=C03e14v76&spid=857390449774&forceauthn=false
Testing GSuite SSO as employee:
Go to your Employee Portal URL. It should show you login page for viewing your handbooks
Click on "Login with Google SSO"
It should take you to login using google 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).
