Note: This feature is only available for enterprise customers and should be set up with the Happl Support team.
Step 1: Open the Google Workspace web and mobile apps console
This can be found here - https://admin.google.com/ac/apps/unified
Step 2: Choose Add custom SAML app
From the Add app button in the toolbar choose Add custom SAML app.
Step 3: Fill out app details
Name: Happl Description: Happl employee benefits and engagement platform App Icon: (See below image)
Step 4: Download IdP metadata
This is a very important step. Click on DOWNLOAD METADATA and save the file that was downloaded.
Then send it to your Happl contact or to [email protected]
Step 5: Add service provider details
Fill out these service provider details on the next screen.
Detail | Value |
ACS URL | https://api.live.happl.io/auth/v1/sso/saml/acs |
Entity ID | https://api.live.happl.io/auth/v1/sso/saml/metadata |
Start URL | https://app.happl.com |
Signed Response | YES |
Name ID Format | PERSISTENT |
Name ID | Basic Information > Primary email |
Step 6: Configure attribute mapping
Attribute mappings allow Happl to get information about your Google Workspace users on each login.
Basic Information | App attributes |
Primary Email | |
Primary Email | user_name |
First Name | first_name |
Last Name | last_name |
Group membership is not required.
Step 7: Configure user access
You can configure which Google Workspace user accounts will get access to Happl. This is important if you wish to limit access.
Most companies allow for all users to have access
Changes from this step sometimes take a while to propagate across Google’s systems. Wait at least 15 minutes before proceeding to the next step.
Click on the User Access box at the top
Then select the users you want to have access - commonly you would simply opt for on for everyone
Step 8: Contact Happl
Once you have completed these steps, ensure you have sent the metadata file to Happl. Once we have added it to your account, we will let you know, and providing you have completed all of these steps, you should be good to go!
The next step is to log into Happl and test if you are able to log in.
Note: SSO does not create users; it only allows them to log in. The HRIS integration still carries out user creation, so users will need to be on the Happl platform to be able to log in using SSO.