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 Canvas

Avatar
YuJa Product Support
  • Updated

YuJa Verity for Test Proctoring allows Instructors to assign proctored quizzes to Students. Canvas Administrators must integrate YuJa Verity for Test Proctoring within the LMS before Instructors and Students can utilize the tool.

Adding YuJa Verity to Canvas

Admins can integrate YuJa Verity with Canvas by adding a JSON URL to the Developer Keys.

  1. In Canvas, under the Admin menu, select the account you would like to add the JSON string to. 
  2. Click on Developer Keys located in the Navigation Bar.
  3. Click +Developer Key in the top right of the screen, and then select LTI Key. canvas developer keys page showing the option for adding an LTI key.
  4. Under the Method drop-down menu, select Enter URL.
  5. Copy the URL below, and paste it under JSON URL.

    • https://zone1.verity.yuja.com/lti/config/canvas.json

  6. Add a Key Name.
     Modal for adding key settings.
  7. Copy the Client ID that is provided under Details, and ensure the developer key is ON under State.Newly created developer key is shown with state set to ON.
  8. On the left-hand side, select Settings from the navigation bar.
  9. Select Apps from the top row, and then select View App Configurations. View app configuration option is shown in App Settings.
  10.  Select +App from the top-right of the screen.
  11. Under Configuration Type, select By Client ID.
  12. Paste the key copied earlier.
  13. Select Submit.
     A new app is added by selecting +app.
  14. To complete the process, please contact your Customer Success Manager with your Deployment ID and Client ID to finalize the LMS configurations for Verity.
  15. To view your Deployment ID, select the Gear icon next to the Verity app.
  16. From the drop-down menu, select Deployment ID. The developer ID option for the app is shown by clicking its gear icon.
  17. A small window will open displaying your Deployment ID. 
    The deployment ID for the app is shown.
  18. Your Client ID can be located in the Developer Keys menu.
    the client ID is shown in the developer keys.

Integrating the REST API for Quizzes 

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

  1. In Canvas, under the Admin menu, select the account you would like to add the API to. 
  2. Click on Developer Keys located in the Navigation Bar.
  3. Click +Developer Key in the top right of the screen, and then select API Key.
  4. Enter the API information as directed below:
    Key settings are shown.

    • Key Name: Any name of your choice (e.g. Verity Practice Quiz).

    • Redirect Url: https://zone1.verity.yuja.com/lms/canvas/auth

    • Redirect Legacy: https://zone1.verity.yuja.com/lms/canvas/auth

  5. Click Save.
    Key settings are shown added.
  6. Ensure the State is toggled ON.
  7. Copy the Client ID that is provided under Details, and click Show Key to reveal and copy the Client Secret.
    The new key is shown in developer keys.
  8. From the left side of the Canvas navigation menu, click the YuJa Verity LTI link. 
  9. On the Verity platform, click Settings and then select Integrations.
  10. For the LMS API integration, select Add Access Key.
    Verity's LMS API integration settings page.
  11. Paste the Client ID and Client Secret copied in step 7. 
  12. Click Add. Optional: Once the key is added, you can click Test API Access and select a course to ensure Verity can access the course and retrieve a list of assessments.
    Options to add a client ID and Client secret for the access key.
  13. Click Save Changes to complete the process.
    The save button is shown selected for the LMS API integration page.

Prevent Students from Accessing Quizzes without YuJa Verity for Test Proctoring Enabled 

Admins can add a JavaScript code within their Theme Editor to monitor the YuJa Verity Chrome extension. With the JavaScript code enabled, Students will not be able to access proctored assessments unless the YuJa Verity Chrome extension is installed. If this feature is not enabled by the admin, students will be able to access proctored assessments without YuJa Verity. To learn how to enable this feature, please follow the steps below.    

  1. Log in to Canvas, select Admin, and then choose your desired account.
  2. Click on the YuJa Verity LTI link.
  3. In the Verity platform, click Settings and then select Integrations.
    The integration page for verity is shown.
  4. From the Select Integration drop-down menu, select LMS Visualizer.
  5. Click View Visualizer and copy the JavaScript code that appears within the new tab. 
    The option to view visualizer is shown.
  6. Next, click Themes from the Canvas navigation menu. 
  7. Hover over your theme, and click Open in Theme Editor.
     Canvas themes is shown with the button to view theme editor.
  8. Click Upload from the top left-hand panel.
  9. Next to JavaScript file, click View File.
     View file option for the uploaded them is shown.
  10. Your file will open within your browser. 
  11. Right-click on the page and click Save as to save the file to your device. 
     The javascript file is shown with the option to save it.
  12. Open your file within a text editor of your choosing, such as Notepad, and paste the Javascript code copied in step 5 at the end. 
    New code is shown pasted into the JavaScript file.
  13. Save your file. 
    The file is shown being saved.
  14. Within your Theme Editor, upload the edited file by clicking Select. The canvas theme editor shows the option to upload a javascript file.
  15. Click Preview Your Changes.
    A preview for the javascript file is shown.
  16. Click Save theme, and then select Apply theme to add the new theme setting. Once applied, students who have not installed the YuJa Verity Chrome extension will not be able to access proctored assessments.
    The theme is shown to be applied.

Related articles