Outdated Method This guide explains how to connect D2L Brightspace to GMetrix using Learning Tools Interoperability (LTI) 1.1. LTI 1.1 is an older connection standard. Do not use this method if your D2L Brightspace instance supports LTI Advantage (LTI 1.3). Use the D2L Brightspace LTI 1.3 setup guide instead.
Check which standard you're using Your D2L Brightspace instance supports LTI 1.3 if you see "LTI Advantage" or are asked for any of the following: • Client ID • Registration URL • OIDC URL Even if your version of D2L Brightspace supports both versions of LTI, we recommend LTI Advantage (LTI 1.3). It's easier to manage and more secure.
Use Legacy LTI 1.1 to open GMetrix from D2L Brightspace when LTI 1.3 is unavailable. An administrator configures GMetrix once as a Tool Provider. Instructors can then add a separate External Learning Tool link for each GMetrix Course or Practice Exam.
Contact GMetrix Support before continuing with a self-hosted, district-wide, multi-school, or other complex implementation.
Before You Begin
Keep D2L Brightspace and the GMetrix Administrator Portal open in separate browser tabs while you follow this guide.
Make sure you have access to the GMetrix Administrator Portal.
Make sure you have D2L Brightspace administrator permission to configure external tools for the intended account.
Do not share the Consumer Key or Shared Secret in email, screenshots, or course content.
Choose Where to Start
Configure the provider: Complete Part 1 when GMetrix is not listed under Manage Tool Providers.
Create a resource link: Skip to Part 2 when the provider exists but the required GMetrix resource link does not.
Add an existing link to a course: Skip to Part 3 when the resource link already exists.
Part 1: Configure the GMetrix Tool Provider
A Brightspace administrator completes this part only once for the intended organization or org-unit scope.
In D2L Brightspace
From the Admin Tools menu, select External Learning Tools.
Select Manage Tool Providers.
Confirm that a GMetrix Tool Provider is not already available for the intended scope.
Select New Tool Provider.
Enter the GMetrix Launch Point without http:// or https://.
Select LTI 1.1 from the Version list.
Select the OAuth Signature Method listed in GMetrix.
In GMetrix: Copy the Connection Values
In the GMetrix Administrator Portal, select Integrations from the sidebar.
Locate the LTI 1.1 section.
Switching between GMetrix and D2L Brightspace, copy and paste the GMetrix LTI 1.1 credentials into their corresponding D2L Brightspace fields.
In D2L Brightspace: Install the General App
Paste the GMetrix Shared Secret into Secret.
Select Use custom tool consumer information instead of default.
Paste the GMetrix Consumer Key into Key.
Select Send system username to tool provider under Security Settings.
Select Send user email to tool provider under Security Settings.
Select Save.
Make the provider available to the intended organization or org units.
Save the availability settings.
OAuth signature method
Brightspace defaults to HMAC-SHA256, but an unmatched legacy link can use HMAC-SHA1. Use the method shown in GMetrix. If GMetrix does not list a method, contact GMetrix Support before saving the provider.
Part 2: Create a GMetrix Resource Link
Complete this part once for each GMetrix Course or Practice Exam. Do not configure another Tool Provider.In D2L Brightspace
From the Admin Tools menu, select External Learning Tools.
Select Manage External Learning Tool Links.
Select New Link.
Enter a title that identifies the GMetrix resource.
In GMetrix: Copy the Connection Values
In the GMetrix Administrator Portal, select Integrations from the sidebar.
Locate the LTI 1.1 section.
Copy the Launch URL.
In D2L Brightspace
Paste the complete GMetrix Launch URL into URL.
Select Allow users to view this link.
In GMetrix
In the GMetrix Administrator Portal, select Integrations from the sidebar.
Locate the Link a Specific Resource section.
Use the Look up buttons to find the specific resource key and access code for the resource you want to add.
Enter the resource key and access code as shown in the next steps.
In D2L Brightspace
Select the option to use the Tool Provider key and secret.
Add accesscode in the first custom parameter Name field.
Paste the GMetrix access code into the matching Value field.
Add gmxresourcekey in the second custom parameter Name field.
Paste the GMetrix resource key into the matching Value field.
Select Use tool provider security settings.
Select Save and Close.
Part 3: Add the Resource Link to a Course
Start here when the resource-specific link already exists.
In D2L Brightspace
Open the intended course.
From the navbar, select Content.
Open the module where the GMetrix resource should appear.
Select Existing Activities or Add Existing.
Select External Learning Tools or External Tool Activity.
Select the resource-specific GMetrix link from the list.
Make the item visible when it is ready for learners.
Confirm the Resource
From the Admin Tools menu, select External Learning Tools.
Select Manage External Learning Tool Links.
Open the menu for the resource-specific GMetrix link.
Select Preview.
Confirm that the intended GMetrix resource opens.
After Setup
Single sign-on (SSO)
The LTI connection signs learners in when they open GMetrix from D2L Brightspace.
Grade Passback
Supported Practice Exam scores can return to D2L Brightspace when the LMS item is configured for grading.
Resource management
Reuse the provider or app that is already configured. Add another resource-level link, activity, material, or app only when you need a different GMetrix resource.
Skills Management System (SMS)
Learners must install the desktop application for in-app tests. The macOS version is called SMSe. AutoCAD and Microsoft Office tests require SMS for Windows.