Integrate an LTI tool in your course project

Integrate an LTI tool in your course project

Torus is an LTI consumer, which means you can incorporate external LTI-enabled tools into your project and embed them on pages.

Register your LTI 1.3 tool with a Torus admin

1. Contact support using the ‘Support’ link in Torus or email oli-help@cmu.edu and request an LTI 1.3 tool integration. 
2. Provide the following details for your tool:
    - Tool Name
    - Tool Description
    - Target Link URI
    - Login URL
    - Keyset URL
    - Redirect URIs
    - Does tool require Deep Linking (used to select a particular tool resource)?
3. A Torus admin will configure your tool in the system for use.

Important Note: There is a current limitation in the system where tools are available for all authors to use in their course. Do not integrate a tool that uses a subscription or API credits without moderating on the tool side which sections are allowed to burn through resources.

Register Torus with your LTI 1.3 tool

Use the following details to register Torus with your LTI tool. The base domain name of the URL may be different depending on which Torus instance you intend to use
- *Name:* OLI Torus
- *Client ID:* provided by Torus admin

Create a course project and add LTI tool

1. If you have a project, start with STEP #. Otherwise go to https://proton.oli.cmu.edu/workspaces/course_author
2. Create a new project “+ Project”
3. In the project Overview click ‘+ Add Activities and Tools’
4. Select the External Tools tab
5. Select your tool and  ‘Apply Changes’
6. Note the Deployment ID under the added tool name. This might be required to configure on the tool side.
7. Go to a project Page and use the insert menu ‘+’ to insert your tool instance onto the page. Your tool can be added to as many pages as you like, each instance is treated as a separate resource in the LTI context. All instances in a project will have the same Deployment ID.
8. It is possible to launch into your tool from the authoring view if your tool supports it. The role sent will be ‘ContentDeveloper’. Grade pass back service (AGS) will be unavailable from the authoring launch
9. When finished authoring, publish your course project under ‘Publish’

Create an instructor account (if not completed yet)

Skip this step if you are using an LMS to deliver your course. The LMS will handle your account creation and all that is required is to launch into your course as an Instructor.

2. Create account and confirm email
    - Note: It is acceptable to reuse the same email used in authoring for this account, as the accounts are considered completely different domains by the system.
3. Request section creation privileges from a Torus admin by using the ‘Support’ link in Torus or emailing oli-help@cmu.edu

Create a section and configure your LTI tool

1. Link your authoring account to give your instructor account access to your authored project
    1. Using the account menu in the top right, click ‘Link Authoring Account’
    2. Login with your authoring credentials to link your account
2. With section creation privileges, go to https://proton.oli.cmu.edu/workspaces/instructor and click ‘Create Section’
3. Use the course builder wizard to create your section. Select your previously authored project as your source materials
4. Once created, you should be on the ‘Manage’ page of the section’s instructor dashboard. If not, click Manage in the page banner.
5. Click the ‘LTI 1.3 External Tools’ link to see a list of all the tools for your section. You should see your tool here.
6. Expand the tool and click the link(s) to access the pages in your course where there is a tool launch instance.
7. Depending on your tool and whether deep linking is used or not, you may need to launch into every instance to configure the tool or select a resource for each one.

    • Related Articles

    • How to Change the Course Authoring Project Title and Project Description

      In this article, you will learn how to Change the Project Title Change the Project Description Changing the Project Title and Project Description If at any reason, you feel like the title you've given your project needs to change, you can change it ...

    • Create Project Containers

      In this article, you will learn What a project container is. How to create project container. Using Project Containers Learning materials are organized using containers in Torus. Containers are identified hierarchically with project labels. This ...

    • How to Create a New Course Authoring Project in Torus

      In this article, you will learn how to create a new project in Torus. Make sure you have logged into an authoring account and not a student or educator account. For more information on authoring accounts, see: “Creating a Torus Authoring Account”. ...

    • Add a Scored Assessment to Your Torus Project

      In this article, you will learn: The function of scored assessments. How to add a scored assessment to your project. The Function of Scored Assessments OLI Torus has two page types: scored and practice. These page types have the same authoring ...

    • Create Course Sections from Authoring Projects for Website Delivery: Link Instructor Account to Authoring Account

      When creating a new section from your instructor account, if you do not see the project you are looking for, either link your instructor account to your authoring account or contact the project collaborators to gain access to create course sections. ...