This document provides instructions on integrating the YuJa Enterprise Video Platform into your Blackboard Learning Management System (LMS) through LTI 1.3. If you have any questions regarding any steps in this process, please contact your dedicated Customer Success Manager. To perform the integration, you will need a Key, Shared Secret, Zone URL, and Client ID, which will be provided in your Zone Provisioning document.
Configuring LTI 1.3 for the Video Platform
- Log in to Blackboard as an Admin and access the System Admin area.
- Select LTI Tool Providers.
- Select Register LTI 1.3.
- Within the Client ID field, paste the Client ID provided by your Customer Success Manager.
- Take note and copy the pre-populated Deployment ID, Initiate Login URL, Tool Redirect URL, and JWKS URL.
- Under Tool Status, select Approved.
- Under Tool Provider Custom Parameters, enter the following:
- blackboard_course_previous_context_ids=$Context.id.history
- lis_person_sourcedid=@X@user.id@X@
- lti_login_id=@X@user.id@X@
- Make sure to check the following boxes and ensure Allow grade service access is set to Yes.
- Select Submit.
Adding the LTI 1.3 Placement for the Video Platform
LTI placement, including a name and link, makes it easy for end-users to find and use the Video Platform. Although it is not required, managing the placement of this tool is strongly recommended.
- While in the LTI Tool Providers menu, click on the drop-down arrow to the right of your YuJa 1.3 LTI Tool to access a drop-down menu of available actions.
- Click Manage Placements.
- Select Create Placement.
- Input the Placement Information as follows:
- Label: YuJa Video Platform
- Handle: YuJa Video Platform
- Type: Course Tool, Student and Non-student
- Tool Provider URL: https://<Your_YuJa_Domain>/LTI3Entry.jsp
- Select Submit.
Adding Deep Linking Placement for Video Quizzes and Analytics
You will need to add a second placement once LTI 1.3 for the Video Platform is installed to allow Deep Linking Placement. This allows users to publish their videos and video quizzes into their Blackboard courses.
- While in Manage Placements for <Your_YuJa_Domain>, select Create Placement.
- Input the Placement information as follows:
- Label: YuJa Video Quizzes and Analytics
- Handle: YuJa Video Quizzes and Analytics
-
Type: Course content tool, Supports deep linking
Note: Do not select the option for Allows.
- Tool Provider URL: https://<Your_YuJa_Domain>/LTI3Entry.jsp
- Select Submit.
Integrating Blackboard Learn into the YuJa Enterprise Video Platform
Once the registration and placement information is configured in Blackboard, the Zone Administrator will need to copy the API Configuration keys into the Admin Panel.
- Log into the Video Platform as an Administrator.
- Go to the Admin Panel >> Integrations.
- Under Select an API to Configure, select LMS via LTI 1.3.
- Under User Role Mapping >> Choose an LMS, select Blackboard.
- Navigate to API Configuration in Integration.
- Input the fields as follows and ensure that there are no spelling mistakes, extra symbols, or spaces.
- ISS: https://blackboard.com
- Client ID: <Refer to your Zone Provisioning document>
- OIDC: https://developer.blackboard.com/api/v1/gateway/oidcauth
- JWKS Endpoint: <Refer to your Zone Provisioning document>
- OAuth 2 Token: https://developer.blackboard.com/api/v1/gateway/oauth2/jwttoken
- Deployment ID: Refer to step 5 in Configuring LTI 1.3 for the Video Platform.
- If your institution does NOT have a vanity URL, proceed to the next section of this guide. If your institution does have a vanity URL, click Add Configuration to add a second API configuration.
- Follow the instructions below, and click Save, located at the top of the page, once done.
- ISS: https://blackboard.com
- Client ID: <Refer to your Zone Provisioning document>
- OIDC: https://developer.blackboard.com/api/v1/gateway/oidcauth
- JWKS Endpoint: <Refer to your Zone Provisioning document>
- OAuth 2 Token: https://developer.blackboard.com/api/v1/gateway/oauth2/jwttoken
- Deployment ID: Refer to step 5 in Configuring LTI 1.3 for the Video Platform. If entering multiple IDs, separate each by a single comma.
Note: When filling out the API Configuration fields, please ensure that there are no spelling mistakes, extra symbols, or spaces.
Testing a Basic LTI Launch in Blackboard
Once the LTI 1.3 placements are added, and the API information is inserted in the Admin Panel, we will then need to confirm that the LTI launch works properly.
- Log into Blackboard as an Instructor of any course.
- Turn on Course Editing.
- Hover over the plus (+) icon and select Course Link.
- In Location, browse and choose the value that was given in the Label field from Adding the LTI 1.3 Placement for the Video Platform (Step 4).
- Choose Available to Users.
- Select Submit.
- Click on the LTI link to authenticate into the Video Platform.
Using The YuJa Media Chooser with Gradebook Sync
Content Item Message is a protocol that enables LTI-based tools to pass back authentication information for embedded videos and quizzes, among other things. Within Blackboard, CIM can be used to embed content using a specified Blackboard-defined CIM workflow. Videos and quizzes posted to Blackboard using the Blackboard CIM workflow will be able to track analytics and sync grade results between the Grade Book and Blackboard Full Grade Center.
Embedding a Video Using the Deep Linking Placement
- Login to Blackboard as an Instructor of any course.
- Go to the Content/Lessons section of any course.
- Click Build Content.
- Select the name of the CIM-Deep Linking Placement.
- Once you have selected the placement, it will open the Media Chooser that supports Deep Linking, where you can select the video or Video Quiz to sync quiz grades with Blackboard's Full Grade Center.
Taking a Video Quiz in Blackboard
Once the Video Quiz is inserted into the Blackboard Content item, grades will automatically sync once students complete the quiz. Below is the workflow for students to complete, which will ensure grades are properly synced.
- Log in to Blackboard with a user who has access to your video quiz.
- Open the Course menu.
- Navigate to your video quiz.
- Select the video quiz and submit all responses until completion.