Skip to main content
All CollectionsFor IT AdministratorsIntegrations
Setting Up Canvas LTI 1.3 Integration
Setting Up Canvas LTI 1.3 Integration
Seth Killian avatar
Written by Seth Killian
Updated over a week ago

LTI v1.3 requires that the integration between the LMS and external tools like Lingco are based on a trust created through OAuth 2.0. Enabling this trust requires a 4-step configuration. This is a one-time configuration that must be done by the LMS administrator with support from Lingco.

To enable LTI v1.3 integration:

  1. In Canvas, create a Client ID for Lingco

  2. In Canvas, enable Lingco as an external tool.

  3. In Canvas, create an API key for Lingco.

  4. Reach out via chat with Lingco, and request LTI 1.3.

Create a Client ID

Note: The following are abbreviated instructions. Instructions complete with screenshots can also be found here in the Canvas documentation.

  1. Login to Canvas as an administrator.

  2. Navigate to AdminDeveloper Keys.

  3. Click + Developer Key+ LTI Key.

Key Settings

Use the following for the required fields:

Key Name: A string that describes the external tool, e.g., “Lingco”.
Redirect URIs: https://class.lingco.io/lti/launch


Configure

Use the following for the required fields:

Method: Manual Entry
Title: Any string. Preferably same as “Key Name”.
Target Link URI: https://class.lingco.io/lti/launch
OpenID Connect Initiation URL: https://class.lingco.io/lti/login
JWK Method: Public JWK URL, https://class.lingco.io/lti/jwks


LTI Advantage Services

This section determines what LTI services are available to Lingco. Enable the settings shown.

Screen Shot 2022-01-18 at 9.07.13 PM.png


Additional Settings

Cut/paste the following field mapping into Additional Settings → Custom Fields. This mapping matches Canvas fields to the LTI v1.3 properties.

email=$Person.email.primary
user_id=$User.id
course_id=$Canvas.course.id
last_name=$Person.name.family
first_name=$Person.name.given
section_ids=$Canvas.course.sectionId
ssectionSISSourceIDs=$Canvas.course.sectionSisSourceIds

Set Privacy Level to Public.

image (4).png

Placements are a Canvas feature that determines where an LTI link appears in the Canvas interface. Enter the following list:

  • Account Navigation

  • Link Selection

  • Assignment Selection

  • Module Menu

  • Course Navigation


Assignment & Link Selection

After entering the placements appear in the form Assignment Selection and Link Selection, select LtiDeepLinkingRequest.

Screenshot 2023-12-12 at 11.21.35 AM.png

Click Save.

Note the Client ID that was created. You will need it in the next section.

Enable Lingco as an External Tool

The following are abbreviated instructions. Instructions complete with screenshots, can also be found here in the Canvas documentation.

  1. Login to Canvas as an admin.

  2. Navigate to Admin → Settings → Apps.

  3. Click View App Configurations.

  4. Click + Apps.

  5. For Configuration Type, select By Client ID.

  6. Cut/paste the Client ID that you created in the previous section.

  7. Click Submit.

  8. If the client is found, click Install when prompted.

  9. Navigate to Admin → Settings → Navigation.

  10. Ensure that the navigation link for the Lingco tool is not hidden. See Canvas.


Create an API Key

If you have an existing integration with Lingco you may already have created an API Key. If not, create one now to enable LTI v1.3 integration for multi-section courses.

Instructions on creating an API key are available here.


Contact Lingco

Establishing trust between the LMS and Lingco requires configuration on the Lingco side as well. This includes consuming the Client ID that you created.

  1. Locate the Client ID.

  2. Locate the Deployment ID.

  3. Locate the API Key and Secret.

  4. Click on the purple chat bubble, and request LTI 1.3.

Did this answer your question?