This document provides admins with instructions on integrating the Verity Test Proctoring Platform into Canvas using LTI 1.3. Before proceeding with the steps below, please ensure you have full access to your Canvas instance as an admin. If you have questions about the process, please contact your dedicated Client Success Manager.
Note: It is strongly recommended to create a separate service account in Canvas for the integration. This makes it easier to identify which actions were performed by the integration and which were performed by a human admin, helping prevent confusion or unintended changes.
Adding Verity to Canvas
As an admin, you can integrate Verity with Canvas by adding a JSON URL to the Developer Keys.
- Log in to Canvas as an admin. From the left sidebar, click on Admin, and select the Canvas account for your institution.
- In the sidebar, select Admin > Developer Keys.
- Click + Developer Key > + LTI Key.
- In the Key Settings page, enter a name for your key (e.g., YuJa Verity).
- From the Method drop-down menu, select Enter URL.
- In the JSON URL field, enter this URL: https://zone1.verity.yuja.com/api/verity/lti/config/canvas.json
- Click Save.
- In the Developer Keys page, locate the Verity key that you have added.
- Toggle the State field to ON. If the Turn On Developer Key pop-up appears, click Switch to On.
- Click View in Canvas Apps. A new Canvas window will be opened.
- Click the Modify availability (pencil) icon.
- Change the status to Available, then click Save. Proceed to Generating a Client Key and Secret to complete the integration.
Generating a Client Key and Secret
- Click + Developer Key > API Key.
- Enter the following information:
- Key Name: Verity API Integration
-
Redirect URls: https://<zoneURL>/canvas-auth
- US Zone: https://zone1.verity.yuja.com/lms/canvas/auth
-
AUS Zone: https://az.verity.yuja.com/lms/canvas/auth
-
(Optional) Enable Enforce Scopes.
Note: We do not recommend enforcing scopes. It will require you to reintegrate Verity with the Canvas API whenever Verity adds new functionality that uses the API. Additionally, if scopes are enabled, the Verity Mobile Lockdown App will not be supported. If your institution uses the Verity Mobile Lockdown App, it is required that scopes be disabled.If you do not want to proceed with this, please ensure that Enforce Scopes is disabled, then proceed to step 5.
- Check Allow Include Parameters and then check the following parameters:
- Accounts:
- url:GET|/api/v1/accounts
- url:GET|/api/v1/accounts/:id
- url:GET|/api/v1/manageable_accounts
- url:GET|/api/v1/course_creation_accounts
- url:GET|/api/v1/course_accounts
- url:GET|/api/v1/accounts/:account_id/sub_accounts
- url:GET|/api/v1/accounts/:account_id/permissions
- url:GET|/api/v1/accounts/:account_id/courses
- Assignments:
- url:GET|/api/v1/courses/:course_id/assignments
- url:GET|/api/v1/courses/:course_id/assignments/:id
- url:POST|/api/v1/courses/:course_id/assignments
- url:PUT|/api/v1/courses/:course_id/assignments/:id
- Courses:
- url:GET|/api/v1/courses
- url:GET|/api/v1/courses/:id
- url:GET|/api/v1/accounts/:account_id/courses/:id
- url:GET|/api/v1/users/:user_id/courses
- url:GET|/api/v1/courses/:course_id/users
- url:GET|/api/v1/courses/:course_id/users/:id
- External Tools:
- url:GET|/api/v1/courses/:course_id/external_tools/:external_tool_id
- url:GET|/api/v1/courses/:course_id/external_tools
- url:GET|/api/v1/courses/:course_id/external_tools/sessionless_launch
- url:GET|/api/v1/accounts/:account_id/external_tools/sessionless_launch
- New Quiz Items:
- url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items/:item_id
- url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items
- url:POST|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items
- url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items/:item_id
- Quizzes:
- url:GET|/api/v1/courses/:course_id/quizzes
- url:GET|/api/v1/courses/:course_id/quizzes/:id
- url:POST|/api/v1/courses/:course_id/quizzes
- url:PUT|/api/v1/courses/:course_id/quizzes/:id
- url:POST|/api/v1/courses/:course_id/quizzes/:id/validate_access_code
- url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
- url:GET|/api/quiz/v1/courses/:course_id/quizzes
- url:POST|/api/quiz/v1/courses/:course_id/quizzes
- url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
- Quiz Questions:
- url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
- url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
- url:POST|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
- url:PUT|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
- Users:
- url:GET|/api/v1/users/:id
- url:GET|/api/v1/accounts/:account_id/users
- Accounts:
- Click Save.
- Copy the API Key Secret that appears in the Developer Key Created pop-up, then click close.
- 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.
- In Canvas, click the YuJa Verity link in the sidebar to open the Verity portal.
- In Verity, select Settings > Integration Settings from the side navbar.
- Select LMS API in the Select Integration drop-down menu.
- In the Access Keys section, click Test Institution Access to make sure your Canvas account has been integrated with the API.
- 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. - Click Close.
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.
- Log in to Verity.
- In Verity, select Settings > Integration Settings from the side navbar.
- Select LMS Visualizer in the Select Integration drop-down menu.
- Click View Visualizer.
- Copy the JavaScript code that appears in the new tab.
- Within Canvas, select Themes from the side navbar.
- Hover over your theme, and click Open in Theme Editor.
- From the left panel, click the Upload tab.
- Locate the JavaScript file field, then click View File to open the JavaScript code page.
- Right-click on the JavaScript code page and select Save as to save the file to your device.
- Open your file within a text editor (e.g., Notepad), and paste the JavaScript code copied in step 5 at the end.
- Save your file in your text editor.
- Within your Theme Editor, locate the JavaScript file field and click Select to upload your file.
- Locate the Mobile app JavaScript file field, then click View File to open the JavaScript code page.
- Right-click on the JavaScript code page and select Save as to save the file to your device.
- Open your file within a text editor (e.g., Notepad), and paste the JavaScript code copied in step 5 at the end.
- Save your file in your text editor.
- Within your Theme Editor, locate the Mobile app JavaScript file field and click Select to upload your file.
- Click Preview Your Changes.
- Click Save theme.
- Click Apply theme to add the new theme setting.