Skip to content

eLearning-BS23/moodle-quizaccess_proctoring

Repository files navigation

Moodle Proctoring

Moodle proctoring plugin is a quizaccess plugin to capture a user's picture via webcam to identify who is attempting the Moodle quiz. It will capture the picture of the user's webcam automatically every 30 seconds and store it as a PNG image. Admins can analyze the image of students after exams for verification using AWS Face Rekognition / BS Face Matching API.

This plugin will help you to capture random pictures via webcam when the student/user is attempting the Quiz.

Features

  • Capture user/student images via web camera
  • Can't access quiz if the user does not allow the camera
  • Admin report and check any suspicious activity
  • Will work with existing Question Bank and Quiz
  • Images are stored in Moodledata as a small png image
  • Image can be deleted individually or in bulks
  • Proctoring log report with search facilities
  • Configurable image size and capture interval
  • Face Recognition service(AWS/BS). [This feature validates the user image with a profile image. You can use either Amazon Rekognition or Brainstation Face Recognition service. Please contact us([email protected]) if you want to obtain API Key for brainstation face recognition service]

Instatllation

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 ‘must be acknowledged before starting an attempt’

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 Upload User Images option to add images of users for verification by matching the face

Upload user image settings

Admins can upload all the users images from the following table:

Users list

There must be a face in the uploaded image by the admin.

Select Face Match Method

Select one of the face match method (BS/AWS) 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: [email protected].

AWS Rekognition Settings

For AWS face match method, only the AWS key and secret are needed.

AWS settings

If you need the AWS key and secret, you can refer to this official documentation here. If you need instant assistance, please contact here: [email protected].

Additional Settings

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

Face validation 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

Allowing webcam access before attempting the quiz

Student will be asked to allow access to their webcam for the exam before attempting the quiz:

2  Attempt Quiz

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 AWS face rekognition service/ BS Face Matching API: 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: [email protected] for a trial key.

  5. Where can I get the AWS Secret and Key?

    You can use your own AWS account's secret and key or, you can ask for a trial key in the following email: [email protected]

  6. Is the screenshot feature available?

    No, it is removed because of browser limitation

  7. 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

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

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

  9. 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.

  10. 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.

  11. 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/.

About

No description or website provided.

Topics

Resources

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
LICENSE.md

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published