1-888-257-2278 Go to YuJa
  1. YuJa Help Center
  2. Panorama LMS Accessibility Platform
  3. D2L Brightspace Integration
  4. Administrators

Integrating Panorama Digital Accessibility into D2L Brightspace Using LTI 1.3

Avatar
YuJa Product Support
  • Updated

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.

  1. Log in as an Admin.
  2. From the top-right corner, click the Gear icon.
  3. Click Manage Extensibility.
    8.png
  4. Select the LTI Advantage tab, and then click Register Tool.
     9.png
  5. Under How would you like to register your tool, select Standard. 
  6. Enter a Name for your tool, such as, Panorama LTI 1.3.
  7. 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
  8. Under domain, enter https://<YOUR_ZONE_URL>/lti/lti-app-1.3-entry
    10.png
  9. Enter the following URLs for the fields below, and then click Register.
    11.png
    • 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
  10. You will be redirected back to the LTI Advantage tab. Locate and click on your newly created tool.  12.png
  11. 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. 
    13.png
  12. Next, Click the Gear icon located in the top-right corner.
  13. Under Organization Related, click External Learning Tools.
    14.png
  14. Click the LTI Advantage tab, and click New Deployment.
     15.png
  15. Under the Tool drop-down menu, select the LTI tool created earlier. 
  16. Add a Name for the Deploy Tool, such as Panorama.
     16.png
  17. Ensure that the following Security Settings are selected. 
  18. Under Configuration Settings, check Open as External Resource. 
     17.png
  19. Click Add Org Units to add courses you would like the LTI App to run on. 
  20. Click Create Deployment.
    18.png
  21. You will be redirected back to the LTI Advantage tab. Click on the newly created tool.  18.1.png
  22. 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. 
  23. Click View Links. 
    19.png
  24. Click New Link.
    20.png
  25. Enter a Name for the link, such as Panorama.
  26. 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
  27. Click Save and close, and then proceed to the next section of this guide.
    21.png

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. 

  1. Log in to your Panorama account.
  2. Click Configuration, and then select Integration Settings. 
  3. 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. 

  1. Log in as an Admin or Instructor and select the course you wish to add the Panorama LTI link to.
  2. Next, click the Actions for Navbar icon and select Edit This Navbar.
     22.png
  3. Enter a Name for the Navbar.
  4. Click Add Links.
    23.png
  5. Click Create Custom Link.
  6. In the Name field, enter Panorama, and then click Insert Quicklink.
  7. Locate and select External Tool from the list of Course Materials.
  8. Use the search bar to search for the Panorama tool.
  9. Click the tool to add it to your custom link. 
  10. 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.

  1. Log in to D2L Brightspace as an admin.
  2. Click the Gear icon.
  3. Under Security, select Roles and Permissions.

     Roles and Permissions is highlighted from the Admin Tool icon.
  4. Click Create/Copy.
    The Creat/Copy button is highlighted in the Role List page.
  5. Click Start Fresh. Optional: You can create a copy of an existing role if you'd like.
    In the Create Role page, Start fresh is highlighted.
  6. 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
  7. Click Save.
    The Save button is highlighted in the New Role page.
  8. On the Edit Role Interactions page, check all boxes for Administrator.
  9. Click Save to create the role. 
    In the Edit Role interactions page, the Administrator row has all options checked and the save button is highlighted.

Uploading the List of Minimum Requirements 

Before proceeding with the steps below, you can access and download the list of minimum requirements from here.

  1. Log in to D2L Brightspace as an admin.
  2. Click the Gear icon.
  3. Under Security, select Roles and Permissions.

     Roles and Permissions is highlighted from the Admin Tool icon.
  4. Locate the role created in the previous section of this guide and select the drop-down arrow next to the role's name. 
  5. Select Import Permissions.
    Import Permissions is highlighted for a role.
  6. Click Choose File and select the file you downloaded from here.
    The Choose file button is highlighted for Import permissions.
  7. Click Next.

     The next button is highlighted after selecting a file to import.
  8. Click Import to complete the process.
    The import button is highlighted in Step 4: Preview Import.

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.

  1. Log in as an Admin.
  2. From the top-right corner, click the Gear icon.
  3. Under Security, select Roles and Permissions.
    1.png
  4. In the Role List, click Administrator. 
    2.png
  5. In the Filter by Tool drop-down menu, select Content, and click Apply Filter.
  6. In the top row, check Organization, Course Template, Course Offering, Group, Semester, Section, and Department.
  7. Click Save.
    3.png
  8. Repeat steps 5-7 by entering Course Builder, Course Management Console, and External Learning Tools in Filter by Tool.
  9. Next, click the Gear icon in the top-right corner.
  10. Under Organization Related, click Manage Extensibility.
     4.png
  11. Ensure the ID Key Authentication tab is selected, and click Register an App. 5.png
  12. Enter a name for Application Name, such as, Panorama.
  13. 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
  14. Check Enable this application and I accept the Non-commercial Developer Agreement.
  15. Click Register Application.
    6.png
  16. 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.
    7.png

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. 

  1. Access the Panorama Platform, click Configurations, and then select Integration Settings. 
  2. Under the Select Integration drop-down menu, select LMS API.
  3. Click Add Access Key.
  4. Paste in the Application ID and Application key obtained in the previous section of this guide. 
  5. Click Authenticate With Application.
  6. A new tab will open with your JSON response. Copy the response and paste it in the text field for Application Authentication JSON Response
  7. Click Add Access Key.
  8. 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.

Related articles