How to Set Up Single-Sign-On with G-Suite

Pre-requisites include:

• Organization Administrator access to your organization’s LearnPlatform account
• GSuite Domain Administrator access through your organization
• Your organizations subdomain must be listed in LearnPlatform's setting configurations

Configuring LearnPlatform Account

1. Sign in to your LearnPlatform administrator account, click on:
   Settings > Single Sign On > Single Sign On Type > SAML 2.0 

1. Toggle on the Use organization domain for callback urls at the bottom of your Single-Sign-On page.

Configuring GSuite

In a separate window or tab, sign in to your G-Suite administrator dashboard (typically at admin.google.com).

Click Apps > Web and mobile apps > Add App (+)  From the dropdown, select: Add Custom SAML app

In the App Details window, type LearnPlatform as the App Name. Download the following image to use as the icon for your custom SAML app. Upload this image as the App Icon. After, press CONTINUE.

Copy the SSO URL, Entity ID, and Certificate from this page into the associated field in LearnPlatform's SSO setup page (see 7a, 7b, and 7c). SSO URL = Identity Provider Redirect URL in LearnPlatform Entity ID = Identity Provider Logout URL in LearnPlatform Certificate = certificate Certificate field: take special care to not include extra spaces or change the formatting of the certificate. We recommend pasting in a text processor like Notepad to remove formatting. Press CONTINUE

Back in the Google Admin Console, complete the "ACS URL” and “Entity ID” fields. These are found on the LearnPlatform’s SAML setup page. ACS URL = the first callback URL ending in “/callback/”  in LearnPlatform Entity ID = the second callback url ending in “/metadata/” in LearnPlatform Make sure you capture the backward slash (/) at the end of each of these Entity ID and ACS URL and avoid any spaces. If the URLs are not identical, your setup may not work properly.

ADD MAPPINGS in the Google Admin Console. Enter the attribute mapping fields as demonstrated in the image below (no spaces and appropriate capitalization). Press FINISH when mapping is complete Set to ‘ON for everyone’

Go back to LearnPlatform’s SAML setup page and enter the same attribute mapping fields as in your Google Admin Console. Remember to match both case and exact formatting. Press APPLY when all fields are completed.

Your final LearnPlatform SSO set up page should look similar to the image below. Hit "Apply"

Bookmark your LearnPlatform Login: [YourSubDomain].app.learnplatform.com/users/sign_in/ Your subdomain is located on LearnPlatform > Settings > Display Appearance Tile

You are all set!

Troubleshooting

If you have questions or need additional support, please take a look at Troubleshooting my Single Sign On (SSO) for SAML or email support@learnplatform.com.