D2L Brightspace: Integrate Torus with Brightspace, and add a link to your Brightspace class

D2L Brightspace: Integrate Torus with Brightspace, and add a link to your Brightspace class

This set of instructions is meant for BOTH the Brightspace admin and the instructor, to add OLI Torus links to a D2L Brightspace class.
Steps 1 through 4 are for the Brightspace admin to add and register Torus as an LTI external tool.
Step 5 is for the instructor (or the admin) to add a Torus link to a Brightspace 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.

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

  1. Brightspace admin clicks ADMIN TOOLS > MANAGE EXTENSIBILITY > LTI ADVANTAGE tab
  2. Click REGISTER TOOL.
  3. Select STANDARD and fill in the following fields.
    1. Enabled: YES
    2. Name (OLI Torus, for example)
    3. Domain (https://proton.oli.cmu.edu)
    4. Redirect URLs (https://proton.oli.cmu.edu/lti/launch)
    5. OpenID Connect Login URL (https://proton.oli.cmu.edu/lti/login)
    6. Target Link URI is the same as Redirect URL  (https://proton.oli.cmu.edu/lti/launch)
    7. Keyset URL (https://proton.oli.cmu.edu/.well-known/jwks.json)
    8. Extensions: Assignments and Grade Services: YES; Names and Role Provisioning Service: YES. (Deep Linking is not supported at this time, but may be supported in future versions of OLI Torus.)
    9. Roles: Send Institutional Role: YES
  4. Click the REGISTER button

STEP 2: Set up an OLI Torus deployment

  1. Immediately after registering OLI Torus Details modal will open. Click VIEW DEPLOYMENTS > NEW DEPLOYMENT
    Registration Details page that's presented after registering OLI Torus.

  2. If you've dismissed the details shown above, click ADMIN TOOLS > EXTERNAL LEARNING TOOLS > LTI ADVANTAGE tab > NEW DEPLOYMENT.
  3. In the tool dropdown select the new OLI Torus registration.
  4. Name (OLI Torus, for example)
  5. Extensions: Assignments and Grade Services: YES; Names and Role Provisioning Service: YES. 
  6. Org Unit Information: YES
  7. User Information (top level): YES
  8. Classlist including users not known to this deployment: YES
  9. Open as External Resource: YES
  10. Grades created by LTI will be included in Final Grade: YES
  11. Add Org Units to share the tool with the appropriate orgs. Typical option is "This org unit and all descendants" if applicable.
  12. Copy Deployment ID for next step.

STEP 3: Create OLI Torus external tool link

  1. Navigate to the OLI Torus deployment configuration page (ADMIN TOOLS > EXTERNAL LEARNING TOOLS > LTI ADVANTAGE tab > OLI TORUS)
  2. At bottom of page click VIEW LINKS

  3. Click NEW LINK and a new page will open
  4. Enabled: YES
  5. Give link a name, such as OLI - Torus
  6. URL: https://proton.oli.cmu.edu/lti/launch
  7. Type: BASIC LAUNCH
  8. Click SAVE AND CONTINUE

STEP 4: Register your Deployment ID with Torus

Launch OLI Torus one time to register your Deployment ID with OLI, completing the integration process. This step sends your Deployment ID and other important information to OLI to finish up the integration.
  1. Navigate to the OLI Torus deployment configuration page (ADMIN TOOLS > EXTERNAL LEARNING TOOLS > LTI ADVANTAGE tab > OLI TORUS) and copy the Deployment ID.
  2. Navigate to any Brightspace course. It can be a production course where OLI Torus will be used with students, or a test course.
  3. In the menu click CONTENT, and then click ADD A MODULE and give it a name.
  4. Click EXISTING ACTIVITIES > EXTERNAL LEARNING TOOLS
  5. In the Add Activity modal that pops up, select OLI - TORUS (look for whatever you named it in Step 3)
  6. Click your new OLI - TORUS link and a new tab should open, labeled "Welcome to Torus!" with a form named "Register Your Institution."
  7. Fill out the form and select D2L from the LTI 1.3 Configuration field, and click REGISTER
    1. Most fields will autopopulate. If there is a blank Deployment ID field, paste it. If you don't see a field, it has already been communicated to OLI behind the scenes.
    2. Leave "Line items service domain" empty
  8.  This will send a Registration request to OLI, who will approve it. If you don't hear back by the next business day, email OLI Tech Support.
  9. When the Registration request has been approved, a notification email will be sent to the address included in the registration form.
  10. Next time any OLI - Torus link is launched, it will result in the Create Course tool.


STEP 5: Add an OLI Torus link to a Brightspace class

Now that the OLI Torus integration is complete, you can add a link to your Brightspace course.
  1. Navigate to your Brightspace course.
  2. In the menu click CONTENT, and then click ADD A MODULE and give it a name.
  3. Click EXISTING ACTIVITIES > EXTERNAL LEARNING TOOLS
  4. In the Add Activity modal that pops up, select OLI - TORUS (look for whatever it was named in Step 3)
  5. Click your new OLI - TORUS link and a new tab should open to the Create Course Section tool

  6. Follow the prompts to configure a course from your desired course topic. If you don't see the expected course topic, please email OLI Tech Support so we can help.
FAQs
What if I need to unlink my course because it is the wrong course?
Contact OLI Support at oli-help@cmu.edu to unlink your course.