Lessonly integrates with a few different SSO options to provide easy access to Lessonly when users signs in via the specified provider.

The following user management options we support and the specific requirements for each are as follow:

Google Suite - creates users the first time they try to log in to Lessonly using the Google SSO button on the login screen. This will only create the user's name and email within Lessonly. This DOES NOT update, bulk create, or archive users. 

  • To set up Google SSO with Lessonly will need is your email domain.


Custom SAML 2.0 SSO - creates users the first time they try to log in to Lessonly using the SAML 2.0 SSO button on the login screen. This will only create the user's name and email within Lessonly. This DOES NOT update, bulk create, or archive users.

What your identity provider needs:

  1. Support SAML 2.0
  2. Support passing back an email address for the users’ Name ID
  3. Support passing back the following source attributes(please map to our default names):
  • First Name (urn:oid:2.5.4.42)
  • Last Name (urn:oid:2.5.4.4)
  • Nickname – optional
  • Email address (urn:oid:0.9.2342.19200300.100.1.3)
  • User ID – anything unique to identify your users (urn:oid:1.3.6.1.4.1.5923.1.1.1.10)
  • entity ID – https://your_subdomain.lessonly.com/auth/saml/metadata

How to get it set up:

Lessonly will need a few different requirements for this integration. To set this up please follow the steps listed below:

  1. We will need your identity provider’s target URL where we will send authentication requests
  2. We will also need either your identity provider’s certificate (in PEM format) or certificate fingerprint
  3. Once we have those, our technical staff can configure Lessonly as a service provider for you
  4. Once that is done, you will be able to find your Lessonly service provider metadata at https://your_subdomain.lessonly.com/auth/saml/metadata
  5. This metadata file will contain information including the requested nameIDFormat, the service provider callback URL, the issuer name, and the SAML version.

Azure Active Directory - creates users the first time they try to log in to Lessonly using the AD Azure SSO button on the login screen. This will only create the user's name and email within Lessonly. This DOES NOT update, bulk create, or archive users.

For all SSO set-up's via ADFS, please read this article, Single Sign-On for ADFS for more detail on this particular set-up.

Important Note - auto-provisioning users into Lessonly will throw an error if user's names contain special characters. For example: !@#$%^&*()+=[]{}? 

If a user is using both SSO and the manual sign-on process if an action is triggered to expire a users password this will expire the user's password immediately. This happens when someone other than the user sets the password (admin in app, on the backend, via the API, or user sync). Passwords will not expire on their own, but if an action is taken that triggers a password to expire, the next time the user tries to login via SSO it will prompt them to create a new custom password. The user will need to set a new password, sign-in manually, and then upon their next sign-in they will be able to sign-in via SSO.

To enable these features please email support@lessonly.com or reach out to your CX manager to learn more. 

Did this answer your question?