LTI 1.3 Advantage is the latest LTI specification offered by IMS Global and offers a number of improvements over LTI 1.1.  The instructions below describe how to add Harmonize to your Brightspace instance via LTI 1.3.


Important Note: Adding Harmonize to Brightspace requires an administrator role with permission to manage LTI Advantage registrations and deployments.  See this Brightspace support article for details.


Dynamic Registration

The simplest way to add Harmonize to Brightspace is by performing a dynamic registration.  If you are unable to use this feature, see the instructions for Standard Registration below.


  1. Click on the gear icon in the top right of your Brightspace screen and click on the Organization Related -> Manage Extensibility link.
  2. Select the LTI Advantage tab and click the Register Tool button.

    Brightspace Manage Extensibility LTI Advantage Tab
  3. Select the Dynamic option, enter the LTI Advantage Tool URL provided by Harmonize Support, check the Configure Deployment checkbox and click Register.

    Brightspace Manage Extensibility Register a Tool Form
  4. Back on the Manage Extensibility page, click on the Disabled filter and click on the Harmonize tool link.

    Brightspace Manage Extensibility Page Disabled Tools Filter
  5. On the Edit Tool page, click the Enabled switch and check the Send Institution Role check box and click the Save button at the bottom of the page.
    Brightspace Edit Tool Page Enabled SwitchBrightspace Edit Tool Page Send Institution Role Checkbox
  6. Click the View Deployments link at the bottom of the Edit Harmonize page.

    Brightspace Edit Tool Page View Deployments Link
  7. Click on the Harmonize link in the Deployments table.

    Brightspace External Tools Page LTI Advantage Tab
  8. On the Edit Deployment page, make the following changes and click Save:
    1. Make sure the following options in Security Settings are checked.
      1. Org Unit Information
      2. User Information and all options underneath it
      3. Link Information and all options underneath it
      4. Classlist including users not known to this deployment
    2. Ensure that the correct Org Unit has been selected for the deployment.
      1. Pay close attention to whether the selected Org Unit includes all descendants.
  9. Click on the View Links link at the bottom of the page.

    Brightspace Edit Deployment Page View Links Link
  10. Click on the Harmonize link in the Links table.

    Brightspace Links Page Harmonize Option
  11. Fill in the following fields on the Edit Link page and click Save and Close.
    1. Description -> Discussion & Classroom Tools
    2. Width -> 800
    3. Height -> 800
  12. Harmonize is now fully installed and ready to use in your courses.


Standard Registration

  1. Click on the gear icon in the top right of your Brightspace screen and click on the Organization Related -> Manage Extensibility link.
  2. Select the LTI Advantage tab and click the Register Tool button.

    Brightspace Manage Extensibility LTI Advantage Tab
  3. Select the Standard option and enter the following values provided by Harmonize Support:

    Brightspace Register a Tool Form
    1. Enabled -> True
    2. Name -> Harmonize
    3. Description -> Discussion & Classroom Tools
    4. Domain -> Enter Provider Domain value
    5. Redirect URLs -> Enter Redirect URIs value
    6. OpenID Connect Login URL -> Enter OpenID Connect Login URL value
    7. Target Link URI -> Enter Target Link URI value
    8. Keyset URL -> Enter Keyset URL value
    9. Extensions
      1. Assignment and Grade Services -> Checked
      2. Deep Linking -> Checked
      3. Names and Role Provisioning Services -> Checked
    10. Roles
      1. Send Institution Role -> Checked
    11. Substitution Parameters
      1. Add 1
        1. prevContexts = $Context.id.history
    12. Custom Parameters
      1. Add 4
        1. allow_nonassignment_selection = true
        2. timezone = $Person.address.timezone
        3. sourceUserId = $Person.sourcedId
        4. ltiGroupContextIds = $Membership.course.groupIds
  4. Click Register.
  5. In the Brightspace Registration Details dialog that appears, copy the following values and provide them to Harmonize Support:
    1. OpenID Connect Authentication Endpoint
    2. Brightspace Keyset URL
    3. Client Id
  6. Within the dialog, click on the View Deployments link.
    1. If you closed the dialog before clicking on the link, click on the gear icon in the top left and click on Organization Related -> External Learning Tools.
  7. Select the LTI Advantage tab and click on the New Deployment button.

    Brightspace External Learning Tools LTI Advantage Tab
  8. Fill in the following values on the form.

    Brightspace Deploy Tool Form
    1. Enabled -> True
    2. Tool -> Harmonize
    3. Name -> Harmonize
    4. Description -> Discussion & Classroom Tools
    5. Extensions
      1. Assignment and Grade Services -> Checked
      2. Deep Linking -> Checked
      3. Names and Role Provisioning Services -> Checked
    6. Security Settings
      1. Org Unit Information -> Checked
      2. User Information and all under -> Checked
      3. Link Information and all under -> Checked
      4. Classlist including users not known to this deployment -> Checked
    7. Make Tool Available To -> Select the Org Units you would like to make the tool available in
  9. Click Create Deployment and click View Links in the dialog that appears.
  10. Click the New Link button.

    Brightspace Tool Deployment Links Page
  11. Fill in the following values provided by Harmonize Support:

    Brightspace Create Link Form
    1. Enabled -> True
    2. Name -> Harmonize
    3. URL -> Enter Tool Provider URL value
    4. Description -> Discussion & Classroom Tools
    5. Type -> Deep Linking Quicklink
    6. Width -> 800
    7. Height -> 800
  12. Click Save and Close
  13. Harmonize is now fully installed and ready to use in your courses