Documentation
Download PDF Version

3. D2L Brightspace Integration

Throughout this section of the document are the details on getting your Brightspace instance connected to eReserve Plus. It’s very important to read all of the details in section 2 of this document, and complete all of the activities in this section. Section 2 deals with the setup required on the eReserve Plus side, including the generation of the LTI Key and Secret. Should you have any questions please contact the eReserve Support Team at support@ereserve.com.au

3.1 Requirements

The eReserve Plus LTI Tool is regularly tested with the Brightspace releases supported by D2L. It is recommended that you use a D2L supported version of Brightspace however the eReserve Plus LTI Tool has been tested with earlier Brightspace versions without incident. This document covers configuration of Brightspace hosted by D2L.

3.2 LTI Advantage Access

In order to configure and manage LTI Advantage Tools you will need to configure permissions on the roles for those staff performing these tasks. When logged in as the Super Administrator you do the following for the roles that need the access:

  1. Click on Roles and Permissions in the Security section of the admin settings menu.
  2. You will be presented with a table of roles.
  3. Select the role name that you want to give admin access and manage the LTI Advantage Tools and select External Learning Tools for the Filter by Tool option.
  4. Tick the two options for LTI Advantage Tools (see screenshot below)
  5. Click Save and Close
Admin User Role Permissions
Figure 1: Admin User Role Permissions

3.3 LTI Advantage Registration

To complete the registration of your eReserve Plus instance within D2L Brightspace, please follow the detailed instructions found here: Register an External Learning Tool for LTI Advantage

Below are some samples for the population of key fields on the registration form:

  • Name Enter a name to identify the registration is for your eReserve Plus instance. (e.g. eReserve Plus Staging)

  • Domain Enter the Domain of your eReserve Plus instance. (e.g. https://eu.ereserve.com.au)

  • Redirect URLs You will need to populate the following Redirect URLs

    • Resource link Generation: https://eu.ereserve.com.au/app/integration/lti/resource_link/generate
    • Reading List View / Manage https://eu.ereserve.com.au/app/integration/lti/reading_list/launch
    • Resource Link View: https://eu.ereserve.com.au/app/integration/lti/resource_link

  • OpenID Connect Login URL You will need to populate the following URL:

    • https://eu.ereserve.com.au/app/integration/lti/login

  • Keyset URL You will need to populate the following URL:

    • https://eu.ereserve.com.au/app/integration/lti/public_jwk.json

  • Extensions Select the Deep Linking option only

  • Roles Tick Send Institution Role

Ensure that you enable the registration. You also need to take note of the Client ID, this will allow you to locate the registration within the integration records in your eReserve Plus instance.

3.4 LTI Deployment

Once the registration has been completed, Deployments and be created based on the registration. Following are the steps to creating a Deployment for eReserve Plus.

  1. Edit the created registration in Brightspace
  2. Scroll to the bottom of the page, and select View Deployments link
  3. You will be presented with a list of deployments, click on the New Deployment button
  4. The Deploy Tool form will be displayed. Complete the form as follows:
    1. Tool Select the registration (e.g. eReserve Plus Staging)
    2. Name Enter a name to identify the deployment is for your eReserve Plus instance (e.g. eReserve Plus Staging)
    3. Security Settings Tick all options except Anonymous
    4. Org Units Add the Org Units that will be using eReserve Plus
  5. Click in the Save & Close button
Creation of LTI Deploymentl
Figure 2: Creation of LTI Deployment

3.5 LTI Link Creation

Once the Deployment has been created, you will need to create links to allow access to eReserve Plus. This is completed on the links page for your deployment. To navigate to the Links page, for your deployment, use the following steps:

  1. Edit the eReserve Plus deployment in Brightspace
  2. Scroll to the bottom of the page, and click on the View Links page
  3. You will now see the Links page

Now that you are on the Links page you can create the required links. Follow these steps for each link.

List View/Management

This link can be used for the management of the list for a site when you have the role of Instructor or to simply view the list for the site when you have the role of Learner.

  1. Click on the New Link button
  2. Complete the form as follows:
    1. Name Provide a name to identify this is the List View/management tool (e.g. Resource List)
    2. URL https://eu.ereserve.com.au/app/integration/lti/reading_list/launch
    3. Type Choose the Basic Launch option
  3. Click on the Save & Close button
Creation of List View/Management Tool
Figure 3: Creation of List View/Management Tool

Resource Link Creation

This link allows Instructors to create new Resource Links in HTML Content

  1. Click on the New Link button
  2. Complete the form as follows:
    1. Name Provide a name to identify this is Resource Link creation tool (e.g. Resource Linking)
    2. URL https://eu.ereserve.com.au/app/integration/lti/resource_link/generate
    3. Type Choose the Deep Linking Insert Stuff option
  3. Click on Save & Close button
Figure 4: Creation of Resource Link Tool
Figure 4: Creation of Resource Link Tool

3.6 eReserve Plus Activation

To activate the registration record in eReserve Plus you will first need to make the List View/Management tool available in a site.

  1. Navigate to your site in Brightspace
  2. In the site content, click on the Existing Activities button
  3. Choose the External Learning Tools option
  4. Choose the List View/Management link created in the LTI Link Creation section
  5. The link will appear on the page

You are now ready to start the activation. Please note to complete this activation, you will need to have a user account in eReserve Plus with the role of Site Manager. Following are the steps for activation

  1. Click on the link you created earlier
  2. You will be asked to authorise your Brightspace instance. Click on the button provided
  3. You will be presented with the login page for your eReserve Plus instance, login with you Site Manager account.
  4. Once authenticated you will see a notification saying your Brightspace instance has been authorised to use eReserve Plus
  5. Return to Bright space then reload the page
  6. Confirm the details are correct, such as the Course Code Filter, Roles are assigned correctly etc.
  7. Click on the Activate button.

Once the above steps have been completed you can then add the List View/Management link to other sites via the Existing Activities > External Learning Tools menu item. For resource links you can use Inset Stuff.

©2024 eReserve Pty Ltd. All rights reserved.