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.
Clickherefor plugin demo.
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.]
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’
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
Admins can upload all the users images from the following table:
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:
BS Service API Settings
When using BS facematch, the BS service API, BS API Key has to be entered.
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.
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 modal will pop up before attempting the quiz.
Face match Scheduler Task
Images of attempted quizzes can be analyzed by an automatic scheduled task. This can be enabled from the following settings.
Allowing webcam access before attempting the quiz
Student will be asked to allow access to their webcam for the exam before attempting the quiz:
Attempting the quiz
During attempting the quiz, the quiz page will look like this:
Proctoring Report
Admins can view the proctoring report:
Admins can view individual proctoring reports and analyze the images using AWS face rekognition service/ BS Face Matching API:
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/>.
