Blackboard LTI Configuration Guide

This guide explains how to configure a Blackboard LTI 1.3 integration with Apporto NextGen, add the tool to a Blackboard course, and complete the first launch that provisions the user in Apporto.

Overview

The configuration requires work in three places:

  • Blackboard Developer Portal (developer.blackboard.com) to register the application and obtain the Application / Client ID, Key, and Secret

  • Blackboard instance (Admin) to register the LTI 1.3 / Advantage tool and manage its placements

  • Apporto NextGen to create the LTI configuration

Once setup is complete, the tool can be added to a Blackboard course and used to launch Apporto. The first launch creates the user in Apporto.

Prerequisites

  • Administrator access to the Blackboard instance

  • Access to the Blackboard Developer Portal

  • Administrator access to the Apporto NextGen environment

  • A publicly reachable Apporto instance URL (Blackboard does not support localhost URLs)

  • A Blackboard course available for launch testing (for example, Math 101)

  • Client Secret, API Client Secret, and API Key values (provided by the developer team)

Step 1: Sign in to both platforms

  1. Log in to the Blackboard instance as an administrator. Example: https://apporto-test.blackboard.com/

  2. Log in to Apporto NextGen as an administrator. Example: https://{instancename}.apporto.com

Step 2: Register the application on the Blackboard Developer Portal

  1. Go to the Blackboard Developer Portal and log in.

  2. Click + to create a new application and select Manual Registration.

    image-20261110-131719.png
  3. Enter the application name, description, and other required details using the values below.

Field

Value / Guidance

Application Name

Example: Apporto NextGen

Domain(s)

Example: {instancename}.apporto.com

Login Initiation URL

https://{instancename}.apporto.com/api/auth/lti/v2/lti/login

Tool Redirect URL(s) / Target Link URI

https://{instancename}.apporto.com/api/auth/lti/v2/lti/launch

Tool JWKS URL

https://{instancename}.apporto.com/api/auth/lti/v2/lti/keys

image-20261110-132032.png
  1. Configure any remaining LTI settings as needed, then click Register application.

  2. Copy the credentials shown after registration (Application ID, Key, Secret). The secret is only displayed once.

    image-20261110-132116.png

The Application ID from this step is the Client ID used in both Blackboard (Step 3) and Apporto NextGen (Step 4).

Step 3: Register the LTI 1.3 tool in Blackboard

  1. In the Blackboard instance, open Admin from the navigation menu.

  2. Under Integrations, select LTI Tool Providers.

    image-20261110-132716.png
  3. Click Register LTI 1.3/Advantage Tool.

  4. Enter the Client ID (Application ID from Step 2) and click Submit.

    blackboard-b677ed89.png
  5. On the tool provider details page, click Edit and confirm the endpoints match your Apporto instance:

    • Initiate Login URL: https://{instancename}.apporto.com/api/auth/lti/v2/lti/login

    • Tool Redirect URL: https://{instancename}.apporto.com/api/auth/lti/v2/lti/launch

    • JWKS URL: https://{instancename}.apporto.com/api/auth/lti/v2/lti/keys

    blackboard-b4eed42f.png
  6. Note the Client ID shown on this page. Example: 05c45aaa-3d60-45f6-b00c-9285ccf9065d

  7. From the tool's dropdown menu, select Manage Placements and create a placement (for example, Apporto NextGen, type Course content tool) so the tool can be added to courses.

    image-20261110-134435.png
image-20261110-134512.png
image-20261110-134602.png
image-20261110-134658.png

Caution: Blackboard does not support localhost URLs. Use a publicly reachable Apporto instance URL.

Step 4: Create the LTI configuration in Apporto NextGen

  1. In NextGen, go to {Base URL}/system-config.

  2. Select the LTI CONFIGURATION tab.

  3. Click Create New LTI Configuration.

  4. Complete the LTI configuration form using the values below.

Field

Value / Guidance

LTI Type

Blackboard LTI

LTI Course Type

Set as per need:

  • Course and Section: Syncs at both the course and section levels, allowing rosters to be tracked separately for each section within a course.

  • Course Only: Treats the entire LMS course as a single group; section-level distinctions are not considered.

  • Section Only: Provisions users by section only; the parent course is not used as a grouping level.

LTI Base URL

Your Blackboard instance URL.
Example: https://apporto-test.blackboard.com

Auth Login URL

https://developer.blackboard.com/api/v1/gateway/oauth2/jwttoken

Auth Token URL

{LTI Base URL}/learn/api/public/v1/oauth2/token
Example: https://apporto-test.blackboard.com/learn/api/public/v1/oauth2/token

Client ID and API Client ID

The Blackboard Client ID from Step 3.
Example: 05c45aaa-3d60-45f6-b00c-9285ccf9065d

Client Secret and API Client Secret

Provided by the developer team.

OIDC Login Redirect

{instanceName}/api/auth/lti/v2/lti/login
Example: https://test-ng-onprem.apporto.com/api/auth/lti/v2/lti/login

API Key

Provided by the developer team.

App Identifier

nid
Used for deep linking. Pass the desktop ID you want to deep link to in the tool's custom fields (for example, nid=<desktop id>).

Example of a completed Blackboard LTI configuration form:

blackboard-6b7e164b.png
blackboard-cd23123e.png

Caution: Blackboard does not support localhost URLs. Ensure all URLs exactly match the Apporto environment being used.

Step 5: Save the configuration

  1. Click Submit to save the LTI configuration.

  2. After successful submission, NextGen redirects to {Base URL}/system-config?tabIndex=5, where the new Blackboard configuration is listed.

Expected result: The Blackboard LTI configuration is saved and ready to be used from Blackboard courses.

Step 6: Add the tool to a Blackboard course

  1. In Blackboard, open the course from which you want to launch Apporto.

    image-20261110-135624.png
  2. Go to Content and click Build Content.

    image-20261110-135919.png
  3. Enter a name for the link and click Submit. The tool is now available in the course.

    image-20261110-140014.png

Step 7: Launch Apporto from Blackboard

  1. In the course, click the Apporto NextGen tab / link to get the launch link.

  2. Click Open in new window. This redirects to your Apporto instance and creates the user.

  3. Launch the desktop assigned to you.

    blackboard-8743ebd3.png

Expected result: The user is provisioned in Apporto NextGen and can launch their assigned desktops.

Troubleshooting

Launch or login fails

  • Confirm the Client ID, Client Secret, API Key, and API Client Secret match the Blackboard Developer Portal application.

  • Verify the Login Initiation, Tool Redirect, and JWKS URLs exactly match the Apporto environment.

  • Verify the Auth Token URL uses the correct Blackboard base URL.

  • Make sure you are not using localhost.

Tool does not appear in the course

  • Confirm the tool is registered under Admin > LTI Tool Providers and its status is approved/enabled.

  • Confirm a placement was created via Manage Placements.

Course launch does not open Apporto

  • Use Open in new window rather than launching inside the Blackboard frame.

  • Validate that the user has an assigned desktop after provisioning.

Deep linking does not open the expected desktop

  • Confirm the App Identifier is set to nid.

  • Verify that the correct desktop ID is being passed in the custom fields.