This article will walk through details about the SSO configuration between the LMS and Wild Apricot, 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 Wild Apricot account. With this connection in place, it ensures that users who are already logged into Wild Apricot 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 Wild Apricot, clicking the login link will take them to a login screen where they will simply enter their Wild Apricot profile account credentials, and will then be immediately redirected back to the LMS in a logged-in state.
Learners will need to have Wild Apricot profiles
Before being able to log into the LMS, a learner must first have a Wild Apricot profile in place, and must also log into the Wild Apricot 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 Wild Apricot 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.
Profile edits should only be made within Wild Apricot
If you need to make an update to a learner's profile, you will want to make these updates in their Wild Apricot profile, not within the LMS. Making updates to LMS profile information will not go back into Wild Apricot, 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. In addition, any groups to which the profiles have been added through the integration will always be overwritten from the Wild Apricot data, not changes made directly in the LMS. To be safe, always make any profile edit within the Wild Apricot system and not the LMS.
Permissioning Content in the LMS
In order for your Wild Apricot users to be able to use the LMS you will need to make sure the "Group" assigned to the packages matches either the Membership Level name in Wild Apricot, or the Event Registration name. In the LMS create a group that matches the name of the membership or the event registrants who should have access. Make sure the name in the LMS matches the event name or the membership level name EXACTLY as it is spelled in Wild Apricot.