How to Set Up Your Edlink-Connected LTI App in Canvas
Step 1
Make sure that your Canvas is connected to Edlink.
Step 2
Log in to Canvas. If you're an admin, select your school from the Admin menu.
Select Settings from the sidebar, then go to the Apps tab and add an external app.
If you're a teacher adding the app for a specific course, choose the course, then:
- Select Settings from the sidebar
- Go to the Apps tab
- Add an external app
Step 3
Choose Paste XML from the drop-down menu.
Enter the following details:
- App Name
- Consumer Key
- Shared Secret
- XML Configuration (below)
Note: This XML will make your app open in a new tab.
If you'd like it to open inside Canvas, remove:<lticm:property name="windowTarget">_blank</lticm:property>
<?xml version="1.0" encoding="UTF-8"?>
<cartridge_basiclti_link
xmlns="http://www.imsglobal.org/xsd/imslticc_v1p0"
xmlns:blti="http://www.imsglobal.org/xsd/imsbasiclti_v1p0"
xmlns:lticm="http://www.imsglobal.org/xsd/imslticm_v1p0"
xmlns:lticp="http://www.imsglobal.org/xsd/imslticp_v1p0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.imsglobal.org/xsd/imslticc_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticc_v1p0.xsd
http://www.imsglobal.org/xsd/imsbasiclti_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imsbasiclti_v1p0.xsd
http://www.imsglobal.org/xsd/imslticm_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticm_v1p0.xsd
http://www.imsglobal.org/xsd/imslticp_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticp_v1p0.xsd">
<blti:launch_url>YOUR EDLINK LAUNCH URL</blti:launch_url>
<blti:title>THE NAME OF YOUR APP</blti:title>
<blti:description>THE DESCRIPTION OF YOUR APP</blti:description>
<blti:extensions platform="canvas.instructure.com">
<lticm:property name="privacy_level">public</lticm:property>
<lticm:options name="course_navigation">
<lticm:property name="url">YOUR EDLINK LAUNCH URL</lticm:property>
<lticm:property name="enabled">true</lticm:property>
<lticm:property name="default">enabled</lticm:property>
<lticm:property name="windowTarget">_blank</lticm:property>
</lticm:options>
</blti:extensions>
</cartridge_basiclti_link>
Make sure to change the launch_url, url, title, and description in the XML where labeled.
This XML will add the app to every course in the Canvas instance.
If you're an admin and would like teachers to manually add the app to a course before it appears:
Change this: <lticm:property name="default">enabled</lticm:property> to this:<lticm:property name="default">disabled</lticm:property>
Teachers can add the app to their course by going to Settings in the Course sidebar, selecting Navigation, and dragging the app into the list of visible navigation items.
Step 4
Once the app is added, a teacher can launch it by selecting it from the Course sidebar in their Canvas course.
Seeing an Error?
Edlink Launch Error
You'll see this if you haven't filled in the XML field with your LTI launch link, which you can find in your Edlink dashboard.
To troubleshoot, scan through the XML field and replace the text in ALL CAPS with the appropriate values: the app's name, the app's description, and your Edlink LTI launch URL.
SSO Error When Attempting to SSO Using LTI
If you installed your LTI app within 24 hours of connecting to Edlink, your initial sync might not have completed yet.
Once the sync completes, the launch should start working.
Still having issues or have questions?
If you're still running into problems, contact our support team and we'll get back to you within 24 business hours.