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
- Click on the Settings icon, then click Manage Extensibility.
- Click the LTI Advantage Tab, then click Register Tool.
- Choose standard registration.
- 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
-
- For more information on endpoint options and uses, please visit the page "Which LTI Endpoint Is Right For You?"
-
- 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
- Click 'Add Substitution Parameter'
- 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.
- Click the New Deployment button.
- Click the LTI 1.3 Tool Registration that was created in the previous step in the Tool dropdown.
- Enable the Auto Migrate Links toggle
- Ensure the following Extensions are selected:
- Ensure the following settings are selected/configured:
- Org Unit Information
- User Information
- Name
- User ID
- Username
- Org Defined ID
- Link Information
- Title
- Description
- Classlist including users not known to tool
- Configuration Settings
- Open as External Resource - Tick
- Grades created by LTI will be included in Final Grade - Not ticked
- Auto Create Grade Items - Not ticked
- Select "Add Org Units".
- To deploy the tool, ensure that the tickbox 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.
- 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.
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.
- From a course, navigate to Course Admin.
- Click on External Learning Tools.
- Click the Manage Tool Links (Legacy) tab.
-
Click Migrate.
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 Deeplinking Interface
The next step is to set up deeplinking, a powerful feature of our existing LTI tooling that significantly improves course integration. Note that deeplinking doesn’t require a new installation. VitalSource’s deeplinking 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
- Create a VitalSource LTI 1.3 link that will initiate the deeplinking flow:
- Click the View Links link from the View Deployments screen.
- 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
- Navigate to the Brightspace course you want to add LTI links to.
- In the module, click the Existing Activities button.
- Click the VitalSource LTI Deeplink name, e.g. VitalSource Content Links.
- 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 deeplinking 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 has been verified.