Canvas Integration Overview
By connecting Canvas with Kyron, educators can enhance existing Canvas courses with Kyron lessons.
Requirements
Kyron Learning Account: Create a Kyron Learning account to access the platform's course creation tools. You need to be an admin in the organization you want to create lessons in.
Developer Key access on Canvas: Developer keys are configured on a per-account basis. This permission is generally only available to Canvas admins.
Create a Developer Key for Kyron
đĄ Have you already created a key for LTI?
Unfortunately, the Developer Key used to configure LTI canât be used here and you will need to create a separate key.
Configuration
1. Register Kyron with your Canvas account
A. Navigate to your Canvas account as an administrator and access the "Admin" tab.
B. Locate the "Developer Keys" section and click the "+ Developer Key" button.
C. Choose "API Key" from the dropdown menu and proceed to the configuration
page.
D. Fill in the form with the following values:
Field | Value |
Key Name | Kyron Learning |
Owner Email | |
Redirect URIs | |
Redirect URI (Legacy) | Leave blank |
Vendor Code (LTI 2) | Leave blank |
Icon URL | |
Notes | (Optional) Leave blank or include info to help identify this key in the future |
Test Cluster Only | Leave unchecked |
Client Credentials Audience | Leave as âCanvasâ |
E. Enforce scopes on the key by toggling on the âEnforce Scopesâ
F. Check the box for âAllow Include Parametersâ
G. Under âCoursesâ, enable the following endpoints:
url:GET|/api/v1/courses
url:GET|/api/v1/courses/:id
H. Under âModulesâ, enable the following endpoints:
url:GET|/api/v1/courses/:course_id/modules
url:GET|/api/v1/courses/:course_id/modules/:module_id/items
url:POST|/api/v1/courses/:course_id/modules/:module_id/items
I. Under âPagesâ, enable the following endpoints:
url:GET|/api/v1/courses/:course_id/pages
url:POST|/api/v1/courses/:course_id/pages
J. Click âSaveâ to create the key
K. In the âStateâ column, toggle the key to âEnabledâ
The key should appear at the top of the list of Developer Keys in your Canvas account. Note the number in the âDetailsâ column and the base64-encoded string behind the âShow Keyâ button. This is your Developer Key ID and Developer Key respectively which youâll need in the next step.
2. Add your Canvas Developer Key to Kyron
Sign into Kyron and go to the âSettings & membersâ page
Under âCanvas OAuthâ, fill in the following fields:
Canvas Host is the domain that you access Canvas on (usually canvas.<institution>.edu)
Canvas Client ID is the ID of your Canvas Developer Key (number that probably starts with 24)
Canvas Client Secret is base64-encoded string that is visible with the âShow Keyâ button in Canvas
Click âSaveâ
Note: If you donât see âCanvas OAuthâ, it probably hasnât been enabled for your organization. Please reach out to support@kyronlearning.com for more info.