Skip to main content

Connecting Brightspace (D2L) with LTI 1.3

A brief guide to getting started with Mindjoy's LTI 1.3 integration for Brightspace

Written by Kat Morgan

This guide connects Mindjoy to Brightspace (D2L) with LTI 1.3. A setup link from Mindjoy registers the tool for you. Brightspace then needs a deployment, and you copy that deployment's ID back into Mindjoy. Manual setup is at the end if you'd rather type the values in yourself.


​

Prerequisites

  • Administrator access to your Brightspace instance

  • Organisation admin access in Mindjoy


​

Step 1: Register Mindjoy with a setup link

1. In Mindjoy, click your organisation name at the bottom of the sidebar and choose Organization. Open the Integrations tab and click LTI. You need to be an organisation admin.

2. Click Create setup link and copy the link. It works for 15 minutes. If it runs out, click the refresh icon next to it (Make a new link) for a fresh one.

3. In Brightspace, go to Admin Tools > Manage Extensibility > LTI Advantage > Register Tool and choose Dynamic.

4. Paste the setup link into Tool initiation registration endpoint, leave Configure Deployment ticked, and click Register. Follow Brightspace's prompts to finish registering.

5. When Brightspace finishes, its window says Mindjoy is connected. Your Mindjoy page switches to the LMS connection card, which says Add the deployment ID from your LMS to finish connecting.

The setup link fills in Mindjoy's URLs and turns on deep linking, so you don't type any of them.


​

Step 2: Create a deployment in Brightspace

1. Open the Mindjoy tool in Brightspace's list of registered tools

2. Click View Deployments. If Brightspace already made a Mindjoy deployment when you registered, open it. If not, click New Deployment.

3. Check the deployment's settings:

  • Name: Mindjoy

  • Open as external resource: we generally recommend this, but Mindjoy works in an iframe too.

  • Security Settings: make sure these are on:

    • User Information

      • Name

        • First Name

        • Middle Name

        • Last Name

      • Email

      • User ID

      • Org defined ID

  • Make available to: select the org units or courses where Mindjoy should be available

Mindjoy signs people in with their email address, so Email must be on. Without it, launches stop on an Email address required page.

4. Save the deployment and copy its Deployment ID


​

Step 3: Add the Deployment ID in Mindjoy

1. On the LMS connection card in Mindjoy, click Edit details

2. Paste the ID into Deployment ID and click Save

The Configure LTI Platform dialog with the Brightspace issuer filled in and the Deployment ID field ready for the ID


​

3. The status changes to Connected with LTI 1.3


​

Step 4: Create a link

1. Open your deployment and click New link

2. Configure your link:

  • URL: the same as the launch URL, https://api.mindjoy.com/lti/launch

  • Type: Mindjoy supports:

    • Basic launch links, a simple launch via iframe or URL

    • Deep linking quick links, where teachers choose a Mindjoy tutor, lesson or pathway to add

3. Save your link


​

Testing the connection

1. Open a course in Brightspace where the deployment is available

2. Add a new External Learning Tool activity, or select the deep link you set up

3. Open the link. You should land in Mindjoy.

Mindjoy doesn't send grades back to Brightspace. Marks and feedback stay in Mindjoy. For what teachers see when they add content, see Adding Mindjoy lessons, pathways and tutors to your LMS course.


​

Set up manually instead

If you'd rather not use a setup link, register the tool by hand. Manual setup needs the Deployment ID before Mindjoy will save it.

1. In Mindjoy, open Integrations > LTI and click Set up manually. The left column, 1. Mindjoy → your LMS, has the values Brightspace needs:

Mindjoy label

Value

Domain

api.mindjoy.com

Redirect URL and target link URI

https://api.mindjoy.com/lti/launch

OpenID Connect login URL

https://api.mindjoy.com/lti/login

Keyset URL

https://api.mindjoy.com/lti/jwks

2. In Brightspace, go to Register Tool, choose Standard and enter those values. Enable deep linking and sending your institution's role, then save. Brightspace shows the values Mindjoy needs.


​

3. Create a deployment as in Step 2 and copy its ID

4. Back in Mindjoy's Manual setup dialog, fill in the right column, 2. Your LMS → Mindjoy: Issuer, Client ID, Deployment ID, Keyset URL, OpenID Connect authentication endpoint and, optionally, OAuth2 access token URL. Click Connect.

5. Create a link as in Step 4

Did this answer your question?