1-888-257-2278 Go to YuJa
  1. YuJa Help Center
  2. YuJa Verity for Test Proctoring
  3. Getting Started
  4. Integrations

Integrating YuJa Verity for Test Proctoring into D2L Brightspace

Avatar
YuJa Product Support
  • Updated

To learn how to integrate YuJa Verity for Test Proctoring into your D2L Brightspace environment, follow the steps below as an admin. Once completed, the integration will allow instructors and students to utilize the tool for test proctoring sessions. 

Registering YuJa Verity to D2L Brightspace

  1. Log in to D2L Brightspace as an admin and click the Gear icon in the top-right corner.
  2. From the drop-down menu, click Manage Extensibility.
    D2L Gear icon selected with Manage extensibility highlighted from the drop-down menu.
  3. Select the LTI Advantage tab and then click Register Tool.
    The Manage extensibility window with the LTI advantage tab and Register Tool highlighted.
  4. Enter the information for the tool as seen below and click Register.
    The register tool window with all required fields entered.
    • How would you like to register your tool: Standard
    • Name: Any name of your choice for the Verity tool.
    • Domain: https://zone1.verity.yuja.com/
    • Redirect URLs: https://zone1.verity.yuja.com/lti/1.3
    • OpenID Connect Login URL: https://zone1.verity.yuja.com/lti/1.3/login
    • Keyset URL: https://zone1.verity.yuja.com/jwks
    • Check the following Extensions:
      • Assignment and Grade Services 
      • Deep Linking
      • Names and Role Provisioning Services 
    • Roles: Check Send Institution Role.
    • Add the following Substitution Parameters:
      • Name: Any name of your choice for the parameter. Value: $User.id
      • Name: Any name of your choice for the parameter. Value: $User.username
  5. The Brightspace Registration Details panel will appear once you click Register. Make note of the Client ID, Brightspace Keyset URL, OpenID Connect Authentication Endpoint, and Issuer.
  6. Click Done and follow the steps in the next section of this guide. 
    The Brightspace registration details panel.

Deploying the YuJa Verity LTI Tool

Once the YuJa Verity LTI tool has been registered to the LMS, it can be deployed in D2L Brightspace.

  1. Log in to D2L Brightspace as an admin and click the Gear icon in the top-right corner of your screen. From the drop-down menu, click External Learning Tool.
    D2L Gear icon selected with External Learning Tools highlighted from the drop-down menu.
  2. Click New Deployment.
    External Learning Tools window with New Deployment highlighted.
  3. Enter the information for the tool as seen below.
    The deploy tool window with all required fields entered.
    • Tool: The YuJa Verity LTI tool registered in the previous section.
    • Name: Any name of your choice for the deployment. 
    • Extensions: Check the following: 
      • Org Unit Information
      • User Information
        • Name
          • First Name
          • Middle Name
          • Last Name
        • Email
        • User ID
        • Username
        • Org Defined Id
    • Configuration Settings: Check Open as external Resource.
  4. Click Add Org Units to add any org units for your deployment.
    Add org unit button highlighted within the deploy tool menu.
  5. Locate and select any org units you wish to deploy the YuJa verity LTI tool for and click Add. 
    Add org units selection list.
  6. Click Create Deployment.
    Create Deployment button highlightedwithin the deploy tool menu..
  7. Send the Deployment Id and Client ID, Brightspace Keyset URL, OpenID Connect Authentication Endpoint, and Issuer, noted in the previous section, to your Customer Success Manager and move to the next section of the guide.
    Brightspace deployment details window.

Adding YuJa Verity as a Course Content Tool

Verity requires a Course Content Tool to allow instructors and students to authenticate themselves before creating or taking a Verity-enabled test. 

  1. Log in to D2L Brightspace as an admin and click the Gear icon in the top-right corner of your screen. From the drop-down menu, click External Learning Tool.
  2. Click on the YuJa Verity tool created in the previous section.
  3. Scroll to the bottom of the page and click View Links.
  4. Click New Links.
  5. Fill out the information as shown below, and then click Save and Close.
    • Name: Any name of your choice.
    • URL: https://zone1.verity.yuja.com/lti/1.3
  6. Ensure that the tool is Enabled.
  7. Next, navigate to a course you wish to add the YuJa Verity tool to and click the Content tab from the top navigation bar.
  8. Select the unit you'd like to add the course content tool to and click Add Existing.
    Content page for a course with a unit highlighted and teh Add Existing button inside a unit highlighted.
  9. Select External Tool Activity.
    What would you like to add window with External Tool Activity highlighted.
  10. Use the search bar to locate the YuJa Verity tool and then click on the tool to insert it into the course. 
  11. Once inserted, and your Customer Success Manager has completed the integration on their side, admins, instructors, and students can access the tool and click Open Link to authenticate themselves and receive instructions on how to download the YuJa Verity extension.The YuJa Verity tool shown inside a course unit.
Note: Adding YuJa Verity as a content tool is only available for the new Content Experience. 

Integrating the LMS Visualizer 

Admins can install the LMS Visualizer within their D2L Brightspace instance to monitor the YuJa Verity Browser Extension. The Visualizer can also help guide students in accessing their assessments. Without it, you will need to give students details on how to authenticate themselves and the password to access their assessments.

  1. Log in to D2L Brightspace as an admin and click the Verity link within any course. 
  2. From the left-side menu, click Settings and then select Integration.
  3. From the Select Integration drop-down menu, choose LMS Visualiser.
    The integration page with the Verity Platform.
  4. Click Download Visualizer. The verity-d2l-theme file will download to your device.
    The Download Visualizer button is shown in the integration page.
  5. Next, click the Admin Tools (gear) icon and select JavaScript Management.
    Javascript management option is shown in the Admin Tools menu.
  6. Click Import Module.
    The import module button is shown in the JavaScript Management page.
  7. Enter a Module Name.
  8. Click Upload and select the verity-d2l-theme file downloaded in step 4. 
    The Add JavaScript Module is shown.
  9. Click Add.
    The downloaded visualizer is shown added to the Add JavaScript Module.
  10. Once added, toggle the visualizer to Enabled.
  11. Click the drop-down arrow next to the module's name and select Manage Roles.
    The added module is shown enabled.
  12. Enable the visualizer for the desired roles to complete the process. We recommend enabling it for instructor and student roles.
    Several roles are shown that the module is enabled for.

Integrating the REST API for Practice Quizzes

The REST API is an optional integration that allows instructors to create practice quizzes in D2L Brightspace to familiarize students with YuJa Verity. 

  1. Log in to D2L Brightspace as an admin and click the Gear icon in the top-right corner.
  2. From the drop-down menu, click Manage Extensibility.
    D2L Gear icon selected with Manage extensibility highlighted from the drop-down menu.
  3. Select the OAuth 2.0 tab and click Register an app.
  4. Fill out the information as shown below, and click Save.
    • Application Name: Any identifiable name of your choice (e.g. Verity Practice Quiz).
    • Redirect URl: Obtained from your Customer Success Manager.
    • Scope: core:*:* quizzing:quizzes:create,read,write
    • Uncheck Prompt for user consent.
    • Check Enable refresh tokens and I accept the Non-Commercial Developer Agreement.
  5. Once registered, click on the newly created app.
  6. To complete the process, please contact your Customer Success Manager with your Client ID and Client Secret to finalize the API configuration for Verity practice quizzes. 

Related articles