1. VitalSource Success
  2. Institutional/LMS Admins
  3. Integrate with VitalSource
  4. Canvas

Canvas LTI 1.3 Tool Setup and Link Placement

Avatar
Kristin E
Follow

Canvas LTI 1.3 Tool Setup and Link Placement

These instructions describe how to register the VitalSource LTI 1.3 tool and enable LTI 1.3 launches in the Canvas learning management system (LMS). 

Tool & Course Setup

New LTI 1.3 Developer Key

  1. In Canvas, click Admin → Developer Keys and click + Developer Key. Select the LTI Key option.

    Blur_add_LTI_Key.png

  2. Under Key Settings enter the following to configure the tool:
  • Key Name: VitalSource LTI 1.3
  • Owner Email: LMS admin’s email address
  • Redirect URI:
    • https://bc.vitalsource.com/oauth2callback
  • Configure: Manual Entry
  • Title: VitalSource
  • Description: VitalSource
  • Target Link URI: https://bc.vitalsource.com/books or https://bc.vitalsource.com/materials depending on the experience desired.
  • OpenID Connect Initiation URL: A VitalSource Integration Manager will provide this.
  • JWK Method: Select Public JWK URL and enter https://bc.vitalsource.com/ltia/security/jwks
  1.  Toggle on the following items listed under LTI Advantage Services. 
  • Can create and view assignment data in the gradebook associated with the tool.
  • Can view assignment data in the gradebook associated with the tool.
  • Can view submission data for assignments associated with the tool.
  • Can create and update submission results for assignments associated with the tool.
  • Can retrieve user data associated with the context the tool is installed in.
  • Can update public jwk for LTI services.

*To learn more about the benefits of rostering, please visit the VitalSource Rostering: Make the Most of Your Investment in Day-One Access page.

LTI_Advantage_Toggles.png

  1. Under Additional Settings
    • Domain: bc.vitalsource.com
    • Custom Fields:
      • canvas_user_id=$Canvas.user.id
      • canvas_user_login_id=$Canvas.user.loginId
      • course_start_date=$Canvas.course.startAt
      • course_end_date=$Canvas.course.endAt
      • canvas_course_id=$Canvas.course.id
      • canvas_section_id=$Canvas.course.sectionIds
      • term_start_date=$Canvas.term.startAt
      • term_name=$Canvas.term.name
      • previous_context_ids=$Canvas.course.previousContextIds
      • previous_canvas_course_ids=$Canvas.course.previousCourseIds
      • canvas_api_domain=$Canvas.api.domain
      • canvas_account_id=$Canvas.account.id

lti_1.3_tool_setup_canvas_additional_settings.png

  1. Under Privacy Level, click Public.

Managing Link Placements

  • Course Navigation - link placement is enabled by default within the course navigation menu. Using course navigation is Ideal if you are using the same link in every course. This is not recommended if you would like to launch to a specific digital product as that requires the link is edited when added to a course.

  • Link Selection - enables link placement within course modules. This is used for deeplinking to specific locations within an eBook, or if you are using certain publisher Partner Integrations, this allows deeplinking to specific locations within courseware.
  1. Placements
    • In the box under Placements, type and select Course Navigation, then Link Selection.
    • Expand the Course Navigation option and input the following values:
    • Target Link URI: https://bc.vitalsource.com/books or https://bc.vitalsource.com/materials, depending on the experience desired
    • Select Message Type: LtiResourceLinkRequest
    • Icon URL: Leave Blank
    • Text: VitalSource Course Materials
    • Selection Height: 1200
    • Selection Width: 1200Screenshot_2023-01-05_at_3.35.01_PM.png
  1. Click Save to register the VitalSource LTI 1.3 Tool.

Now that the tool has been saved, VitalSource needs some information

  1. Click the new LTI 1.3 Developer Key to On and copy the Client ID in the Details column for the newly created LTI Developer Key.

Screenshot_2022-12-08_at_10.57.07_AM.png

 

Note: The Key will not be utilized at any point during these instructions.

Screenshot_2022-12-08_at_11.06.49_AM.png


Link Placement for Deep Linking

  1. Link Selection enables link placement within course modules. This is used for deeplinking to specific locations within an eBook, or if you are using certain publisher partner Integrations. This allows deeplinking to specific locations within courseware.
      • Target Link URI: https://bc.vitalsource.com/adopt
      • Select Message Type: LtiDeepLinkingRequest
      • Icon URL: Leave Blank
      • Text: VitalSource Deep Linking Tool
      • Selection Height: 1200
      • Selection Width: 1200 

image

  1. Click save.

Using the VitalSource Deeplinking Interface

This is available to instructors or LMS admins who are enrolled in the course only.

  1. When in a Course, click the Modules link in the Course Navigation.

  2. In the Module where you’d like to add the link, click the + button.

  3. In the Add [Item Type] To: drop-down menu, select External Tool.

  4. Find the VitalSource Course Materials Adoptions tool in the list. (It should have a search magnifying glass icon next to it.)

  5. Select your current adoption or search for content by title, author or SKU (if available).
    Note: Inclusive Access courses will not have search capability

  6. Click the Link to Specific Page button for the content for which you want to create links.

  7. Select a location and click Add Materials.

  8. Click Review and Submit.

  9. Click Add to Course.

  10. Back in Canvas, review the selection and click Add Item.

Screen_Shot_2022-07-13_at_12.14.02_PM.png

 

Screen_Shot_2022-07-13_at_12.14.39_PM.png

 

LTI 1.3 Tool Deployment

  1. Copy the Client ID created in the steps above.
  2. Navigate to Admin → Settings → Apps → View App Configurations → + App.
  3. Select Configuration Type: By Client ID
  4. Paste the Client ID from the Developer Key step above and click Submit.
    Blur_External_Apps_Add_App.png

 

  1. Verify and install the VitalSource app by clicking Install.
    Blur_Add_App_client_ID.png

Retrieve the Deployment ID for the VitalSource Tool

  1. On the View App Configurations page, find the VitalSource tool, click the gear icon, and click Deployment ID.
    lti_1.3_tool_setup_canvas_copy_deployment_id.png
  2. Copy the Deployment ID and send both the Client ID and Deployment ID to the VitalSource integration Manager to complete the integration.

    Blur_Deployment_ID.png

    deeplinking fuzzy.png
  1. When in a Course, click the Modules link in the Course Navigation.
  2. In the Module where you’d like to add the link, click the + button.
  3. In the Add [Item Type] To: drop-down menu, select External Tool.
  4. Find the VitalSource external tool and review the following:
  • URL: This will pre-populate based on how the LTI External App was configured. If you are launching to a specific VitalSource digital product, you may need to edit the URL to include the VitalSource product SKU for the item you are using. Example: https://bc.vitalsource.com/books/978000000000R180.
  • Page Name: This will pre-populate based on the name of the LTI External App, but it can be edited.
  • Load in a new tab: We recommend this box is checked, but it is not required to load the VitalSource app in a new tab
  1. Click Add Item.

    Blur_Resource_LInk_Page.png

Note: If you are interested in deeplinking into an Explore collection via your LMS, please complete the steps outlined above then visit our Deeplinking into an Explore Collection page for more instructions.

Canvas Documentation

Registering a new LTI 1.3 Tool: https://community.canvaslms.com/docs/DOC-16729-42141110178

Deploying a LTI 1.3 Tool: https://community.canvaslms.com/docs/DOC-16730-42141110273

Was this article helpful?