1. Home
  2. Knowledge Base
  3. Learning Management Systems
  4. Installing in the LMS
  5. Installing Hypothesis in Moodle – LTI 1.3 (Canada)
  1. Home
  2. Knowledge Base
  3. Learning Management Systems
  4. Moodle
  5. Installing Hypothesis in Moodle – LTI 1.3 (Canada)

Installing Hypothesis in Moodle – LTI 1.3 (Canada)

🇨🇦 Canada Only Guide

This guide is only for Canadian schools who need to comply with Canadian data residency requirements. To view the worldwide version of this guide click here.

Who is this guide for?

  • New or existing Hypothesis customers. If you are not yet a customer, please reach out to us here to talk with a member of Education team about using Hypothesis at your school.
  • People with administrator-level access to their institution’s Moodle instance

Upgrading an existing Hypothesis LTI 1.1 installation

If you are installing Hypothesis for the first time you can skip this section and begin at Create the Hypothesis external tool.

Moodle allows you to upgrade the existing Hypothesis LTI 1.1 tool to LTI 1.3 directly, without needing to install a new instance of the tool. To ensure that previous Hypothesis assignments made with the old tool continue to work properly, we need to know the LTI 1.1 consumer key of the previous Hypothesis tool.

Follow the steps below to copy the LTI 1.1 consumer key, and then upgrade the existing Hypothesis tool.

1. Open the “Site Administration” page, and in the “Search” field type “manage tools” and hit enter

Under Search results click the Manage tools link.

Note that the typical path to the Manage tools page will be Administration / Plugins / Activity modules / External tool / Manage tools though some Moodle sites may be configured differently.

2. From the “Manage tools” page, locate the exiting Hypothesis tool card and click the gear button in the upper-right to edit the tool’s configuration

Location of gear (edit) button on the Hypothesis tool card

3. Under “Tool settings” locate the “Consumer key” and copy its value to a temporary note or text file

Location of LTI 1.1 consumer key

You will need to refer to this value later in the upgrade process.

4. Click the drop-down menu for “LTI version” and change the value from “LTI 1.0/1.1” to “LTI 1.3”

Location of LTI version drop-down menu

5. You may now skip to step 3 in the “Create the Hypothesis external tool” section of this guide below and continue entering the remaining configuration values as directed

Create the Hypothesis external tool

1. Open the “Site Administration” page, and in the “Search” field type “manage tools” and hit enter

Under Search results click the Manage tools link.

Note that the typical path to the Manage tools page will be Administration / Plugins / Activity modules / External tool / Manage tools though some Moodle sites may be configured differently.

Location of link to configure a tool manually

3. Fill out the “External tool configuration” page (start here if you are upgrading an existing LTI 1.1 version of the tool)

Under Tool Setting enter the following:

  • Tool Name:
    • Hypothesis
  • Tool URL:
    • https://lms.ca.hypothes.is/lti_launches
  • LTI version:
    • LTI 1.3
  • Public key type:
    • Keyset URL
  • Public keyset:
    • https://lms.ca.hypothes.is/lti/1.3/jwks
  • Initiate login URL:
    • https://lms.ca.hypothes.is/lti/1.3/oidc
  • Redirection URI(s):
    • https://lms.ca.hypothes.is/lti/1.3/oidc
      https://lms.ca.hypothes.is/lti_launches
  • Custom parameters:
    • ResourceLink.title=$ResourceLink.title
      ResourceLink.description=$ResourceLink.description
      ResourceLink.available.startDateTime=$ResourceLink.available.startDateTime
      ResourceLink.submission.endDateTime=$ResourceLink.submission.endDateTime
      ResourceLink.id.history=$ResourceLink.id.history
      Context.id.history=$Context.id.history
  • Tool configuration usage:
    • Show as preconfigured tool when adding an external tool
  • Default launch container:
    • New window
  • (Hidden behind Show more…) Secure icon URL:
    • https://d242fdlp0qlcia.cloudfront.net/uploads/brand/HypothesisBlackboardIcon.png

Tool settings with all values shown filled in

Under Services enter the following:

  • IMS LTI Assignment and Grade Services:
    • Use this service for grade sync only
  • IMS LTI Names and Role Provisioning:
    • Do not use this service
  • Tool Settings:
    • Do not use this service

Privacy section with values configured

Under Privacy enter the following:

  • Share launcher’s name with tool:
    • Always
  • Share launcher’s email with tool:
    • Always
  • Accept grades from the tool:
    • As specified in Deep Linking definition or Delegate to teacher
  • ✓ Force SSL

Privacy section with values configured

Leave the Miscellaneous section unchanged.

Click the Save changes button to save.

Submit LTI details to Hypothesis to complete registration

1. From the “Manage tools” page, locate the Hypothesis tool and click the “View configuration details” button in the upper right

Location of View configuration details button on the Hypothesis tool card

2. In the “Tool configuration details” window, note the “Platform ID”, “Client ID”, and “Deployment ID” values

Tool configuration details window with location of Platform ID, Client ID, and Deployment ID values noted

You will need to copy each of these values into our registration form during the steps below.

3. In a new browser tab, open our LTI 1.3 / Advantage Registration form

Image of form to submit an LTI 1.3 Advantage installation

4. If you are upgrading an existing LTI 1.1 Hypothesis tool, check the box “Migrate from existing LTI 1.1?” and paste the previous LTI 1.1 consumer key into the text box

Section of LTI 1.3 Registration form with Migrate from existing LTI 1.1? checked and previous consumer key pasted

5. Enter the following values into the form as shown

  • Email
    • Your email address, or another address that you want associated with this registration
  • LMS URL
    • Enter the Platform ID value copied from the Tool configuration details window above
  • LMS
    • Select Moodle from the drop-down menu
  • Client ID
    • Enter the Client ID value copied from the Tool configuration details window above
  • Deployment ID
    • Enter the Deployment ID value copied from the Tool configuration details window above

5. Click the “Submit” button to send your LTI info to Hypothesis

We will email the address you provided above when your registration has been processed and Hypothesis is ready to be used. We can’t wait to have you annotating!

Important note: Hypothesis will not be available to use in courses until you have received confirmation that we have processed your LTI instance.

Was this article helpful?

Related Articles

Ask a Question

Send us a support ticket to get more help.
Create a Ticket

Contents