Go to YuJa
  1. YuJa Help Center
  2. YuJa Verity for Test Proctoring
  3. Integrations

Integrating Verity for Test Proctoring into Canvas

Avatar
YuJa Doc Team
  • Updated

Verity allows instructors to create proctored assessments for test-takers within Canvas. To allow instructors and test-takers to access Verity, as an admin, you must connect your Canvas account with Verity.

Adding Verity to Canvas

As an admin, you can integrate Verity with Canvas by adding a JSON URL to the Developer Keys.

  1. In Canvas, select the Admin menu in the side navbar, then select the account you would like to add the JSON string to. Admin menu in the side navbar.
  2. Select Developer Keys in the side navbar.
  3. Click + Developer Key, and select + LTI Key from the drop down menu. The add LTI key button within the Developer Keys section.
  4. In the Key Settings page, enter a name for your key (e.g., YuJa Verity).
  5. Select Enter URL in the Method drop down menu.
  6. In the JSON URL field, enter this URL: https://zone1.verity.yuja.com/lti/config/canvas.json
  7. Click Save.
    The Key Settings pop-up window.
  8. In the Developer Keys page, locate the Verity key that you have added.
  9. Copy the number shown in the Details field (the Client ID), and toggle the State field to ON.The toggle in the State column and the key are highlighted.
  10. Click Switch to On to confirm enabling the Verity key in Canvas.The Switch to On button in the Turn On Developer Key window.
  11. Select Settings from the side navbar.
  12. Select Apps from the top navbar.
  13. Click View App Configurations.
    The View App Configurations button within the Apps tab.
  14. Click +App.
    The add App button within the Apps tab.
  15. Select By Client ID in the Configuration Type field.
  16. In the Client ID field, paste the Client ID copied earlier in the Developer Keys section.
  17. Click Submit.
    The Add App window.
  18. Locate the row of the YuJa Verity app that you have just added, then click the Settings icon.
  19. Select Deployment Id from the drop-down menu. The Deployment Id option within the Settings menu.
  20. Copy and save the Deployment ID shown in the pop-up window.
    The Deployment Id is displayed.
  21. Contact your Client Success Manager with your Deployment ID and Client ID to finalize the LMS configurations for Verity.

Testing Verity's API Access

Once your Client Success Manager completes the integration, you can test the REST API to ensure instructors can delete Verity quizzes and create Verity practice quizzes in Canvas.

  1. In Canvas, click the YuJa Verity link in the sidebar to open the Verity portal.
  2. In Verity, select Settings > Integration Settings from the side navbar.The Settings and Institution Settings button in the side navbar within Verity.
  3. Select LMS API in the Select Integration drop-down menu.
  4. In the Access Keys section, click Test Institution Access to make sure your Canvas account has been integrated with the API.The Select Integration and Access keys field are highlighted.
  5. Confirm that your API access is successful for both Read Accounts and Read Courses access.
    Note: If your API access fails, please contact your Client Success Manager to update the API key for your institution.
  6. Click Close.
    The Test API Access pop-up window.

Adding the LMS Visualizer to Canvas

As an admin, you can add JavaScript code within the Theme Editor to monitor the Verity Browser extension. With the JavaScript code enabled, test-takers will be guided to download the Verity Browser Extension before accessing the assessment. They will not be able to access the assessment unless the Browser Extension is installed.  

  1. Within Canvas, click the YuJa Verity link in the sidebar to open the Verity portal.
  2. Within Verity, select Settings > Integration Settings from the side navbar.The Settings and Institution Settings button in the side navbar within Verity.
  3. Select LMS Visualizer in the Select Integration drop-down menu.
  4. Click View Visualizer.
    The LMS Visualizer is selected.
  5. Copy the JavaScript code that appears in the new tab. 
  6. Within Canvas, select Themes from the side navbar.
  7. Hover over your theme, and click Open in Theme Editor.
    The Themes section is selected from the side navbar in Canvas.
  8. From the left panel, click the Upload tab.
  9. Locate the JavaScript file field, then click View File to open the JavaScript code page.
    The View File button is highlighted.
  10. Right-click on the JavaScript code page and select Save as to save the file to your device. 
    Saving the JavaScript code as a new file.
  11. Open your file within a text editor (e.g., Notepad), and paste the JavaScript code copied in step 5 at the end. 
    Adding the copied JavaScript code to the file.
  12. Save your file in your text editor. 
  13. Within your Theme Editor, locate the JavaScript file field and click Select to upload your file. The select button is highlighted in the JavaScript file field.
  14. Locate the Mobile app JavaScript file field, then click View File to open the JavaScript code page.
    The View File button is highlighted in the Mobile app JavaScript file field.
  15. Right-click on the JavaScript code page and select Save as to save the file to your device. Saving the JavaScript code as a new file.
  16. Open your file within a text editor (e.g., Notepad), and paste the JavaScript code copied in step 5 at the end. 
    Adding the copied JavaScript code to the file.
  17. Save your file in your text editor. 
  18. Within your Theme Editor, locate the Mobile app JavaScript file field and click Select to upload your file. The select button is highlighted in the Mobile app JavaScript file field.
  19. Click Preview Your Changes.
    The preview your changes button is highlighted.
  20. Click Save theme.
    The Save theme button is highlighted.
  21. Click Apply theme to add the new theme setting.

Related articles