Introduction

• HelloID environment
• Google Workspace environment

Notes

• Single sign-on for Google Workspace can only be applied to all users or none of them. Super Administrators are the exception, and are exempt from the requirements to use SSO once it is enabled.
• Any service or generic accounts you use in Google Workspace will need to be able to use HelloID as well, otherwise they will not be able to log in unless they are Super Administrators.

Create or Import a Certificate

If there is no certificate yet, you must create or import one. For this tutorial, we will create a self-signed certificate. Name it GoogleWorkspaceSelfSigned. Download it in .CER format.

Application setup

Add the Google GSuite application

1. Add a new application.
2. Find the template for Google GSuite (SAML).
3. Select its Add button.

General tab

Change the following settings:

• Default Login URL
  Customize with your organization's Google Workspace domain name, in the format: https://accounts.google.com/a/{yourGoogleDomain}/acs

Select the Next button.

Single Sign-On tab

Change the following settings:

• Issuer
  Enter your HelloID domain in the format https://{customer}.helloid.com.
• Endpoint URL
  Copy and paste the Default Login URL from the General tab.
• X509 Certificate
  Select the GoogleWorkspaceSelfSigned certificate that you previously imported or created.

Credential tab

Select Credentials are configured by admin. The settings for the NameID and Password depend on whether users are logging in with QR codes. Learn more about application credentials here.

1. • Users log in with QR codes:
     • Name ID: User's contact email
     • Password: Custom value
       • {{user.login.password}}{{user.attributes.qr}}
         
   • Users do not log in with QR codes:
     • NameID: User's contact email
     • Password: Password is the same as user's password
       

Select the Next button.

Self Service tab

Optionally, generate a Self Service product, which makes the application requestable. Select a group which will have access to the product. 

Select the Next button.

Finish tab

Select the Save button to add the application to HelloID.

Additional configuration

Retrieve application metadata

1. Go to the Applications overview.
2. Select the Edit link for the newly-added Google Workspace application.
3. Right-click the Download metadata button
4. Select Copy link address. It will resemble: https://enyoi.helloid.com/metadata/download?ApplicationGUID=e6e741f5-a469-4849-93f7-fe2e259a339f. You will need this shortly.
   
5. Open the metadata URL in a browser and copy the SingleSignOnService location. It will resemble: https://test.helloid.com/relayservice/redirect/c46bfd46-c569-4274-bd6e-031b9c021423
   
6. Scroll down the page and enable Hide Application. Click Save when you are finished.
   
7. Select the Save button.

Why am I hiding the application?

Some service providers, including Google Workspace, have a number of different applications or "endpoints". Instead of having users navigate directly to the main Google Workspace application, you will provide users with shortcuts to the various endpoints, such as Gmail and Drive. They are indirectly routed through the primary service provider application that you have hidden. We will configure this in the Add product shortcuts section, below.

Google Workspace configuration

1. Log on to your organization's Google Workspace admin console and go to Security > Authentication > SSO with third-party IdP.
2. Select the edit button for the Third-party SSO profile for your organization pane.
   
3. Enter the following information and click Save.
   
   
   • Set up SSO with third-party identity provider
     Enable
   • Sign-in page URL
     Paste the SingleSignOnService URL that you copied from the application metadata.
   • Sign-out page URL
     Enter https://{yourdomain}.helloid.com/authentication/signoff.
   • Change password URL (optional)
     Enter the URL of your password reset manager. For example, SSRPM.
   • Verification Certificate
     Upload the certificate created at the start of this guide.

The SAML connection is now configured. The next step is to add shortcuts to the Google products.

Add product shortcuts

1. Add a new application.
2. Search for "Google".
3. Select the Add button for the relevant product.
   
4. On the General tab, replace {company domain} in the Default Login URL with your organization's Google Workspace domain name.
   
5. Select the Save button.

Repeat these steps for any other Google product shortcuts you want to create.

Finish up

After you have finished adding product shortcuts, authorized users will see the applications on their HelloID User Dashboard. When they launch an application, they will be authenticated to Google with the credentials stored in the attribute you specified on the Google Workspace application. If any users are not able to access their Google products, double check that they have the required information in the chosen attribute.

You are now free to assign the product shortcuts to users within your organization. See Applications - Overview and its related articles for more information.