The OER Commons LTI 1.1 Tool is currently incompatible with Safari. We recommend using the LTI 1.1 Tool with Chrome or Firefox while we work to fix this. We apologize for the inconvenience.
Updated July 8, 2021: When ISKME begins rolling out LTI 1.3 in 2022, no new installations of LTI 1.1 (except for Schoology) will be offered, and LTI 1.1 support will be discontinued. |
TABLE OF CONTENTS
- Overview
- Getting Set up in Blackboard
- Add OER Commons LTI 1.1 tool provider
- Troubleshooting and Technical Documentation
Overview
Content Selection
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 OER Commons 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 Blackboard
Get Your LTI 1.1 Credentials
Contact info@oercommons.org for your LTI 1.1 credentials. If you would like to configure access to a specificOER Commons Group you have created, please specify that in your email.
Installing and Configuring the LTI 1.1 Tool in Blackboard
Add the OER Commons LTI 1.1 Tool Provider
On the Administrator Panel, select LTI Tool Providers.
Configure Provider Domain Status
Enter oercommons.org in the Provider Domain textbox.
Set Provider Domain Status to “Approved”
Default Configuration
Select “Set Globally”
Enter the Key and Secret you received from info@oercommons.org
Configure Institution Policies
Select “Send User Data only over SSL”
User Fields to send should include Role in Course and Email Address
*Note: If you don’t allow sending email address you will need to manually log in with a username and password every time you useOER Commons
Click “Submit”
Add the OER Commons LTI 1.1 Placement
From the LTI Tool Providers page, open the Tools menu and select “Manage Placements”
Select “Create Placement”
Configure Placement Information
Enter a Label. This is the name that appears to users in a course.
Enter a Handle. This must be a unique ID for the tool which can only contain alphanumeric, underscore, or dash characters.
Set Availability to “Yes”
Set Tool Type to “Content Type” tool
Select “Build Content (Create)”
Configure Tool Provider Information
Enter the Launch URL you received from info@oercommons.org in the Tool Provider URL input box
Enter the Key and Secret you received from info@oercommons.org
Click “Submit”
Troubleshooting and Technical Documentation
Check your Cookie Settings
Make sure you are allowing third party cookies. We use a cookie to connect your Blackboard 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
You can refer to the links below for more information about managing cookies in different browsers.
Manage Cookies in Chrome
Manage Cookies in Firefox
Manage Cookies in IE
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
Required Parameters
The following parameters must be present in LTI 1.1 launch request sent by the 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 theOER Commons platform, used in manual config only)
tool_consumer_instance_guid
role
email
userid
*If parameters do not conform exactly to the parameters listed above, the LTI 1.1 tool will return a missing parameter error.
Optional Parameters
launch_presentation_return_url
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.
Error Messages
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.