Brightspace Data Integration

1. Login as a Brightspace Administrator

2. Navigate to Admin tools (the gear icon on top right), then click Manage Extensibility
   

3. Navigate to “OAuth 2.0” tab

4. Click on “Register an app” button

5. Enter the below information into the appropriate fields:
   

   • Give an appropriate “Application Name” - such as Course Evaluations & Surveys

   • Redirect URIs: Create a redirect URI with this formula using your CES URL: <customer CES domain>/d2l/AuthenticateDataSettings/callback (For example, if your CES URL is https://myschool.evaluationkit.com then your redirect URI would be https://myschool.evaluationkit.com/d2l/AuthenticateDataSettings/callback)

   • Scope: Copy and paste this entire string into the Scope field:

     enrollment:orgunit:read organizations:organization:read orgunits:course:read role:detail:read sections:section:read users:own_profile:read users:userdata:read

   • Access Token Lifetime (seconds): this is an optional setting. You can enter any number value for “Access Token Lifetime (seconds)”. The default is 3600. When the token expires, CES generates a new token.
   • Checkboxes:
     
     
     • Leave the Prompt for user consent and Enable refresh tokens checkboxes enabled
     • Check the check box for “I accept the Non-Commercial Developer Agreement”
       
   • Click on “Register” button. You will be directed to the following summary screen:
     

   • Copy and paste the “Client ID” and “Client Secret” to a Notepad (or other simple text editor). You will need these values in subsequent steps.

6. If you have multiple CES accounts (subaccounts), you will need to repeat the above steps for each CES account to generate a Client ID and Client Secret for each subaccount.

In Course Evaluations & Surveys

1. Login to Course Evaluations & Surveys as a CES Administrator

2. Navigate to Account > Integrations (section) > Brightspace

   

   • (If you have a previous setup of Brightspace, click the Clear Settings button and then click OK)
   • Brightspace URL: copy and paste your institution's Brightspace URL into this field. For example, your Brightspace URL will be something like https://yourschool.brightspace.com

   • Paste the Client ID and Client Secret that you saved to a Notepad from Step 5 above

   • Save the settings

    

3. In the API Token section on that same page, click the Authenticate button. NOTE: If the Brightspace Administrator who authenticated is deleted or if their password changes in Brightspace, the integration will no longer work. So we recommend creating an Brightspace Administrator account specifically for the purpose of this integration so that the integration isn't affected if staffing changes occur.
4. This will redirect you to Brightspace. If you are not logged into Brightspace, you will be prompted to log in.
   
5. Click the Accept button
6. This will redirect back to CES page. Click Test. The test status should indicate Success
7. In the Role Mappings section, select any of the roles in Brightspace that you intend to use in CES. Click Save once all the roles have been selected. NOTE: You can revisit this page in the future to select or remove roles as needed.
   

   
   Additional Notes:

   Once authenticated, the “Clear Settings” button disappears. You must first click Deauthorize if you wish to clear the settings.