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.
  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.
  7. Copy the Client ID that is provided under Details, and ensure the developer key is ON under State.
  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.
  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.
  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.
  17. A small window will open displaying your Deployment ID. 
  18. Your Client ID can be located in the Developer Keys menu.

Integrating the REST API for Practice Quizzes 

The REST API is an optional integration that allows instructors to create practice quizzes in Canvas to familiarize students with YuJa 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 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. Enable Enforce Scopes.
  6. Check Allow Include Parameters and check the parameters listed below:
    • Expand Quiz Questions and check:
      •  url:POST|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
    • Expand Quizzes and check:
      • url:POST|/api/v1/courses/:course_id/quizzes
      • url:PUT|/api/v1/courses/:course_id/quizzes/:id
  7. Click Save.
  8. Ensure the State is toggled ON.
  9. Copy the Client ID that is provided under Details, and click Show Key to reveal and copy the Client Secret.
  10. 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. 

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 YuJa Verity quizzes unless the YuJa Verity Chrome extension is installed. If this feature is not enabled by the Admin, Students will be able to access Verity quizzes without YuJa Verity for Test Proctoring. To learn how to enable this feature, please follow the steps below.    

  1. Log in to Canvas as an Admin.
  2. Click Admin from the left-hand panel and select the account you would like to add the JavaScript code to.
  3. Click Themes from the navigation menu. 
  4. Select your theme, and click Open in Theme Editor.
  5. Click Upload from the top left-hand panel.
  6. Next to JavaScript file, click View File.
  7. Your file will open within your browser. 
  8. Right-click on the page and click Save as to save the file to your device.   
  9. Open your file within a text editor of your choosing, such as Notepad. 
  10. Copy the JavaScript code below, and add it to the end of your existing file. 

    • (async function() { const VERITY_URL = 'https://zone1.verity.yuja.com'; function loadScript(url) { const script = document.createElement('script'); script.src = url; script.classList.add("yuja-verity-canvas-theme-inject"); document.head.appendChild(script); } try { const response = await fetch(VERITY_URL + '/resources/themes/canvas', {cache: 'no-store'}); const scriptUrl = await response.text(); loadScript(scriptUrl); } catch (e) { console.error('Failed to load Verity: ', e); } })();  

  11. Save your file. 
  12. Within your Theme Editor, upload the edited file by clicking Select.
  13. Click Preview Your Changes.
  14. Click Save theme, and then select Apply theme to add the new theme setting.
  15. Once applied, Students who have not installed the YuJa Verity Chrome extension will not be able to access YuJa Verity for Test Proctoring quizzes.

Related articles