Overview

The GoOpenNC LTI tool allows educators to embed GoOpenNC content within any Learning Management System that supports LTI 1 or 1.1. It has currently been fully tested for Quality Assurance in Canvas, Moodle, Blackboard,  and Schoology.

Content Selection

The LTI 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 GoOpenNC Collections. Additionally, users can also able to 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 key/secret pair can also be configured to automatically add new users to an GoOpenNC Group. 

LTI Tool Preview Images

Some basic preview images of the tool have been included below. More details about using the LTI tool are available in the "Using the LTI tool" section of this guide. 

This is a screenshot showing what searching an GoOpenNC Collection looks like in the LTI tool.

This is a screenshot showing what browsing My Items looks like in the LTI tool.

 

This is a screenshot showing what browsing Group folders looks like in the LTI tool.

 

Getting Set up in your LMS

Default Canvas LTI Credentials 


If you would like to configure access to a specific GoOpenNC Group you have created, please specify that in an email to GoOpenNC@oercommons.org before continuing with these directions!

Installing and Configuring the App in Canvas

  1. Navigate to the "Apps" section on your Canvas Course

     
  2. Click "View App Configurations" 

  1. Click the big blue +App button  



 

  1. Select “By URL” from the Configuration Type Dropdown

 

  1. Enter the Name, and the Key and Secret

 

  1. Paste the following URL into the  Config URL input box and click Submit:
    https://www.eduappcenter.com/configurations/aj2ls8boeccjcqek.xml

     

 

Installing and Configuring the App in Moodle

Read: Adding an External Tool 

Configuration Notes 

Launch Container

Decide whether you'd like content to launch as embedded inside Moodle, or if you'd like to load the resource in a new tab. Selecting the Default launch container will often result in embedded content. This can be changed by an LMS administrator, so settings vary between institutions.

This is an annotated screenshot highlighting the Launch Container selection field in the Moodle External Tool General Settings window.

Selecting Moodle Launch Container.png This is an annotated screenshot highlighting the Launch Container selection field in the Moodle External Tool General Settings window.

 

Installing and Configuring the App in Blackboard

Configuration Notes: 

You must configure both an LTI Tool Provider and an LTI Placement 

Setting up the LTI Tool Provider: 

Provider domain: goopennc.oercommons.org 

Privacy settings: You must allow Blackboard to send Role in Course and User Email with 

                            LTI launch requests.  

Setting up the LTI Placement: 

Supported Placement: Course Content Tool

Launch URL: https://goopennc.oercommons.org/lti/launch

 

Using the LTI Tool to Manually Embed Custom Content

Any GoOpenNC LTI Link can be configured to direct users to any page on the GoOpenNC platform that logged in users can access. For example, this might be a Group Discussion board page, or a specific Collection.

When you use an LTI Link to embed content, rather than simply copy/pasting the URL, you get the added benefit of the automated authentication and account provisioning.  This means users will be logged in automatically and added as a member of your Group without having to manually manage membership enrollments. 

Configuring Custom Redirect

Most Learning Management systems allow you to enter custom parameters when you configure LTI links. 

The GoOpen tool uses a custom_redirect_url parameter to redirect launch requests to a specific GoOpen URL. 

Most Learning Management Systems append the "custom" automatically when you enter a custom parameter. In Canvas, Blackboard, and Moodle this is the case. Because of this, you should simply enter redirect_url

 

Troubleshooting and Technical Documentation

Safari SSO Issue

The Problem: I am using Safari and I can’t seem to login to the LTI Tool no matter what I do! I’ve even tried changing my password via reset password from email, and it still doesn’t work. 

 

The Solution: 

  1. Check your cookie settings, and make sure you are allowing third party cookies. If you are strict about your cookie settings, you may need to whitelist goopennc.oercommons.org 
  2. Close out of the LTI Tool
  3. Open the GoOpenNC Homepage in a new tab and login 
  4. Launch the LTI tool again 

 

The Reason

 

Safari does a lot to protect your privacy, and ensure third parties aren’t tracking you without your consent. Because of this, Safari won’t allow third parties to set cookie information, if it looks like you haven’t visited the site recently. This means we can’t set an SSO cookie if you’ve recently cleared your history, are using Safari for the first time, or are using Safari on a new device. Opening the GoOpenNC homepage and logging in will fix this problem, because it indicates to Safari that GoOpenNC is a site you use intentionally. Technical details can be found here: https://webkit.org/blog/7675/intelligent-tracking-prevention/

 

Other Technical Documentation

 

The GoOpenNC LTI 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 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 the GoOpen 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 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, user is redirected to the specified GoOpen content page.

Error Messages

If the cause of the error is known, the LTI tool will return an error message with debugging information. The most common cause of errors is missing LTI parameters.