saLTIre is a testing system for LTI®. It is designed to allow users to inspect the communications which occur between an LTI Tool Consumer and an LTI Tool Provider. The test systems can be accessed via the buttons above; the expected use cases are:
Note that the tools are designed to allow both valid and invalid communications to be sent and received, hence they do not ensure that only valid (compliant with the LTI specification) messages are composed. This allows the system to be used for testing that other systems properly handle invalid connections, not just valid ones.
The content below provides some information which you may find helpful when using the tools.
Note that some options within the system will be disabled when settings have been changed - use the Save to resolve this.
Use this menu to change the page which is displayed.
Each parameter supported by the LTI specification has an input box containing its current value.
The associated checkbox can be used to disable the parameter to stop it from being sent in the message.
Some parameters have a menu which can be used to select a value, but values may always be entered manually.
A checkbox is provided on the Tool Consumer page for each algorithm which is to be available.
The selected algorithms are available for signing the current message on the Message page.
A checkbox is provided on the Tool Consumer page for each service which is to be available. A settings panel is displayed for each selected service.
Each supported capability can be enabled on the Tool Consumer page. Capabilities related to services are not included here, but are automatically assumed when a service is selected.
Capabilities are divided into categories based on their type or prefix. Clicking on the title expands and hides the capabilities for the category.
Clicking on the Connect button on the Tool Provider page will cause a message of the type selected on the Message page to be sent to the Tool Provider using URL and credentials supplied on the same page. You can preview the message or override where the connection is opened via the drop-down menu.
Only those parameters on each page which have been checked will be included in the message. Service parameters for any selected service will automatically be included as well.
Custom parameter substitution variables will be replaced where an appropriate value is available (for example, $User.username).
Clicking on the Register button on the Tool Provider page will cause a ToolProxyRegistration message to be sent to the Tool Provider. The Tool Consumer Profile will include those services and capabilities which are selected on the Tool Consumer page.
When a Tool Proxy is accepted, the Tool Provider page is replaced with a copy of the Tool Proxy and a summary of the agreed credentials. The services and capabilites on the Tool Consumer will be selected based on the services in the security contract and the enabled capabilities for a resource. Any parameters required for the message type will always be selected. All others are signified by a checkbox with a shaded background - the system allows the choices to be changed but the checkbox presentation will identify which formed part of the agreed Tool Proxy.
A resource defined in the Tool Proxy should be selected from the menu provided on the Tool Proxy page. A message supported by the resource should be selected on the Message page.
A Tool Proxy can be cancelled by clicking on the Unregister button.
Alternatively, the Test Tool Provider can be opened directly in a browser and the Tool Consumer credentials and service endpoints entered manually.
Use this menu to change the page which is displayed.
This tab summarises the message received which opened the system.
This tab displays the credentials and security profile used for connections with the Tool Consumer. These values are used when sending service requests to the Tool Consumer. Changing them allows invalid requests to be tested.
If a Tool Consumer Profile has been obtained it will be also be displayed on this tab.
This tab is displayed for ContentItemSelectionRequest messages. You can use it to select sample content-item(s) to be returned to the Tool Consumer, or to create a bespoke item. Messages to be returned with the items can also be added.
This menu lists all the services supported by the Test Tool Provider; those which have not been made available by the Tool Consumer will be disabled. Selecting a service from the menu will display the settings relevant to its use, including the endpoint(s). The settings page can be used to send requests to the Tool Consumer; use the View menu (see below) to inspect the request made and response received.
This menu provides access to the last message sent to an endpoint for the currently selected service. A tab is displayed for the each of the request and response elements.
More information about LTI and how to use it can be found in the following sources: