Skip to main content

D2L Brightspace API OAuth2 Integration

Authenticating your D2L Instance with HiTA​

As an organization administrator, you can authenticate your institution's D2L instance with HiTA. We use OAuth2 to authenticate your D2L instance with HiTA. For more information on the D2L OAuth2 flow, see the D2L OAuth documentation.

Registering HiTA Application using OAuth 2.0 in D2L​

  1. From the Admin Tools menu, click Manage Extensibility.

  2. Click OAuth 2.0.

  3. Click Register an app.

  4. In the Application Name field, enter:

    HiTA

  5. In the Redirect URI field, enter:

    https://app.hita.ai/api/lms/d2l/callback

  6. In the Scope field, enter:

    organizations:organization:read enrollment:orgunit:read content:toc:read content:topics:readonly content:file:read core:*:*

  7. In the Access Token Lifetime field, enter:

    3600

  8. Select the Prompt for user consent check box.

  9. Select the Enable refresh tokens check box.

  10. Select the I accept the Non-Commercial Developer Agreement check box stating you agree to the terms.

  11. Click Register.

D2L Register
D2L Menu
D2L Register
D2L OAuth
D2L Register
D2L Register

Retrieve OAuth Credentials in D2L​

  1. From the Admin Tools menu, click Manage Extensibility.
  2. Click OAuth 2.0.
  3. Click the name of the application, HiTa.
  4. Make a note of the values in the Client ID and Client secret fields.

HiTA Integration​

  1. Click on the User icon menu.
  2. Click Organization Dashboard.
  3. On the Organization page menu, click LMS.
  4. Then, click Authenticate.
  5. On the Authenticate page, select D2L Brightspace.
  6. Fill out the form with D2L details.
    • In the LMS Base URL textbox, enter your D2L instance URL (ex. https://acme-inc.brightspace.com)
    • In the Client ID and Client Secret textboxes, enter the values generated on D2L.
  7. Click Authenticate.
D2L Org Authentication
D2L Org Authentication

Once you have filled out the form in HiTA with the D2L OAuth details and clicked Authenticate, you will be redirected to your institution's D2L instance, where you can login to your D2L user account and approve the connection between HiTA and D2L.

Approve D2L Connection
Approve D2L Connection

Once you have approved the connection, you will be redirected back to the Authenticate tab of the LMS section within the organization view. You will see a success message indicating that the connection has succeeded.

D2L Connection Success
D2L Connection Success