Later you will be asked to provide a consumer key and shared secret. To generate these credentials, open a new tab or window and visit our form. Once you provide basic contact information you can generate credentials for your domain.

1. Fill in the necessary information

Your LMS Domain is just the basic web address of the campus LMS.

You should immediately be given a Consumer Key and Shared Secret. Don’t close this tab/window! You will need to copy and paste these credentials later in the process.

II. Within D2L

A. Across an Installation

1. Go to External Learning Tools

Click New Link.

2. Enter Link Properties

Title: Hypothesis

URL:

https://lms.hypothes.is/lti_launches

Under Visibility, make the link visible to users.

3. Enter Key and Secret

Under Signature select Link key/secret.

Key and Secret are specific to your installation and were acquired above in “I” from this URL:

https://lms.hypothes.is/welcome

4. Enter Security Settings

See below for needed security selections.

These parameters are necessary for the app to create private groups for courses and individual accounts for instructors and students. For more on what LTI parameters are necessary for the Hypothesis LMS app, please see this wiki.

Make the link available to whatever “Org Unit” is appropriate in your case.

5. Save and Close

B. Within a Specific Course

Same as above, but select External Tool Learning Tools within a specific course.

Using the App

1. Add Existing Activities

Select External Learning Tools

2. Select Hypothesis

Hypothesis (or whatever you’ve named the app) should appear as an option.

3. Rename the assignment

D2L automatically names the module item the name of the app, but most users will be creating multiple Hypothesis-enabled readings so you may want to rename the item something sensible, like “Hypothesis Reading 1.”

Click the carrot next to the item and select Edit Properties-in-Place.

Click into the module title window and type a new name.

4. View Topic

Click the carrot again and select View Topic.

5. Select document to be annotated

A. Enter a Public Document URL for a document

This can be a public web page or a PDF hosted at a public website. The URL is public in that it cannot require any kind of login by a user.

To be annotatable by Hypothesis, PDFs must have optically recognizable text. If you can select text in the doc, then it does.

B. Use a PDF file from Google Drive through Google Picker

Technically, this process will generate a public URL for the document. In practice, this is a secret URL that will not be shared with anyone outside your course and cannot be easily discovered.

1. Authorize a Google account

2. Select (or Upload) a file

Again, note that you can upload a PDF to Google Drive via the Google Picker workflow.

To be annotatable by Hypothesis, PDFs must have optically recognizable text. If you can select text in the doc, then it does.

[a]Some extra from one user, which was validated by another user who ran into the same problem:

""We just integrated Hypothesis into our LMS, but ran into a configuration error message of "Required parameter "tool_consumer_instance_guid" missing from LTI params" when we went clicked on the External Learning Tool link from within a course. To get it to work, I had to add it as a 'Tool Provider' in addition to having it as a 'External Learning Tool Link.'"

[b]UPDATE: working with the great Hypothes.is folks got this cleared up. Be sure to create the Tool Provider FIRST before creating the External Learning Tool Link. When we wiped it and started with a clean slate and did the TP first, it worked beautifully! Thanks!!