Canvas Admin: Integrate Torus so instructors can add a link to Canvas course

Canvas Admin: Integrate Torus so instructors can add a link to Canvas course

This set of instructions is meant to help a Canvas admin add and register OLI Torus as an LTI external tool.
Step 4 is for the instructor (or the admin) to add a Torus link to a Canvas class, so Torus content can be delivered to students.

NOTE: If you install OLI Torus in your Canvas sandbox, you'll need to repeat the process for your production environment; it cannot be transferred between Canvas instances.

ADMIN STEP 1: Create an LTI 1.3 Developer Key

Canvas requires elevated privileges to configure LTI 1.3 Developer Keys and Apps. Canvas administrators should have the necessary privileges. If you don't see the options mentioned belo w, you may not have proper privileges or your canvas instance may be an older version which does not support LTI 1.3. In either case, you should check with your LMS administrator.

  1. In Canvas using the left main menu, select Admin > [Admin Account Name] > Developer Keys
  2. Click + Developer Key > + LTI Key
    + developer key > + LTI key
  3. Fill in Key Name field, such as "OLI Torus"
  4. Fill in Redirect URIs field: https://proton.oli.cmu.edu/lti/launch
  5. Change Method to Enter URL and paste: https://proton.oli.cmu.edu/lti/developer_key.json
  6. Click Save button.
  7. Enable the newly created LTI Key by setting it to "ON".
  8. Copy the Client ID into a notes/text document for use in an upcoming step. It's the value found in the Details column, and will look like this.

ADMIN STEP 2: Add Torus as an External Tool link (App) in Canvas

Adding Torus as global External Tool will enable Torus to be used by any course in the LMS and will only require a single registration request.

  1. Navigate to your Canvas admin panel Admin > [account name] > Settings > Apps > +App
  2. Select Configuration Type "By Client ID" and insert the Client ID we kept from the previous steps. Click "Submit". When prompted to install the tool, select "Install".
  3. We must configure this specific deployment with Torus. To do this, we must get the Deployment ID by Selecting the "gear" menu > Deployment ID. Copy the Deployment ID into your notes/text document for an upcoming step.

ADMIN STEP 3. Securely register Canvas with OLI with registration form

Instead of sending your sensitive app values to OLI via using unsecure methods like email or chat, you can submit that information in a secure form. Add a link to a Canvas course to access the Registration form. It can be a test course or a real course where Torus is expected to be used.
  1. Navigate to your course and click Modules > + Module and add a new Module.
  2. In the module bar click the plus symbol to add an item.
  3. Select External Tool in the dropdown menu and select OLI Torus from the list.
  4. NOTE: Check the "Load in a new tab" box and click Add Item.
  5. Click the new OLI Torus Item link, then click the Load OLI Torus in a new window button to reach the Registration Form.
  6. Fill in your institution name (full name please), your institution's URL, and the email address of your Canvas admin (or an email the Canvas team can access; this email is not published, it's just for OLI in case of emergencies).
  7. Select Canvas in the last field, and review the URLs that are prepopulated. Add the Deployment ID from your noted/text document. Leave "Line items service domain" empty, and click Register.
  8. OLI will review and approve your Registration request.
  1. Follow the steps in this linked article to add a Torus link to your Canvas class.

FAQs
What if I encounter an error or cannot reach the Register Your Institution form?
Contact OLI Support at oli-help@cmu.edu to unlink your course.