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:
In Canvas, create a Client ID for Lingco
In Canvas, enable Lingco as an external tool.
In Canvas, create an API key for Lingco.
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.
Login to Canvas as an administrator.
Navigate to Admin → Developer Keys.
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.
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.
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.
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.
Login to Canvas as an admin.
Navigate to Admin → Settings → Apps.
Click View App Configurations.
Click + Apps.
For Configuration Type, select By Client ID.
Cut/paste the Client ID that you created in the previous section.
Click Submit.
If the client is found, click Install when prompted.
Navigate to Admin → Settings → Navigation.
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.
Locate the Client ID.
Locate the Deployment ID.
Locate the API Key and Secret.
Click on the purple chat bubble, and request LTI 1.3.