Setting up Eduframe and Brightspace Connection

Last updated: November 17, 2026

Summary

Set up the connection between Eduframe and Brightspace step by step, including Single Sign-On (SSO) and the grade export in Brightspace.

Note: Drieam makes the Brightspace plugin, the Brightspace tab on Course Editions and the Go to Course button in the Participant Portal available in your Eduframe environment. Reach out to Support before you start.

How to set up your Brightspace integration? [Brightspace part]

The first step is giving Eduframe access to Brightspace. Your Brightspace environment must be on LMS version 20.26.7 or later.

To give Eduframe access, follow the steps below as a Brightspace administrator:

  • Create a Service User in Brightspace. Eduframe uses this user to make its changes in Brightspace.

  • Go to Admin Tools > Manage Extensibility and register an OAuth 2.0 app for the Service User.

  • Fill in the following information:

    • JWKS URL: https://brightspace.eduframe.nl/jwks

    • Scopes: copy and paste the scopes below.

      core:*:*

      organizations:organization:create,delete,read

      organizations:organizationtypes:read

      orgunits:course:create,update,delete

      orgunits:coursetemplate:create,update

      role:detail:read

      calendar:events:read,write,delete

      users:userdata:create,read,update,delete

      users:merge:create

      enrollment:orgunit:create,read,delete

      grades:gradevalues:read

  • Save the app and copy its Client ID. You need it in the Eduframe part.

Note: Eduframe does not use a client secret. Brightspace checks the requests of Eduframe with the JWKS URL.

Also check that the departments and roles you want to use exist in Brightspace. Eduframe links to them, but does not create them.

Give the role of the Service User the permissions listed in 📄 Brightspace Service User permissions.

How to set up your Brightspace integration? [Eduframe part]

The second series of steps is done in Eduframe. Use a technical user for this: a separate Eduframe Admin account that is only used for this integration. The integration makes its changes in Eduframe with this account.

1. Log in to Eduframe with the technical user and go to Settings > Plugins > Brightspace. Click Go to Brightspace.

Brightspace plugin in Eduframe

2. Click Sign in with Eduframe.

Sign in with Eduframe

3. Eduframe shows what the integration may do. Click Authorize.

Authorize the Brightspace integration in Eduframe

4. The integration opens Eduframe credentials. Click Use my access token.

Set the access token of the technical user

Note: Only click Use my access token when you are logged in with the technical user. Never do this with your personal account.

5. Go to Webhooks and click Register webhook (Update registration if it was registered before). Eduframe now informs the integration about changes.

Register the webhook of the Brightspace integration

6. Open Eduframe in a separate tab and go to Settings > Webhooks. Click Reveal at the webhook that starts with https://brightspace.eduframe.nl and copy the primary secret.

Reveal the webhook secret in Eduframe

7. Go back to Webhooks in the integration, paste the secret in Primary secret and click Save secret (Replace secret if a secret was saved before). Until the secret is saved, no changes are sent to Brightspace.

8. Go to Brightspace credentials. Fill in the Client ID of the OAuth 2.0 app and, as Instance URL, the URL of your Brightspace environment, for example https://yourinstitution.brightspace.com. Click Save.

9. Click Test connection. The status must be Connected.

Brightspace credentials in Eduframe

10. Link the departments in Department links and set the roles in Role links. You can read how in 📄 Brightspace Integration.

When all steps on the home page have a checkmark, your Brightspace integration is set up. A warning under a step tells you what still needs your attention.

Set up steps of the Brightspace integration

How to set up the grade export in Brightspace?

Participants' final grades are exported from Brightspace with the Eduframe tool in Brightspace. To add the tool to Brightspace:

  • In the integration, go to Brightspace credentials and click Create a Registration URL under LTI Registration. Copy the URL: it is shown only once, works for one hour and can be used once.

  • In Brightspace, go to Admin Tools > Manage Extensibility > LTI Advantage and register a tool with Dynamic registration. Paste the Registration URL as the registration endpoint. Brightspace shows Registration complete and adds the tool Eduframe Brightspace.

  • Enable the new registration. Brightspace leaves it disabled.

  • Share the deployment of the tool with the organization's descendants too, otherwise opening the tool from a course fails.

  • Add the tool to the navigation bar of the course offerings: go to Navigation & Themes, open the navbar and click Add links > Create custom link > Insert quicklink > External learning tools, and select the tool.

In Brightspace credentials, the status under LTI Registration is now Registered.

Note: Learners also see the tool in the navigation bar, but only instructors and administrators can export grades with it.

How to set up Single Sign-On (SSO) Eduframe within Brightspace?

As part of the connection between Eduframe and Brightspace, you can set up Single Sign-On (SSO). This means that the credentials created for Eduframe are also used for logging in to Brightspace.

To connect the Eduframe login to Brightspace, CAS is set up as the primary login method in Brightspace:

  • CAS URL: https://xxx.eduframe.nl/cas/ (xxx is the name of the educator).

  • CAS is set up in Brightspace together with D2L.

When a user logs in, Eduframe tells Brightspace the Principal ID of the Contact. Brightspace then logs the user in to the Brightspace user with that username: the user Eduframe created for the Contact. Find out more in 📄 Principal ID.

Note: Eduframe creates Brightspace users without a password and without an email address, and does not send them an email. Users log in with their Eduframe login.

Users that already exist in Brightspace, for example created by your SIS, are used by Eduframe when their Org Defined ID is the Principal ID of the Contact.

Note: Turn on Manage externally for Contacts whose Brightspace user is managed by another system, such as your central identity management system. Otherwise Eduframe overwrites their username and, when the Contact is deleted in Eduframe, deletes the Brightspace user with all its enrollments, also in courses that were not published from Eduframe.