Canvas Config URL: https://www.eduappcenter.com/configurations/nyueaf7qk6v4jab1.xml
LTI Key/Secret: contact firstname.lastname@example.org to obtain your key/secret
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 VIVA Collections. Additionally, users can browse or search content from Group Shared Folders and personal My Items libraries.
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 a VIVA Group or Hub.
LTI Tool Preview Images
Some basic preview images of the tool have been included below. More detailed instructions for using the LTI tool is available in the "Using the LTI tool" section of this guide.
This is a screenshot showing what browsing VIVA 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 Canvas
Get Your LTI Credentials
Contact email@example.com for your LTI Credentials
If you would like to configure access to a specific VIVA Group you have created, please specify that in your email.
Installing and Configuring the App in Canvas
- Navigate to the "Apps" section on your Canvas Course
- Click "View App Configurations"
Click the big blue +App button
Select “By URL” from the Configuration Type Dropdown
Enter a Name, and the Key and Secret you obtained from firstname.lastname@example.org
Paste the following URL into the Config URL input box and click Submit:
Troubleshooting and Technical Documentation
Safari Login 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.
If you are using Safari 13+ the solution below will not work, due to updates with the way 3rd party cookies are handled. We recommend using Firefox or Chrome instead.
If you are using Safari 12 or earlier:
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
Close out of the LTI Tool
Open the VIVA Open Homepage in a new tab
Launch the LTI tool again
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 VIVA Homepage will fix this problem, because it indicates to Safari that VIVA Open is a site you use intentionally. Technical details can be found here: https://webkit.org/blog/7675/intelligent-tracking-prevention/
Other Technical Documentation
The VIVA 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
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 VIVA platform, used in manual config only)
*If parameters do not conform exactly to the parameters listed above, the LTI 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 VIVA content page.
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.