Adding and configuring the D2L Brightspace for Zoom connector

The D2L Brightspace for Zoom connector enables natural language interactions with Brightspace courses through the Brightspace (Valence) REST API. Teachers and students can manage news (announcements), content, grades, dropbox assignments, quizzes, enrollments, and users through conversational commands, while maintaining secure OAuth authentication. Zoom account owners or admins must install the D2L Brightspace for Zoom connector for their account, during which they configure the connection between Brightspace and Zoom.

Requirements for installing and configuring the D2L Brightspace for Zoom connector

• Zoom account owner or admin privileges
• Brightspace administrator privileges (Manage Extensibility)

How to add the D2L Brightspace for Zoom connector

To configure the D2L Brightspace for Zoom app, an admin must register an OAuth 2.0 application in Brightspace, then use those credentials to configure the connector in the Zoom Marketplace.

Create an OAuth 2.0 application in Brightspace

Brightspace uses OAuth 2.0 Authorization grant (authorization code with refresh tokens). Do not register a Client Credentials (server-to-server / JWKS) application for this Zoom connector.

1. Sign in to Brightspace as a Brightspace administrator.
2. Open Admin Tools, then click Manage Extensibility.
3. Click the OAuth 2.0 tab, then click Register an app.
4. Configure the following settings:
   • Grant Type: Authorization grant.
   • Application Name: Zoom Brightspace Connector.
   • Redirect URI: https://integrations.zoom.us/connectors/oauth/callback/authorized
   • Scope: enter the space-delimited list below. This value must include every scope you will later paste into the Zoom Marketplace.
     Note: core:*:* is the Brightspace fallback scope for API routes that do not yet have a specific scope. Some Learning Platform routes used by this app (course schema, course templates, and org-unit demographics) require it.
     • core:*:*
     • content:toc:read
     • content:modules:readonly
     • content:topics:readonly
     • dropbox:folders:*
     • dropbox:access:read
     • grades:gradeobjects:*
     • grades:gradevalues:*
     • grades:access:read
     • news:newsitems:*
     • news:access:read
     • quizzing:quizzes:*
     • quizzing:attempts:read
     • quizzing:access:read
     • users:userdata:*
     • enrollment:orgunit:*
     • organizations:organization:read
   • Access Token Lifetime: 3600 (default). Allowed range is 1800–72000 seconds.
5. Select Prompt for user consent.
6. Select Enable refresh tokens.
7. Accept the Non-Commercial Developer Agreement, then click Register.
8. Open the registered application and save the Client ID and Client Secret.

For Brightspace OAuth registration details, see OAuth 2 authentication and the Authentication Scopes Table.

Add D2L Brightspace for Zoom connector in the Zoom Marketplace

1. Sign in to the Zoom Marketplace with your Zoom account.
2. In the top right of your screen, enter D2L Brightspace for Zoom in the search box to find the app.
3. In your search results, find the D2L Brightspace for Zoom connector and click it.
4. Click Add.
5. In the Configure D2L Brightspace window, enter the following information:
   • Domain: enter your Brightspace host without "https://" (for example, your-institution.brightspace.com).
   • Client ID: Enter the Client ID from Brightspace.
   • Client Secret: Enter the Client Secret from Brightspace.
   • Scopes: Enter the following list of scopes. All the tools configured for this connector are covered by this list. If you did not register certain scopes when you created the OAuth 2.0 application in Brightspace, remove them from this list. Every scope you enter here must be a subset of the scopes registered in Brightspace.
     Note: To enable every tool with a single fallback scope, you can enter core:*:* only. That value matches the Marketplace field placeholder. Granular scopes above are preferred when you want to limit access.
     • core:*:*
     • content:toc:read
     • content:modules:readonly
     • content:topics:readonly
     • dropbox:folders:*
     • dropbox:access:read
     • grades:gradeobjects:*
     • grades:gradevalues:*
     • grades:access:read
     • news:newsitems:*
     • news:access:read
     • quizzing:quizzes:*
     • quizzing:attempts:read
     • quizzing:access:read
     • users:userdata:*
     • enrollment:orgunit:*
     • organizations:organization:read
   • LP API Version: Enter 1.58. This is the Learning Platform version used for users, enrollments, org structure, courses, and roles.
   • LE API Version: Enter 1.92. This is the Learning Environment version used for content, dropbox, grades, news, and quizzes.
6. Under Admin settings, click the Set these configurations as default for all users toggle to enable it.
7. (Optional) To prevent all users in the account from changing this setting, click the lock icon, and then click Lock to confirm the setting.
8. Click Submit.
9. Complete the installation and Brightspace consent prompt.

How to use the D2L Brightspace for Zoom connector

Using the D2L Brightspace for Zoom connector with ZoomMate

Once an admin configures and installs D2L Brightspace for Zoom, teachers and students can manage news, content, grades, dropbox assignments, quizzes, enrollments, and users through conversational commands in ZoomMate.

How to remove the D2L Brightspace for Zoom connector

Remove the connector in Zoom Marketplace

1. Sign in to the Zoom Marketplace web portal.
2. Click My Library.
3. Next to D2L Brightspace for Zoom, click the more icon .
4. Click Remove.

Revoke the Brightspace consent for the OAuth application

1. Sign in to Brightspace as a Brightspace administrator.
2. Click Account Settings, then Manage applications registered with OAuth 2.0.
3. Remove the app.

Data Security for the D2L Brightspace for Zoom connector

Communications between this app and Zoom and Brightspace are encrypted:

• Protocol: TLS 1.2
• Cipher suite: ECDHE-ECDSA-AES128-GCM-SHA256
• Key length: 128 bits
• Perfect Forward Secrecy: YES

This app stores access credentials in the local data store:

• Brightspace OAuth2 tokens and Zoom OAuth credentials (both user-level only) are stored in an encrypted database.

How your data is used for the D2L Brightspace for Zoom connector

Zoom's D2L Brightspace for Zoom app allows Zoom Communications, Inc., access to your Brightspace course information records. To do so, you’ll need to share Brightspace permissions. You decide what permissions to share with Zoom according to the scopes enabled on your Brightspace OAuth 2.0 application. Brightspace still enforces the signed-in user’s role permissions in addition to those scopes.

• Organization and course structure (org units, course offerings, course templates, roles): Used to display your org structure, identify courses, and create or update course offerings and templates.
• User profile (user ID, name, demographics): Used to authenticate the Brightspace user, look up users, create or update user records, and determine enrollment context.
• Enrollments: Used to list who is in a course or org unit and to enroll users.
• News (announcements): Used to display and create course news items.
• Content and modules: Used to display the table of contents and module structure for a course.
• Dropbox assignments (folders and submissions): Used to list assignment folders and review submissions.
• Grades (grade objects, values, setup, statistics, access): Used to display grade items, update scores, and manage gradebook setup.
• Quizzes (quizzes, categories, questions, attempts, access): Used to display, create, update, and delete quizzes and to review attempt data.

By authorizing this connection, the D2L Brightspace for Zoom app maintains ongoing access to your information.