Adding an LTI 1.1 consumer#

LTI 1.1#

Click the Add a new LTI 1.1 consumer button.

You will be asked to give a unique _key_ to identify the consumer, and optionally the URL of the consumer’s homepage. The key can be any text, but should uniquely identify the consumer and its purpose.

Form with fields "Home URL of consumer", "Field used to identify students" and "Key".

The “Add a consumer” screen.#

Once you have created a consumer, you are shown its key and shared secret. These are the pieces of information that the consumer will use to establish a secure connection with the Numbas LTI provider.

A card showing information about the consumer "my_moodle", with LTI version 1.1, a shared secret, and 0 resources. Next to it is a button to add a new LTI 1.1 consumer.

The consumer management screen.#

You must now set up the connection from the consumer’s end. There are instructions for some of the most popular VLEs below.

Blackboard Learn#

Follow Blackboard’s instructions - you’ll need to add Numbas as a new LTI Tool provider, and then add a placement for it.

Blackboard doesn’t support automatic configuration by URL, so you’ll have to use the manual configuration settings.

For the tool provider, fill in the following values:

Provider domain

Your launch URL.

Tool provider key

Your consumer key.

Tool provider secret

Your shared secret.

For the placement, fill in the following values:

Label

“Numbas”

Type

“Content Type”, and select “Assessments” in the menu.

Placement allows grading

Ticked.

Save the icon from your “Manage consumers” page and upload it under the Icon field on the Blackboard form.

You can now add a Numbas exam to any folder in Blackboard by selecting “Numbas” from the Assignments menu.

Moodle#

Moodle from version 3.0 onwards supports LTI configuration by URL. Earlier versions require you to enter the configuration settings manually.

If you have administrator privileges on Moodle, you can add the tool as an activity type, so you don’t have to enter the settings for each exam.

Moodle 3.0+#

  • Go to Site administrationPluginsActivity modulesExternal toolManage tools.

  • Paste your automatic configuration URL into the box labelled Tool URL, and click Add Legacy LTI.

  • Enter your consumer key and shared secret, then click “Save changes”.

  • Go back to the Manage tools page and edit the Numbas tool.

  • For Default launch container, select “New window”.

  • If you’d like Numbas to show up as an activity type, bypassing the “External tool” step, for Tool configuration usage, select “Show in activity chooser and as a preconfigured tool”.

Now you can add a Numbas exam in any course by clicking Add an activity or resource and selecting External tool, then select “Numbas” from the Preconfigured tool dropdown.

Versions of Moodle before 3.0#

  • Go to Site administrationPluginsActivity modulesExternal toolManage tools.

  • Click on Configure a tool manually.

  • Fill in the following values:

    Tool name

    “Numbas”.

    Tool base URL

    Your launch URL.

    Consumer key

    Your consumer key.

    Shared secret

    Your shared secret.

  • Under Tool configuration usage, select “Show in activity chooser and as a preconfigured tool”.

Now you can add a Numbas exam in any course by clicking Add an activity or resource and selecting Numbas.

Canvas LMS#

  • Go to your course’s Settings page, then click on Apps and View App Configurations.

  • Click the button to add an App.

  • Fill in the following values:

    Configuration type

    “By URL”.

    Consumer key

    Your consumer key.

    Shared secret

    Your shared secret.

    Config URL

    Your automatic configuration URL.

Now you can add a Numbas exam in your Modules page:

  • Click the button to add an item.

  • Select External tool and click on Numbas.

  • Click Add item.

D2L BrightSpace#

Note

These notes were based on a single installation performed in March 2022.

You must have the “Manage External Learning Tools Configuration” permission.

  • In the Admin Tools menu, under Organizational Tools, click External Learning Tools.

  • Switch to the Manage External Learning Tool Links tab.

  • Click New Link.

  • Fill in the following values:

    Title

    “Numbas”.

    URL

    Your launch URL.

    Allow users to view this link

    Ticked

    Sign messages with key/secret with

    “Link key/secret”

    Key

    Your consumer key.

    Secret

    Your shared secret.

    Security settings

    Ensure the following are ticked:

    • “Send tool consumer information to tool provider”

    • “Send LTI user ID and LTI role list to tool provider”

    If you want to be able to identify students within the Numbas LTI tool, you should also tick:

    • “Send user name to tool provider”

    • “Send user email to tool provider”

  • Click Save and Close.

Now you can add a Numbas exam in your Modules page:

  • Click Existing activities.

  • Select External Learning Tools.

  • Select Numbas.