Skip to content

Latest commit

 

History

History
executable file
·
184 lines (113 loc) · 8.89 KB

README.md

File metadata and controls

executable file
·
184 lines (113 loc) · 8.89 KB

Moodle Proctoring

The Moodle Proctoring plugin is a Quiz Access plugin designed to capture a user's picture via webcam to identify the individual attempting the Moodle quiz. It automatically captures images from the user's webcam at 30-second intervals (or any configurable time gap) and stores them as PNG files. Admins can analyze these images after the exam for verification purposes using the BS Face Matching API.

This plugin enables the capture of random images via webcam while the student or user is attempting a quiz.

Features

  • Automatically captures user/student images via a webcam during a quiz.
  • Prevents quiz access if the user does not allow camera permissions.
  • Admins can view reports to identify suspicious activities.
  • Works seamlessly with the existing Question Bank and Quiz modules.
  • Stores images in Moodledata as compact PNG files.
  • Provides options to delete images individually or in bulk.
  • Includes proctoring log reports with advanced search capabilities.
  • Allows admins to upload base images for user face recognition.
  • Supports face validation before quiz attempts.
  • Configurable image resolution and capture interval.
  • Face Recognition service(BS). [This feature validates the user image with a profile image. You can use Brain Station Face Recognition service. Please contact us(elearning@brainstation-23.com) if you want to obtain API Key for Brain Station face recognition service]

Installation

Install by downloading the ZIP file

  • Install by downloading the ZIP file from Moodle plugins directory
  • Download zip file from GitHub
  • Unzip the zip file in /path/to/moodle/mod/quiz/accessrule/proctoring folder or upload the zip file in the install plugins options from site administration : Site Administration -> Plugins -> Install Plugins -> Upload zip file
  • In your Moodle site (as admin), Visit site administration to finish the installation.

Install using git clone

Go to Moodle Project root/mod/quiz/accessrule/ directory and clone code by using following commands:

git clone https://github.com/eLearning-BS23/moodle-quizaccess_proctoring.git proctoring

Install from Moodle Plugin directory

You can install this plugin directly from Moodle plugins directory.

Configuration

After installing the plugin, you can enable the plugin by configuring the quiz settings:

  • Go to your quiz setting (Edit Quiz):
  • Change the ‘Extra restrictions on attempts’ to ‘Enable webcam capture by Proctoring’
1 Proctoring allow

Settings

To update the plugin settings, navigate to plugin settings: Site Administration->Plugins->Proctoring

  • Go to Site Administrations plugins section.
  • Select Proctoring from the activity module section to configure your plugin settings

Upload User Images

Use the Click here to upload the images option to add user images for verification by matching faces.

Delete All Tracking Records

Use the Click here to delete all records option to remove all tracking records, including images captured during exams.

Upload user image & delete record settings

Admins can upload all user images from the following table: (Note: Admins cannot upload entries that do not contain any images.)

Users list

Additional Settings

Camshot Interval

Admins can adjust the camshot interval and camshot resolution from here. camshot interval and resolutions

Select Face Match Method

Select one of the face match method (BS) from the following settings:

Face match method settings

BS Service API Settings

When using BS facematch, the BS service API, BS API Key has to be entered.

BS Service API Settings

If you need the BS service API, API key for trial, please contact here: elearning@brainstation-23.com.

Validate Face on Quiz Start

You can enable face validation before attempting the quiz. Users will not be able to attempt the quiz if the face doesn’t match with the image uploaded by admin. Face validation settings

This Modal will pop up before attempting the quiz if face validation is disabled. Scheduler task

If Face validation is enabled then this modal will pop up before attempting the quiz. Face validation modal

Face match Scheduler Task

Images of attempted quizzes can be analyzed by an automatic scheduled task. This can be enabled from the following settings. Scheduler task

Attempting the quiz

During attempting the quiz, the quiz page will look like this: 3 Quiz

Proctoring Report

Admins can view the proctoring report: 5 Proctoring summary

Admins can view individual proctoring reports and analyze the images using BS Face Matching API: 6 Proctoring individual report

Proctoring Summary

Admin can view the details record of a course. They can delete a specific quiz record or the entire course record. 6 Proctoring individual report

Browser compatibility of proctoring plugin

Proctoring plugin uses the getUserMedia() API. So, the browser compatibility will be similar to the browser compatibility of getUserMedia() API.

FAQ’s:

  1. How can I upload a user image?

    From the settings of the proctoring plugin, there is an option for uploading user images.

  2. Why does the analyze image button give a red mark for all the images?

    Check whether the credentials for the face match methods are correct and the user’s image is uploaded by the admin.

  3. Can the students upload their own images?

    No, only admins can access.

  4. Where can I get the BS Service API credentials?

    Please contact here: elearning@brainstation-23.com for a trial key.

  5. Is the screenshot feature available?

    No, it is removed because of browser limitation

  6. How can I report an issue regarding this plugin?

    Please raise an issue in this link: https://github.com/eLearning-BS23/moodle-quizaccess_proctoring/issues

  7. Why is my moodle stuck while validating the face?

    Please check whether the credentials for the face match methods are correct

  8. Why can’t I upload some of the user images?

    Every user image needs to have a face that can be detect. Please make sure the image is bright enough and there is no multiple face in that image. Otherwise, it can’t be uploaded.

  9. As a student, why can’t I validate my face before starting a quiz?

    Student’s image must be uploaded by an admin in the moodle to validate their face before an attempt.

  10. What does the yellow mark around the image mean?

    Case 1: Please check whether the user image is uploaded in moodle.

    Case 2: Images captured with previous version of proctoring plugin can’t be analyzed by the current version of proctoring plugin because it lacks some meta data.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.