Blackboard LTI 1.3 Tool Setup and Link Placement

System Requirements

LTI 1.3 and LTI Advantage integrations are available on SAAS Learn deployments and Learn 9.1 Q4 2019 Self and Managed hosted versions and above.

LMS Admin/Course Set Up

1. Navigate to System Admin → Integrations → LTI Tool Providers, and click Register LTI 1.3 Tool.
2. Enter the Client ID provided by your VitalSource Integration Manager and click Submit.
3. Verify and set the following information:
   • Tool Status
     • Client ID: Should be the same as the one your VitalSource Integration Manager sent you
     • Name: VitalSource LTI 1.3 Production
     • Description: VitalSource LTI 1.3 Production
     • Deployment ID: Copy this value and send to your VitalSource Integration Manager
     • Initiate Login URL: https://bc.vitalsource.com/lti1-3/blackboard/login_initiations
     • Tool Redirect URLs: https://bc.vitalsource.com/oauth2callback
   • Domains
     • bc.vitalsource.com
   • Tool Status: Approved
   • Tool Provider Custom Parameters
     • blackboard_username=@X@user.id@X@
     • blackboard_course_id=@X@course.pk_string@X@
     • blackboard_user_external_uid=@X@user.batch_uid@X@
     • blackboard_course_external_uid=@X@course.batch_uid@X@
     • blackboard_user_id=@X@user.pk_string@X@

• Institution Policies 
  • User Fields to Send
    • Role in Course
    • Name
    • Email Address
  • Allow grade service access: Yes
  • Allow Membership Service Access: Yes
• Click Submit.

Managing Link Placements

After you have set VitalSource up as an LTI 1.3 Tool, the next step is to add three placements: a global link available outside of a course, a course level link, and a deep linking placement.

Global Link Placement

1. Go to the System Admin panel.
2. Click on LTI Tool Providers and find the Tool/Provider for VitalSource (bc.vitalsource.com).
3. Click the arrow next to the provider domain and click Manage Placements.
4. Click Create Placement and enter the following:
5. Label: VitalSource Course Materials
6. Description: Global link placement
7. Handle: vitalsource
8. Availability: Yes
9. Type: 
   • System tool
10. Tool Provider URL: https://bc.vitalsource.com/materials
11. Tool Provider Custom Parameters
    • link_placement=global_navigation
12. Click Submit.

Course Menu Placement

1. Click Create Placement and enter the following:
2. Label: VitalSource Course Materials
3. Handle: vitalsource
4. Availability: Yes
5. Type: 
   • Course tool, student
6. Tool Provider URL: https://bc.vitalsource.com/materials
7. Tool Provider Custom Parameters
   • blackboard_username=@X@user.id@X@
   • blackboard_course_id=@X@course.pk_string@X@
   • blackboard_user_external_uid=@X@user.batch_uid@X@
   • blackboard_course_external_uid=@X@course.batch_uid@X@
   • blackboard_user_id=@X@user.pk_string@X@
8. Click Submit.

Deep Linking Placement

1. Click Create Placement and enter the following:
   • Label: VitalSource Content Deep Linking Tool
   • Handle: vitalsource_deeplinks
   • Availability: Yes
   • Type: 
     •  Deep Linking content tool
       • Do not select “Allow student access”
   • Tool Provider URL:
     • https://bc.vitalsource.com/adopt
   • Tool Provider Custom Parameters
     • blackboard_username=@X@user.id@X@
     • blackboard_course_id=@X@course.pk_string@X@
     • blackboard_user_external_uid=@X@user.batch_uid@X@
     • blackboard_course_external_uid=@X@course.batch_uid@X@
     • blackboard_user_id=@X@user.pk_string@X@
2. Click Submit.

Adding Tool Link to the Course Menu (Classic View)

Default Course Menu

This will allow you to add a Link Placement to the default Course Menu.

1. In the System Admin panel, click on Course Settings
2. Select Course Menu and Structures
3. Click the + on the default Course menu
4. Select Tool Link and enter the following:
   • Name: VitalSource Course Materials
   • Type: Select the link placement you created for VitalSource
   • Available to Users: Check the box
5. Click Submit

Now that you have the main tool and deep linking installed, you’re all set! Securely share the details once everything is verified.