Connecting Mursion to your LMS

Mursion integrates with LTI v1.1 and LTI v1.3 LMS platforms

We recommend creating any new SSO integration in our Staging environment first so you can test to make sure everything works properly. Once you've created the configuration in staging, you can duplicate that process in the live portal environment. 

If you do not have a staging account, contact your Client Success Manager.

Video Overview

This is an overview of the process to connect an LMS to Mursion. Note: In this demo, we're using Moodle to demonstrate, your LMS may be different. You should always review with your LMS provider or your LMS Admin. 

What is the benefit of connecting my LMS to Mursion

  • All learning content can live in one location that learners are already familiar with, integrating Mursion with their existing learning pathways
  • Learners can launch directly from the LMS, be auto-provisioned for a Mursion account, auto-assigned a team, and will launch directly into a scenario
  • If supported by the client's LMS, once the learner completes their Mursion simulation, it's marked completed in the LMS.

How do I know if my LMS is LTI v1.1 or v1.3 compliant?

Many of the most popular LMS providers are LTI v1.1 or v1.3 complaint, which makes integrating to other learning platforms or external tools more easy. Whenever possible, we recommend 1.3. You can see the list of 1.1 and 1.3 compatible LMS platforms here. You should also check with your Client Success Manager, they may have more information about your specific LMS provider.

What will I need to connect my LMS to Mursion?

Once you've confirmed that your LMS is v1.1 or v1.3 compliant, you'll need to have administrator-level access to your LMS. If your company has an LMS administrator, it's best to involve them in this process as it can be technical. 

The process below is a generic workflow because there are about a hundred LMS clients that we can integrate with, it's difficult to give exact step-by-step instructions for your LMS. We're always here to help, but your LMS likely has better support documentation for your specific integration needs. 

Connecting Mursion to an LTI v1.1 LMS Provider

If your LMS provider is able to connect to LTI v1.1 and LTI v1.3, we recommend using the LTI v1.3 protocol. It is easier to establish and provides more functionality. If you would like to connect an LTI v1.1 LMS, please contact: integrations@mursion.com, it's a bit more technical and we'll need to do it behind the scenes. 

Connecting Mursion to an LTI v.1.3 LMS Provider

What You’ll Need 

  1. An LMS account with administrator access
  2. An Account Owner profile in the Mursion Portal 
    1. Your account should also have an active project and scenario (contact your Mursion Customer Success Manager if you don’t)
  3. A blank document in a text editor like Google Docs or Notepad. You’ll need to copy and paste data between your LMS and Mursion, and it’ll come in handy.

Prepare your Mursion Account

  1. Log into Mursion Portal with your Account Owner credentials (if you don't have an Account Owner login, contact your CSM)
  2. Follow this process to create a team if your CSM hasn’t already done this for you
  3. Follow this process to import your learners if your CSM hasn’t already done this for you
    1. Take care to enter your team name in the spreadsheet so that the learners are automatically assigned to the correct team
  4. Once you have a Team full of learners:
    1. Click Teams in the Mursion Portal Navigation Bar
    2. Select your Team
    3. Locate the team ID in the URL. It’s the string of characters between teams/ and learners/
    4. Copy and Paste that string of characters into your notepad, you’ll need it later (you don’t need to copy the slashes)
  5. Your CSM should have created a Scenario for you, follow this process to find it:
    1. In the portal, click Projects
    2. Then click the scenario at the bottom of the page
    3. Click Add to add your team to the project if they’ve not already been assigned by your CSM:
    4. Locate the Scenario ID in the URL. It’s the string of characters after scenarios/
    5. Copy the Scenario ID and paste it into your notepad

  6. Now, keep your Mursion Portal tab open and click over to your LMS account in your other window and keep the copied Team ID and Scenario ID nearby, you’ll need them in the next section.

Connect your LMS with LTI v1.3

In most LMS applications, you will first need to add an LTI v1.3 “tool” or “app” in your LMS application. Refer to the help documentation of your LMS application for more details. 

To create the LTI 1.3 tool or app in your LMS application, the following are some of the primary parameters that usually need to be configured (there may be additional parameters required, depending on the LMS you are using):

On the Tool or App configuration page, configure these fields as follows:

  1. Tool name: This can be anything you want: e.g.: “Launch Mursion” 
  2. Tool URL: This is the Scenario ID from Step 5 above. Copy the Scenario ID from your notepad and paste it here. 
  3. Tool description: This can be anything you want: e.g.: “Mursion Scenario 1” 
  4. LTI Version:  LTI 1.3 
  5. Client ID: This is usually auto-populated by your LMS
  6. Public key type: Keyset URL 
  7. Public key set: Copy this URL and paste it into the Public key set field: https://portal.mursion.com/lti13/.well-known/jwks.json
  8. Initiate Login URL: This is URL is generated once your Mursion integration has been created.
    1. Note: Your Mursion Login URL will be created once you save your LMS configuration in the Mursion Portal.  You'll need to come back to your LMS and enter the URL before you use the tool or the connection will not work.
  9. Redirection URI(s): Copy this URL and paste it into this field: https://portal.mursion.com/lti13/callback/oauth/login
  10. Custom parameters: This is the Team ID from Step 4 above. 
    1. Type “team=” and then paste the Team ID from your notepad after it. 
    2. Example: team=1b51d8a3-26fc-429a-89c2-abc5e5f8be85 
  11. Tool configuration usage: Must be visible so select “Show as pre-configured tool when adding an external tool” if possible (may not be the exact phrasing)
  12. Default launch container: Select New Window if possible
  13. These services may be offered, select Do Not Use for each: 
    1. IMS LTI Assignment and Grade Services: Do not use this service
    2. IMS LTI Names and Role Provisioning: Do not use this service
    3. Tool Settings: Do not use this service
  14. These privacy features may be offered, select the following for each: 
    1. Share launcher's name with tool: Always
    2. Share launcher's email with tool: Always
    3. Accept grades from the tool: Never
  15. Save your configuration

Mursion Portal - Create your Integration Settings

  1. In the Mursion Portal, click Settings in the navigation bar
  2. Click Integrations
  3. Click Add Configurations
  4. Next, to complete the following fields, you’ll need the data from the Tool Configuration Details (step five) above:
    1. Configuration Name: This can be anything you want: e.g.: “Example Learning Module in LMS”
    2. Platform issuer Identifier: Enter in your Platform ID from your LMS’s Configuration Details
    3. Authorization Endpoint: Enter in your Authentication request URL from your LMS’s Configuration Details
    4. Token Endpoint:  Enter in your Access token URL from your LMS’s Configuration Details
    5. App Id: Enter in your client ID your LMS’s Configuration Details
    6. Public Keyset Endpoint: Enter in your Public Keyset URL from your LMS’s Configuration Details
    7. Deployment ID: Enter in your Deployment ID from your LMS’s Configuration Details
    8. Roles mapping: This is optional. We refer to users as learners, your LMS may refer to them as something else. This will help map the two together for reporting purposes.
    9. Click Create LTI Configuration to save the configuration in Mursion
  1. You should now see your configuration saved in your LMS’s integrations screen

Verifying Your LMS settings

  1. For this step, you’ll need both your LMS and your Mursion portal open
  2. In your LMS, open the settings for the external tool you just created (example image below)
  3. This will open your External tool configuration again. Leave this open and go over to your Mursion tab.
  4. In your Mursion tab, click Settings in the navigation bar
  5. Click Integrations
  6. You should see your new integration on this page
  7. Click your new integration
  8. Copy the Initiate Login URL
  9. In your LMS find the Initiate Login URL setting for your new integration and paste the URL into the Initiate Login URL field
  10. Click Save