English Español Français
Go to YuJa
  1. YuJa Help Center
  2. Verity Test Proctoring Platform
  3. Integrations

Integrating the YuJa Verity Test Proctoring Platform into D2L Brightspace

Avatar
YuJa
  • Updated

This document provides instructions on integrating the YuJa Verity Test Proctoring 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 Account Manager.

Registering YuJa Verity in D2L Brightspace

  1. Log in to D2L Brightspace as an admin.
  2. Click the Settings icon in the top-right corner.
  3. Click All, then select Manage Extensibility from the Settings menu.
  4. Select the LTI Advantage tab, then click Register Tool.
    register tool.png
  5. Under How would you like to register your tool?, select Standard.
  6. Certain fields will require you to enter your zone URL. Refer to your correct zone URL from the list below:  
    • US Zone: https://zone1.verity.yuja.com/
    • AUS Zone: https://az.verity.yuja.com/
  7. Enter the following information in each field according to your Zone:
    • US Zone Customers:
      • Name: You can select a name for the Verity LTI link (e.g., YuJa Verity).
      • 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
    • AUS Zone Customers:
      • Name: You can select a name for the Verity LTI link (e.g., YuJa Verity).
      • Domain: https://az.verity.yuja.com/
      • Redirect URLs: https://az.verity.yuja.com/lti/1.3
      • OpenID Connect Login URL: https://az.verity.yuja.com/lti/1.3/login
      • Keyset URL: https://az.verity.yuja.com/jwks
        The Register a Tool page.
  8. In the Extension field, check the following checkboxes:  
    • Assignment and Grade Services 
    • Names and Role Provisioning Services
      extensions.png
  9. In the Roles field, check Send Institution Role.

  10. In the Substitution Parameters field, click Add Substitution Parameter to add the following parameters: 

    • Name: Any name of your choice. Value: $User.id
    • Name: Any name of your choice. Value: $User.username

    This is a required step. You cannot skip adding substitution parameters.

  11. Click Register.
    roles substitution parameters.png
  12. Copy the Client ID, Brightspace Keyset URL, OpenID Connect Authentication Endpoint, and Issuer, as you will be using them in the next section.
    The Brightspace Registration Details page.
  13. Click Done.

Deploying the YuJa Verity LTI tool in D2L Brightspace

Once the 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.
  2. Click the Settings icon.
  3. Select External Learning Tools from the drop-down menu.
  4. Click the LTI Advantage tab, then click New Deployment.
    new deployment.png
  5. Fill in the Tool and Name fields for your new deployment:
    • Tool: YuJa Verity
    • Name: Any name of your choice (e.g., YuJa Verity).
      tool and name.png
  6. In the Security Settings field, check the following checkboxes:
    • User Information
      • Name
        • First Name
        • Middle Name
        • Last Name
    • Email
    • User ID
    • Username
    • Org Defined Id
  7. In the Configuration Settings field, check Open as External Resource.
    security settings.png
  8. (Optional) Click Add Org Units to add any org units for your deployment.
    The Add Org Units button.
  9. (Optional) Select any org units you want to deploy the Verity LTI tool for, then click Add. 
    The units options are highlighted in the Add Org Units window.
  10. Click Create Deployment. 
  11. Copy down the Deployment Id and click done. You will be redirected back to the External Learning Tools page.
    Note: Please remain on the External Learning Tools page. You will need to continue from this page in the next section.
    Brightspace deployment details.png
  12. Send both the Deployment Id and the information saved in the previous section (Client ID, Brightspace Keyset URL, OpenID Connect Authentication Endpoint, and Issuer) to your Account Manager to complete the deployment process.

Adding YuJa Verity as a course content tool

Adding Verity as a course content Tool in D2L allows instructors and test-takers to authenticate themselves before creating or taking a Verity-enabled assessment. 

Note: Make sure you are currently in the new Content Experience version on D2L Brightspace to add Verity as a course content tool.

  1. On the External Learning Tools page, select your newly created deployment from the previous section. 
    locate new deployment.png
  2. Scroll to the bottom of the page and click View Links.
    The View Links button.
  3. Click New Link.
    The New Link button in the Links page.
  4. Fill in the Name and URL fields according to your zone.
    • US Zone:
      • Name: Any name of your choice.
      • URL: https://zone1.verity.yuja.com/lti/1.3
    • AUS Zone:
      • Name: Any name of your choice.
      • URL: https://az.verity.yuja.com/lti/1.3
  5. Click Save and Close.
  6. Ensure that the tool is Enabled.
    The YuJa Verity option in the Links page.
  7. Go to a course where you want to add the Verity tool, then select the Content tab from the top navbar.
  8. Select the unit you want to add the course content tool to and click Add Existing.
    The unit page with Add Existing button highlighted.
  9. Select External Tool Activity.
    The external tool activity is selected.
  10. Use the search bar to locate the Verity LTI Link.
  11. Click the Verity LTI Link to insert it into your course. 
    The Verity tool is being serched adn selected.
  12. Depending on your display settings, you and users will either be able to:
    • Click Open Link to complete the authentication process and receive instructions on how to download the Verity Browser Extension.
      The Open Link button within the Verity unit.
    • Complete the authentication process and receive instructions on how to download the Verity Browser Extension directly within the course.
      extension set up.png 

Installing the YuJa Verity D2L Brightspace Visualizer

As an admin, you can install the YuJa Verity visualizer as an extension on D2L Brightspace. This will enable Verity to inject content into your D2L Brightspace environment, such as informing test-takers on how to authenticate themselves when attempting to access a proctored assessment without authentication.

  1. Log in to D2L Brightspace as an admin.
  2. Click the Settings icon in the top-right corner.
  3. Click All, then select Manage Extensibility from the Settings menu.

     
  4. Click Apps > Find Apps.
    find apps.png
  5. Click YuJa Verity.
    YuJa Verity App.png
  6. Click Install App to complete the process.
    install app.png

Integrating Verity's API for accessing quizzes

The REST API is an integration that allows instructors to delete Verity quizzes and create Verity practice quizzes in D2L Brightspace to help students familiarize themselves with Verity. 

  1. Log in to D2L Brightspace as an admin.
  2. Click the Settings icon in the top-right corner.
  3. Click All, then select Manage Extensibility from the Settings menu.
  4. Select the OAuth 2.0 tab and click Register an app.
    The Register an app button within the OAuth 2.0 tab.
     

  5. Fill in the Application Name, Redirect URl, and Scope fields as follows: 

    • Application Name: Any name of your choice (e.g., Verity Practice Quiz).
    • Redirect URl: Enter based on your Zone.
      • US Zone Customers: https://zone1.verity.yuja.com/api/verity/lms/desire2learn/auth
      • AUS Zone Customers: https://az.verity.yuja.com/api/verity/lms/desire2learn/auth
    • Scope: content:modules:* content:toc:read content:topics:* core:*:* grades:gradeobjects:* grades:gradevalues:write lti:links:read ltiadvantage:links:create,read ltiadvantage:quicklinks:create organizations:organization:read orgunits:course:read quizzing:quizzes:create,delete,read,write

  6. Uncheck Prompt for user consent.
  7. Check Enable refresh tokens, and I accept the API Developer Agreement.
  8. Click Register.
    check enable refresh tokens.png
  9. Copy and save the Client ID and Client Secret shown.
    client ID and client secret.png
  10. Contact your Account Manager with your Client ID and Client Secret to finalize the API configuration for Verity practice quizzes. 

Related articles

Contact Support