Setting up H5P.com in Blackboard (LTI 1.3)

To set up H5P.com as a tool in Blackboard via LTI 1.3 you need to:

1. Create a registration on H5P.com
2. Register your H5P.com application in Blackboard's Developer portal
3. Add the provider application details to the H5P.com registration
4. Create a deployment of the application inside your Blackboard instance
5. Add the deployment ID to the registration on H5P.com
6. Verify that it works

Part 1: Create a registration on H5P.com

Step 1: Log in to H5P.com as an admin user with your email address as the username and your password.

Step 2: Go to Manage Organization

Step 3: Go to "Connect LMS"

Step 4: Press “Add LMS Connection” and select your LMS: Blackboard. Select LTI version 1.3 and press “Save”.
Note: If you want to use LTI v1.1 please follow this tutorial

Make note of the following information provided on H5P.com, these are the connection details and look something like this: 

• Login URL: https://yourorganization.h5p.com/lti/login
• Redirect URL: https://yourorganization.h5p.com/lti/launch
• Public key: https://yourorganization.h5p.com/lti/jwks/numbers.json

You’ll be needing these in the next section.

Important: Please, do not copy and paste the information above, it won't work, as it has been edited and are not the actual details you must use. You need to copy the valid values from inside H5P.com as they are personally and randomly generated. It looks something like the image below:

Part 2: Register your H5P.com application in Blackboard's Developer portal

Step 1: Head over to https://developer.blackboard.com/ and sign up if you haven’t already. Make sure you are logged in before continuing.

Step 2: Navigate to the “Manage Your Applications” section and press the “Register a new application” button.

Step 3: Before you start filling in the fields, make sure to switch ON the "My Integration supports LTI 1.3" toggle.

Step 4: Fill in the form using the details from the previous step. It should look like this:
You must use the values provided in the previous section, do not try to copy these example values.

• Application Name: Interactive Content - H5P
• Description: Create, share and reuse interactive HTML5 content in your browser
• Domain(s): yourorganization.h5p.com
• Group: Choose whichever you prefer. This is only related to how multiple applications are organized within your Blackboard Developer account.
• My Integration supports LTI 1.3:ON
• Login Initiation URL: https://yourorganization.h5p.com/lti/login
• Tool Redirect URL(s): https://yourorganization.h5p.com/lti/launch
• Tool JWKS URL: https://yourorganization.h5p.com/lti/jwks/1290994208887981337.json
• Signing Algorithm: RS256

Step 5: Make note of all the details on the next screen as you will be needing these in the next section. Note that some of these values are only displayed once, meaning that if you don’t note them down or if you lose them you will have to start this process over again.

Part 3: Add the provider application details to the H5P.com registration

Step 1: Head back to your H5P.com account, locate the registration you created, and press the “Connection settings” button next to it. An “Add registration data” dialog should appear.

Step 2: Fill in the registration values from the previous section.

Note that some of the values will already be populated with their defaults and need they need only be changed for custom setups.

• Client ID: Fill in the Application ID provided in the previous section.
• Key Set URL: Fill in the Public keyset URL provided in the previous section.
• Audience: Leave blank.
• Private key (optional): Leave blank.
• Press the “Save” button

Part 4: Deploy the application to your Blackboard site

Step 1: Log in to your Blackboard site and head over to the “Administrator Panel” from where you select the “LTI Tool Providers” section.

Step 2: Press the “Register LTI 1.3/Advantage Tool” link and copy paste the “Application ID” from Part 2 into the “Client ID” field and press “Submit”.

Step 3: You’ll end up on the “Accept LTI 1.3 Tool” page. Make sure everything looks correct and that the tools and services required are enabled. It’s very important to make note of the Deployment ID as you’ll be needing that in the next section. 

For Institution Policies, use the below configuration. 

Then after checking everything looks right, press “Submit”.

Step 4: Locate the tool in the “LTI Tool Providers” list and select “Manage Placements” from the drop-down menu next to it. 

Step 5: Press “Create Placement”. Fill in the Label and Handle with “Interactive Content - H5P” and make sure the type is "Deep Linking content tool" with "Allow student access" enabled.
For “Tool Provider URL” use the “Redirect URL” provided in section 1.

Press “Submit”.

Part 5: Add the deployment ID to the registration on H5P.com

Step 1: Head back to the H5P.com page and locate the same registration, again. This time, press the “New deployment” button under it and paste the “Deployment ID” you made note of in the previous section. Press “Save”.

Part 6: Verify that it works

Everything is now set up. To make sure that it works we're going to add an H5P activity to a course.

Step 1: Log in as an instructor.

Step 2: Go to an existing or create a new course.

Note that the way you add H5P within a course is different depending on the theme/version of Blackboard that you are using. Below are the steps:

• Part 3.1: Blackboard Original and Blackboard Ultra (Original Course View) and
• Part 3.2: Blackboard Ultra (Ultra Course View)

Part 3.1: Blackboard Original and Blackboard Ultra (Original Course View) 

Step 1: Select "Content" in the left menu

Step 2: Select "Build Content" in the top menu

Step 3: Select "H5P Content" in the dropdown menu

H5P.com will launch and you may insert a new or an existing H5P.

Step 4: Select "Add Content" to create new or upload existing content

Step 5: Select "Insert" to insert content into Blackboard course

Part 3.2: Blackboard Ultra (Ultra Course View)

Step 1: Within the "Books and Tools" section click on "View course & institution tools".

Step 2: Scroll down the "Book & Course Tools" popup that just appeared on the right side.
At the very bottom, you will see the link: Browse All Course Tools. Click on this link

The content Market page will open.

Step 3: Under "Institution tools" find and select "H5P Content"

H5P.com will launch and you may insert a new or an existing H5P.

Step 4: Select "Add Content" to create a new or upload an existing H5P

Step 5: Select "Insert" to insert content into the Blackboard course