How to set up Google Workspace SSO

Summary

• Sign in as administrator at Google Apps Administration Site.
• Select Apps > Web and mobile apps.
• Add a custom SAML app for ClickView or Streamable Learning.
• Download IdP Metadata and send the XML file to Product Support.
• Enter ACS URL and Entity ID from the regional table.
• Complete attribute mapping with organization unit path or Google Groups.
• Enable app for all users and submit SSO onboarding form.

Step-by-step SSO integration guide

This article explains how to integrate Google Workspace Single Sign-On (SSO) for ClickView and Streamable Learning, with step-by-step instructions for setup and attribute mapping. Follow these steps to connect your Google Workspace account to ClickView or Streamable Learning and support seamless authentication for both staff and students.

1. Sign in to your Google Apps Administration Site with an administrator account.
2. In the left-hand pane, select Apps > Web and mobile apps.
   
3. Click Add app then Add custom SAML app.
   
4. Enter Application Name and App Icon. Recommended application names are ClickView (for ClickView integration) or Streamable Learning (for Streamable Learning integration). Click Continue.
   
5. Choose Option 1 and Download IdP Metadata. Send the GoogleIDPMetadata.xml file to Product Support. Then click Next.
   
6. Enter the ACS URL and Entity ID according to your region, then press Continue:
   • ACS URL: https://saml-in1.clickview.us/Shibboleth.sso/SAML2/POST
   • Entity ID: https://saml-in1.clickview.us/shibboleth
     
7. In the Attribute mapping section, enter the required basic attributes, including First name, Last name, and Primary email address. You must also include an attribute for the user’s level of access (staff or student) and, if a student, their grade level. Choose only one mapping method:

Option I: Using organization unit path

In SAML attribute mapping, add the Organization unit path. Click Save.

• How do I retrieve the full path in Google Admin?
  • Sign in at https://admin.google.com with your admin account.
  • Navigate to Directory > Organizational Units.
    
  • Select the lowest level of the organization unit path.
    
  • Click the + symbol to reveal the Parent organizational unit.
    
  • Copy the full parent organizational unit and paste its value for each grade level and staff organizational unit in the SSO onboarding form.

Option II: Using Google groups

• In SAML attribute mapping, scroll to the bottom and search for the desired groups under the Group membership (optional) heading.
  
• Enter the ‘App attribute’ value as ‘Department’. Click Save.

Option III: Using Department field

1. In SAML attribute mapping, add Department 
2. Once you have chosen one of the options above, continue below.
3. Click Finish. Your SAML App is now added to your Google Workspace account.

Enable SAML app for all users

1. After the ClickView SAML App is added, open the Expand panel and change the setting from OFF for everyone to ON for everyone. Click Save. 
   
   
2. Note: This change may take up to 24 hours to apply for all users.

Submit the SSO onboarding form

Submit the required information using the SSO onboarding form.

Frequently asked questions