D2L/Brightspace LTI 1.1 to 1.3 Upgrade

If your LMS currently has the VitalSource LTI 1.1 tool configured, the below steps will guide you through the process of upgrading the existing 1.1 tool to a 1.3 configuration.

LMS Admin/Course Set-Up

LTI 1.3 Tool Registration

  1. Click on the Settings icon, then click Manage Extensibility.

Manage_Extensibility.png

 

  1. Click the LTI Advantage Tab, then click Register Tool.

LTI_Advantage_-_Register_Tool.png

 

  1. Choose standard registration. 
    Screen_Shot_2022-08-09_at_2.22.53_PM.png
     
  2. Enter the following information in the Register Tool form:
    • Name: VitalSource
    • Description: VitalSource
    • Domain: https://bc.vitalsource.com
    • Redirect URLs: https://bc.vitalsource.com/oauth2callback
    • OpenId Connect Login URL: This will be given to you by your VitalSource Integration Manager
    • Target Link URI: https://bc.vitalsource.com/books 
    • Keyset URL: This will be given to you by your VitalSource Integration Manager
    • Under Extensions, choose:
      • Click "Add Substitution Parameter"
        • Name: course_start_date
        • Select $CourseSection.timeFrame.begin
      • Click "Add Substitution Parameter" again
        • Name: course_end_date
        • Select $CourseSection.timeFrame.end
  3. Once the new LTI 1.3 tool is registered, Brightspace will expose a set of configurations that are needed to complete the registration on the VitalSource side. Copy and paste this data and send it to your VitalSource Integration Manager to complete the registration and enable the integration.

d2l_tool_registration.png

Note: This data can also be seen again by clicking on the LTI Advantage Tool.

Tool Deployment 

Next, create a Deployment for the new tool that was just created, either from the Creation screen or the Edit Tool screen. 

  1. Click the New Deployment button.

New_Deployment.png

  1. Click the LTI 1.3 Tool Registration that was created in the previous step in the Tool dropdown.
  2. Enable the Auto Migrate Links toggle
  3. Ensure the following Extensions are selected:
  4. Ensure the following settings are selected/configured:
    • Org Unit Information
    • User Information
      • Name
      • Email
      • User Id
      • Username
      • Org Defined ID
    • Link Information
      • Title
      • Description
  5. Classlist including users not known to tool
    Screen_Shot_2023-04-03_at_11.07.22_AM__1_.png
  6. Configuration Settings
    • Open as External Resource - Check
    • Grades created by LTI will be included in Final Grade - Not checked
    • Auto Create Grade Items - Not checked
      image__1_.png
  7. Select "Add Org Units."
    Screen_Shot_2022-08-23_at_11.03.31_AM.png
  8. To deploy the tool, ensure the checkbox is marked for the desired org unit(s); then enable the correct radio button in the options column to add any applicable descendant org units.
    Screen_Shot_2022-08-23_at_11.00.23_AM.png
  9. After a successful Deployment creation, Brightspace will expose a unique Deployment ID. Copy and paste that value and send it to the VitalSource Integration Manager along with the LTI 1.3 Tool information created before.

deployment_tool_ID.png

Note: This value can also be seen by clicking the new Deployment in the View Deployments screen.

For steps on adding LTI 1.3 links, please refer to the documentation here.

Migrate LTI links

TI links that were created with the LTI 1.1 tool will continue to use LTI 1.1 until they are migrated to LTI 1.3. D2L/Brightspace allows the migration of existing LTI 1.1 links to LTI 1.3 on a course level. To migrate links, follow the steps below.

  1. From a course, navigate to Course Admin.

    d2l 1.png

  2. Click on External Learning Tools.

    d2l2.png

  3. Click the Manage Tool Links (Legacy) tab.

    d2l3.png

  4. Click Migrate.

    d2l4.1.png

    Note: there are other options to migrate links via API or course import/copy. More details can be found directly from D2L/Brightspace by visiting this page.  

     

    Using the VitalSource Content Deep Linking Interface

    The next step is to set up deep linking, a powerful feature of our existing LTI tooling that significantly improves course integration. Note that deep linking doesn’t require a new installation. VitalSource’s deep linking tool functions in two major capacities:

    •  Allows for the creation of LTI links directly to specific locations within eBooks delivered in Bookshelf® back into your D2L course
    • Allows for the creation of LTI links directly to specific locations within courseware delivered via our Partner Integration (SSO) with many of our publishing partners
    1. Create a VitalSource LTI 1.3 link that will initiate the deep linking flow:
    2. Click the View Links link from the View Deployments screen.
    3. Click the New Link button and enter the deep link LTI details:
      • Name: VitalSource Content Links
      • URL: https://bc.vitalsource.com/adopt
      • Description: VitalSource Content Links
      • Type: Deeplinking Quick Link
      • Width: 1200
      • Height: 800
      • Click Save and Close
    4. Navigate to the Brightspace course you want to add LTI links to.
    5. In the module, click the Existing Activities button.
    6. Click the VitalSource LTI Deeplink name, ex. VitalSource Content Links. 

    VST_Connect_Links.png

    1. This will launch the instructor to the VitalSource Content Deeplinking tool. Search for content, choose links from the Table of Contents, review the list of links, and then add them back to the course.

    Now that you have the main tool and deep linking installed, you’re all set! Before sending the credentials to the Integration Manager, please confirm that both endpoints are installed. Securely share the details once everything is verified.

 

Was this article helpful?