LTI Integration Setup Guide

LTI (Learning Tools Interoperability) is the open standard that lets PaperScorer connect to LMS platforms like Canvas, Brightspace, Blackboard, and Moodle. This article walks through setting up an LTI integration from scratch, verifying it, and managing it over time.

Before You Begin

You’ll need:

• Administrator access to both PaperScorer and your LMS.
• Your LMS instance’s domain (e.g. canvas.yourdistrict.edu ).
• The ability to create an LTI developer key or external tool in your LMS.

PaperScorer supports the following LMS platforms via LTI:

• Canvas
• Brightspace (D2L)
• Blackboard
• Moodle

If your LMS isn’t listed but supports the LTI standard, contact support@paperscorer.com to confirm compatibility.

Step 1: Create the LTI Integration in PaperScorer

1. Sign in to PaperScorer as an enterprise administrator with the Enterprise Client: Manage Connections permission.
2. From the enterprise menu, open LTI Integrations.
3. Click Add Integration.
4. Fill in the form:
   • Type — pick your LMS (Canvas, Brightspace, Blackboard, or Moodle).
   • Client Domain — your LMS instance domain (e.g. canvas.yourdistrict.edu ). Omit the http://  or https://  prefix; PaperScorer strips it automatically if you include it.
   • Description — an internal label for your reference (e.g. “District Canvas”).
   • Client ID — provided by your LMS after creating the developer key (filled in after Step 2).
   • Client Secret — provided by your LMS (filled in after Step 2).
5. Save.

Saving generates a Consumer Key and Consumer Secret for this integration — you’ll need these in Step 2 when you configure PaperScorer in your LMS.

Step 2: Configure PaperScorer in Your LMS

The exact steps vary by LMS, but the general process is the same:

1. Sign in to your LMS as an administrator.
2. Navigate to the developer tools or external tools section.
3. Create a new LTI tool or developer key.
4. Enter PaperScorer’s consumer key and consumer secret from Step 1.
5. Set the launch URL to:

https://app.paperscorer.com/connected_lti.php

1. Save the configuration and copy the LMS-generated Client ID and Client Secret back into PaperScorer (Step 1 form).

Canvas-Specific Setup

In Canvas, this is a Developer Key created from the Admin panel:

1. Go to Admin → Developer Keys → + Developer Key → + LTI Key.
2. Choose Method Paste JSON if PaperScorer provides JSON; otherwise fill in the form fields manually.
3. Save the key and toggle it ON.
4. Copy the resulting Client ID back into PaperScorer.

Brightspace-Specific Setup

In Brightspace, PaperScorer is registered as a deployed tool:

1. Go to Admin Tools → Manage Extensibility → LTI Advantage.
2. Click Register Tool and fill in PaperScorer’s details.
3. Copy the resulting Client ID back into PaperScorer.

Step 3: Verify the Integration

Once both sides are configured, you need to verify the connection works.

1. Return to LTI Integrations in PaperScorer.
2. Find the integration you just created.
3. Open the integration’s action menu and select Verify.
4. You’ll be redirected to your LMS to authorize the connection.
5. Approve the authorization in your LMS.
6. You’ll be redirected back to PaperScorer.

Once verified, the integration’s status badge changes from Not Verified to Verified.

Step 4: Connect Teachers

Once an integration is verified at the organization level, individual teachers can connect their PaperScorer accounts to the LMS:

1. Each teacher signs in to PaperScorer.
2. They open Account → Connected Accounts.
3. They click Connect next to the relevant LMS.
4. They authorize the connection through their LMS sign-in.
5. Their LMS classes and rosters become available to import.

For platform-specific roster-import flows, see:

• Importing Canvas Classes and Rosters
• Importing Brightspace Classes and Rosters

Managing an LTI Integration

Editing the Integration

From the integration’s action menu, choose Edit to update the domain, Client ID, or Client Secret.

Revealing the Consumer Secret

The Consumer Secret is masked by default. Click the eye icon to reveal it temporarily, or the copy icon to copy it to your clipboard without displaying the value.

Active vs Inactive

Each integration has an active toggle. Toggling it off preserves the integration record but prevents new connections from being established — useful when troubleshooting or sunsetting an LMS.

Deleting an Integration

From the integration’s action menu, choose Delete. Deleting:

• Removes the integration from PaperScorer.
• Disconnects every teacher who was using it.
• Does not delete the assessment data they’ve already created or synced.

Troubleshooting

Verification Fails

• Confirm the Client ID and Client Secret match the LMS exactly — copy-paste, don’t retype.
• Confirm the Client Domain in PaperScorer matches your LMS URL (no http://  prefix).
• Confirm the LTI tool is enabled on the LMS side (Canvas requires the key to be toggled ON).

Teachers Can’t Connect

• Confirm the integration shows the Verified badge.
• Confirm teachers are signing in with the correct LMS account (their school account, not a personal Google or Apple account).
• For Canvas/Brightspace, confirm teachers have permission to install LTI tools in their courses.

Grades Aren’t Syncing

• Confirm the teacher completed Step 4 and connected their personal account.
• Confirm the assessment is linked to an LMS-imported class.
• See Troubleshooting LMS Sync Issues.

Security Notes

• Consumer secrets and client secrets are sensitive. Never paste them into email, chat, or shared documents.
• If you suspect a secret has leaked, rotate it in your LMS and re-enter the new value in PaperScorer.
• PaperScorer stores secrets encrypted at rest.
• Every LTI launch is validated server-side — a stolen secret on its own can’t be used without also being able to spoof your LMS’s domain.

Related Articles

• Connecting Your Account to Canvas
• Connecting Your Account to Brightspace
• Troubleshooting LMS Sync Issues
• Whitelist Requirements for Locked Down Environments