Integrate MATLAB Grader with Moodle

Integrate MATLAB Grader with Moodle — LTI 1.3

To add MATLAB^® Grader™ to Moodle™ external tools, follow the steps in this section.

The version of Moodle you are using must be compatible with LTI 1.3. For information on which Moodle versions support LTI 1.3 integration, see Moodle LTI support.

Note

In each step of this procedure, make sure there are no leading or trailing spaces in the text you copy and paste from this page. Otherwise, the integration might not work.

Step 1. Sign in to Moodle as an LMS Administrator

Sign in to your university’s instance of Moodle as a user with administrator privileges, specifically one with the ability to register a new LTI 1.3/Advantage tool.

Step 2. Go to Manage Tools

In Moodle, go to Manage Tools under Site Administration > Plugins > Activity modules > External tool. The URL of this page might look similar to this example: https://sandbox.moodledemo.net/mod/lti/toolconfigure.php.

Step 3. Register a New LTI 1.3/Advantage Tool

On Manage Tools, click configure a tool manually.

On External Tool Configuration, when prompted, enter the following values.

Field Name	Field Value
Tool Name	`MATLAB Grader LTI 1.3`
Tool URL	`https://learningtool.mathworks.com/v1p3/launch`
Tool Description	`Automatically grade MATLAB code`

Change LTI version to LTI 1.3. The form updates with the new fields.

When prompted, enter the following values.

Field Name	Field Value
Public key type	`Keyset URL`
Public keyset	`https://learningtool.mathworks.com/lti/jwk`
Initiate login URL	`https://learningtool.mathworks.com/lti/oidc`
Redirect URI(s):	`https://learningtool.mathworks.com/lti/redirect`
Tool configuration usage	`Show in activity chooser and as a preconfigured tool`
Default launch container	`New Window` Enable this setting to comply with security and accessibility requirements.

Expand Services and set options to the following values.

Field Name Field Value

IMS LTI Assignment and Grade Services Use this service for grade sync and column management

Field Name	Field Value
IMS LTI Assignment and Grade Services	`Use this service for grade sync and column management`
IMS LTI Names and Role Provisioning	To include learner names and email addresses in reports accessible to instructors, set this field to `Use this service to retrieve members' information as per privacy settings`. Also set the privacy settings Share launcher’s name with tool and Share launcher’s email with tool to `Always`. To enable this setting after creating the LTI 1.3/Advantage Tool, edit the existing LTI 1.3 integration and then select this option. Save the LTI 1.3/Advantage Tool. Otherwise, you can set this field to `Do not use this service`.
Tool Settings	`Do not use this service`

IMS LTI Names and Role Provisioning

To include learner names and email addresses in reports accessible to instructors, set this field to Use this service to retrieve members' information as per privacy settings.

Also set the privacy settings Share launcher’s name with tool and Share launcher’s email with tool to Always.
To enable this setting after creating the LTI 1.3/Advantage Tool, edit the existing LTI 1.3 integration and then select this option. Save the LTI 1.3/Advantage Tool.

Otherwise, you can set this field to Do not use this service.

Tool Settings Do not use this service

Expand Privacy and set options to the following values.

Field Name	Field Value
Share launcher’s name with tool	To display learner names in instructor reports, select `Always` from the context menu. Also set IMS LTI Names and Role Provisioning to `Use this service to retrieve members' information as per privacy settings`. To enable this setting after creating the LTI 1.3/Advantage Tool, edit the existing LTI 1.3 integration and then select this option. Save the LTI 1.3/Advantage Tool. Otherwise, set this option to `Never`.
Share launcher’s email with tool	To display learner email addresses in instructor reports, select `Always` from the context menu. Also set IMS LTI Names and Role Provisioning o `Use this service to retrieve members' information as per privacy settings`. To enable this setting after creating the LTI 1.3/Advantage Tool, edit the existing LTI 1.3 integration and then select this option. Save the LTI 1.3/Advantage Tool. Otherwise, set this option to `Never`.
Accept grades from the tool	`Always`
Force SSL	Selected

Click Save Changes.

Step 4. Obtain Tool Configuration Details from Moodle

After saving your changes, you are returned to Manage Tools, where you can see the list of the tools that are currently configured in your instance of Moodle. Locate the newly created entry for MATLAB Grader LTI 1.3.

On the tool entry, click View configuration details to see information about your MATLAB Grader installation.
Copy the field values listed. You need this information in the next step.
The following example is the type of information you might see. Do not copy these specific example values.
- Platform ID: https://sandbox.moodledemo.net
- Client ID: nnzajGSuLlx6LJK
- Deployment ID: 1
- Public keyset URL: https://sandbox.moodledemo.net/mod/lti/certs.php
- Access token URL: https://sandbox.moodledemo.net/mod/lti/token.php
- Authentication request URL: https://sandbox.moodledemo.net/mod/lti/auth.php
After you have copied this information, click Cancel.

Step 5. Sign in to MATLAB Grader as an LMS Administrator

When you sign in to MATLAB Grader, use the MathWorks^® Account associated with the LMS administrator. The account holder must also be a license administrator for managing MathWorks licenses, and must have been given access to MATLAB Grader by MathWorks Customer Support or by another license administrator at your university.

Sign in at the URL https://grader.mathworks.com and click LMS Integration. Alternatively, you can access the page directly at https://grader.mathworks.com/lti_credentials.

Step 6. Register the LMS Information in MATLAB Grader

On the LMS Integration page:

Under Step 1, choose LTI Version LTI 1.3.

Under Step 3, when prompted, provide the values that you that you copied in Step 4.

Field Name	Field Value
Issuer	Use the value for Platform ID from Step 4.
Client ID	Use the value for Client ID from Step 4.
Public keyset URL	Use the value for Public keyset URL from Step 4.
Auth token endpoint:	Use the value for Access token URL from Step 4.
OIDC auth request endpoint	Use the value for Authentication request URL from Step 4.
Deployment ID	Use the value for Deployment ID from Step 4.

Click Submit.

The integration is now complete and instructors can add content from MATLAB Grader to their LMS courses.

Troubleshoot Your MATLAB Grader LMS Integration with Moodle

Common causes for a failed Moodle integration are:

URLs are protected behind a firewall or not on the public internet. These failures include SSO challenges.
No SSL certificate is provided or the SSL certificate is self signed.
The Moodle server is not sending the complete SSL certificate chain.
URLs do not use HTTPS protocol.
The Moodle server is configured on a nonstandard port number. Moodle servers can be configured behind a proxy service or port mapping at a firewall to ensure the public access to the server is always through port 443.
Your Apache^® configuration does not allow all required headers. See the article "'Authorization' header sent with request, but missing from apache_request_headers()."
MATLAB Grader does not support the submission review message in the latest version of LTI 1.3 as implemented in Moodle.
Clicking links to MATLAB Grader assignments directly from the Moodle gradebook might have unexpected results or the links might not work. Always click through to assignments from the Moodle syllabus/activity list view.

If you have a nonstandard Moodle installation, you might need to make some configuration changes to allow the MATLAB Grader server and your server to talk to each other successfully.

Get Help

If at any point in this process you require assistance integrating MATLAB Grader with your LMS using LTI 1.3, contact MathWorks Technical Support.