Using LTI integrations with Canvas

In this article, you'll learn how to set up and use LTI 1.1 and LTI 1.3 integrations with Canvas.

• What's the difference between LTI 1.1 and LTI 1.3?
• How to set up the LTI 1.1 tool
• How to set up the LTI 1.3 tool
• How to use the LTI 1.3 tool
• How to accept scenario scores as grades via LTI 1.3 tool

Note that you must be an admin on both Canvas and ThingLink to set up the integrations. 

You can embed your ThingLinks in Canvas without the LTI integrations. See this article for more details

What's the difference between LTI 1.1 and LTI 1.3? 

LTI 1.1 allows your users to sign into their ThingLink accounts by simply clicking a button in your LMS. See this article for more information on what data the integration uses. 

LTI 1.3 allows you to pick a piece of content from your account and embed it without having to use the embed code. However, note that it will automatically create a ThingLink account for any viewer. See this article for more info on the integration.

How to set up the LTI 1.1 tool in Canvas

1. Log in to your ThingLink account, go to the Organization page, then select the 'Integrations' tab and scroll down to LTI 1.1. You'll need the information from this page to set up the integration:
   
2. Log into Canvas with an admin account. Go to 'Admin' - 'Settings' - 'Apps' and use the '+App' button to enable ThingLink for all courses:
3. Once you've added the app, it will appear in all courses in the course navigation menu on the left.

Alternatively, you can add the app to select courses via the course settings. Use the same configuration type, consumer key and shared secret.

How to set up the LTI 1.3 tool in Canvas

1. Log in to your ThingLink account and go to the Organization page, then open the Integrations tab and scroll down to LTI 1.3 connections.
2. Click the blue 'Add new' button to create a new connection.
3. This will bring up a new form. Enter anything in the 'Connection name' field, then click the blue 'Add' button. You'll need to fill in the rest of the form later.
4. Click the 'View details' button next to the connection you've created.
5. Click the 'Select your LMS' menu and select Canvas. Copy the 'JSON configuration for Canvas' text:
   
6. Go to Canvas and navigate to Admin > Developer keys. Click 'Developer Key' and add a new LTI Key.
7. Set 'Key name' to what you want.
8. Choose 'Paste JSON' under 'Method'.
9. Paste the JSON configuration you've copied into the 'LTI 1.3 configuration' field. Make sure to replace or remove the placeholder brackets {}.
10. Click Save.
11. You'll be redirected to the Developer Keys page. Toggle the LTI key you've created ON.
12. Go back to ThingLink > LTI 1.3 page and scroll down to Platform-specific parameters. You'll need to paste the information from the Developer Key you've set up on Canvas here:
    1. Issuer / PlatformID: if you are using a licensed/cloud version of Canvas, enter https://canvas.instructure.com. If you are using a self-hosted version Of Canvas, enter the link you use to access Canvas.
       If you are installing the LTI app in a test environment and getting an error, try changing the Issuer / PlatformID to https://canvas.test.instructure.com. 
    2. Client ID: go to Canvas and copy the number for the LTI key you've set from the Details column. Paste it as Client ID on ThingLink.
    3. Deployment ID: in Canvas, go to Admin > Settings > Apps > View App configurations > +App. Set Configuration Type to By Client ID and paste the Client ID for the LTI key you've set up, then click Submit and confirm that you want to install the tool. In the External Apps list, click the cog icon next to the tool, then click Deployment ID, copy it and paste it into the Deployment ID field back on ThingLink.
    4. Platform keyset URL: https://canvas.instructure.com/api/lti/security/jwks
    5. Access token URL: https://canvas.instructure.com/login/oauth2/token
    6. Authentication request URL: https://canvas.instructure.com/api/lti/authorize_redirect  
13. Click Save.

The integration is now ready. You can test it by creating a new page/assignment for any course and trying to use the ThingLink app via the rich content editor as described below.

How to use the LTI 1.3 tool

When editing or creating a new post in your courses, you should see a small ThingLink icon within the rich content editor. To embed a ThingLink scene or scenario, do the following:

1. Click the ThingLink icon. If the icon is not visible, click 'Apps' and select ThingLink from the dropdown menu.
2. A new window with your content will be loaded. Click the 'LTI link' option in the top-left corner and select 'HTML link' instead.
   • If you use LTI link, the app will paste a thumbnail image for your content and add a link to it. The learners will have to click the image to interact with its interactive version in a new tab.
   • If you use the HTML link, the app will embed your content and the learner will be able to interact with it directly in the post.
3. Hover over the scene or scenario you'd like to insert and hit the 'Send' button.

LTI 1.3: Accepting scenario scores as grades in Canvas

You can use the LTI 1.3 tool to accept scores from ThingLink scenarios as assignment grades. Note that this works only for scenarios.

1. Create a new assignment and start editing it.
2. Scroll down to 'Submission type' and select 'External tool'.
3. Click 'Find' next to the URL field, then select ThingLink.
4. Your ThingLink content will pop up in a new window. Select 'Scenarios', then hover over the scenario you'd like to show and hit 'Send'.
5. You'll be taken to the previous menu. The URL field should be filled out. Check the 'Load this tool in a new tab' box and click the blue 'Select' button.
6. Set the maximum number of points and publish the assignment.

How the scenario is displayed

If the scenario is public, it will be displayed on the same page. If the scenario is not public, the learner will see a button that will redirect them to complete the scenario on ThingLink. The scenario will open in a new tab.

Note that we will automatically create a ThingLink account for the learner in order to track their progress.

How the grade is calculated

Once the learner reaches the end of the scenario, we'll show them how many points they've received and the total number of points available in the scenario:

ThingLink will calculate the final grade as a ratio of points received to the maximum number of points. In the example above, the learner's grade would equal ((75/110)*100%)) = 68.18. 

• If the learner goes through the scenario another time, their grade will be overwritten
• If the learner does not complete the scenario, their grade will not be sent to Canvas

Note: if you do not see the option to add ThingLink as an external tool in assignments, please ask your admin to make sure that you are using the up-to-date version of ThingLink's LTI 1.3 app and that the app has an 'Assignment selection' placement.