Configuring Gradescope LTI 1.3 in Moodle

Configuring Gradescope LTI 1.3 in Moodle

Before you can begin configuring your LTI 1.3 integration:

• Sign up for a Gradescope account. If you don’t have an account yet, go to the Gradescope website and select Sign Up. Select the Instructor role, fill out the provided form and ensure you use the same email address you use on Moodle. You will be emailed with a link to set a password so that you are able to access your new account.
• Get integration permissions on your account, if needed. Please email us at help@gradescope.com so that we can enable the integration permissions to your account. Once you have received our confirmation that your Gradescope account has the necessary permissions, you can continue onto the first step.
• Update to the latest Moodle version. Due to Moodle ending security support for versions 3.9, 3.11, and 4.0 on December 11, 2023, Gradescope will not be able to continue to support those versions of Moodle after this time. If you are using Moodle 4.0 or earlier, please be sure to update your Moodle version before starting this configuration.

Configuration recommendations

• Have Moodle and Gradescope open in separate tabs to make the process easier because the configuration process consists of steps in both Moodle and Gradescope.
• We recommend completing the configuration process all at once. If you think it may need to be completed in stages, use your test Moodle environment.

Step One - Configuring in Moodle

1. Log into your Gradescope account that has the integration permissions enabled. It contains details that need to be copied onto your Moodle integration configuration page. 
2. Once logged in, select LTI 1.3 Integrations from the left side navigation and then select Configure Integration in the bottom right corner.

1. Select Create new registration and then choose Moodle from the drop-down menu. Two headings will appear, Gradescope and LMS Details. The details under the Gradescope heading need to be copied into Moodle. Once that has been done, Moodle will provide you with the information needed for the LMS Details section. 

1. Open a new tab in your browser and log into your Moodle administrator account. 
2. Select Site Administration and then search for Manage Tools in the search bar. Select the Manage Tools result. 
3. Inside the Add Tool box, select configure a tool manually.

   

4. From this External Tool configuration page, you can begin copying the details listed in the Gradescope page. Ensure you copy the details for the following fields:
   1. Tool URLPublic keyset 
   2. Initiate login URL
   3. Redirection URL 
   4. Ensure the LTI Version is set to LTI 1.3.
5. If your institution will be using the gradescope.ca, gradescope.eu, or gradescope.com.au instance, in the Custom parameters box add one of the following:
   1. Gradescope.eu users enter - preferred_geography=eu
   2. Gradescope.ca users enter - preferred_geography=ca
   3. Gradescope.com.au users enter - preferred_geography=ap
   4. If you are using gradescope.com, you can leave this box blank. 

1. Set Tool configuration usage to be Show in activity chooser as a preconfigured tool.
2. Set the Default launch container to either be Existing Window or New Window. 
3. Ensure the Supports Deep Linking box is ticked. 

1. From the Services drop-down, configure the settings to show:
   1. IMS LTI Assignment and Grade Services: Use this service for grades sync and column management
   2. IMS LTI Names and Role Provisioning: Use this service to retrieve members’ information as per privacy settings
   3. Tool Settings: Use this service
2. From the Privacy drop-down, configure the settings to show:
   1. Share launcher’s name with tool: Always
   2. Share launcher’s email with tool: Always
   3. Accept grades from the tool: Always
   4. Force SSL: Check

1. Select Save changes. Gradescope will now appear as an option for your instructors, but they will receive error messages until the Deployment stage in Step 3 is complete if they attempt to create Gradescope courses or assignments via the LTI links in Moodle.

Step Two - Configuring in Gradescope

1. Now that you have configured the necessary details in Moodle, you need to copy details back to Gradescope. To access the required information, return to the Manage Tools page in Moodle. 
2. Under the Tools heading, you will notice your Gradescope configuration is listed at the top. Select the View configuration details icon (depending on the version you are using, this will either be stacked lines or a magnifying glass). 

   

    
3. Copy the details provided from Moodle’s Tool configuration details modal and paste them into the LMS Details section in Gradescope. Ensure you provide details for:
   1. Platform ID
   2. Client ID
   3. Public keyset URL 
   4. Access token URL
   5. Authentication request URL
4.  Select Save on the Gradescope configuration page. 

   

Step Three - Deployment

Gradescope is now installed and will be listed within your External Apps. To complete the configuration we need to link it to your account so that it can be used by instructors and students. 

1. Access a Moodle course and select + Add an activity or resource.
2. Select External Tool.
3. Enter an activity name and select Gradescope from the Preconfigured tool drop-down. Gradescope will be listed as whatever you have named it in the External Tool configuration page. Select the Select Content button. 

1. You may be prompted to log into Gradescope if you are not already. Please ensure you are logging into the account that has had the integration permissions enabled. 
2. Enter your Branded Platform Name and select your school. This will be the name that instructors will see in Gradescope when referring to your Moodle integration. We recommend using a name that instructors will easily associate with your Moodle LMS.

1. Select Save and return to course.
2. You’re done! Your instructors are now able to link their Moodle courses to Gradescope, sync rosters, create and link assignments, and sync grades between Gradescope and Moodle. Want to know how? Check out our Moodle guidance for instructors. We also provide guidance for your students.