Configuration URL

 https://www.eduappcenter.com/configurations/o609c5bemb37uygv.xml

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 OERTX 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 key/secret pair can also be configured to automatically add new users to an OERTX 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 browsing Collections 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 Moodle

Get Your LTI Credentials 

Contact [email protected] for your LTI Credentials 

If you would like to configure access to a specific OERTX Group you have created, please specify that in your email.   

Installing and Configuring the App in Moodle

1. Open Site Administration

2. Click on the Plugins Tab

3. Scroll Down to Activity Modules and Click on “Manage Tools”


 





  1. Paste the following URL into the input box and click “Add”:
     https://www.eduappcenter.com/configurations/o609c5bemb37uygv.xml



  1. Enter the Key and Secret you obtained from [email protected], and click “Save Changes”


  1. Adjust Settings by clicking on gear icon in the upper right hand corner of newly created tool



  1. Scroll down to Privacy. Make sure email is always shared, and check “Force SSL” *Note: If you don’t share email, you will need to manually log in with your email and password every time you use the tool.


Troubleshooting and Technical Documentation


Check your Cookie Settings  

  1. Make sure you are allowing third party cookies. We use a cookie to connect your Moodle session to your OERTX session. If you don't allow third party cookies, we won't be able to connect your sessions and log you in.  

  2. Make sureOERTX 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 Safari

Manage Cookies in IE


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 vivaopen.oercommons.org 

  2. Close out of the LTI Tool

  3. Open the Homepage https://oertx.highered.texas.gov/ in a new tab 

  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 OERTX Homepage will fix this problem, because it indicates to Safari that OERTX is a site you use intentionally. Technical details can be found here: https://webkit.org/blog/7675/intelligent-tracking-prevention/


Other Technical Documentation


The OERTX 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 OERTX 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, the user is redirected to the specified OERTX 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.