Aktiv Learning

Logo

View the Project on GitHub Aktiv-Learning/Aktiv-Help

Home > Guides > LMS

LMS Launch Issues FAQ

  1. Why do I launch into another user’s account?

1. Why do I launch into another user’s account?

A “user basic launch” (or simply “user launch”) is a concept within the LMS, which one clicks on a link to be navigated to the Aktiv app. In other words, the user is “launched” from the LMS into the Aktiv app.

This process involves:

  1. The LMS sends an LTI message payload to the the Aktiv backend at https://api.platform.aktiv.com/lti.
  2. The Aktiv backend inspects this message and tries to match this LMS user with an Aktiv user (if possible).
    1. It checks email addresses in the LMS user account against the email addresses in the Aktiv users collection. Particularly this attempted match is on user.email and student.schoolEmail (or instructor.schoolEmail). If there is a match, then the user is logged in automatically to Aktiv. This linkage is recorded in UserLaunch collection.
    2. Otherwise, we check for a previous launch that the Aktiv backend already matched on (if this exists). This is recorded in the UserLaunch collection (based on userLaunch.ownerId). If the user has a previous launch that the Aktiv Backend was able to match, then the user is logged in automatically.
    3. Otherwise, if there is no possible match, the user is taken to the account signup/login page, where upon signup or login, the user launch will be linked to this account. And then on subsequent launches, they will be logged in automatically now that the Aktiv Backend has a matching user launch in its system.

Now, if a user A, for some reason, is launching into a different Aktiv account (user B), it means the Aktiv Backend is matching the LMS user A with Aktiv user B. The likely reason is that the email address in LMS user A matches an email address of Aktiv user B (such as user.email or student.schoolEmail). This particularly seems to happen when a student or instructor unintentionally sets their Aktiv school email address with someone elses.

To solve this issue, two steps are needed:

  1. Remove the data mistakes in Aktiv, such as an incorrect school email. This can be done in the admin site admin.aktiv.com. Look for the “Edit User” widget.

  2. Remove the user launches in Aktiv for the affected user(s). This can also be done in the admin site admin.aktiv.com. Here you would need to remove user launches for both user A and user B. Look for the “Clear User Launches” widget.