Who can do this?
EchoVideo administrators in conjunction with their LMS/VLE administrators.
EchoVideo now supports getting user authentication information from each LMS when users view embedded videos or video links posted in LMS content windows. This is done by supporting the "content-item-request" feature of the LTI specification, which allows EchoVideo to see WHO is viewing the posted material. To take advantage of this, be sure to update the EchoVideo Plugin, Building Block, or App on your LMS to the newest version available.
Enabling Authenticated Embedded Video Views
So what do YOU have to do to make this work?
Simple. Update your EchoVideo plugins for the EchoVideo embed button in the LMS. The specifics for each LMS are as follows.
If you update your LMS/VLE to use the new plugin/building block/app for authenticating views of EchoVideo embedded videos, you NO LONGER need to have the Instructor and Student Public Links toggles enabled. We suggest, however, that you retain the main Public Links toggle in the ON position so that videos embedded prior to the update to authenticated embeds continue to work.
To enable authenticated embedded videos/links in Blackboard, simply remove the existing Blackboard plugin for the EchoVideo Video Library, and install the newer one. You MUST use AT LEAST version 1.0.10 of the plugin (the current version is 1.0.13). Also, be sure that your SafeHTML file is updated with the Echo360 domains as documented. See Adding an EchoVideo Video Option to Blackboard Mashups for instructions.
Even if your SafeHTML file does not need to be changed, you may need to delete the existing one from your Blackboard installation, re-upload it, and then Activate it. Updating the Plugin sometimes requires a "reset" of the SafeHTML file in this way. See Configuring Blackboard to allow Students to Embed from their EchoVideo Library for instructions if necessary.
Canvas can be a little tricky depending on how your current EchoVideo Apps are configured. This is because Canvas does not allow for editing some App configurations via the UI once they are created (in particular, those created by XML). If you created three DIFFERENT EchoVideo Apps for each of the available features (Course Navigation, Editor Button, and Homework Submission), you can remove the old Editor Button and Homework Submission ones and replace them with new ones. The basic steps are:
- Log into EchoVideo as an administrator.
- Click the Settings icon in the upper-right corner of the screen.
- From the Settings menu, select Institution Settings.
General settings appear and Basic Info is selected by default.
- Click Integration.
- From the middle panel, select LMS/VLE.
The LTI 1.1 tab is selected by default.
- Scroll down to your Canvas instance and click the XML Config tab.
- Click the Copy XML button.
- Return to the Apps Configurations in Canvas.
- Create a new EchoVideo App for the Editor Button using the XML you just copied.
- Delete the old Editor Button App if there was one.
- Repeat these steps to replace the Homework Submission app (toggling on ONLY the Homework Submission toggle in EchoVideo).
More detailed instructions are provided in Adding an EchoVideo App for an Embed Button in the Canvas Editor Toolbar and Adding an EchoVideo Homework Submission App for Canvas Assignments as needed.
As long as you do NOT change the LMS Configuration fields in EchoVideo (key, secret, and URL), all existing embeds will work as before, and all new embeds will provide unique view data for LMS viewers.
Updating the Course Navigation app is not required, and you can leave that one alone for now. However, if you WANT to update it, you need to use the Canvas API to do so. If you are not comfortable using the API, feel free to contact Echo360 Support and we can help you through the process. See the Technical Details note below for why we do not recommend just replacing the Course Navigation app.
How do I know what kind of App I have? In Canvas, navigate to your Account and go to the Settings page (link on the left). Click Apps from the top, then click View App Configurations. Find your EchoVideo app(s) and click the Info or Placement option - you will see a popup box that lists the Placements for the app. EchoVideo apps support three types of placements: Course Navigation (links into EchoVideo sections from a Canvas course), Embed Button (a handy EchoVideo icon from which you can embed videos into a content window), and Homework Submission (the option to allow Students to embed videos from their EchoVideo library as submissions for homework assignments). Ideally, you should have three different EchoVideo apps. But if you do not, and your Embed Button and/or Homework Submission app is combined with your Course Navigation app, you will need to use the Canvas API to update your app configuration.
Technical details: If you replace the EchoVideo Course Navigation app in your Canvas instance, your links into EchoVideo will continue to work just fine. The URL being launched is the same, so incoming links know exactly where to go. The problem is that Gradebook exports from EchoVideo into the existing Assignment link columns in Canvas will break; Canvas will no longer recognize the column(s) in the Gradebook for your Assignment link(s) as being tied to the EchoVideo section or classrooms. Grade exports from EchoVideo out to Canvas will not update the data.
Enabling authenticated embedded videos in D2L/Brightspace is essentially a matter of deleting the old Remote Plug-In and installing a new EchoVideo Plugin. You also must enable the Content Item Messaging configuration variable. All of the steps necessary are documented in Adding a Remote Plugin to Brightspace for Embedding EchoVideo Videos in Content Windows.
Essentially the differences you will notice if updating your plugin are:
- When installing the Remote Plugin, be sure to select Insert Stuff (CIM) from the drop-down list. If you have done this before, you selected the "Non-CIM" option. That will no longer work. Select the CIM option instead.
- The URL added to the Remote Plugin NO LONGER requires "/launch/library" to be appended to it. Now simply the main Launch URL will do.
- You must enable the configuration variable for content messaging. These instructions are provided in the Plugin installation page linked above.
Your users should not notice anything different in their process for using the embed plugin (unless you give the new Insert Stuff plugin a different name).
Enabling authenticated embeds in Moodle is really as simple as installing the new TinyMCE Plugin or upgrading the Atto Plugin and the Filter to at least version 1.0.17. Furthermore, the new plugin and filter remove the need for you to change the Trusted Sites or Student Role configuration to allow students to embed. The updated Filter handles all of that functionality now.
Download the new plug-in and follow the instructions located in Adding an EchoVideo Button to the Moodle Content Editor Toolbar.
Enabling authenticated embeds in Sakai is as simple as upgrading the EchoVideo plugin to at least version 1.0.5 (the current version is 1.0.7/ 1.0.10 for Sakai 12.3 or higher). Download the newest plugin and follow the instructions contained in Adding an EchoVideo Embed Option to Sakai Content Windows and/or refer to the Readme file included with the plugin download.