Skip to content
Developers & integrations

Proctoring Settings: Key Parameters for Integration

This article summarizes the main proctoring_settings that can be passed in assignment.settings.proctoring_settings to control how TrustExam monitors an exam.

Guide reviewed:

Full parameter set is available in the TrustExam manager interface. Below are the most important groups for integrators
Full parameter set is available in the TrustExam manager interface. Below are the most important groups for integrators
Full parameter set is available in the TrustExam manager interface. Below are the most important groups for integrators

1. System & Environment

Parameter (Type, Default)

Description

check_env (bool, default: true)

Hardware and environment check before the exam.

browser_type (string, default: "*" for any)

Limit allowed browsers in browser mode ("chrome", "edge", "yandex", "firefox", "safari", or "*").

displays_check (int, default: 1)

Enforce single-monitor usage (0 = off, 1 = on).

hdcp_check (int, default: 0)

Advanced external display / HDCP checks (0 = off, 1 = on).

fullscreen_mode (int, default: 1)

Require full-screen mode (0 = off, 1 = on).

focus_detector (int, default: 1)

Track loss of exam window focus.

focus_tolerance_seconds (int, default: 1500)

Allowed time with lost focus (in seconds).

extension_detector (int, default: 1)

Check for forbidden browser extensions.

read_clipboard (bool, default: false)

Allow reading clipboard for potential content leak detection.

content_protect (bool, default: false)

Enable content protection (against screenshots / remote tools).

2. Camera & Screen

Parameter (Type, Default)

Description

main_camera_record (bool, default: true)

Streaming from the primary (front) camera.

main_camera_upload (bool, default: false)

Recording and uploading front-camera video.

second_camera_record (bool, default: true)

Streaming from a secondary camera (mobile device).

second_camera_upload (bool, default: false)

Recording and uploading secondary camera video.

screen_share_record (bool, default: true)

Screen streaming.

screen_share_upload (bool, default: false)

Recording and uploading screen video.

3. Identity & Verification

Parameter (Type, Default)

Description

photo_head_identity (int, default: 1)

Biometric photo identification (0 = off, 1 = on).

video_head_identity (bool, default: false)

Ongoing video-based identity verification.

id_verification (bool, default: false)

ID document capture (passport, student ID, etc.).

4. Audio, Noise, and Speech

Parameter (Type, Default)

Description

second_microphone_record / second_microphone_upload (bool)

Use a second microphone for micro-earpiece detection.

second_microphone_label (string)

Regex patterns for allowed second-mic device names.

noise_detector (int, default: 1)

Enable ambient noise analysis.

speech_detector (int/bool, default: true)

Enable speech detection.

noise_sensitivity (int, default: 10)

Noise sensitivity (dB).

noise_tolerance_frames (int, default: 3)

Number of consecutive “noisy” frames allowed.

noise_tolerance_seconds (int, default: 1500)

Allowed noise duration.

silent_tolerance_seconds (int, default: 1500)

Allowed full silence duration.

5. Head & Face Tracking

Parameter (Type, Default)

Description

head_x_sensitivity, head_y_sensitivity, head_depth_sensitivity

Sensitivity to head movements (left-right, up-down, forward-back).

head_compare_interval

Interval for biometric face comparison.

head_position_interval

Frequency of head position checks.

head_tolerance_seconds

How long the head may stay out of the safe zone.

head_tracking_client (bool, default: true)

Client-side head tracking.

head_tracking_server, head_tracking_server_post, head_tracking_server_realtime

Server-side analysis during or after the exam.

object_detect (bool, default: false)

Enable object detection (phones, people, etc.).

object_detect_interval, object_detect_threshold, object_detect_categories

Frequency, confidence, and types of objects to track.

face_landmarker (bool, default: false)

Eye / gaze tracking.

6. Additional Flags

Parameter (Type, Default)

Description

proctoring_mobile_restrict (bool, default: false)

Block exams on mobile devices.

proctoring_fallback_allow (bool, default: false)

Allow exam start even if some proctoring features fail to initialize.

rtc_connection_timeout

Max time to establish streaming connections.

facemodel_init_timeout

Max time to initialize face recognition.

YOUR NEXT STEP

Still need help?

Reach the right team for your question.

A technical problem

For the camera, microphone, app or equipment check, open support chat inside TrustExam when available in your session. If you cannot sign in, use the contact in your invitation.

Open TrustExam

Access, schedule or results

Contact your exam organiser using the details in your invitation. They handle assignment access and timing, grades, retakes, appeals and individual arrangements.

What to check before contacting them
What to include in a support message
  • Exam name and the step where the problem occurred.
  • The time and your time zone.
  • Exact error text, operating system, and browser or app version.
  • Checks already tried; an error screenshot without exam questions or unnecessary personal data.

Do not include passwords, sign-in codes or identity documents in an ordinary message. Use the exam’s designated identity-check step for documents.