Integrate MATLAB Grader with Other LMS

Integrate MATLAB Grader with Other LMS — LTI 1.3

To add MATLAB^® Grader™ to an LMS not listed (see Integrate MATLAB Grader with an LMS), follow the steps in this section.

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 as LMS Administrator

Sign in to your university’s learning management system (LMS) as a user with administrator privileges, specifically the ability to register a new LTI 1.3/Advantage tool.

Step 2. Create Entry for New LTI 1.3/Advantage Tool

In your LMS, go to Manage Tools and create an entry for a new LTI 1.3/Advantage tool. Check with your LMS vendor for detailed instructions on how to begin this process.

Step 3. Register LTI 1.3/Advantage Tool

When prompted by your LMS, configure MATLAB Grader using these field values. Field names may vary slightly in your LMS.

Field Name	Field Value
Tool Name	`MATLAB Grader LTI 1.3`
Tool URL / Target URL / Launch 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. Use the following values when prompted.

Field Name	Field Value
Public key type	`Keyset URL` or `Public JWK URL`
Public keyset URL or Public JWK URL	`https://learningtool.mathworks.com/lti/jwk`
Initiate login URL or OIDC Authentication URL	`https://learningtool.mathworks.com/lti/oidc`
Redirect URL or Redirect URI	`https://learningtool.mathworks.com/lti/redirect`

If prompted, set the following fields:
- Make sure that IMS LTI Assignment and Grade Services is set to YES or checked.
- To include learner names and email addresses in reports accessible to instructors:
  - Set LTI Names and Role Provisioning to YES or checked.
  - Also set 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 the options to share launcher's name and email. Save the LTI 1.3/Advantage Tool.
- If given the option, select Open in New Tab so that your LMS launches MATLAB Grader in a new tab. You should enable this setting to comply with security and accessibility requirements.

Under Privacy, if prompted, use the following options.

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 LTI Names and Role Provisioning to `YES` or checked. 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 LTI Names and Role Provisioning to `YES` or checked. 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, Use SSL, Require Secure Connections, or USE HTTPS	`YES` or checked

Save your tool configuration.

Step 4. Obtain Tool Configuration Details from Your LMS

In this step, you get configuration details so that you can register the LMS information in MATLAB Grader in the next step.

Locate the newly created entry for MATLAB Grader LTI 1.3 in your LMS. The information you see for the MATLAB Grader configuration and the specific labels of each field might be different in your LMS, but you must identify the following values.

Issuer or Platform ID
Client ID
Public Keyset URL
Access Token URL or Endpoint
OIDC Auth Request Endpoint or Authentication Request URL
Deployment ID

If you have any issues locating these values, contact the vendor for your LMS.

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 then 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, using the information that you copied in Step 4, provide the following values.
- Issuer
- Client ID
- Public Keyset URL
- Access Token URL or Endpoint
- OIDC Auth Request Endpoint
- Deployment ID
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

Common causes for a failed 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.
URLs do not use HTTPS protocol.
The LMS server is configured on a nonstandard port number. LMS 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.

If you have a nonstandard LMS installation, you might need to make some configuration changes to allow the MATLAB Grader server and your LMS 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.