Set up a Reusable LTI Store

Set up a Reusable LTI Store#

Tags: educator how-to

The Reusable LTI Store centralizes LTI configuration in Django Admin. Course authors then reference a single reusable configuration in Studio (via the LTI Consumer component). A single configuration can be referenced multiple times, eliminating repeated copy/paste of tool credentials.

Overview#

The Reusable LTI Store allows operators and course authors to simplify setup by:

  • Defining LTI configurations once in Django Admin.

  • Allowing course authors to reference those configurations in Studio.

  • Reducing errors and duplication of tool credentials.

This feature supports LTI 1.3 integrations and is particularly useful for institutions running multiple courses with the same tool.

Before you start#

To use the Reusable LTI Store, ensure the following:

  • You have an operational Open edX deployment.

  • You have staff access to Django Admin (model-level access to lti_store).

  • You have access to an LTI 1.3 tool with:

    • Client ID

    • Deployment ID

    • OIDC/Authorization URL

    • Launch URL

    • JWKS (key set) URL or a tool public key

  • For Tutor-based deployments: You can install Tutor plugins.

  • For non-Tutor deployments: You can install and configure Django apps.

Install the LTI Store Tutor Plugin#

  1. Install the plugin from the LTI Store Repository and follow the plugin’s README to enable it for your environment.

  2. Rebuild and restart your platform. Apply the plugin’s documented Tutor config, images rebuild, and services restart steps.

Note

For non-Tutor installations, follow Non-Tutor Install Instructions. Most community operators use Tutor, but some large operators do not.

Grant staff access for LTI Store administration#

To create and manage reusable configurations:

  • Ensure the user has is_staff enabled.

  • Assign permissions for the LTI Store models only (no superuser needed).

  • This limits access to just the LTI Store configuration screens.

Create a reusable LTI configuration#

Note

The following steps correspond to an LTI 1.3 configuration.

  1. Open Django Admin.

  2. Navigate to: /admin/lti_store/externallticonfiguration/ (You must be logged in as a staff user with LTI Store model access.)

  3. Add a new External LTI Configuration.

'Add External LTI Configuration' button on Django Admin

  1. Enter the required fields:

    • Name

    • Slug (will be automatically generated from the name if left blank)

    • Version: LTI 1.3

    • LTI 1.3 Client ID: Provided by the tool.

    • LTI 1.3 Deployment ID: Provided by the tool.

    • LTI 1.3 OIDC URL: Provided by the tool (sometimes called “OIDC auth URL”).

    • LTI 1.3 Launch URL: The tool’s launch URL for LTI 1.3.

    • LTI 1.3 Private key: Platform private key for this registration. Must be supplied manually. You can generate these using the IMS LTI Reference Implementation.

    • LTI 1.3 Tool Keyset URL (recommended), or LTI 1.3 Tool Public Key

    • LTI 1.3 Redirect URIs: Required by some tools. For many tools this matches the launch URL. If not specified otherwise, use your launch URL in a JSON list. For example:

      ["https://example.com/launch"]

LTI store configuration fields in Django Admin

  1. Save the configuration.

  2. After saving, note the Filter key displayed on the External LTI Configurations screen (/admin/lti_store/externallticonfiguration/). The Filter Key usually has the form lti_store:slug (e.g. lti_store:reference_tool). You will use this value later in Studio when referencing this configuration from the LTI Consumer component.

Best practices#

  • Use clear, consistent names for configurations and slugs (for example: tool-environment-purpose).

  • Keep a registry of created configurations (tool name, environment, slug, owner) to assist course teams.

  • Create separate configurations per environment (production, staging, sandboxes) since Client ID and Deployment ID typically differ.

Notes on current limitations and improvements#

  • Dynamic registration: The LTI community is adopting dynamic registration, which allows configuring an LTI integration from a single URL. This may simplify setup in future releases. The Open edX platform does not currently support dynamic registration.

  • Alternative reuse path: Reusable Library Components may allow LTI reuse without the LTI Store. Investigation is ongoing; migration guidance will be provided if this path becomes preferred.

Next steps#

  • Share the Filter key with course authors.

  • Authors configure the LTI Consumer component in Studio to use this reusable configuration (documented separately).

See also

Set up an LTI Consumer with Reusable LTI Configuration (how-to)

LTI Component Settings (reference)

Enable LTI Components for a Course (how-to)

Set Up an LTI 1.1 Component (how-to)

Set Up an LTI 1.3 Component (how-to)

Enable and Use LTI Advantage Features (how-to)

Using Open edX as an LTI Tool Provider (concept)

Maintenance chart

Review Date

Working Group Reviewer

Release

Test situation

Ulmo

Draft
Contents