TABLE OF CONTENTS



Overview

The instructions below describe how to add Harmonize to your Canvas instance via LTI 1.3. LTI 1.3 Advantage is the latest LTI specification offered by IMS Global and offers a number of improvements over LTI 1.1.  


Important Note: Adding Harmonize to Canvas via LTI 1.3 requires a Canvas Administrator user with access to the root account.


Creating Your LTI Key

  • Log into your Canvas instance as an Administrator with access to the root account.
  • Click on the Admin menu and select the root account.
  • In the navigation list, select Developer Keys.


Canvas Admin Developer Keys Page


  • Click the + Developer Key button and select + LTI Key.


Add Developer Key Menu LTI Key Option


  • Enter the following values on the Key Settings page:


  • Method -> Enter URL
  • Key Name -> Harmonize
  • Redirect URIs -> Redirect URI provided to you from Harmonize Support
  • JSON URL -> Config URL provided to you from Harmonize Support


  • Click Save.


  • On the Developer Keys page, a new row will be added named Harmonize. Copy the Client ID located in the Details column just above the Show Key button.


Canvas Developers Keys Page Details Column Client ID


  • Send the Client ID to Harmonize Support. Your Client ID must be received by the Harmonize Support team before installation can continue. 
  • Once Harmonize Support confirms your Client ID, return to your Developer Keys page.
  • Click the ON button in the Harmonize row to toggle the LTI key from Off to On.


Developer Keys Page Harmonize Row On Button



Adding Harmonize to Canvas

Now that the LTI Key has been created, Harmonize can be installed in the Canvas root account or added to sub-accounts and individual courses.


In the Canvas Root Account


Administrators can add Harmonize in the Canvas root account. Installing at the root account makes Harmonize available as an External Tool option in all your Canvas courses.


  • In the Admin section of your Canvas instance, click Settings.
  • Select the Apps tab, click on the View App Configurations button.



  • Click the + App button.



  • In the Add App window that appears, click the Configuration Type dropdown menu and select By Client ID.
  • Enter your Client ID into the Client ID field and click Submit.


Add App Dialog


  • Confirm that you want to install Harmonize.
  • Harmonize is now available as an External Tool option in all your courses.


In a Sub-Account or Course

Harmonize can instead be added to a sub-account or an individual course by any user with edit access.


  • Navigate to your course or sub-account within Canvas, then go to the Settings page.
  • Select the Apps tab, click on the View App Configurations button.



  • Click the + App button.



  • In the Add App window that appears, click the Configuration Type dropdown menu and select By Client ID.
  • Enter your Client ID into the Client ID field and click Submit.


Add App Dialog


  • Confirm that you want to install Harmonize.
  • Harmonize is now available as an External Tool option in your selected sub-account or course.






Questions? Contact Harmonize Support!

harmonize-support@42lines.n