How to setup LTI 1.3 integration on your LMS with GETMARKED Digitaliser

How to setup LTI on your LMS

Overview

This article provides instructions for configuring Getmarked Digitaliser as an LTI 1.3 app on Learning Management Systems (LMS).

Note: Please ensure that the LMS supports deployment of external apps with the LTI 1.3 standard.

General Instructions for Configuring LTI on your LMS

The following steps are general instructions applicable for any LMS like Canvas, Blackboard or Moodle. For specific instructions on individual LMS, please refer to the LMS specific instructions in the subsequent sections.

Please create a LTI Tool Instance on your LMS by providing the following information to it. LMS that supports LTI will have an interface for you to input these in. These information tells your LMS where to load our app from.

Login URL :
Redirection URL :
RSA key :	-----BEGIN PUBLIC KEY-----MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAi7Zo437y92HyrFCzHThWGRV56lFEIljENBpcyen0COp0WPH7JTkWNIX9SCxfAx5OPJHznJBp5FilwfHo5FpJ7cwPS5D3y6P3dDZCD1BjFcbqKsEjgb5+PTajvcbyNej1YWX9Zy54+tYZ95s6xQ5zf/KzV/O73B+4b/itoga39jo4ZFbAxW1BU0SxU32Aox3xxvikNJbdxsr24YY3hSEL+7YTfNx0xgHQfjXK6wr5iJpisCBTF9lW2KLa/icRpUmlzRRDGxgXINF/5m5U4fpYpwaupSJ5kLlewFBBKkpBgg6hLdejk7tp9IaGv8HazheKAiBl/bpRXkSrgbPwb7ykDdi8v/Bk2YMPRtiKKa6cfgcCJZ2qmt5CoPRY/ZrrIyiJTCcpeKBzduCyr1ZKSDQrRLOUjStnQ9xBbiUkKLM/7lUsytReNenuGVqmAjJFpkrDSf3WtqG15LIddPThj76reJLCizspYPnBF5PEQl2/0MttNeRxp6ZjK1KTHxCBcQTvAgMBAAE=-----END PUBLIC KEY-----
JWKS :

Please obtain a Client ID / Developer Key from your LMS.
Register your LMS platform and Client ID / Developer Key on GETMARKED Digitaliser developer portal.

Note: While different LMSes may have slightly different steps for configuring LTI apps, the steps should generally not deviate too much from the above. If you encounter any problems with specific LMSes, please do not hesitate to contact us.

Configuring LTI on Canvas

Skip Step 1 below if you have an account manager working with you to setup the LTI integration. Proceed to step 2.

Step 1
Register and login as a developer on GETMARKED Digitaliser. At login, from the Developer Portal → Deploy LTI tool on LMS.
1. Select Canvas (Cloud) under LMS Platform.
2. Set the Tool Name. This is for your own reference and can be anything. We recommend it be the name of your school or organization.
3. Skip Client ID and Deployment ID. You will fill it up later.
4. Set Canvas Instance URL to the URL of your Canvas site. Usually it's something like "https://harvard.instructure.com"
5. If you have filled in the form properly, it should look something like this:
6. Click Create Tool.
7. Copy the Canvas Config URL, it would be used in the next step.
Step 2
Next, we need to create a Developer Key in Canvas. Login to Canvas. Go to Admin → Developer keys. Click on the + Developer Key button, then click on the + LTI Key.
1. Under Configure → Method, choose Enter URL, and paste the Canvas Config URL from the previous step into into the JSON URL field.
  
  It will look something like so (where XXX will be unique to you):
  https://digitaliser.getmarked.ai/launch/canvas_configuration/XXX/
2. Set Redirect URIs to https://digitaliser.getmarked.ai/launch/authenticate/
3. You may set Key name and Owner email to whatever you like. It is for your own reference.
4. Click on save, and you should be able to see your created Developer Key. Turn on the state to On, and copy the key under Details.
Note: You will need to be a site administrator in order to access the above settings.
Step 3
Go back to the Deploy LTI tool on LMS page in your GETMARKED Developer Portal and register your Developer Key (Client ID).
1. Click on the edit icon right beside your Platform Name (this in example "Harvard Campus Wide").
2. You should see that the Client ID field is now editable. Paste the Developer Key you have obtained from Canvas in the previous step into this field.
3. Click save changes. Our tool is now connected to the canvas platform.
Step 4
Installing GETMARKED Digitaliser tool to course.
To install globally, complete step 4 in site admin
1. In Canvas, go to the course you want to add the tool to. Click on Settings → Apps → (View App Configurations →)+ App.
2. Under Configuration Type, choose By Client ID, and key in the Developer Key (this is a string of numbers) that you copied earlier.
3. Click submit and install the app.
4. GETMARKED Quiz Importer should appear on the left sidebar menu on your course page.

Configuring LTI 1.3 on Blackboard

Setting up an LTI 1.3 integration on Blackboard with GETMARKED Digitaliser is straightforward. Get your Learn Admin to enter our Client ID in your Admin Panel. You should get back a Deployment ID. Email it to support@getmarked.ai and we will setup it up for you in less than one business day.

Our Blackboard Client ID is: 6a696831-387f-4906-bc09-932ffff78ff8

Reference: Blackboard's LTI regsitration and deployment page

Configuring LTI 1.3 on Brightspce by D2L

Setting up the LTI 1.3 integration on Brightspace with GETMARKED Digitaliser consist of a Registration step and a Deployment step.

Registration

Login into Brightspace using your admin account
Click on Settings icon, then click Manage Extensibility.
Click on LTI Advantage tab and click Register Tool.
Enter the following information into the Register Tool Form:
1. Name: GETMARKED Digitaliser (can be anything, for your own reference)
2. Description: GETMARKED Digitaliser (can be anything, for your own reference)
3. Domain: https://digitaliser.getmarked.ai/
4. Redirect URLs: https://digitaliser.getmarked.ai/launch/authenticate/
5. OpenId Connect Login URL: https://digitaliser.getmarked.ai/launch/
6. Keyset URL: https://digitaliser.getmarked.ai/launch/public_keys/
7. Under Extensions, Check Send Institution Role.
Once you have registered GETMARKED Digitaliser as an LTI 1.3 tool, Brightspace will expose a set of configurations that are needed to complete the registration on our side. Please copy and paste this data and send it back to us. Also please include a screenshot so that we can verify that everything is correct.

Deployment

In D2L go to: Gear Icon → External Learning Tools → LTI Advantage → New Deployment
“Tool“ choose the tool that you just registered
Enter the “Name“ what you want
In Security Setting Check “Org Unit Information“, ”User Information” and “Link Information“
Click “Add Org Units” and choose which course can use this tool and click Add
Click “Create Deployment”
Create Link by clicking View Links → New Link
1. Enter “Name“ what you want
2. Copy https://digitaliser.getmarked.ai/launch/authenticate/ to "URL"
3. Click “Save and Close” button
Go to Course that you want to add tool to
Click “Content” in top navigation in course
Under Table of Contents click the module that you want to add the tool too (you may need to Add a module)
Click Existing Activities → External Learning Tools → Choose the Link you just created
Click the link to the tool that was added
GETMARKED Digitaliser should launch

Configuring LTI on Moodle

Create a Client ID in Moodle. Login to Moodle. Go to Site administration → Plugins. Under Activity modules, go to External tool → Manage tools.

Click on configure a tool manually.
Tool Settings
1. Set Tool name to what you want. This is for your reference and it can be anything.
2. Select LTI 1.3 under LTI version.
3. Copy the Redirection url located above to both Tool URL and Redirection URI(s).
4. Copy the Login url located above to Initiate login URL.
5. Under Public key type on Moodle, select either RSA key or Keyset URL. Copy the appropriate values from the corresponding field type located above (either RSA key or JWKS) into the Public keyset field on Moodle.
6. Select Show as preconfigured tool when adding an external tool under Tool configuration usage.
7. Select Embed, without blocks under Default launch container.
8. Click Save changes. You should now be able to see your added tool listed under Tools.
Obtaining Client ID. Click on of your tool and you will be able to copy the Client ID, the Platform ID, Authentication request URL, Access token URL and Public keyset URL from the popup.
Note: An example of what the popup should look like:

Here are some examples of the required fields from a moodlesite:

Field	Example
Platform ID	https://plat_address.com
Client ID	MYsr14bTf5avcakl
Authentication request URL	https://plat_address.com/mod/lti/auth.php
Access token URL	https://plat_address.com/mod/lti/token.php
Public keyset URL	https://plat_address.com/mod/lti/certs.php

Note: You will need to be a site administrator in order to access the above settings.

Registering Client ID on Getmarked Digitaliser. Login to Getmarked Digitaliser as a developer account. Go to portal → Deploy LTI tool on LMS.
1. Select Others under LMS Platform.
2. Set Platform Name to the name of your Moodle Platform name. This is for your own reference and it can be anything.
3. Copy Platform ID that you copied earlier to Domain.
4. Copy Authentication request URL, Access token URL and Public keyset URL that you copied earlier to the corresponding fields.
5. Set Tool name to what you want. This is for your own reference and it can be anything.
6. Enter in the Client ID that you copied earlier to Client ID.
7. If you have filled in the form properly, it should look something like this:
8. Click Create Tool. You should now be able to see your registered Tool. Your tool is now connected to the Moodle platform.
Adding Getmarked Digitaliser tool to course.
1. In Moodle, go to the course you want to add the tool to. Click on Turn editing on → Add an activity or resource.
2. Under Preconfigured tool, you should be able to select the Getmarked Digitaliser tool that you set up earlier.
3. Give your activity a name. You can leave the rest of the fields blank.
4. Click Save and return to course.