This article will walk through details about the SSO configuration between the LMS and Atlas, and troubleshooting tips to ensure seamless access.
How it works
When you purchased your LMS, as part of your setup, our team established the API connection between your LMS and your Atlas account. With this connection in place, it ensures that users who are already logged into Atlas and who click on a link to go to the LMS will arrive to the LMS in an already logged-in state. Alternately, if a user accesses the LMS home page but is not already logged into Atlas, clicking the login link will take them to an Atlas login screen where they will simply enter their Atlas profile account credentials, and will then be immediately redirected back to the LMS in a logged-in state.
Learners will need to have Atlas profiles
Before being able to log into the LMS, a learner must first have an Atlas profile in place, and must also log into the Atlas account at least once before trying to log in through the SSO to the LMS. This is especially important to note if you are currently using the event registration option as a means to permission groups within the LMS - the registration itself will not be enough to grant them access to the LMS, that registrant must also have a profile set up with login credentials in order to have access.
Profiles must have a few mandatory fields
To be able to successfully log into the LMS, the user's Atlas profile must always include a first name, last name, and email address. Having these pieces of information in place will ensure the user is able to access the LMS without error.
User email addresses are unique to each Atlas profile
If a user who is attempting to access the LMS is having access issues (especially an error that references information missing, such as first name, last name, email, etc) it is often because another profile in your Atlas instance is using the same email address as the user who is attempting to login. Ensuring you don't have multiple profiles using the same email address is a best practice in general, but is crucial to each profile being able to successfully login to the LMS since the email address is referenced as part of the authentication.
Profile edits should only be made within Atlas
If you need to make an update to a learner's profile, you will want to make these updates in their Atlas profile, not within the LMS. Making updates to LMS profile information will not go back into Atlas, but especially if the edits are to information such as the learner's email address, such an edit in the LMS could prohibit your learner from being able to successfully log in on their next attempt. To be safe, always make any profile edit within the Atlas system and not the LMS.