D2L/Brightspace LTI 1.3 Tool Setup and Link Placements

Follow these instructions to enable LTI 1.3 launches in the Brightspace (D2L) LMS.  The first step is to create a new LTI 1.3 Tool Registration.  LMS Admin/Course Set-Up

LTI 1.3 Tool Registration

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

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

3. Choose standard registration.   
4. 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/materials
   • Keyset URL: This will be given to you by your VitalSource Integration Manager
   • Under Extensions, choose:
     • Assignment and Grade Services
     • Deep Linking
     • Names and Role Provisioning Service
   • Substitution Parameters
     • 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
5. 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.

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.

2. Click the LTI 1.3 Tool Registration that was created in the previous step in the Tool dropdown.
3. Ensure the following Extensions are selected:
   • Assignment and Grade Services
   • Deep Linking
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
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
7. Select "Add Org Units."

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.
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.

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

Create Links

Create Global Placement

1. Click View Links
2. Click New Link
   • Name: VitalSource Course Materials
   • URL: https://bc.vitalsource.com/materials
   • Description: Global link placement
   • Type: Basic Launch
   • Custom Parameter
     • Add Custom Parameter
     • Name: link_placement
     • Value: global_navigation
3. Click the Gear icon
4. Click Navigation & Themes
5. Click Add Links
6. Click Create Custom Link
   • Name: VitalSource Course Materials
   • URL: click Insert Quicklink > External Learning Tools > Find the link you just created
   • Click Create
7. Locate the link you just created and make sure it is checked, then click add
8. Position the new link as desired
9. Click save & close

Create Course Link

1. Click View Links from the View Deployments screen.
2. Click New Link and enter the link details. 
3. Enter the link information and select save and close.

• For more information on endpoint options and uses, please visit the page "Which LTI Endpoint Is Right For You?"

4. Once the link is created and shared at the Deployment level it is available to be added in all of the courses that the deployment was shared with above. Navigate to a course, and either choose an existing module or create a new one.
5. Click Existing Activities → External Learning Tools and click on the LTI 1.3 link created previously.

Create Deep Linking Link

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 deeplink 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. 

7. 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.