Consumers

A tool consumer is an application which sends users to the Numbas LTI provider, and receives score data in return. In most cases, this will be a Virtual Learning Environment (VLE), such as Blackboard, Canvas or Moodle.

Only admin users on the LTI provider can create and manage consumers.

Adding a consumer

The first step is to add a consumer. Click the Add a new LTI 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 "Consumer key" and "Home URL of consumer"

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.

Table listing consumer key and shared secret, and a section detailing configuration information.

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.

Managing a consumer

Click on the Manage button to see more detailed information about a consumer.

The management view lists all contexts provided by this consumer. Contexts usually correspond to courses in a VLE - all resources launched from the same course will appear under the same context here. Click on a context’s name to see all resources in that context.

Time periods

Time periods allow you to group a consumer’s contexts by when they were active. You could use this to group contexts by academic year, for example.

Click on the Manage time periods button at the bottom of the consumer management page. Each time period has a name and start and end dates.

Each context is assigned to the latest time period containing the date on which the context’s first resource was created. If a context falls into a gap between non-overlapping time periods, it will be shown separately.

Time periods are used solely to group contexts in the display. If you change or delete a time period, no data will be lost.