Integrate MATLAB Grader with Canvas (Instructure) — LTI 1.3

To add MATLAB^® Grader™ to Canvas^® Apps, 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 to Canvas as an LMS Administrator

Sign in to your university’s LMS instance of Canvas as a user with administrator privileges, specifically the ability to create developer keys and configure LTI apps. The URL of the login page might look like this example: https://mathworks.instructure.com/.

Step 2. Go to Developer Keys in Canvas

Go to the Developer Keys page. The URL of this page might look like this example: https://mathworks.instructure.com/accounts/1/developer_keys.

Step 3. Create a New LTI Key for MATLAB Grader

Following the Canvas instructions in How do I configure an LTI key for an account?, create a new developer key of type “LTI Key” for MATLAB Grader.

1. In the section Open Account, the account name to select is MathWorks.

2. Provide the following values when prompted:

   Field Name	Field Value
   Key Name	MATLAB Grader LTI 1.3
   Owner email	[e-mail]
   Redirect URL	https://learningtool.mathworks.com/lti/redirect
   Notes	Automatically grade MATLAB code
   Method	Manual
   Title	MATLAB Grader LTI 1.3
   Description	Automatically grade MATLAB code
   Target Link URI	https://learningtool.mathworks.com/v1p3/launch
   OpenID Connect Initiation URL	https://learningtool.mathworks.com/lti/oidc
   JWK Method	Public JWK URL
   Public JWK URL	https://learningtool.mathworks.com/lti/jwk

3. Expand Additional Settings and provide the following value when prompted:

   Field Name	Field Value
   Domain	https://learningtool.mathworks.com
   Privacy Level	Public To display learner names and emails in reports from MATLAB Grader, set the privacy level to public.

Step 4. Enable LTI Advantage Services

On the Developer Key configuration page, expand the section for LTI Advantage Services and set the services as shown in the following table:

Service	Selected
Can create and view assignment data in the gradebook associated with the tool.	Yes
Can view assignment data in the gradebook associated with the tool.	Yes
Can view submission data for assignments associated with the tool.	Yes
Can create and update submission results for assignments associated with the tool.	Yes
Can retrieve user data associated with the context the tool is installed in	To include learner names and email addresses in reports accessible to instructors, select this option. To enable this setting after creating the developer key, edit the existing LTI Key and then select this option. Save the developer key.
Can update public jwk (JSON Web Key) for LTI services.	Yes
Can lookup Account information	No
Can view Progress records associated with the context the tool is installed in	No

The following image from Canvas shows the services selected correctly.

Step 5. Create a Placement Assignment Selection

Under Placements, from the drop down menu, select Assignment Selection. Expand the new section for Assignment Selection and provide the following values:

Field Name	Field Value
Target Link URI	https://learningtool.mathworks.com/v1p3/launch
Select Message Type	Select LtiResourceLinkRequest.

If any other placements exist for Account Navigation or Link Selection, delete them from the list of placements.

Step 6. Save and Enable the Developer Key

1. On the Developer Key configuration page, click Save and return to the list of developer keys.

2. On the list of developer keys, locate the key that you just created, and toggle the State of the key from OFF to ON.

3. Confirm your selection to enable the developer key for MATLAB Grader.

Step 7. Identify the Client ID for MATLAB Grader

In the list of developer keys, identify the newly created key for MATLAB Grader, and copy the numeric client ID value (located under Details). You need this client ID in the following steps.

Step 8. Generate a Deployment ID for MATLAB Grader

1. In Canvas, go to Settings Apps.

2. Click View App Configurations.

3. When the list of enabled external apps is displayed, click + App.

4. Choose Configuration Type “By Client ID” and enter the numeric client ID value that you obtained in the previous step. Make sure there are no leading or trailing spaces in this field.

5. Click Submit. Confirm that you would like to install the MATLAB Grader LTI 1.3 app by clicking Install when prompted.

6. When the list of installed apps is displayed again, click the gear icon to the right of MATLAB Grader LTI 1.3, and then choose the option Deployment ID.

7. Copy the value for Deployment ID for MATLAB Grader LTI 1.3. You need this deployment ID in the following steps.

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

Note

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 10. Register the LMS Information In MATLAB Grader

On the LMS Integration page:

1. Under Step 1, choose LTI version LTI 1.3.

2. Under Step 3, provide the following values when prompted. These values are for production instances of Canvas. If you are using Canvas in a non production environment, see Configuring LTI Advantage Tools.

   Note

   Use only the URLs provided in the table for the Issuer, Public keyset URL, Auth token endpoint, and OIDC auth request endpoint. Do NOT use vanity or FQDN URLs.

   Field Name	Field Value
   Issuer	https://canvas.instructure.com
   Client ID	Use the client ID value that you obtained in an earlier step.
   Public keyset URL	https://sso.canvaslms.com/api/lti/security/jwks
   Auth token endpoint	https://sso.canvaslms.com/login/oauth2/token
   OIDC auth request endpoint	https://sso.canvaslms.com/api/lti/authorize_redirect
   Deployment ID	Use the deployment ID value that you obtained in an earlier step.

3. Click Submit.

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

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.

Related Topics

• Link MathWorks Account to MATLAB Grader Assessment Content
• Modify an Existing MATLAB Grader LTI 1.3 Deployment
• Add MATLAB Grader Assessment Items to LMS Course