Set up and test an LTI connection with Saltire

Set up a Linqur LTI 1.1 (Legacy) tool in the Saltire platform emulator, launch it as a test user, trigger a grade and check that it reaches the Saltire gradebook and Linqur.

Saltire is an LTI platform emulator, so you can test a Linqur LTI tool without a real LMS. You paste the Launch URL and the Secret into Saltire, open the content as a test user and trigger a grade. A minute later you check the gradebook in Saltire and the registered users in Linqur. The interactive walkthrough below shows the same steps; the text follows it.

Before you start

• You have an LTI 1.1 (Legacy) tool in Linqur, with its Launch URL and Secret. See publish a SCORM package as an LTI tool and share the launch details of an LTI tool.
• The tool publishes content that can send a grade. The free sample SCORM file has buttons for completed, incomplete and a score, so you don’t need your own course material.

Step by step

1. Open Saltire in a private window

Open a new private browser window (also called incognito mode). The launch logs you in to Linqur as an LTI user, without administrator rights. If you are logged in to Linqur as administrator in the same browser, that leads to errors. In the private window, go to saltire.lti.app/platform.

2. Choose a test user

Click User in the sidebar.

Click Select a user at the top right.

Choose a learner from the list.

3. Open the Security Model

Click Security Model in the sidebar.

4. Enter the Launch URL

Select the content of the Message URL field. You replace it with the Launch URL of your tool.

Paste the Launch URL from Linqur in Message URL.

5. Enter the Secret

Paste the Secret from Linqur in Shared secret. You can leave Consumer key on the default value of Saltire; any value works.

6. Save

Click Save at the top left.

7. Connect

Click Connect at the top right.

A new tab opens with your content. If you see your content, the connection works.

8. Trigger a grade

To test whether the tool sends a grade, trigger a grade or a completion in the content. In the sample package you click Completed/passed.

The package confirms which status it sent. Linqur sends the grade to Saltire within about a minute.

9. Check the Saltire gradebook

After a minute, switch back to the Saltire tab and click View.

Click Gradebook.

The gradebook shows a score, a status and the activity progress of the test user.

10. Check Linqur

Open the tool details in Linqur and click the Registered users tab. The tabs are explained in share the launch details of an LTI tool.

The Grade column shows the grade that was sent through the LTI tool.

For a SCORM package, the SCORM results tab shows the grade and the status that the package itself recorded.

If the status or the score changed here, but not in the gradebook of Saltire, the grade did not synchronise. Check the grade synchronisation setting of the tool in LTI tool settings explained and look the error up with the Debug assistant.

Next step

• If Connect returns an error instead of the content, look the message up in the list of LTI errors and their solutions.
• Once Saltire shows the grade, the same Launch URL and Secret go into the real LMS: Moodle 4.x via LTI Legacy (1.1/2.0), Docebo via LTI Legacy (1.1/2.0) or Pluvo via LTI Legacy (1.1).
• The short version of this test, with the request and the response: test a Legacy LTI connection with Saltire.