Talis Aspire LTI 1.3 - Brightspace Set Up Instructions

Overview (WORK IN PROGRESS MAY NOT BE COMPLETE)

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.
  • 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 URL exactly:
      • EU/APAC - https://rl.talis.com/lti/1p3/deep_link_request
      • Canada - https://rl.ca.talis.com/lti/1p3/deep_link_request
    • OpenID Connect Login URL - enter the following URL exactly:
    • 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.
    • 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
    • MORE INSTRUCTIONS TO FOLLOW
  •  
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.