This documentation describes how to connect LTI tools into Torus. There are several steps to this, including adding the tool at a system level, adding to a course, publishing the course, and then configuring it as an instructor.

MIA ADD PERUSALL INSTRUCTIONS and LTIJS

Adding Tools As an Admin

  1. Log in as an Account Admin or higher
  2. Navigate to Admin → Manage LTI 1.3 External Tools
  3. Select + Add Tool
  4. Configure the new tool. You will need all of the following information:
    1. Tool Name
    2. Tool Description
    3. Target Link URI
    4. Client ID - this is an ID that you assign, typically a string of numbers and letters, like 00001234
    5. Login URL
    6. Keyset URL
    7. Redirect URIs
    8. Custom Params - this is optional
  5. Select Add Tool

Setting Up the Tool Externally

  1. Before leaving Torus, make sure you:
    1. Copy the Client ID
    2. Navigate to the Overview page of any project, then under Advanced Activities, find the tool you just added and copy the Deployment ID.
  2. Navigate to your external tool and set up the tool with the following information. Note - change the URLs depending on what environment of Torus you are in.
    1. Issuer: https://tokamak.oli.cmu.edu
    2. Login URL: https://tokamak.oli.cmu.edu/lti/authorize_redirect
    3. Token URL: https://tokamak.oli.cmu.edu/lti/auth/token
    4. Key Set URL: https://tokamak.oli.cmu.edu/.well-known/jwks.json
  3. Enter the Client ID and Deployment ID
  4. Note: the setup for each tool varies.

Adding the Tool to a Project (Admin or Author)

  1. In Torus, navigate to the Overview page of the project, then under Advanced Activities, find the tool you just added and enable it.
  2. On a new or existing basic page, press the + to insert content, and select the tool
  3. Choose whether or not you want to tool to open in a new tab
  4. Once you’ve added the tool to your page, publish the project.

Note: You can’t launch the tool as an author