H5P LTI 1.3 Tool Provider Integration
OpenLearning supports multiple technologies to provide interoperability with other systems, tools, and apps. In this article, we will be covering the Learning Tools Interoperability (LTI 1.3 ) integration with H5P.com, an open-source content collaboration framework that aims to make it easy for everyone to create, share and reuse interactive HTML5 content such as interactive videos, interactive presentations, quizzes, interactive timelines and more within an LMS.
LTI 1.3 is based upon LTI 1.1 but uses the IMS Security Framework, which is based on the industry-standard protocol IETF OAuth 2.0 for authentication services along with JSON Web Tokens (JWT) for secure message signing and the Open ID Connect workflow paradigm.
This integration is useful, as it will allow you to export out reports that capture the results, attempts, timestamps etc of each user that interacted with the uploaded content from your H5P.com account page.
Pre-requisite
- A portal subscription with access as an institution administrator in order to set up this integration for your courses.
- Paid H5P.com plan
Setting up H5P with LTI 1.3
Step 1
Log In to H5P.com and click on Manage Organization.
Step 2
Navigate to Connect LMS and select these values:
- Select your LMS: Other
- Connection Name: Any string is acceptable but we suggest naming this to OpenLearning
- LTI Version: LTI v.1.3
Step 3
Click Save. This will generate the details needed for the integration.
Take note of the Login URL and the Public key for LTI v.1.3 as you will need this later when setting this in OpenLearning. We can ignore the Redirect URL for this integration.
Setting up H5P.com Integration in the Portal
Step 1
Log in to OpenLearning and navigate to your Institution Settings > Integrations.
Step 2
Scroll down to the LTI Tool Providers section and click on + Add LTI tool provider.
Step 3
Enter the tool provider name, and on the Tool provider registration section, select LTI 1.3 for the LTI version.
Step 4
Enter the details that you copied over from H5P earlier:
- Launch URL : Login URL that you copied from H5P
- OIDC Launch URL: Consumer Key : Login URL that you copied from H5P
- Key Set URL Secret : Public key that you copied from H5P
- Tool deep link service URL : Login URL that you copied from H5P
Example:
Note: The widget icon will automatically be updated automatically once the correct Launch URL is added to the section above.
Step 5
Scroll down and enter a Key pair name and click on Generate keys to get a public/ private key pair
Step 6
In Advanced Settings;
- Tick the Deep Linking checkbox to ensure a tighter integration with the H5P.com tool set
In Email address identification:
- Select Personal Email Address
Leave everything else as it is for now and click Save.
Finalising set up on H5P.com
Step 1
Enter into the H5P LTI Tool that you've just created again and scroll down to the Registration details.
Step 2
Keep this tab open or copy the details here as you will need to add these into your H5P.com settings again.
Step 3
Head back to the H5P Connect LMS page and scroll down to the connection that you created. Click on Connection Settings.
Step 4
Enter the details that are taken from the LTI Tool setting in OpenLearning from Step 2 into this section.
Client ID: this is the Client ID from OpenLearning
Issuer: https://www.openlearning.com
Login URL : this is OIDC Auth URL from OpenLearning
Token URL: this is OAuth2 Access Token URL from OpenLearning
Key Set URL: this is Keyset URL from OpenLearning
Example:
Step 5
Leave every other settings as it is and click Save.
Optional: You can choose to tick these checkboxes if you would prefer to have the name and email address of the users in H5P be updated with the one that is linked to OpenLearning.
Step 6
You should now see a Deployments section at the bottom of the H5P LMS configuration page. Click on New Deployment and enter the Deployment ID from OpenLearning Registration details.
Note: This is usually just the number 1.
Click Save to complete the set up.
Adding the H5P LTI tool to a course
Step 1
On your preferred course page, click on the Edit button to go into Edit mode.
Step 2
Go to the Widget menu and select Integration from the category dropdown. Click or drag the H5P widget icon onto your page as with any other widget.
Step 3
On the first launch, the tool will request to use your email address, which will be sent to H5P to complete the sign-on process.
Note: Your role in H5P has to be added in either as an Author, Super User or an Administrator before you are able to access the Setup section of the widget.
For more details, please refer to H5P user roles section here.
Step 4
Select the H5P Setup tab and if you have an existing activity on H5P.com which you would like to use, you can select it here.
Otherwise, use the H5P Add Content button to create a new activity.
Step 5
When you have finished creating or selecting H5P.com content, click the Save or Save and Insert button.
Create a Quiz with H5P.com
Step 1
Click Add Content and select the Quiz (Question Set) option to create a new quiz.
Step 2
Add a title to your quiz.
Step 3
Create your questions by first choosing the question type from the drop-down menu.
Step 4
Next, simply create your questions by adding the title of your question, the question itself and adding the different answer options.
Step 5
To add more questions click on the + Add Question button.
Step 5
Scroll down, click on LTI Settings and select an option from the Choose when to send scores back to LMS from the drop-down menu.
- Do not send score - do not send the score to OpenLearning
- First attempt - capture the first attempt and send it to OpenLearning
- Last attempt - capture the last attempt and send it to OpenLearning
- Best attempt - capture the best attempt and send it to OpenLearning
This will send a score between 0.0 and 1.0 (where 1.0 is 100%) back to OpenLearning. (excluding the first option - do not send score)
Step 6
This score can be used to automatically set completion for a learner using the Completion Settings tab, where a score threshold can be provided.
Administrator's View
As an administrator of the course that has been added to the H5P.com plan, it will allow you to add, create and edit the H5P content directly from the widget.
What you see in the view mode will differ slightly from the learner's view as well; you can Edit the content and gather Reports on the activity and download the H5P content to your device directly from the widget as well.
Learner's View
As a learner, you can just view and interact with the content that has been added to the widget by the course administrator.