diff --git a/openedx/envs/common.py b/openedx/envs/common.py
index 86f6d9e1dc..4d8c223d25 100644
--- a/openedx/envs/common.py
+++ b/openedx/envs/common.py
@@ -2390,7 +2390,33 @@ ENTRANCE_EXAM_MIN_SCORE_PCT = 50
# Initialize to 'release', but read from JSON in production.py
EDX_PLATFORM_REVISION = 'release'
-# Proctoring configuration (redirct URLs and keys shared between systems)
+# .. setting_name: PROCTORING_BACKENDS
+# .. setting_description: A dictionary describing all available proctoring provider configurations.
+# Structure:
+# {
+# "
": {
+# "show_review_rules": ,
+# "requires_escalation_email": ,
+# ... additional provider-specific options ...
+# },
+# "": { ... }
+# ...
+# "DEFAULT": "",
+# }
+#
+# Keys:
+#
+# **show_review_rules** (bool):
+# Whether studio would show a "Review Rules" field as part of proctoring configuration.
+# Default is True.
+#
+# **requires_escalation_email** (bool):
+# Providers with this flag set to True require that an escalation email address be
+# specified in the advanced course settings. Default is False.
+# .. setting_default: {
+# 'DEFAULT': 'null',
+# 'null': {}
+# }
PROCTORING_BACKENDS = {
'DEFAULT': 'null',
# The null key needs to be quoted because
diff --git a/requirements/edx/kernel.in b/requirements/edx/kernel.in
index 38bf64f8ed..4c2ed2c145 100644
--- a/requirements/edx/kernel.in
+++ b/requirements/edx/kernel.in
@@ -80,7 +80,6 @@ edx-opaque-keys>=2.12.0
edx-organizations
edx-proctoring>=2.0.1
# using hash to support django42
-# edx-proctoring-proctortrack==1.2.1 # Intentionally and permanently pinned to ensure code changes are reviewed
edx-rest-api-client
edx-search
edx-submissions
diff --git a/xmodule/course_block.py b/xmodule/course_block.py
index 9d24f15306..0ebd00a3e5 100644
--- a/xmodule/course_block.py
+++ b/xmodule/course_block.py
@@ -283,7 +283,10 @@ class ProctoringProvider(String):
return default
-def get_available_providers(): # lint-amnesty, pylint: disable=missing-function-docstring
+def get_available_providers() -> list[str]:
+ """
+ Return list of available proctoring providers.
+ """
proctoring_backend_settings = getattr(
settings,
'PROCTORING_BACKENDS',
@@ -296,6 +299,24 @@ def get_available_providers(): # lint-amnesty, pylint: disable=missing-function
return available_providers
+def get_requires_escalation_email_providers() -> list[str]:
+ """
+ Return list of available proctoring providers that require an escalation email.
+ """
+ requires_escalation_email_providers = [
+ provider
+ for provider in settings.PROCTORING_BACKENDS
+ if provider != "DEFAULT"
+ and settings.PROCTORING_BACKENDS[provider].get(
+ "requires_escalation_email", False
+ )
+ ]
+ # Add lti_external unconditionally since it always requires an escalation email
+ requires_escalation_email_providers.append('lti_external')
+ requires_escalation_email_providers.sort()
+ return requires_escalation_email_providers
+
+
class TeamsConfigField(Dict):
"""
XBlock field for teams configuration, including definitions for teamsets.
@@ -878,9 +899,9 @@ class CourseFields: # lint-amnesty, pylint: disable=missing-class-docstring
)
proctoring_escalation_email = EmailString(
- display_name=_("Proctortrack Exam Escalation Contact"),
+ display_name=_("Proctoring Exam Escalation Contact"),
help=_(
- "Required if 'proctortrack' is selected as your proctoring provider. "
+ "Required if 'requires_escalation_email' is set in the proctoring backend."
"Enter an email address to be contacted by the support team whenever there are escalations "
"(e.g. appeals, delayed reviews, etc.)."
),