Integrate MATLAB Grader with Canvas (Instructure) — LTI 1.3

LMS Administrators: Add MATLAB Grader to Canvas Apps

To add MATLAB^® Grader™ to Canvas^® Apps, follow the steps in this section.

Note

For all text that you copy and then paste into the integration fields, make sure there are no leading and trailing spaces in the text, otherwise the integration may 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 may 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 may 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

Step 4. Enable LTI Advantage Services

On the Developer Key configuration page, expand the section for LTI Advantage Service and set only the following services as shown:

Services selected:

• Can create and view assignment data in the gradebook associated with the tool.

• Can view assignment data in the gradebook associated with the tool.

• Can view submission data for assignments associated with the tool.

• Can create and update submission results for assignments associated with the tool.

• Can update public jwk (JSON Web Key) for LTI services.

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.

Ready For Instructor Access

The integration is now complete. Instructors can now add MATLAB Grader problems to their courses.

• If instructors have already created assessment content at https://grader.mathworks.com, they can add content by following the instructions in Add MATLAB Grader Assessment Items to LMS Course.

• Otherwise, instructors can go to https://grader.mathworks.com to set up collections (Create Collections and Groups) and start adding content (Add MATLAB Grader Assessment Items to LMS Course).

Getting 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
• Add MATLAB Grader Assessment Items to LMS Course
• Modify an Existing MATLAB Grader LTI 1.3 Deployment