Overview
The instructions below describe how to add Harmonize to your Moodle instance via LTI 1.3. This is the latest LTI specification offered by IMS Global and offers a number of improvements over LTI 1.1.
Important Note: Adding Harmonize to Moodle requires a System Administrator role on the Moodle instance.
Dynamic Registration
The simplest way to add Harmonize to Moodle is by performing a dynamic registration. If you are unable to use this feature, see the instructions for manual registration.
- Log into your Moodle instance as an administrator
- Navigate to Site Administration, click on the Plugins tab and click the External Tool - Manage Tools link.
- Enter the LTI Advantage Tool URL value provided by Harmonize Support into the Tool URL field and click the Add LTI Advantage button.
Note: if you only see a green button this page labeled "Add", then your version of Moodle does not support dynamic registration. Please see the instructions for manual registration.
- Click the Activate button on the Harmonize tool that is now listed on the Manage Tools page.
- Harmonize is now ready to use in your courses.
Manual Registration
- Log into your Moodle instance as an administrator.
- Navigate to Site Administration, click on the Plugins tab and click the External Tool - Manage Tools link.
- Click on the configure a tool manually link.
- Fill in the following values provided by Harmonize Support:
- Tool Settings
- Tool name - Harmonize
- Tool URL - Enter Tool URL value
- Tool description - Discussion & Classroom Tools
- LTI version - LTI 1.3
- Public key type - Keyset URL
- Public keyset - Enter Public keyset value
- Initiate login URL - Enter Initiate login URL value
- Redirection URI(s) - Enter Redirect URIs value
- Custom Parameters - Enter Custom Params values
- Supports Deep Linking (Content-Item Message) - Checked
- Content Selection URL - Enter Content Selection URL value
- Icon URL - Enter Secure Icon URL value
- Secure icon URL - Enter Secure Icon URL value
- Expand the Services menu
- IMS LTI Assignment and Grade Services - Use this service for grade sync and column management
- IMS LTI Names and Role Provisioning - Use this service to retrieve members' information as per privacy settings
- Tool Settings - Use this service
- Expand the Privacy menu
- Share launcher's name with tool - Always
- Share launcher's email with tool - Always
- Accept grades from the tool - As specified in Deep Linking definition or Delegate to Teacher
- Force SSL - Checked
- Click Save Changes.
- Back on the Manage Tools page, click on the list icon inside the Harmonize box and provide the following values to Harmonize Support:
- Access token URL
- Authentication request URL
- Public keyset URL
- Client ID
- Once Harmonize Support has added these values to your institution's Harmonize tenant, Harmonize will be ready to use in your courses.
Next Steps
Ready to use Harmonize? Our Quick Start Guide is a great place to begin.