***ATTENTION!!! AS OF MAY, 2021, THIS ARTICLE IS OBSOLETE PER THE RECENT BLACKBOARD UPDATE. ALL BLACKBOARD CUSTOMERS WILL NEED TO INSTALL LTI 1.3 (LINK: https://help.vidgrid.com/en/articles/3546332-how-to-set-up-the-blackboard-learn-saas-integration)***

This article is for all versions of Blackboard utilizing the Original Experience. This includes Self Hosted, Managed Hosted, SaaS, and Ultra Experience - Original View. The main difference between Original and Ultra View at this point is that Original uses Building Blocks.

This document outlines the setup for the following integrations:

Prerequisites

1.1 Copy your Consumer Key from VidGrid Account Settings > Integrations> LTI Settings > LTI 1.1 Settings (see Figure 1)

(Figure 1)
​
​1.2 Go to https://github.com/ilosvideos/ilosB2/releases > The latest release displays at the top of the page > Assets > Click the .war file to download the lastest version (see Figure 2).

(Figure 2)

1.3 Go to your Blackboard System Admin > Building Blocks > Installed Tools > Upload Building Block > Browse and select the .war file from 1.2 > Submit > Approve.

(Figure 3)

1.4 Return to the Blackboard Installed Tools page and find the VidGrid Building Block. Go into its Settings and click Configure Building Block Settings. Enter your Consumer Key where is says "API Key" and the Shared Secret. Submit.

(Figure 4)

1.5 Check the VidGrid Building Block System Settings to ensure the Server URL is app.vidgrid.com and the API URL is api.vidgrid.com. Perform a test configuration to make sure the connection is OK.

(Figure 5)

1.6 From your System Admin Panel, go to Tools and Utilities > Tools > VidGrid Building Block. Turn the Availability on for all three tool types. Apply to both new and existing courses.

(Figure 6)

1.7  Embed a video in Blackboard anywhere that offers a "Media Mashup." Just click Add Content Icon (Figure 7), choose VidGrid, and search for the video you'd like to embed. Once you've selected the video, hit Insert. (To play back the video, make sure Edit Mode is off).

(FIgure 7)

If, after configuring the Embed plugin, instructors can embed VidGrid videos on Blackboard but students cannot, then you need to take a few more steps. (Embedding the video will appear to work while the student authors their post, but when they click save, the VidGrid video will be "sanitized" out by Blackboard as a security precaution).  If this is happening, do the following:

2.1 As a Blackboard admin, navigate to System Admin > Safe HTML Filters  > Safe HTML Filter for Content Editor, and download the active "policy" XML file, indicated by the green checkmark:

(Figure 8)

2.2 Open the XML file in a text editor like notepad on Windows or textedit on Mac, and search for the word "iframe." You should see a long list of websites that are allowed to embed, in XML format. Add this line to the list:
  <regexp value="http[s]?://app.vidgrid.com/.*"/>

(Figure 9)

2.2 Save and upload the modified policy XML file, and set it as "active" by clicking the down-carrot to the right of the file name and selecting "activate."

(Figure 10)

2.3 Sign is a student in Blackboard (make sure to log out of VidGrid first via https://app.vidgrid.com or open an incognito window, so you don't appear signed in as your VidGrid admin user during the test) and test if the issue is fixed. If not, then continue to the next steps.
​
​2.4 In Blackboard, navigate to System Admin > Safe HTML Filters > Global Safe HTML Filter, and change "Filtering Enabled" to "yes," and "Filtering Mode" to "dangerous HTML" (not "all HTML").  This should fix the issue. If not, please try a rolling restart of Blackboard, and if the issue still persists, contact VidGrid support.

3.1 From the Administrator Panel > Integrations > LTI Tool Providers
3.2 Click Register LTI 1.3 Tool
3.3 Enter Client ID: a0ebe52b-2d2a-449d-99e4-770e0ac1939c > Submit
3.4 On the Accept LTI 1.3 Tool complete the following:

3.5 On the LTI Tool Providers Page, click on the Options Menu for Prod Lti 13 New (see Figure 10)

(Figure 10)

3.6 Click Manage Placements

4.1 Click Create Placement (see Figure 11)

(Figure 11)

4.2 Fill in the fields with the following information:

4.3 Click Submit

(Note: If you want the Portal to appear as a system tool AND course tool, you will need to create two separate placements for the VidGrid Portal. Change the type depending on the placement desired)

5.1 Click Create Placement (see Figure 11)

5.2 Fill in the fields with the following information:

5.3 Click Submit

6.1 Click Create Placement (see Figure 11)

6.2 Fill in the fields with the following information:

6.3 Click Submit

7.1 Log into VidGrid as an Admin. Navigate to Account Settings (see Figure 12) > LTI Settings.

(Figure 12)
​
7.2 Fill out the LTI basic settings.

7.3 LTI 1.3 Settings > Add a new LTI 1.3 deployment

7.4 LTI 1.3 Settings > Add a new LTI 1.3 deployment

7.5 LTI 1.3 Settings > Add a new LTI 1.3 deployment

8.1 Testing VidGrid Embed: 

8.2 Testing VidGrid Quiz: 

8.3 Testing VidGrid Student Record: 

8.4 Testing VidGrid Portal 

From Blackboard

9.1 Click Create Placement (see Figure 11)

9.2 Fill in the fields with the following information:

From VidGrid

9.3 LTI 1.3 Settings > Add a new LTI 1.3 deployment