Canvas LTI 1.1 to 1.3 Upgrade

Canvas LTI 1.1 to 1.3 Upgrade

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

1. In Canvas, click Admin → Developer Keys and click + Developer Key. Select the LTI Key option.
2. Enter the following to configure the tool:
   1. Key Name: VitalSource LTI 1.3
   2. Owner Email: LMS admin’s email address
   3. Redirect URI: https://bc.vitalsource.com/oauth2callback
   4. Method: Manual Entry
   5. Title: VitalSource
   6. Description: VitalSource LTI 1.3 Tool
   7.  Target Link URI:
      • This URL should match the existing VitalSource LTI 1.1 App that is currently configured. If you are unsure which endpoint to use, please refer to the 1.1 app OR reach out to your VitalSource Integration Manager.

      • https://bc.vitalsource.com/materials OR https://bc.vitalsource.com/books

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

   8. OpenID Connect Initiation URL: Your VitalSource Integration Manager will provide this.

   9. JWK Method: Select Public JWK URL and enter https://bc.vitalsource.com/ltia/security/jwks

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

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=$http://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

1. Privacy Level = Public

Placements - Currently only placements in the Course Navigation and the Link Selection are supported by VitalSource.

1. In the Placements dropdown, find “Course Navigation” and click it. Then find “Link Selection” and click it.
   • Course Navigation - link placement is enabled by default within the course navigation menu which 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.
   • Target Link URI: https://bc.vitalsource.com/books  OR https://bc.vitasource.com/materials, depending on the experience desired
     • For more information on endpoint options and uses, please visit the page "Which LTI Endpoint Is Right For You?"
   • Select Message Type: LtiResourceLinkRequest
   • Icon URL: Leave Blank
   • Text: VitalSource Course Materials
     • This is the text of the link in the course navigation.
   • Selection Height: 1200
   • Selection Width: 1200
     
     

     • • Click Save to register the VitalSource LTI 1.3 Tool.
         

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

Provide the Client ID and Deployment ID in a one-time secret link to your VitalSource Integration Manager to complete the setup.

Client ID

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.

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

Link Placement for Deep Links

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 deep linking 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 
      

      

Click save.

LTI 1.3 Tool Deployment

Copy the Client ID created in the steps above.

Navigate to Admin → Settings → Apps → View App Configurations → + App.

Select Configuration Type: By Client ID

Paste the Client ID from the Developer Key step above and click Submit.

Verify and install the VitalSource app by clicking Install.

An additional pop-up will appear. “Click Yes, Install Tool”.

Retrieve the Deployment ID for the VitalSource Tool

On the View App Configuration page, find the VitalSource tool, click the gear icon, and click Deployment ID.

Copy the Deployment ID and send both the Client ID and Deployment ID to the VitalSource integration Manager to complete the integration. 

Locate the exciting LTI 1.1 app that was created previously. Click the gear icon and select Edit. 

Ensure the Domain field has bc.vitalsource.com filled in and click Submit.