Português do Brasil

Articles in this section

See more

Integrate Google Workspace SAML SSO with LearnUpon

Ben
  • Updated

Use Google Workspace as identity provider (IdP) for a seamless login for learners

Set up an integration between Google Workspace (previously G Suite) and LearnUpon.

Availability: all customers

Google Workspace is a set of cloud computing, productivity and collaboration tools, software and products developed by Google Cloud: https://workspace.google.com/ 

Google Workspace's integration provides Single Sign-On (SSO) capacity:

  • users are issued a single set of credentials with Google Workspace
  • the credentials lets users log in to many applications, including LearnUpon
  • Google Workspace keeps users' login details separate from their LearnUpon usage data

So, Google Workspace never "sees" or records what courses users take, or their course outcomes. The Google integration only provides learners access to their LearnUpon account. Adding this integration as a login option means LearnUpon admins can manage users in a centralized location.

Access permissions

  • Admins with full portal permissions: can set up the feature

The admin setting up the integration requires access to Google Workspace admin account.

Prerequisites

  • SAML SSO turned on for your portal
  • any related custom user data fields set up in LearnUpon

Note: the YYYY-MM-DD format is required for custom user data fields that contain dates. This format supports integrations for LearnUpon like SSO SAML, and services like batch user upload and API automations.

See:

Setting up LearnUpon app with Google Workspace

From your Google admin view

  1. In the menu select Apps > SAML Apps.
  2. Select Add App.
  3. Select Add custom SAML app to open the app wizard.

For App details

  1. Enter the app name.
  2. Upload an icon, if available.
  3. Select Continue.

The following screenshot shows the App details page.

screenshot_add_custom_SAML_app_to_g_suite.png

For Google Identity Provider details 

Google displays your SSO URL (1) and your Certificate along with its SHA-256 fingerprint (2). Use Google to generate a public certificate.

Copy or save the SSO URL and SHA-256 fingerprint values to a safe place for future use.

See the following screenshot for (1) and (2) as mentioned.

Untitled design (9).png

Note: LearnUpon stores finger prints in Settings > Integrations > Single Sign On SAML > General Settings. 

See Set up SAML SSO for your portal  

After copying the SSO URL and SHA-256 fingerprint values select Continue.

For Service provider details

  1. Enter ACS URL
https://yourportal.learnupon.com/saml/consumer
  1. Assign an Entity ID (required)
learnupon.com
  1. Add a Start URL (optional)
  2. Select Signed Response (required)
  3. Enter Name ID Format: EMAIL
  4. Enter Name ID: Basic information > Primary email
  5. Select Continue.

The following screenshot shows Service provider details.

screenshot_add_custom_saml_app_wizard_page.png

For Attribute Mapping

  1. Add Attributes and Fields to specify user variables included in the SAML Assertion.
  2. Select Finish.

The following screenshot shows an example of selecting fields from the Google directory and mapping them to the attributes available from LearnUpon.

screenshot_adding_attributes_to_map_to_google.png

 See: Set up SAML SSO for your portal  

Next steps with SAML SSO

See SAML SSO: send default and custom user data to LearnUpon about setting up additional customization for learners, to improve their learning experience. 

Related articles