1. Log in to Moodle as an admin, and click Site administration.
2. Select Plugins tab from the top navbar.
3. Under Activity modules, select External tool.
   
4. Click Manage tools.
   
5. Click Configure a tool manually.
   
6. In the LTI Version field, select LTI 1.3.
7. In the Public key type field, select Keyset URL.

8. Enter the following information in these fields accordingly:  

   • US Zone:
   • Tool name: YuJa Verity
   • Tool URL: https://zone1.verity.yuja.com/lti/1.3
   • Public keyset: https://zone1.verity.yuja.com/jwks
   • Initiate login URL: https://zone1.verity.yuja.com/lti/1.3/login
   • Redirection URL(s): https://zone1.verity.yuja.com/lti/1.3
   
   
   • AUS Zone:
   • Tool name: YuJa Verity
   • Tool URL: https://az/lti/1.3
   • Public keyset: https://az/jwks
   • Initiate login URL: https://az/lti/1.3/login
   • Redirection URL(s): https://az/lti/1.3

   

9. In the Custom Parameters field, enter each of the following parameters on a separate line:  
   • username=$User.username
   • user_id=$User.id
   • person_sourced_id=$Person.sourcedId
   • full_name=$Person.name.full
   • course_section_sourced_id=$CourseSection.sourcedId
   • course_offering_sourced_id=$CourseOffering.sourcedId
   • course_id=$Context.id
   • course_name1=$CourseSection.title
   • course_name2=$Context.title
   • course_role=$Membership.role
10. In the Tool configuration usage field, select Show in activity chooser and as a preconfigured tool. 
11. In the Default Launch Container field, select New Window and check the checkbox of Supports Deep Linking (Content-Item Message).
12. Expand the Services section, and select the following settings:
    • IMS LTI Assignment and Grade Services: Use this service for grade sync and column management. 
    • IMS LTI Names and Role Provisioning: Use this service to retrieve members' information as per privacy settings.
    • Tool settings: Use this service.
13. Expand the Privacy section, and select the following settings:
    • Share launcher's name with tool: Always.
    • Share launcher's email with tool: Always.
    • Accept grades from the new tool: Always.
14. Check Force SSL.
15. Click Save Changes.
    
16. You should be automatically redirected back to the Manage tools page. Scroll down to the Tools section and locate your newly created tool named YuJa Verity.
17. Click the Magnifying Glass icon to open Tool configuration details.
    
18. In the Tool configuration details window, copy the details from each bullet on your screen and send them to your Account Manager to complete the integration process.
    

1. Log in to Moodle as an admin, and select the course you wish to add the Verity LTI link to.
2. Toggle on Edit mode next to your profile icon.
3. Expand the section that you want to add Verity to, then click + Add an activity or resource. 
   Note: Depending on your version of Moodle, the button to add an activity or resource may be different from the image shown.
   
4. Locate and select YuJa Verity. 
   Note: The modal opens automatically to the Starred page. If you cannot find YuJa Verity, navigate to the Activities tab, you should be able to see all activities in your Moodle instance and locate YuJa Verity there.
   
5. In the Activity name field, enter the name you want Verity to be displayed in your course.
6. Click Save and display.
   
7. You will be directed to the YuJa Verity link to authenticate yourself.
   Note: All users must authenticate themselves before being able to access Verity.

1. Locate and click the YuJa Verity LTI link in your Moodle environment.
2. Within Verity, select Settings > Integration Settings from the side navbar.
   
3. Select LMS Visualizer in the Select Integration drop-down menu.
4. Click Download Visualizer.
5. Copy and make a note of the information in the Verity Institute ID and Environment fields. They will be required in the steps later.
   
6. Within Moodle, click Site administration.
7. Click Plugins > Install plugins.
   
8. Click Choose a file or drag and drop to upload the Visualizer file.
   
9. (Optional) If you have clicked Choose a file..., click Choose File in the pop-up window, select the Visualizer file, then click Upload this file.
   
10. Click Show more.
    
11. From the Plugin type drop-down menu, select Local Plugin (local).
12. Click Install plugin from the ZIP file.
    
13. Click Continue.
    
14. Once all server checks have passed, scroll down and click Continue to complete the plugin installation process.
15. Click Site administration > Plugins.
16. Locate the Verity section and select Verity for Moodle Settings.
    
17. Enter the information copied from Verity previously in the Institute ID and the Verity Environment fields from step 5.
18. Click Save changes. Your Moodle instance will now check for the Verity Browser Extension before test-takers start a Verity proctored assessment.
    

Adding the Moodle API with Verity

After integrating Moodle with Verity, admins can add the Moodle API to Verity. Adding the API will ensure assessment names are synced between Moodle and Verity. 

Creating an External Service in Moodle

You will need to create an external service that includes the required API functions.

1. Log in to Moodle as an administrator and click Site administration from the navigation menu.

   

2. Click Server and select External services from Web services.

   

3. Under Custom services, click Add.

   

4. Enter the Name of your integration (e.g. Verity) and, check the Enabled checkbox, then click Add service.

   

5. On the next page, click Add functions.

   

   Note: Click Continue if you're not properly redirected to the add functions page.
   

6. In the Name drop-down list, search for the following API functions and click each of them to add them to your service:
   • core_course_get_contents
   • core_course_get_courses
   • core_user_get_users
   • core_enrol_get_enrolled_users_with_capability
   • mod_assign_get_assignments
   • mod_folder_get_folders_by_courses
   • mod_forum_get_forums_by_courses
   • mod_glossary_get_glossaries_by_courses
   • mod_lesson_get_lessons_by_courses
   • mod_page_get_pages_by_courses
   • mod_quiz_get_quizzes_by_courses
   • core_webservice_get_site_info
   • local_verity_get_lti_launch_url

7. Click Add functions.
   

    

Obtaining Your API Access Token in Moodle

After creating an external service that contains the necessary API functions, you can now create an API access token with the created service.

1. In Moodle, go to Site administration > Server.

2. Select Manage tokens from Web services.

   

3. Click Create token on the Manage tokens page.

   

4. In the User field, select your desired administrator account(s) from the drop-down menu.
5. In the Service field, select the name of the service that you created in the previous section of this guide from the drop-down menu.

6. Click Save changes.

   

7. Copy the token of the new service that you have created from the Manage tokens page.
   

Adding the Token to Verity

After getting the API access token from Moodle, you can add the access token into Verity.

1. Navigate to Moodle and click My courses in the navigation menu.

2. Select any course in which Verity is enabled.

   

3. On the course page, select Verity from the side menu.

   

4. Inside Verity, hover over to the side menu and click Settings > Integration Settings.

   

5. Select LMS API from the Select Integration drop-down menu. 

6. Click Add Access Key in the LMS API Access window.

   

7. Paste the access token that you copied from Moodle, then click Add.

   

8. Click Save Changes to save your integration.