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

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


These instructions are meant to help MOODLE ADMINS register Torus as an LTI v1.3 external tool.
Step 3 is a link for the instructor (or the admin) to add a Torus link to a Moodle class, so Torus content can be delivered to students.

NOTE: if you integrate OLI Torus in your test environment, you will need to follow these directions again to integrate in your production environment.

ADMIN STEP 1: Configure OLI Torus as an LTI Advantage (LTI v1.3) external tool

  1. As an admin user, go to "Site administration > Plugins > Activity Modules > External Tool" and add a new LTI Advantage tool.
  2. Enter the Tool URL: https://proton.oli.cmu.edu/lti/launch
  3. Provide the following values:
  1. Tool name: OLI - Torus
  2. Tool URL: https://proton.oli.cmu.edu/lti/launch
  3. LTI version: LTI 1.3
  4. Public key type: Keyset URL
  5. Public Keyset URL: https://proton.oli.cmu.edu/.well-known/jwks.json
  6. Initiate login URL: https://proton.oli.cmu.edu/lti/login
  7. Redirect URI(s): https://proton.oli.cmu.edu/lti/launch
  8. Tool configuration usage: Show as preconfigured tool when adding an external tool
  9. Default launch container: new window
  10. Services: 
    1. IMS LTI Assignment and Grade Services: grade sync and column management
    2. IMS LTI Names and Role Provisioning: use this service
  11. Privacy:
    1. Share launcher's name with tool: Always
    2. Share launcher's email with tool: Always
    3. Accept grades from the tool: Always

    ADMIN STEP 2: Add OLI - Torus link to a class to Register Moodle with OLI

    The first time you launch Torus from a newly integrated LMS, you must register your institution. 
    Note: If you do not complete this step, the first person who launches Torus (such as instructor) will be shown the Registration screen. We recommend you do this in advance of your instructors needing to connect to Torus, because an OLI Admin must take the step of accepting your registration, which may take up to 24 hours. If you have not received approval in 24 hours, or need it more quickly, content OLI Support.
    1. In a class, click "Add an activity or resource > External tool"
    2. Enter a name, such as OLI - Torus
    3. Preconfigured tool > select OLI - Torus from list, click "Save and Display"
    4. Click "open in a new window" to reveal the following Registration form interface

    5. Fill in your institution name (full name please), your institution's URL, and the email address of your Moodle admin (or an email the Moodle team can access; this email is not published, it's just for OLI in case of emergencies).
    6. Select Moodle in the last field, and review the URLs that are prepopulated. You can leave them unchanged, and they can be revisited if any issues arise during testing. Leave "Line items service domain" empty, and click Register.
    7. OLI will review and approve your Registration request.

    STEP 3: Add OLI Torus to a Moodle class (either Admin or Instructor)

    1. Follow the steps in this linked article to add a Torus link to your Moodle course.

    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.