Overview
The following information details how an Admin, within both EchoVideo and Blackboard access, can set up a new LTI 1.3 configuration to be used for Deep Linking capabilities between Blackboard and EchoVideo.
- Create an Application in the Blackboard Developer Site
- Create an Initial EchoVideo LTI 1.3 Configuration
- Create the Blackboard LTI 1.3 Configuration
- Manage Placements for the Blackboard Application
- Register the LTI 1.3 Tool in Blackboard and Create a Deployment
- Register a Deployment to the EchoVideo LTI 1.3 Configuration
In order to complete these steps, you must have an Administrator role within both EchoVideo and the Blackboard LMS environments.
Process
Part 1: Create an Application in the Blackboard Developer Site
The first part involves creating your Blackboard Developer account and Application in the Anthology portal:
- Go to https://developer.anthology.com/ and create an account.
- After the account registration is completed, create a "Group". You can give the group any name you want.
- Once your Group has been created you need to create the new Application for this integration.
- Click on "My Applications"
- On the my applications page click on "Register a REST or LTI application".
- If you already have existing Applications, on the Register a New Application page click the plus icon in the table header to start the process.
- If you do not have an existing Application, on the new application page fill out the Application name and Description fields.
- Your application requires two domains dependent on your region. Here are the two domains broken out by regions. There are four regions:
- United States
- Canada
- Europe / Middle East / Africa
- Asia / Pacific
- Lastly check the "My Integration supports LTI 1.3" toggle to enable the feature in the application.
- Keep this page open as we will need to populate it with data from the EchoVideo side next.
Part 2: Create an Initial EchoVideo LTI 1.3 Configuration
This part creates the initial EchoVideo LTI 1.3 configuration. The resulting information in EchoVideo will be populated in the Blackboard Developer Application (Part 3).
- Log into your EchoVideo Admin account.
- Click the Settings icon.
- Select Institution Settings.
- Click the Integration icon.
- Select LMS / VLE and then LTI 1.3.
- Click Add Configuration, provide a name for the configuration, and click Save.
- In the newly created LTI 1.3 configuration, make sure that the use alternate domain name option is selected:
The generated details from this step will be used for the configuration of Blackboard in Part 3.
Part 3: Create the Blackboard LTI 1.3 Configuration
This part creates the Blackboard LTI 1.3 configuration and specifies the placements. You will need to be logged into Blackboard Developer site and will enter data from the Echo side (from Part 2 above)
- Log into Blackboard Developer OR navigate back to the browser tab from Part 1 above.
- Log into EchoVideo as an Admin OR navigate back to the browser tab from Part 2 above.
- From the LTI 1.3 Configuration in EchoVideo, copy the OIDC Initiation URL and paste it into the Login Initiation URL in Blackboard Developer > Register a New Application page.
- From the LTI 1.3 Configuration in EchoVideo, copy the Redirect URI and paste it into the Tool Redirect URL(s) field in Blackboard Developer > Register a New Application page.
- From the LTI 1.3 Configuration in EchoVideo, copy the Public Keyset URL and paste it into the Tool JWKS URL in Blackboard Developer > Register a New Application page.
- Click Register Application
- After Registering the Application you will be taken to the Key page:
-
NOTE: The Secret shown on this page is only shown once. If you close this page without copying the secret to a safe and secure location, it cannot be recovered.
-
NOTE: The Secret shown on this page is only shown once. If you close this page without copying the secret to a safe and secure location, it cannot be recovered.
- Enter the LTI 1.3 configuration details from the page above, into your EchoVideo LTI 1.3 Configuration LMS Details as follows:
- Copy and paste the Issuer into the EchoVideo LMS Details > Issuer field
- Copy and paste the Public Keyset URL into the EchoVideo LMS Details > Public Keyset URL field.
- Copy and paste the Access token endpoint into the EchoVideo LMS Details > Access Token URL field.
- Copy and paste the OIDC auth request endpoint into the EchoVideo LMS Details > Authentication Request URL field.
- Copy and paste the Application ID into the EchoVideo LMS Details > Client ID field.
- Now that we have all of the LMS Details filled in, click Save.
- Now that we have Saved the configuration in EchoVideo, we need to Manage the Placements in the Blackboard Developer site for this new Application. (Part 4)
Part 4: Manage Placements for the Blackboard Application
Now we need to create the placements for our Application in the Blackboard Developer site.
- From the My Applications page, click on the three horizontal dots next to your Application in the list to reveal a menu and select Manage Placements.
- This will bring you to the Register a new placement page where we will create two placements for this integration.
- First we will create an Analytics tool.
- Name the placement and add an (optional) description.
- For Type select Course tool.
There are multiple types of placements in Blackboard. Different placement types will show up in different parts of the Blackboard platform. Consult your support documentation for more information on placements.
- The Target link URI should be set to https://api.echo360integrate.org/lti/analytics
- The Target link URI of your placement depends on the region you are in. There are four regions:
- Optionally, populate the Icon URL: https://echo360qa.dev/assets/images/0a11772a218c58bd62b8c46ab5bf90dc-favicon.png
- Click Register Placement.
- Next we need to create a Deep Linking Tool placement, so click the plus sign in the top right of the Manage Placements page.
- Name the placement and add an (optional) description.
- For Type select Deep Linking content tool
- The Target link URI of your placement depends on the region you are in. There are four regions:
- Optionally, populate the Icon URL: https://echo360qa.dev/assets/images/0a11772a218c58bd62b8c46ab5bf90dc-favicon.png
- Click Register Placement
Now we have two placements associated with the LTI 1.3 application.
Part 5: Register the LTI 1.3 Tool in Blackboard and Create a Deployment
In this part, you will need the application ID from the application you created in the Blackboard Developer site.
- From My Applications in the Blackboard Developer site, copy the Application ID for your app.
- Login to Blackboard as an Admin.
- Go to the Administrator Tools page.
- Click LTI Tool Providers.
- On the LTI Tool Providers page, click Register LTI 1.3 / Advantage Tool
- Paste the Application ID from your Blackboard Developer Application into the Client ID field in Blackboard and click Submit:
- This will take you to a page to verify the settings and approve the tool status:
For your Blackboard tool, the domain will depend on the region you are in.
- Make sure you copy the Deployment ID field to a safe place. We will need it to create the deployment in EchoVideo.
- Scroll down this page and make sure the Role in Course, Name and Email Address are checked and click Submit:
Part 6: Register a Deployment to the EchoVideo LTI 1.3 Configuration
This set of instructions requires you to be in EchoVideo on the LTI 1.3 Configurations page (check Part 1 for information on how to get there if required) plus have access to the Blackboard Deployment ID from Part 5 above.
- For the relevant LTI 1.3 configuration click on Manage Configuration and select the Add Deployment button.
- Add the deployment registration details.
- Deployment Name: Enter a deployment name
- Deployment ID: Add the Blackboard Deployment ID saved from Part 5 above.
- Click Save to complete the EchoVideo LTI 1.3 Configuration's Deployment registration.
In the event that placements or the tool icon does not sync between the two systems, click the Synchronize LTI 1.3 Tools button in Blackboard, as shown in the figure below.
The LTI 1.3 configuration for Blackboard and EchoVideo is now complete and ready for use.