Overview (Your feedback welcome)
This article explains each step of setting up an LTI 1.3 integration with Talis Aspire Reading Lists.
You will need to create a tool deployment in Brightspace 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 Brightspace accounts. In both cases Talis will link these to your live Talis Aspire Reading Lists 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 Aspire FAQ
Prerequisites
You will need to be a Brightspace administrator who can manage extensibility settings.
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
Step by step instructions
Note that some values are different depending on whether your Talis Aspire 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 Brightspace, go to the settings icon, then click on Manage Extensibility
- Select the tab for 'LTI Advantage' and click 'Register Tool'
- If you don't see the 'LTI Advantage' tab, you will need to enable permissions.
the form:
-
- How would you like to register your tool: Choose the standard option.
- Name - Something meaningful as it will be visible to students
- Description - Something meaningful as it will be visible to students
-
Domain: Enter one of the following URLS depending on your region.
- EU/APAC - https://rl.talis.com
- Canada - https://rl.ca.talis.com
-
Redirect URI - enter the following URLs exactly (you need to add both):
- EU/APAC -
- https://rl.talis.com/lti/1p3/deep_link_request
- https://rl.talis.com/lti/1p3/launch
-
Canada -
- https://rl.ca.talis.com/lti/1p3/deep_link_request
- https://rl.ca.talis.com/lti/1p3/launch
- EU/APAC -
-
OpenID Connect Login URL - enter the following URL exactly:
- EU/APAC - https://rl.talis.com/lti/1p3/oidc_login
- Canada - https://rl.ca.talis.com/lti/1p3/oidc_login
-
Target Link URL
- Leave this blank
-
Keyset URL - enter the following URL exactly:
- EU/APAC - https://rl.talis.com/lti/1p3/jwks
- Canada - https://rl.ca.talis.com/lti/1p3/jwks
-
Extensions section
- Select `Deep Linking`.
- Roles
- Make sure this is ticked
- Substitution Parameters
- none required
- Custom Parameters
- none required
- Click Register
- Copy the Registration Details into a text file. You will need these to send to Talis.
- Now you need to create a deployment.
- Click 'View Deployments' in the registration details window.
- Click 'New Deployment'
- Fill out the fields
- Tool - Select the tool that you just registered.
- Name - Give it a name - this will likely be seen by students.
- Description - Again this will be seen by students.
- Extensions
- Select the 'Deep Linking' option.
- Security Settings
- Put a tick against the following entries:
- Org Unit Information.
- User Information - and all of its sub entries.
- Link Information - and all of the sub entries.
- Put a tick against the following entries:
- Select the Org Units you wish to enable this deployment for if needed.
- Click 'Create Deployment'
- Copy the deployment details into a text file. You will need these to send to Talis.
-
Raise a ticket by emailing support@talis.com and Talis will do the next part of the tool registration to link Talis Aspire Reading Lists with your Brightspace instance.
You will send the following fields.- Client ID
- Brightspace Keyset URL
- Brightspace OAuth2 Access Token URL
- OpenID Connect Authentication Endpoint
- Brightspace OAuth2 Audience
- Issuer
- Deployment ID
- Once Talis confirm that registration is complete, you will be able to test the tool by adding content to a module.
- You will need to take additional steps to add a quicklink
-
Manage External Tools, LTI Advantage, click on the registration, view links, create a new link
- EU/APAC - https://rl.talis.com/lti/1p3/deep_link_request
- CANADA - https://rl.ca.talis.com/lti/1p3/deep_link_request
- Follow guidance provided by Brightspace for any other configuration needed at this point
- If you think we need to add anything to these instructions, please raise a support ticket with details of what needs adding and why.