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.
In the section Open Account, the account name to select is MathWorks.
Provide the following values when prompted:
Field Name Field Value Key Name MATLAB Grader LTI 1.3
Owner email support@mathworks.com
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
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
On the Developer Key configuration page, click Save and return to the list of developer keys.
On the list of developer keys, locate the key that you just created, and toggle the State of the key from OFF to ON.
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
In Canvas, go to Settings Apps.
Click View App Configurations.
When the list of enabled external apps is displayed, click + App.
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.
Click Submit. Confirm that you would like to install the MATLAB Grader LTI 1.3 app by clicking Install when prompted.
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.
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:
Under Step 1, choose LTI version
LTI 1.3
.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.
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.