This document provides instructions on integrating the Panorama Platform into your D2L Learning Management System (LMS). Before proceeding with the steps below, please ensure that you have full access to your D2L Brightspace instance as an admin. If you have questions regarding any steps in this process, please contact your dedicated Client Success Manager.
Adding Panorama to D2L Brightspace
The first process in integrating Panorama is to have the Panorama LTI link availabale in your D2L Brightspace instance.
- Log in as an Admin.
- From the top-right corner, click the Gear icon.
- Click Manage Extensibility.
- Select the LTI Advantage tab, and then click Register Tool.
- Under How would you like to register your tool, select Standard.
- Enter a Name for your tool, such as, Panorama LTI 1.3.
- Certain fields will require you to enter your zone URL. Refer to your correct zone URL from the list below:
- US Zone: https://panorama-api.yuja.com
- CAN Zone: https://panorama-api-cz.yuja.com
- EU Zone: https://panorama-api-ez.yuja.com
- AUS Zone: https://panorama-api-az.yuja.com
- Under domain, enter https://<YOUR_ZONE_URL>/lti/lti-app-1.3-entry
- Enter the following URLs for the fields below, and then click Register.
- Redirect URLs: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-entry
- OpenID Connect Login URL: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-oidc-initiation
- Target Link URL: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-entry
- Keyset URL: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-jwk
- You will be redirected back to the LTI Advantage tab. Locate and click on your newly created tool.
- Scroll down and copy the Brightspace Registration Details. You will need to enter this information in your Panorama account in the next section of this guide.
- Next, Click the Gear icon located in the top-right corner.
- Under Organization Related, click External Learning Tools.
- Click the LTI Advantage tab, and click New Deployment.
- Under the Tool drop-down menu, select the LTI tool created earlier.
- Add a Name for the Deploy Tool, such as Panorama.
- Ensure that the following Security Settings are selected.
- Under Configuration Settings, check Open as External Resource.
- Click Add Org Units to add courses you would like the LTI App to run on.
- Click Create Deployment.
- You will be redirected back to the LTI Advantage tab. Click on the newly created tool.
- Scroll down and copy the Deployment ID. You will need to enter this information in your Panorama account in the next section of this guide.
- Click View Links.
- Click New Link.
- Enter a Name for the link, such as Panorama.
- Under URL, enter the URL based on your zone.
- US Zone: https://panorama-api.yuja.com/lti/lti-app-1.3-entry
- CAN Zone: https://panorama-api-cz.yuja.com/lti/lti-app-1.3-entry
- EU Zone: https://panorama-api-ez.yuja.com/lti/lti-app-1.3-entry
- AUS Zone: https://panorama-api-az.yuja.com/lti/lti-app-1.3-entry
- Click Save and close, and then proceed to the next section of this guide.
Configuring Panorama for D2L Brightspace
Before proceeding with the steps below, you will need to have received an email from your Client Success Manager asking you to sign up for your Panorama account. Sign up for your account, and then proceed with the steps below.
- Log in to your Panorama account.
- Click Configuration, and then select Integration Settings.
- Enter the information as shown below and then click Save Changes:
- Client ID: The client ID that was obtained in step 11 in the previous section of this guide.
- Deployment ID: The Deployment ID that was obtained in step 22 in the previous section of this guide.
- ISS: The Issuer that was obtained in step 11 in the previous section of this guide.
- OIDC Endpoint: The OpenID Connect Authentication Endpoint that was obtained in step 11 in the previous section of this guide.
- JWKS Endpoint: The Brightspace Keyset URL that was obtained in step 11 in the previous section of this guide.
Adding the Panorama LTI 1.3 Link to the Navbar
Proceed with this section of the guide once Panorama has been successfully added to your D2L Brightspace instance.
- Log in as an Admin or Instructor and select the course you wish to add the Panorama LTI link to.
- Next, click the Actions for Navbar icon and select Edit This Navbar.
- Enter a Name for the Navbar.
- Click Add Links.
- Click Create Custom Link.
- In the Name field, enter Panorama, and then click Insert Quicklink.
- Locate and select External Tool from the list of Course Materials.
- Use the search bar to search for the Panorama tool.
- Click the tool to add it to your custom link.
- Set the Behavior to Same window, and click Create to add the Panorama tool to your Navbar.
Creating a Role with Permissions
Panorama requires an access token to scan and download files within D2L Brightspace. To allow the access token to function, admins will need to download a list of minimum requirements and upload it to their D2L Brightspace zone. Before you upload the list of minimum requirements, we recommend creating a new role associated with the requirements to avoid affecting other users.
- Log in to D2L Brightspace as an admin.
- Click the Gear icon.
- Under Security, select Roles and Permissions.
- Click Create/Copy.
- Click Start Fresh. Optional: You can create a copy of an existing role if you'd like.
- Fill out the information as shown below.
- Name: Any identifiable name of your choice.
- Cascading: Ensure this is checked.
-
Course Access Options
- Access inactive courses: Ensure this is checked.
- Access past courses: Ensure this is checked.
- Access Future courses: Ensure this is checked.
- Selection: Access all course sections
- Groups: Access all course groups
- Click Save.
- On the Edit Role Interactions page, check all boxes for Administrator.
- Click Save to create the role.
Uploading the List of Minimum Requirements
Before proceeding with the steps below, you can access and download the list of minimum requirements from here.
- Log in to D2L Brightspace as an admin.
- Click the Gear icon.
- Under Security, select Roles and Permissions.
- Locate the role created in the previous section of this guide and select the drop-down arrow next to the role's name.
- Select Import Permissions.
- Click Choose File and select the file you downloaded from here.
- Click Next.
- Click Import to complete the process.
Registering Your D2L Brightspace Application for Panorama
The YuJa Panorama - LMS Connector requires an Application to be registered in order to access the API provided by D2L. To register an Application, follow the instructions below.
- Log in as an Admin.
- From the top-right corner, click the Gear icon.
- Under Security, select Roles and Permissions.
- In the Role List, click Administrator.
- In the Filter by Tool drop-down menu, select Content, and click Apply Filter.
- In the top row, check Organization, Course Template, Course Offering, Group, Semester, Section, and Department.
-
Click Save.
- Repeat steps 5-7 by entering Course Builder, Course Management Console, and External Learning Tools in Filter by Tool.
- Next, click the Gear icon in the top-right corner.
- Under Organization Related, click Manage Extensibility.
- Ensure the ID Key Authentication tab is selected, and click Register an App.
- Enter a name for Application Name, such as, Panorama.
- For Trusted URL, copy and paste the correct URL based on your zone.
- US Zone: https://panorama-api.yuja.com/d2l-auth
- CAN Zone: https://panorama-api-cz.yuja.com/d2l-auth
- EU Zone: https://panorama-api-ez.yuja.com/d2l-auth
- AUS Zone: https://panorama-api-az.yuja.com/d2l-auth
- Check Enable this application and I accept the Non-commercial Developer Agreement.
- Click Register Application.
- After registering the Panorama application, you will be redirected to the newly created application. Note down the Application ID and Application Key, they will be needed in the next section of this guide.
Integrating D2L Brightspace With Panorama
After noting down your Application ID and Application Key from the previous section, the final process is to establish a connection between your D2L Brightspace instance and Panorama so that Panorama can retrieve data.
- Access the Panorama Platform, click Configurations, and then select Integration Settings.
- Under the Select Integration drop-down menu, select LMS API.
- Click Add Access Key.
- Paste in the Application ID and Application key obtained in the previous section of this guide.
- Click Authenticate With Application.
- A new tab will open with your JSON response. Copy the response and paste it in the text field for Application Authentication JSON Response
- Click Add Access Key.
- Click Save Changes. Panorama will now be able to retrieve information from your D2L Brightspace instance. To allow Panorama's content to be displayed inside D2L Brightspace, such as the Alternative Formats menu and the Accessibility Report, you will need to install the Panorama D2L Brightspace Visualizer.