Resolve learner issues with logins, including using Single Sign-On (SSO)
Review the most common problems learners have logging into LearnUpon.
Availability: all customers
Access permissions
- all admins: can review learner login issues
- admins with full permissions: can set up SAML SSO integrations
“User not found” and “Invalid login” errors: learners can't log in
Resolve these errors by:
- confirming the portal URL is correct, typically in the format
https://yourdomain.learnupon.com - confirming the email address or username is correct, with no typos or trailing spaces
- clearing the browser cache, or trying the same login details in a private or incognito window
- checking if the learner is Pending. Some learners receive an invite link but don’t select it, and instead try to log in directly in their browser. They’re Pending because they haven’t yet accepted the invite. Forgot your password? doesn’t work because they have no password yet. Resolve with 1 of 2 options:
- learner accepts the original invite
- send a second invite with a reminder to accept the invite rather than attempting to log in
For organizations using Single Sign-On (SSO): make sure learners select Log in with SSO / Company ID, rather than entering your login details manually.
Learners don't receive password reset links
When learners forget or lose their passwords, they can typically reset them themselves through the Forgot your password? feature.
Make sure learners:
- use this feature on the correct portal or sub-portal, rather than a related portal within the same portal realm. Confirm:
- the URL of the portal they’re accessing
- the URL leads with
https://nothttp://
- enter the correct email address to request a reset link, with no typos or trailing spaces
- check their Spam, Junk or Promoted email folders for an email from
no-reply@learnupon.com, or from your organization’s custom sending address
If learners don’t receive an email within about 10 minutes:
- confirm sure your organization’s IT team allow messages from
no-reply@learnupon.com, or from your organization’s custom sending address - try the Forgot your password? request from a different IP address - for example, by turning a virtual private network (VPN) on or off, or trying from a different location
- ask another portal admin to send a reset password email
If your organization turns off self-service password resets, admins can send a password reset link to the learners' email address.
See Users: set and reset passwords
Learners get SAML SSO errors or “infinite loops” during login
Organizations use SAML SSO so learners can log into LearnUpon automatically with their existing organization credentials.
If learners cannot log in with their SSO credentials, past browser sessions may be affecting their current session. Try:
- closing all portal browser tabs, and clearing browser cookies
- logging into the identity provider dashboard such as
yourdomain.okta.com, and launching LearnUpon from your application catalog
For portals with a white-label URL: confirm with your IT team that the SSO assertion consumer service (ACS) URL matches your portal configuration.
See Set up SAML SSO for your portal
SAML/SSO authentication errors: overview
Incorrect or missing setup information causes most SAML SSO authentication errors. Use the following troubleshooting options to resolve most errors.
For full instructions, see Set up SAML SSO for your portal
Check ACS URL & Audience URI
Verify that your IdP's Single Sign-On URL is set to the correct URL, with no typos.
- From main navigation go to Settings > Integrations > Single Sign On - SAML.
- Confirm that your ACS URL matches one of the following formats:
- Standard (EU) format:
https://yourcompany.learnupon.com/saml/consumer - US data residency portal:
https://yourcompany.learnuponus.com/saml/consumer - AU data residency portal:
https://yourcompany.learnuponau.com/saml/consumer - your custom white-labelled domain URL
Confirm correct IdP SSO target URL
Check the correct IdP SSO target URL is set in your portal. This URL is provided by your identity provider.
- From main navigation go to Settings > Integrations > Single Sign On - SAML > General Settings.
- From Settings check Identity Provider Location (IDP SSO Target URL).
Verify SAML certificates
- From main navigation go to Settings > Integrations > Single Sign-On - SAML > General settings > Manage fingerprints.
- Confirm the X.509 Certificate fingerprint is active.
Check NameID attribute
Ensure the IdP assertion passes urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress containing the user's primary email. The IdP must pass the Name ID tag in the SAML assertion, for example:
<NameID Format=urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress>exampleemail@example.com</NameID>.
- From main navigation go to Settings > Integrations > Single Sign On - SAML > General Settings.
- From Settings, check Name Identifier Format.
Check JIT (Just-in-Time) provisioning
If newly added learners cannot log in, but existing learners can log in, check that Auto-create users is enabled along with default group assignments.
- From main navigation go to Settings > Integrations > Single Sign On - SAML.
- Select Users & Groups Settings.
- From User Settings, select Create Users if they do not exist in your portal on a valid assertion.
See: