Testing LTI 1.3 Integrations

Background

You university will often want to test integrations with tool providers before going live. This article explains an approach that you can use.

Important: If you already have LTI 1.1 integrations configured, these do not need to be deleted or altered in any way. Removing LTI 1.1 configurations will permanently remove LTI 1.1 links from courses in your learning system. It is unlikely that your learning system has a recovery mechanism if you do this accidentally.

Sandbox environments are not necessary

Talis Aspire and Talis Elevate are tenanted systems and each customer will typically only have one instance of the system.  Talis Aspire and Talis Elevate do not provide sandbox environments for testing LTI integrations as we find that these are not necessary to be able to successfully test a deployment.

Multiple LTI integrations can be configured for each tenant instance. This means that staging, development and production systems can all be linked to the same Talis Aspire or Talis Elevate system.

LTI links made in different deployments to the same tenancy are entirely separate.

Rollout plan

A suggested rollout plan looks like this:

  1. Read through the documentation for setting up the LTI 1.3 tool for Talis Aspire or Talis Elevate for your particular learning management system.
  2. For your staging or development systems
    1. Complete the steps in the documentation and share the relevant information with Talis
    2. Talis will configure the LTI 1.3 tool to link to your deployment
    3. Carry out any user testing that you need to...
      1. ...verify that you know how to setup the tool and...
      2. ...understand how it will behave for your users and...
      3. whether you need to update any local documentation.
  3. For your production systems
    1. Complete the steps in the documentation and share the relevant information with Talis
    2. Talis will configure the LTI 1.3 tool to link to your deployment
    3. Verify that the LTI 1.3 tool is behaving in the same way as the staging or development systems.
    4. Carry out any commissioning activities such as sharing documentation with users.
  4. Once you are happy that users have created LTI 1.3 links to replace their LTI 1.1 links, you can safely remove the LTI 1.1 configurations.
    Important: removing LTI 1.1 configurations will permanently remove LTI 1.1 links from courses in your learning system. it is unlikely that your learning system has a recovery mechanism if you do this accidentally.

Talis Aspire LTI Testing FAQs

  1. I get an error saying I don't have permission what do I check in Talis Aspire?
    The error message is: 
    403: Forbidden

    You do not have sufficient permission to manage instructor content inside Talis Aspire
    You need to have an instructor role in the learning system.
    You need to be able to edit a list in Talis Aspire. Speak to the library if you do not normally have cause to use Talis Aspire.
  2. There is no list found for the course in the learning system. What can I do?
    You will need to use a course which already has a list associated with it in Talis Aspire.
    This might also mean you have to first create a course in the Talis Aspire Hierarchy and create a list to link to the course. Your library will be able to help you setup some test data and support you.
    If the course DOES already exist in Talis Aspire but is not found, we will need to adjust the configuration of the deployment to detect the correct course codes and map them to the Talis Aspire hierarchy.  You can do this by sending us a list of common Course code formats as seen in your learning system. If you already have an LTI 1.1 integration, you can also copy and paste any custom parameters into a support ticket so that we can use those as part of the configuration.
  3. I get an error saying "UNREGISTERED_PLATFORM" what does this mean?
    This means that there is an issue with the LTI registration. Please record a HAR file while you are clicking the links that generate that error, and share it with the support team.
  4. I get an error saying "Failed to fetch public key" what can I do?
    This means that as part of the LTI authorisation process out LTI tool has requested a public key from your learning system, but has not been able to get a response. You will need to ensure that the public key URL for your learning system is accessible on the internet. This can happen if your learning system is in a development environment which may not normally be visible to the outside world. You will need to work with your IT team to resolve this, and they may ask for a list of IP addresses for Talis systems.

Talis Elevate LTI Testing FAQs

  1. I get an error saying "UNREGISTERED_PLATFORM" what does this mean?
    This means that there is an issue with the LTI registration. Please record a HAR file while you are clicking the links that generate that error, and share it with the support team.
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.