Updated April 9, 2021: In Spring/Summer 2021, ISKME began rolling out LTI 1.3 to microsites. Support for LTI 1.1 will be discontinued except for Schoology, and new installations of LTI 1.1 in OER Commons or microsites are no longer offered.
TABLE OF CONTENTS
- Getting Set up in D2L
- Troubleshooting and Technical Documentation
The LTI 1.1 tool allows any educator to browse and embed media objects alongside other content within assignments, or select content which comprises entire modules, lessons, or units. All users are able to search content added to OER Commons Collections. Additionally, users can also browse or search content from Group Shared Folders and personal My Items libraries, if that content has been configured and made available.
Authentication and Account Provisioning
The tool provides automated authentication and new account provisioning, providing users with an "SSO like" experience. The LTI 1.1 key/secret pair can also be configured to automatically add new users to an OER Commons Group.
LTI 1.1 Tool Preview Images
Some basic preview images of the tool have been included below.
This screenshot shows what browsing Collections looks like in the LTI 1.1 tool.
This screenshot shows what browsing My Items looks like in the LTI 1.1 tool.
This screenshot shows what browsing Group folders looks like in the LTI 1.1 tool.
Getting Set up in D2L
Get Your LTI 1.1 Credentials
Contact firstname.lastname@example.org for your LTI 1.1 credentials. If you would like to configure access to a specific OER Commons Group you have created, please specify that in your email.
Installing and Configuring the LTI 1.1 Tool in D2L
Open Course Admin
Open External Learning Tools
3. Select Manage Tool Providers
4. Select New Tool Provider
5. Configure a new LTI 1.1 tool provider
5a. Open the Credentials.txt file you received from the OER Commons admin
5b. Copy the Launch URL from the Credentials.txt file and paste it in to the “Launch Point” box
5c. Set Version to 1.1
5d. Set Oauth Signature Method to HMAC-SHA1
5e. Copy the Secret from the .txt file, and paste into the “Secret” box
5f. Check the “Use Custom Tool Consumer Information” Checkbox, copy the Key from the .txt file, and paste the Key into the Tool Providers Settings
5g. Scroll down to Security Settings. Check all the boxes shown below. *Note: The OER Commons LTI 1.1 tool will NOT work if you don’t check all of the boxes shown below.
6. Add New Link
6a. Add a Title, and Paste in the Launch URL from Credentials.txt file again
6b. Scroll Down to Key/Secret and select “Use Tool consumer key/secret” This will use the key/secret pair you already set up in your Tool Provider earlier.
6c. Scroll Down to Security Settings and Settings and select “Use tool provider security settings”
Troubleshooting and Technical Documentation
Check your Cookie Settings
- Make sure you are allowing third party cookies. We use a cookie to connect your Moodle session to your OER Commons session. If you don't allow third party cookies, we won't be able to connect your sessions and log you in.
- Make sure oercommons.org has been added to your allowed sites if you are strict about your cookie settings
Other Technical Documentation
The OER Commons LTI 1.1 Tool Provider conforms to the IMS LTI 1.1 Standard: https://www.imsglobal.org/specs/ltiv1p1/implementation-guide
We also support Content Item Message Extension, or Deep Linking: https://www.imsglobal.org/specs/lticiv1p0
The following parameters must be present in LTI 1.1 launch request sent by the LTI 1.1 tool consumer
One of the following content identification parameters:
a.) resource_link_id (alphanumeric GUID)
b.) custom_redirect_url (full URL pointing to content on the OER Commons platform, used in manual config only)
*If parameters do not conform exactly to the parameters listed above, the LTI 1.1 tool will return a missing parameter error.
If this parameter is present it will be used to redirect a user when a resource is selected in the picker interface. Otherwise, the user is redirected to the specified OER Commons content page.
If the cause of the error is known, the LTI 1.1 tool will return an error message with debugging information. The most common cause of errors is missing LTI 1.1 parameters.