Overview
Connecting Brightspace to SolidProfessor takes three objects in Brightspace, and all three are required: a registration, a deployment and a link.
| Object | What it does |
|---|---|
| Registration | Tells Brightspace who SolidProfessor is. Created once per institution. |
| Deployment | Decides which parts of your institution can use SolidProfessor. |
| Link | What instructors actually see inside a course. |
Stopping after the registration and deployment is the most common setup mistake. Everything looks finished on the admin side, but instructors see nothing in their courses.
Brightspace connects as a custom integration, so a few web addresses are entered by hand. Nearly all of them are copy and paste from this guide.
Here is who does what:
| Stage | Who | What happens |
|---|---|---|
| Before you start | SolidProfessor | We add your Brightspace details to SolidProfessor first. |
| Steps 1 to 6 | Brightspace administrator | Register, deploy and link SolidProfessor in Brightspace. |
| Step 7 | You and SolidProfessor | You send us three IDs and we finish the connection. |
| Hand-off | An instructor | Add SolidProfessor content to a course to test it. |
Before you begin
Three things need to be in place before you open Brightspace: your permissions, your Brightspace address, a known or anonymous decision, and your instructors' emails.
- Permissions: administrator access with both Manage LTI Advantage Tool Registrations and Manage LTI Advantage Tool Deployments at the organization level. They are two separate permissions, and you need both.
- Your Brightspace web address: for example, https://university.brightspace.com, with no slash at the end. Send it to your SolidProfessor Customer Success Manager.
- Known or anonymous: tell us which connection you want. A known (unmasked) connection shares each student's name and email, so students get real SolidProfessor accounts. An anonymous (masked) connection shares nothing, and students exist only through Brightspace. Your choice sets the Security Settings in Step 3.
Brightspace Platform Details
These addresses come from the school's Brightspace and are entered in SolidProfessor, by your SolidProfessor CSM. We will replace {brightspace-url} with your school's actual address (no slash at the end).
| Setting in SolidProfessor | Value |
|---|---|
| Issuer ID |
{brightspace-url} (e.g., https://university.brightspace.com) |
| OIDC Authorization Endpoint / Redirect URL | {brightspace-url}/d2l/lti/authenticate |
| OAuth 2 Access Token Endpoint URL | https://auth.brightspace.com/core/connect/token |
| JWKS URL | {brightspace-url}/d2l/.well-known/jwks |
The access token address is the same for every Brightspace customer and sits on a different web address than the rest. That is expected, not a typo. Everything else uses the institution's own address and includes a /d2l/ segment.

Wait for our confirmation before you register the tool in Step 1 below. Brightspace checks SolidProfessor's keyset address the moment you click Register. We need to add your Brightspace address on our side first, or Brightspace reports "Keyset URL is unreachable" even though nothing is wrong.
NOTE: Anyone who launches SolidProfessor from Brightspace without a matching SolidProfessor account is created as a student. If an instructor's Brightspace email doesn't match their SolidProfessor email, their first launch creates an inactive student account and drops them on the payment screen.
Step 1: Register SolidProfessor as a tool
Register SolidProfessor once, using a Standard registration, after we confirm our side is ready.
- Log into Brightspace as an administrator and open Admin Tools (the gear icon).
- Select Manage Extensibility.
- Open the LTI Advantage tab and click Register Tool.
- Choose Standard, not Dynamic.
Then fill in the form using these values:
| Brightspace field | What to enter |
|---|---|
| Enabled | On |
| Name | SolidProfessor |
| Domain | https://plt-backend.solidprofessor.com |
| Redirect URLs | https://plt-backend.solidprofessor.com/api/v1/lti/launch |
| OpenID Connect Login URL | https://plt-backend.solidprofessor.com/api/v1/lti/oidc |
| Target Link URI | https://plt-backend.solidprofessor.com/api/v1/lti/launch |
| Keyset URL | https://plt-backend.solidprofessor.com/api/v1/lti/jwks?iss=YOUR-BRIGHTSPACE-ADDRESS |
Only the Keyset URL changes from school to school. It ends with ?iss= followed by your Brightspace web address, for example: https://plt-backend.solidprofessor.com/api/v1/lti/jwks?iss=https://university.brightspace.com
Think of it like a return address on an envelope. When Brightspace asks SolidProfessor for its security keys, it has to say who is asking, so SolidProfessor knows which keys to send back.
Then set the rest of the form:
- Extensions: check Assignment and Grade Services only. Leave Names and Role Provisioning Services and Platform Notification Service unchecked. SolidProfessor doesn't read class lists, so it doesn't need them.
- Roles: leave Send Institution Role checked. This is the default.
- There is no Deep Linking option in the Extensions list, and you don't need one. Brightspace turns it on for every tool, and you choose the deep linking behavior on the link in Step 6.
Click Register.
If Brightspace says the keyset URL is unreachable, our side isn't set up yet. Contact us before trying again.

Step 2: Copy the registration details
After you register, Brightspace shows a Brightspace Registration Details panel, and the Client Id on it is the one value you need to send us.
| Brightspace shows | What to do |
|---|---|
| Client Id | Copy it. You will send it to us in Step 7. |
| Issuer | Confirm it matches your Brightspace web address. |
| OpenID Connect Authentication Endpoint | Confirm it matches your Brightspace address. |
| Brightspace Keyset URL | Confirm it matches your Brightspace address. |
| Brightspace OAuth2 Access Token URL | The same for every Brightspace customer: https://auth.brightspace.com/core/connect/token. It sits on a different address than the rest, and that is expected. |
| Brightspace OAuth2 Audience | Nothing. SolidProfessor doesn't need it. |
Read these off the screen rather than assuming. Institutions hosted through a consortium can differ from the standard pattern. Send us a copy or screenshot of the whole panel so we can confirm our side matches.
When you're done, click View Deployments to continue to Step 3. You can also click Save and Close and come back later through Admin Tools, External Learning Tools, then LTI Advantage.

Step 3: Create the deployment
The deployment decides what Brightspace shares with SolidProfessor, so the Security Settings here depend on whether your connection is known or anonymous.
- From the registration details page, click View Deployments. Otherwise go to Admin Tools, External Learning Tools, then LTI Advantage.
- Click New Deployment.
- Tool: choose the SolidProfessor registration from Step 1.
- Name: SolidProfessor.
- Extensions: check Assignment and Grade Services. Anything you left off at the registration appears grayed out here.
Under Security Settings, select the information to share with SolidProfessor:
| Connection | What to check |
|---|---|
| Known (unmasked) | User Information, then Name (First Name and Last Name), Email and User ID. Leave Username, Org Defined Id and Middle Name unchecked. |
| Anonymous (masked) | Leave every User Information box unchecked. Sharing nothing is what makes the connection anonymous. There is no separate Anonymous toggle. |
Leave Classlist including users not known to this deployment unchecked.
For a known connection, Name, Email and User ID must all be checked. If any are left off, SolidProfessor can't match students to their accounts, and the problem looks like a login failure instead of a privacy setting.
Then set the Configuration Settings:
- Auto Create Grade Items: on.
- Grades created by LTI will be included in Final Grade: your institution's grading policy decision.
- Open as External Resource: off, so SolidProfessor content appears inside the course. If launches fail, turning it on is a useful test, because it opens SolidProfessor in a new tab and removes browser cookie restrictions from the picture.
- Leave all other settings at their defaults.
Brightspace doesn't always honor Open as External Resource. A link added through Content, Existing Activities, External Learning Tools opens as an external resource regardless of this setting. If a launch opens in a new tab when you expected it embedded, that is the likely reason.
Don't save yet. Continue to Step 4 and Step 5 on the same page.
Step 4: Add the two parameters
SolidProfessor needs two pieces of information on every launch: who the user is and which school they belong to, and launches fail without both.
Brightspace splits these into two separate boxes, still on the deployment page:
- Under Substitution Parameters, click Add Substitution Parameter.
Name: user_id. Value: choose $User.id from the dropdown. - Under Custom Parameters, click Add Custom Parameter.
Name: lms_school_id. Value: a short label your school chooses, for example north-campus.
Substitution parameters hold values Brightspace fills in automatically. Custom parameters hold fixed text. Both names must be exactly user_id and lms_school_id, lowercase with underscores. Putting the school label in the Substitution Parameters box is a common mistake.
The school label can be any plain text, but it has to match exactly, including capitalization, what we enter as your School ID. You'll send it to us in Step 7. If the two don't match, users see a "school not linked" message.
Set each parameter in only one place. In this setup, both go on the deployment.
If your Brightspace serves more than one SolidProfessor school, stop here and contact us first. The setup is different.
Step 5: Choose where SolidProfessor is available
A deployment with no org units reaches nobody, so this step is what actually makes SolidProfessor available to courses.
At the bottom of the deployment, under Make tool available to, click Add Org Units. Which level to choose depends on how your Brightspace is organized. Filter by org unit type first, then pick the unit and set its scope:
| To cover | Do this |
|---|---|
| A whole department | Filter by the Department org unit type, find the department, tick it, and set the scope to This org unit and all descendants. This includes courses created later. |
| One semester or another narrower grouping | Filter to that level instead and apply the same scope to it. Use this to keep the tool contained rather than campus-wide. |
| One course | Pick the course offering itself. |

The scope defaults to This org unit. On an organization or department, that covers the container only and none of the courses inside it. With the default, the deployment looks finished and the link is enabled, but instructors see an empty list.
To confirm the scope saved correctly, look at the list under Make tool available to. Choosing This org unit and all descendants produces two rows: The Organization (or Department) with its name, and Every Org Unit under that name. If you don't see the Every Org Unit under row, courses are not covered.
Click Add, then save the deployment and copy the Deployment Id from the bottom of the page. You'll send it to us in Step 7.
Step 6: Create the link
This step is easy to miss, and instructors see nothing in their courses until it's done.
- On the deployment, scroll to the bottom and click View Links, then New Link.
- Name: SolidProfessor. This is what instructors see in their course, so keep it recognizable.
- URL: https://plt-backend.solidprofessor.com/api/v1/lti/launch
- Type: Deep Linking Quicklink.
- Width: 1000. Height: 800.
- Leave the parameter boxes blank. They show the deployment's values as gray placeholder text, which means the link inherits them.
- Click Save and Close.
The Type matters. Deep Linking Quicklink is what puts SolidProfessor under Add Existing in a course and lets instructors pick a class and its assignments. Basic Launch, the default, reaches SolidProfessor but carries no lesson or class, so it opens to a "This page could not be found" error.
Step 7: Send us your IDs
Send SolidProfessor three values from your Brightspace setup, and we'll finish the connection on our side.
| Send us | Where you found it |
|---|---|
| Client Id | Step 2, the Brightspace Registration Details panel |
| School label | Step 4, the value you entered for lms_school_id |
| Deployment Id | Step 5, the Brightspace Deployment Details at the bottom of the deployment |
Copy the Client Id and Deployment Id exactly. A single wrong character will stop the connection from working.
We'll enter the Client Id and Deployment Id in SolidProfessor, confirm the Platform Settings match your Registration Details, and enter your school label as the School ID in School Mapping. We'll let you know when it's ready for an Instructor to test.
Step 8: Hand-off to the Instructor
Once we confirm our side is ready, ask an instructor whose Brightspace email matches their SolidProfessor email to complete their side of the set up.
The full instructor workflow is in LTI 1.3: D2L Brightspace Setup for Instructors
Once the first launch succeeds, the Client Id and Deployment Id can no longer be edited via SolidProfessor's Instructor Tools. Changes after that require contacting SolidProfessor.
Troubleshooting
Most Brightspace problems come from the link step, the org unit scope, or a school label that doesn't match.
| What you see | What's going on | How to resolve |
|---|---|---|
| "Keyset URL is unreachable" when you click Register | Our side isn't set up for your Brightspace address yet. | Contact us. We'll confirm, then you can register again (Step 1). |
| Instructors see no SolidProfessor under Add Existing | The link doesn't exist, its Type isn't Deep Linking Quicklink, it has a different name, or the org unit scope excludes the course. | Check the link's Name and Type (Step 6), then confirm an Every Org Unit under row on the deployment (Step 5). |
| "This page could not be found" after a launch | A Basic Launch link was used, or content was added through External Tool Activity. It carries no lesson or class. | Change the link Type to Deep Linking Quicklink (Step 6), and have the instructor add content through Add Existing and the SolidProfessor tile. |
| An instructor lands on an enrollment or payment screen | Their Brightspace email doesn't match their SolidProfessor email, so they were created as a new inactive student. | Contact us with both emails. We'll correct the account. |
| A "missing parameter" error that mentions the school | The parameters are missing, or the school label was put in the Substitution Parameters box. | Check Step 4. user_id is a substitution parameter, and lms_school_id is a custom parameter. |
| A "school not linked" message | The school label in Brightspace doesn't match the School ID we have, including capitalization. | Compare your lms_school_id value with the label you sent us, and contact us if they differ. |
| "No matching registrations" or "invalid issuer" | The Brightspace address or Client Id we have doesn't match your registration. | Confirm your Brightspace address (with https://, no slash at the end) and the Client Id, then contact us. |
| Student names or emails are missing on a known connection | The deployment isn't sharing them. | Check User Information, Name, Email and User ID on the deployment (Step 3). |
| The launch hangs or loops inside the course page | Browser restrictions on content shown inside another site. | Turn on Open as External Resource on the deployment to open SolidProfessor in a new tab. This rules the cause in or out. |
Multiple schools on one Brightspace
The standard setup is one SolidProfessor school for each Brightspace institution. More than one is possible, but please scope it with us before you start.
A multi-school setup needs a different school label for each SolidProfessor school, sent through its own link, and all of the schools must sit under the same SolidProfessor account. The configuration differs from the steps above, so contact us first instead of adapting this guide.