Main Content

Integrate MATLAB Grader with Moodle — LTI 1.3

To add MATLAB® Grader™ to Moodle™ external tools, follow the steps in this section.

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

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 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 might look similar to this example: https://sandbox.moodledemo.net/mod/lti/toolconfigure.php.

Step 3. Register a New LTI 1.3/Advantage Tool

  1. On Manage Tools, click configure a tool manually.

  2. On External Tool Configuration, when prompted, enter the following values.

    Field NameField Value
    Tool NameMATLAB Grader LTI 1.3
    Tool URL https://learningtool.mathworks.com/v1p3/launch
    Tool DescriptionAutomatically grade MATLAB code
  3. Change LTI version to LTI 1.3. The form updates with the new fields.

  4. When prompted, enter the following values.

    Field NameField Value
    Public key typeKeyset URL
    Public keysethttps://learningtool.mathworks.com/lti/jwk
    Initiate login URLhttps://learningtool.mathworks.com/lti/oidc
    Redirect URI(s):https://learningtool.mathworks.com/lti/redirect
    Tool configuration usageShow in activity chooser and as a preconfigured tool
    Default launch container

    New Window

    Enable this setting to comply with security and accessibility requirements.

  5. Expand Services and set options to the following values.

    Field NameField Value
    IMS LTI Assignment and Grade ServicesUse this service for grade sync and column management
    IMS LTI Names and Role Provisioning

    To include learner names and email addresses in reports accessible to instructors, set this field to Use this service to retrieve members' information as per privacy settings.

    • Also set the privacy settings 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 this option. Save the LTI 1.3/Advantage Tool.

    Otherwise, you can set this field to Do not use this service.

    Tool SettingsDo not use this service
  6. Expand Privacy and set options to the following values.

    Field NameField Value
    Share launcher’s name with tool

    To display learner names in instructor reports, select Always from the context menu.

    • Also set IMS LTI Names and Role Provisioning to Use this service to retrieve members' information as per privacy settings.

    • 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 IMS LTI Names and Role Provisioning o Use this service to retrieve members' information as per privacy settings.

    • 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 toolAlways
    Force SSLSelected
  7. 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.

  1. On the tool entry, click View configuration details to see information about your MATLAB Grader installation.

  2. 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

  3. 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:

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

  2. Under Step 3, when prompted, provide the values that you that you copied in Step 4.

    Field NameField Value
    IssuerUse the value for Platform ID from Step 4.
    Client IDUse the value for Client ID from Step 4.
    Public keyset URLUse 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 endpointUse the value for Authentication request URL from Step 4.
    Deployment IDUse the value for Deployment ID from Step 4.
  3. 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 with Moodle

Common causes for a failed Moodle 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.

  • The Moodle server is not sending the complete SSL certificate chain.

  • URLs do not use HTTPS protocol.

  • The Moodle server is configured on a nonstandard 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()."

  • MATLAB Grader does not support the submission review message in the latest version of LTI 1.3 as implemented in Moodle.

    Clicking links to MATLAB Grader assignments directly from the Moodle gradebook might have unexpected results or the links might not work. Always click through to assignments from the Moodle syllabus/activity list view.

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

Related Topics