Integrate MATLAB Grader with Moodle — LTI 1.3
LMS Administrators: Add MATLAB Grader to Moodle External Tools
To add MATLAB® Grader™ to Moodle™ external tools, follow the steps in this section.
Note
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
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 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 may 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 Embed, without blocks
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
IMS LTI Names and Role Provisioning Do not use this service
Tool Settings Do not use this service
Expand Privacy and set the options there to the following values:
Field Name Field Value Share launcher’s name with tool Never
Share launcher’s email with tool Never
Accept grades from the tool Always
Force SSL Make sure this option is 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. Obtain Tool Configuration Details from Moodle". Some of the field names are the same and some are different.
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.
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).
Troubleshooting 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. This includes SSO challenges.
There is either no SSL certificate or the SSL certificate is self signed.
URLs must use HTTPS.
The Moodle server is configured on a non-standard 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()."
If you have a non-standard Moodle installation, you may need to make some configuration changes to allow the MATLAB Grader server and your server to talk to each other successfully.
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.