Moodle LTI 1.3 - Integration with Inspera Assessment

Content

1. Moodle LTI 1.3 Integration - Overview

Learning Tools Interoperability® (LTI®) allows Moodle to connect with external learning tools such as Inspera easily and securely. The connection supports Moodle by passing information in a standards-based way to Inspera. These include the role of that user (instructor or candidate) and the course which they launched the tool from. It can create user accounts in the tool upon launch as well, acting as both a registration and single sign-on (SSO) launch in one easy workflow. Additionally, LTI Advantage / 1.3 supports returning marks from Inspera to the Moodle gradebook. 

There are two (2) steps to firstly configuring Moodle:

  1. Registering the tool (refers to the external service providing functionality) 
  2. Registering the platform (refers to the application wanting to use the functionality provided by the tool) in Moodle.

 

2. External Tool Registration and Configuration

The security model for LTI 1.3 and LTI Advantage services is based on OAuth 2.0 and OpenID Connect. This differs from previous versions of the LTI standard, which used OAuth 1.0. Practically, this means the Tool and Platform must register with one another ahead of time before activities and courses can be accessed from the platform. Registration happens only once manually, when setting up a link between the tool and a platform, and is essentially a security contract between those two respective systems.

2.1  Administrator - Configuring LTI Integration With Moodle

To configure the integration between Inspera and Moodle, you must complete the following setup within Inspera and Moodle:

This is available for Administrators in Moodle.

  1. To configure an LTI integration in Moodle, select 'Site administration' on the left panel, then select 'Plugins' and select 'External Tool'.

  1. Click 'Manage tools'

 

  1. Select 'configure a tool manually'

NOTE: There are three (3) URLs that you will need for the first time from Inspera to set up the LTI connection in your Moodle instance. They are: 

  1. key-url: a key-url typically refers to a set of public keys used for authentication and security purposes.
  2. login-init: When a user initiates a login process from LMS to an external tool using LTI 1.3, the "initiate login URL" is the endpoint where this process begins.
  3. redirect-url(s): The redirect URLs specify the URLs where LMS should redirect the user after completing the OAuth 2.0 authorization flow.

URL template

Using the URL templates above, replace {domain} with your Inspera tenancy that you will be setting up the integration against.

For example, if your Inspera tenancy has the URL, demo.inspera.com, then the URLs would be:

key-url https://demo.inspera.com/ICSXapi/metadata/PublicCertificates
login-init  https://demo.inspera.com/ltiprovider/init
redirect-url(s)  https://demo.inspera.com/ltiprovider/launch
  1. Under Tool Settings, complete the fields as follows:

    • Tool name: The name you wish to give to the external tool eg. Inspera
    • Tool URL:  Tool launch URL eg. redirect-url
      https://{domain}/ltiprovider/launch
    • Tool description: Not required but you can add a description of the tool.

    • Important: Make sure you have replaced {domain} with the URL to your Inspera tenancy.
  •  

    • Custom parameters: Add custom parameters, if any (Refer Custom Parameters)
    • Tool configuration usage: Select Show as a preconfigured tool when adding an external tool
    • Default launch container: Select either the existing window or choose the Embed, Embed without blocks, or New window if you wish to launch the activity in a new tab.
    • Supports Deep Linking: Uncheck this box, if we enable this then ‘select content’ will be available while adding an external tool
    • Content Selection URL: Leave this blank else Content Selection URL will be used to launch the content selection page from the tool provider.
  1. Under Services, select the following:
  • IMS LTI Assignment and Grade Services: Select “Use this service for grade sync and column management” to enable assignment and grade services
  • IMS LTI Names and Role Provisioning: For enabling membership service, select, “Use this service to retrieve members’ information as per privacy settings.” 
  • Tool Settings: Select “Do not use this service” so it will not allow you to save and retrieve setting values.

  1. Under Privacy, select the following:
    • Share launcher's name with the tool: Select “Always” to send the launcher’s name to Inspera
    • Share launcher's email with the tool: Select “Always” for sending the launcher’s email with Inspera
    • Accept grades from the tool: Select “Always” to accept grades from Inspera.

  1. Miscellaneous section: This section can be skipped.
  2. Click 'Save changes'.

  1. All the registered tools will be available under Manage Tools. Click on the list icon to get the details needed to be shared with Inspera for the pending configuration.

  1. Once the tool is set up, Click on the ‘Tool Configuration Details’. 
    • These 6 values must be shared with Inspera to complete the configuration.

2.2 Administrator - Configuration of Inspera Assessment

Inspera will need the following information back from Moodle. You will need to contact Inspera Support to have them make these updates for your specific Inspera tenancy.

The specific Moodle values are to be configured in Inspera to complete external tool configuration on both Moodle & Inspera.

Platform ID https://<moodle domain>/
Client ID Unique for the tool that is created and can be found as part of the initial tool registration done in Moodle
Deployment ID Unique ID (Optional)
Public keyset URL https://<moodle domain>/mod/lti/certs.php
Access token URL https://<moodle domain>/mod/lti/token.php
Authentication request URL https://<moodle domain>/mod/lti/auth.php

 

2.3 Teacher - Adding an Activity 

Once the configuration is completed on Moodle and Inspera, the teacher will create an activity.

The Moodle integration with the Inspera Assessment can be set up to allow for marks from the Inspera Assessment to be returned to the Moodle gradebook.

  1. Login to Moodle as an instructor
  2. Enable Edit mode (top right-hand corner of page)
  3. Open the Course in which you wish to create the linkage to an assessment
  4. Go into the topic for which you will add this linkage
  5. Click the Add an activity or resource link associated with that topic

    6. Click on Add an activity or resource and Choose External Tool

7. Complete the following fields:

  • Activity name: The name you wish to give to the test e.g. Art History Sem 1 Exam
  • Preconfigured tool: This is the name of the tool you created in the earlier step

8.  Click the Save and Return to course[iii] button.

9. Turn off Edit mode by selecting the switch on the top right-hand corner. Your page should look something like this:  

2.4 Teacher - Author Assessment

Log in to Moodle as an instructor.

After adding an activity in the course, the teacher will need to click on the activity named Science Exam.

The Inspera Assessment test setup will open at the Deliver tab, and you can set about configuring the appropriate settings for this test. Further instructions on this can be found in the Help Center article, Deliver overview.

 

2.5  Candidate – How to take an Inspera Assessment from Moodle

Candidates can launch into an Inspera Assessment from Moodle and undertake scheduled tests set up by an instructor.

Log in to Moodle as a candidate. 

  1. Click on the Course containing the link to your assessment, then click on the name of the assessment.

  1. candidates will be redirected to the Inspera screen to attempt the scheduled test.

The Candidate takes the test and submits their answers at the end. The candidate can then log out of Inspera Assessment.

Once the test has been graded and marks are confirmed by the grader, the candidate will be able to see their results on the candidate dashboard within the Inspera Assessment as well as in the Moodle Gradebook.

Note: To Enable Marks/Results Display in Inspera Assessment, check for an option i.e. ‘Show Final Marks or Grades on Candidate Dashboard’  in the After test settings during the assessment setup process.

3. Roles and test access rules

When the user logs in, Inspera evaluates the roles/privileges and redirects the user to the following pages.

Role/Privilege Landing-page
Planner Deliver, Monitor & Grade (Test Setup)
Chief invigilator Deliver & Monitor (Test Setup)
Invigilator Deliver & Monitor (Test Setup)
Grader Grade & Monitor
Reporter Report

E.g. If a user has the Planner and reporter role, Inspera redirects them to the delivery view since that rule is matched first.

Frequently Asked Questions (FAQs)

Question 1

What steps should I take if I encounter authentication issues during the LTI 1.3 setup?

Answer

Revalidate LTI  Configurations for both Moodle and Inspera

In Moodle, validate the tool configuration by editing the tool from the “Manage Tool” section.

Recheck the accuracy of the following fields: Tool URL, Public Keyset, Initiate Login URL & Redirection URI(s). Ensure that these details are correctly configured to ensure seamless integration and functionality

In Inspera, the Service Desk will need to ensure the below details are configured properly

 

Question 2 Can we use custom parameters in LTI 1.3 and how are they configured?
Answer Yes, Custom parameters can be used to transmit specific data or information between the tool consumer Moodle (e.g., a learning management system) and the tool provider Inspera (e.g., an external learning tool). Please refer to the Custom parameters for further details



Question 3 Why does Candidate auto provisioning not work for LTI 1.3?
Answer

Possible explanations include:

  1. Check & confirm if your LTI Version 1.3 has auto-provisioning enabled and is backward compatible
  2. Ensure that the IMS LTI Names and Role provisioning is set to option

 “Use this service to retrieve members information as per privacy settings”. 

To verify this setting using the Admin credentials, follow the steps below: 

  1. Click on Site administration on the left panel, then select Plugins & select External Tool. Click on Manage tools 

  1. Verify the setting for IMS LTI Names and Roles Provisioning 

  1. Send “enroll_candidates=true” if the membership-service is available.



Articles in this section

Was this article helpful?
0 out of 0 found this helpful