Integrating Panorama with your D2L Brightspace instance using your Client ID and Client Secret allows you to control Panorama's access through different scope settings.
Generating a D2L Brightspace Client ID and Secret
- Log in to D2L Brightspace as a SuperAdmin.
- Click the Gear > Manage Extensibility.
- Click OAuth 2.0 > Register an app.
- Fill out the information as shown below.
- Application Name: Panorama Oauth API
-
Redirect URl: Enter the URL based on your zone.
- US Zone: https://panorama-api.yuja.com/d2l-auth/oauth
- CA Zone: https://panorama-api-cz.yuja.com/d2l-auth/oauth
- EU Zone: https://panorama-api-ez.yuja.com/d2l-auth/oauth
- AUS Zone: https://panorama-api-az.yuja.com/d2l-auth/oauth
-
Scope: There are four available scopes you can enter, depending on the level of access you want to grant Panorama.
-
Default (Recommended): With the default scope, Panorama can scan all course content, including the Assignments section, and update existing documents in D2L Brightspace with their remediated versions. To grant these permissions, copy and paste the following scope:
- organizations:organization:read orgunits:course:read enrollment:orgunit:read checklists:checklist:read content:modules:readonly content:topics:readonly content:file:read content:toc:read discussions:forums:readonly discussions:topics:readonly dropbox:folders:read managefiles:files:read news:newsitems:read quizzing:quizzes:read surveys:surveys:read checklists:checklist:write content:modules:manage content:topics:manage discussions:forums:manage discussions:topics:manage dropbox:folders:write managefiles:files:manage news:newsitems:manage quizzing:quizzes:write surveys:surveys:update core:*:*
-
Disable Access to Assignments: If you DO NOT want to grant Panorama access to the Assignments section of your D2L Brightspace instance, copy and paste the following scope:
- organizations:organization:read orgunits:course:read enrollment:orgunit:read checklists:checklist:read content:modules:readonly content:topics:readonly content:file:read content:toc:read discussions:forums:readonly discussions:topics:readonly dropbox:folders:read managefiles:files:read news:newsitems:read quizzing:quizzes:read surveys:surveys:read checklists:checklist:write content:modules:manage content:topics:manage discussions:forums:manage discussions:topics:manage dropbox:folders:write managefiles:files:manage news:newsitems:manage quizzing:quizzes:write surveys:surveys:update
-
Disable Write Access: If you DO NOT want to grant Panorama access to update existing documents on D2L Brightspace with remediated versions, copy and paste the following scope:
- organizations:organization:read orgunits:course:read enrollment:orgunit:read checklists:checklist:read content:modules:readonly content:topics:readonly content:file:read content:toc:read discussions:forums:readonly discussions:topics:readonly dropbox:folders:read managefiles:files:read news:newsitems:read quizzing:quizzes:read surveys:surveys:read core:*:*
-
Disable Access to Assignments and Write Access: If you want to DISABLE BOTH permissions, copy and paste the following scope:
- organizations:organization:read orgunits:course:read enrollment:orgunit:read checklists:checklist:read content:modules:readonly content:topics:readonly content:file:read content:toc:read discussions:forums:readonly discussions:topics:readonly dropbox:folders:read managefiles:files:read news:newsitems:read quizzing:quizzes:read surveys:surveys:read
-
Default (Recommended): With the default scope, Panorama can scan all course content, including the Assignments section, and update existing documents in D2L Brightspace with their remediated versions. To grant these permissions, copy and paste the following scope:
- Access Token Lifetime (Seconds): 7200
-
Check the following:
- Prompt for user consent
- Enable refresh tokens
- I accept the Non-Commercial Developer Agreement
- Click Register.
- You'll be redirected to the details of the registered app. Note the Client ID and Client Secret, as they will be required to complete the setup in the next section of this guide.
Integrating D2L Brightspace with Panorama
After noting down your client ID and secret from the previous section, you'll need to establish a connection between your D2L Brightspace instance and Panorama so that Panorama can retrieve data.
- Log in to Panorama, click Configurations, and then select Integration Settings.
- Under the Select Integration drop-down menu, choose LMS API.
- Click Add Access Key.
- Select Client ID.
- Enter the Client ID and Client Secret using the information provided in step 6 of the previous section.
- Based on the scope you entered in Step 4 of the previous section, enable or disable the Allow Write Access and Allow Assignment Access options.
- Click Authenticate With D2L Brightspace.
- In the new tab that opens, copy the authentication response and paste it in the space provided under D2L Brightspace Authentication Response.
- Click Add Access Key.
- Click Save Changes. Panorama will now be able to retrieve information from your Canvas instance. You can choose which courses or accounts Panorama can access by managing your scope settings.