Overview
This article explains each step of setting up an LTI 1.3 integration with Talis Elevate.
You will need to create a tool deployment in Canvas and then send some information to Talis for us to complete the deployment registration.
NO plugin code is required to use this integration.
You can configure tools in your staging and production Canvas accounts. In both cases Talis will link these to your live Talis Elevate tenancy so you can see how the LTI integration would behave with live lists.
For frequently asked questions, see this article: LTI 1.3 - Talis Elevate FAQ
Prerequisites
You will need to be a Canvas administrator who can manage Developer Key registrations.
To complete this task, you will need approximately 20 minutes at most.
To test that LTI is working as expected you will need:
- To enable cookies in your browser. The LTI specification requires a 'state cookie' to make the LTI connection. Read more about LTI Cookies.
- To not use an incognito browser (especially if it disable cookies)
- To already have a user account in Talis Aspire which allows you to edit reading lists, if you are testing the academic workflow
Configure By URL Instructions
- In Canvas, go to : Admin >> [choose the organisation account] >> Developer Keys
- Click '+ Developer Key' Choose to add a new LTI Key.
- Change the 'Method' option to 'Enter URL'
- The form will change and you will have a box labeled JSON URL. Paste in the following:
- Click save.
- In the list of developer IDs, capture the client id which is in the `Details` column. The client ID appears above the button ‘Show key’ (do not click the button, we don't want the key). We need this Client ID later.
-
Go to: Admin >> [choose the organisation account] >> Settings >> Apps
- Click on `View App Configurations`
- Click on `+ App`
- Change `Configuration Type` to `By Client ID`
- Enter the Client ID saved earlier. (keep a note of it as we'll need it again)
- Submit and Install the App
-
In the list of installed External Apps, click on the Cog button to the right of the new app.
- Select Deployment ID
- Capture the Deployment ID.
-
Raise a ticket by emailing support@talis.com and Talis will do the next part of the tool registration to link Talis Elevate with your Canvas instance.
You will send the following fields.- Client ID
- Deployment ID
- Once Talis confirm that registration is complete, you will be able to test the tool by adding content to a module.
Manual Configuration Instructions
Note that some values are different depending on whether your Talis Elevate tenancy is located in the EU/APAC or Canada regions. Check your usual tenancy URL (navigate to any list) and use the values below which have the same domain root.
- In Canvas, go to : Admin >> [choose the organisation account] >> Developer Keys
- Click '+ Developer Key' Choose to add a new LTI Key.
-
Fill in the form:
- Key Name - Something to help you recognise this in the future.
- Title - Something meaningful as it will be visible to students
- Description - Something meaningful as it will be visible to students
-
Redirect URIs - enter the following exactly
-
https://app.talis.com/lti
-
-
Target Link URI - enter the following exactly:
-
https://app.talis.com/lti
-
-
OpenID Connect Initiation URL - enter the following exactly:
-
https://app.talis.com/lti/login
-
- JWK Method - Choose Public JWK URL
-
Public JWK URL - enter the following exactly:
-
https://app.talis.com/lti/keys
-
-
LTI Advantage Services section
- Talis don't use any of these services
- Additional Settings section
- Domain
-
app.talis.com
-
-
Tool ID
-
elevate.talis.com
-
-
Icon URL
-
https://app.talis.com/cache/img/toolicons/tool_icon_2x.png
-
-
Text - Customise this as it may be student facing
-
Talis Elevate deep linking
-
-
Custom Fields
- <YOURTENANT> - Talis can advise you what this is, or, when you have logged in to Talis Elevate, you will see your tenant name in the URL as the first part of the path after app.talis.com.
-
tenant=<YOURTENANT>
tool_name=Talis Elevate
tool_owner=team.elevate@talis.com
xp_context_id_history=$Context.id.history
xp_resourcelink_id_history=$ResourceLink.id.history
-
Privacy Level
- Private
- Domain
-
Placements
- Deselect anything other than 'Link Selection' and 'Editor Button'
-
In the Link Selection and Editor Button sections
- Target Link URI
-
https://app.talis.com/lti
-
- Select Message Type - LtiDeepLinkingRequest
- Text - This Identifies the link or button to students.
- Add an Icon URL
-
https://app.talis.com/cache/img/toolicons/tool_icon_2x.png
-
- Target Link URI
- Click Save
- In the list of developer IDs, capture the client id which is in the `Details` column. The client ID appears above the button ‘Show key’ (do not click the button, we don't want the key). We need this Client ID later.
-
Go to: Admin >> [choose the organisation account] >> Settings >> Apps
- Click on `View App Configurations`
- Click on `+ App`
- Change `Configuration Type` to `By Client ID`
- Enter the Client ID saved earlier. (keep a note of it as we'll need it again)
- Submit and Install the App
-
In the list of installed External Apps, click on the Cog button to the right of the new app.
- Select Deployment ID
- Capture the Deployment ID.
-
Raise a ticket by emailing support@talis.com and Talis will do the next part of the tool registration to link Talis Elevate with your Canvas instance.
You will send the following fields.- Client ID
- Deployment ID
- Once Talis confirm that registration is complete, you will be able to test the tool by adding content to a module.