Compare commits

..

No commits in common. "master" and "dev-1.2" have entirely different histories.

1313 changed files with 17965 additions and 72600 deletions

View file

@ -16,60 +16,92 @@ jobs:
maven-build-reporting: maven-build-reporting:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- name: Get short SHA
uses: benjlevesque/short-sha@v3.0
id: short-sha
- name: Store short SHA as environment variable
run: echo $SHA
env:
SHA: ${{ steps.short-sha.outputs.sha }}
- name: Set env
run: echo "TAG_NAME=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
- name: Test tag name
run: |
echo $TAG_NAME
echo ${{ env.TAG_NAME }}
- -
name: Checkout repository name: Checkout repository
uses: actions/checkout@v4 uses: actions/checkout@v2
- -
name: Build Test Reporting name: Set up JDK 8
uses: actions/setup-java@v4 uses: actions/setup-java@v2
with: with:
java-version: '17' java-version: '8'
distribution: 'adopt' distribution: 'adopt'
- -
name: Cache Maven packages name: Cache Maven packages
uses: actions/cache@v4 uses: actions/cache@v2
with: with:
path: ~/.m2 path: ~/.m2
key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }} key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
restore-keys: ${{ runner.os }}-m2 restore-keys: ${{ runner.os }}-m2
- -
name: Build with Maven name: Build with Maven
run: mvn clean install -e -P let_reporting -Dsebserver-version="${{ env.TAG_NAME }}-${{ env.SHA }}" run: mvn clean install -e -P let_reporting
env: -
sebserver-version: ${{ env.TAG_NAME }}-${{ env.SHA }} name: Reporting
uses: codecov/codecov-action@v1
with:
flags: unittests
name: SEB Server Build
fail_ci_if_error: false
verbose: false
- name: Simplify package name maven-build-docker:
needs: maven-build-reporting
# Run only on tagging
if: github.event_name == 'push' && contains(github.ref, 'refs/tags/')
runs-on: ubuntu-latest
steps:
-
name: Get short SHA
uses: benjlevesque/short-sha@v1.2
id: short-sha
-
name: Store short SHA as environment variable
run: echo $SHA
env:
SHA: ${{ steps.short-sha.outputs.sha }}
-
name: Set env
run: echo "TAG_NAME=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
-
name: Test tag name
run: |
echo $TAG_NAME
echo ${{ env.TAG_NAME }}
-
name: Checkout repository
uses: actions/checkout@v2
-
name: Set up JDK 11
uses: actions/setup-java@v2
with:
java-version: '11'
distribution: 'adopt'
-
name: Cache Maven packages
uses: actions/cache@v2
with:
path: ~/.m2
key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
restore-keys: ${{ runner.os }}-m2
-
name: Build with Maven
run: mvn clean install -Dmaven.test.skip=true -Dsebserver-version="${{ env.TAG_NAME }}-${{ env.SHA }}"
env:
sebserver-version: ${{ env.TAG_NAME }}-${{ env.SHA }}
-
name: Simplify package name
run: mv target/seb-server-${{ env.TAG_NAME }}-${{ env.SHA }}.jar target/seb-server.jar run: mv target/seb-server-${{ env.TAG_NAME }}-${{ env.SHA }}.jar target/seb-server.jar
- uses: actions/upload-artifact@v4 -
uses: actions/upload-artifact@v2
with: with:
name: Package name: Package
path: target/seb-server.jar path: target/seb-server.jar
docker-build: docker-build:
needs: maven-build-reporting needs: maven-build-docker
# Run only on tagging # Run only on tagging
if: github.event_name == 'push' && contains(github.ref, 'refs/tags/') if: github.event_name == 'push' && contains(github.ref, 'refs/tags/')
runs-on: ubuntu-latest runs-on: ubuntu-latest
permissions:
contents: read
packages: write
# This is used to complete the identity challenge
# with sigstore/fulcio when running outside of PRs.
id-token: write
steps: steps:
- -
name: Set env name: Set env
@ -81,71 +113,31 @@ jobs:
echo ${{ env.TAG_NAME }} echo ${{ env.TAG_NAME }}
- -
name: Set up QEMU name: Set up QEMU
uses: docker/setup-qemu-action@v3 uses: docker/setup-qemu-action@v1
- -
name: Set up Docker Buildx name: Set up Docker Buildx
uses: docker/setup-buildx-action@v3.2.0 uses: docker/setup-buildx-action@v1
- -
name: Login to DockerHub name: Login to DockerHub
uses: docker/login-action@v2 uses: docker/login-action@v1
with: with:
username: ${{ secrets.DOCKERHUB_USERNAME }} username: ${{ secrets.DOCKERHUB_USERNAME }}
password: ${{ secrets.DOCKERHUB_TOKEN }} password: ${{ secrets.DOCKERHUB_TOKEN }}
- -
name: Checkout repository name: Checkout repository
uses: actions/checkout@v4 uses: actions/checkout@v2
# Install the cosign tool except on PR
# https://github.com/sigstore/cosign-installer
-
name: Install cosign
if: github.event_name != 'pull_request'
uses: sigstore/cosign-installer@main
- -
name: Download a single artifact name: Download a single artifact
uses: actions/download-artifact@v4 uses: actions/download-artifact@v2
with: with:
name: Package name: Package
-
name: Extract metadata (tags, labels) for Docker
id: meta
uses: docker/metadata-action@v4
with:
images: anhefti/seb-server
tags: |
type=raw,${{ env.TAG_NAME }}
- -
name: Build and push name: Build and push
id: docker_build id: docker_build
uses: docker/build-push-action@v4 uses: docker/build-push-action@v2
with: with:
context: . context: .
file: ./docker/Dockerfile file: ./docker/Dockerfile
push: true push: true
tags: | tags: |
anhefti/seb-server:${{ env.TAG_NAME }} anhefti/seb-server:${{ env.TAG_NAME }}
# Sign the resulting Docker image digest except on PRs.
# This will only write to the public Rekor transparency log when the Docker
# repository is public to avoid leaking data. If you would like to publish
# transparency data even for private images, pass --force to cosign below.
# https://github.com/sigstore/cosign
- name: Sign the published Docker image
if: ${{ github.event_name != 'pull_request' }}
# This step uses the identity token to provision an ephemeral certificate
# against the sigstore community Fulcio instance.
run: yes | cosign sign ${TAGS}
env:
COSIGN_EXPERIMENTAL: true
TAGS: ${{ steps.meta.outputs.tags }}
cleanup:
needs: [maven-build-reporting, docker-build]
if: |
always()
runs-on: ubuntu-latest
steps:
-
name: Delete Artifacts
uses: geekyeggo/delete-artifact@v5
with:
name: Package

View file

@ -1,35 +0,0 @@
# Read the Docs configuration file for Sphinx projects
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
# Required
version: 2
# Set the OS, Python version and other tools you might need
build:
os: ubuntu-22.04
tools:
python: "3.12"
# You can also specify other tool versions:
# nodejs: "20"
# rust: "1.70"
# golang: "1.20"
# Build documentation in the "docs/" directory with Sphinx
sphinx:
configuration: docs/conf.py
# You can configure Sphinx to use a different builder, for instance use the dirhtml builder for simpler URLs
# builder: "dirhtml"
# Fail on all warnings to avoid broken references
# fail_on_warning: true
# Optionally build your docs in additional formats such as PDF and ePub
# formats:
# - pdf
# - epub
# Optional but recommended, declare the Python requirements required
# to build your documentation
# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
python:
install:
- requirements: docs/requirements.txt

31
Jenkinsfile vendored
View file

@ -14,28 +14,35 @@ pipeline {
stages { stages {
stage('Maven build') { stage('Maven build') {
steps { steps {
withMaven(maven: 'Maven3.9.6') { withMaven(maven: 'Maven', options: [findbugsPublisher(disabled: true)]) {
sh "mvn clean install -e -P let_reporting" sh "mvn clean install -e -P let_reporting"
} }
} }
} }
stage('Reporting') { stage('Reporting') {
steps { steps {
withMaven(maven: 'Maven3.9.6') { pmd canComputeNew: false, defaultEncoding: '', healthy: '', pattern: '**/target/pmd.xml', thresholdLimit: 'high', unHealthy: ''
sh "mvn --batch-mode -V -U -e -P let_reporting pmd:pmd pmd:cpd spotbugs:spotbugs" findbugs canComputeNew: false, defaultEncoding: '', excludePattern: '', healthy: '', includePattern: '', isRankActivated: true, pattern: '**/target/findbugsXml.xml', unHealthy: ''
} jacoco classPattern: '**/build/classes/*/main/', execPattern: '**/target/*.exec', sourcePattern: '**/src/main/java', inclusionPattern: '**/*.class'
}
}
stage('Tag') {
steps {
echo 'Build is tagged here.'
} }
} }
stage('Push to Nexus') {
steps {
echo 'Build is pushed to Nexus here.'
}
}
} }
post { post {
always {
junit testResults: '**/target/surefire-reports/TEST-*.xml'
recordIssues enabledForFailure: true, tool: spotBugs()
recordIssues enabledForFailure: true, tool: pmdParser(pattern: '**/target/pmd.xml')
}
failure { failure {
setBuildStatus("Build failed", "FAILURE"); setBuildStatus("Build failed", "FAILURE");
emailext body: "The build of the LET Application (${env.JOB_NAME}) failed! See ${env.BUILD_URL}", recipientProviders: [[$class: 'CulpritsRecipientProvider']], subject: 'LET Application Build Failure' emailext body: "The build of the LET Application (${env.JOB_NAME}) failed! See ${env.BUILD_URL}", recipientProviders: [[$class: 'CulpritsRecipientProvider']], subject: 'LET Application Build Failure'
@ -50,6 +57,6 @@ pipeline {
} }
triggers { triggers {
pollSCM('H/5 * * * *') pollSCM('H/5 * * * *')
} }
} }

View file

@ -1,21 +1,32 @@
Safe Exam Browser (SEB) Server Master:
--------------------------------
.. image:: https://github.com/SafeExamBrowser/seb-server/actions/workflows/buildReporting.yml/badge.svg?branch=master .. image:: https://github.com/SafeExamBrowser/seb-server/actions/workflows/buildReporting.yml/badge.svg?branch=master
:target: https://github.com/SafeExamBrowser/seb-server/actions :target: https://github.com/SafeExamBrowser/seb-server/actions
.. image:: https://readthedocs.org/projects/seb-server/badge/?version=latest .. image:: https://readthedocs.org/projects/seb-server/badge/?version=latest
:target: https://seb-server.readthedocs.io/en/latest/?badge=latest :target: https://seb-server.readthedocs.io/en/latest/?badge=latest
.. image:: https://codecov.io/gh/SafeExamBrowser/seb-server/branch/master/graph/badge.svg
:target: https://codecov.io/gh/SafeExamBrowser/seb-server
.. image:: https://img.shields.io/github/languages/code-size/SafeExamBrowser/seb-server .. image:: https://img.shields.io/github/languages/code-size/SafeExamBrowser/seb-server
:target: https://github.com/SafeExamBrowser/seb-server :target: https://github.com/SafeExamBrowser/seb-server
Development:
.. image:: https://github.com/SafeExamBrowser/seb-server/actions/workflows/buildReporting.yml/badge.svg?branch=development
:target: https://github.com/SafeExamBrowser/seb-server/actions
.. image:: https://codecov.io/gh/SafeExamBrowser/seb-server/branch/development/graph/badge.svg
:target: https://codecov.io/gh/SafeExamBrowser/seb-server
.. image:: https://img.shields.io/github/last-commit/SafeExamBrowser/seb-server/development?logo=github
:target: https://github.com/SafeExamBrowser/seb-server/tree/development
About
-----
The Safe Exam Browser Server web application simplifies and centralizes the configuration of Safe Exam Browser clients for exams. It interacts with a learning management or exam system for setting up and conducting e-assessments with Safe Exam Browser. It also improves security by allowing to monitor connected Safe Exam Browser clients in real time during e-assessments. The Safe Exam Browser Server web application simplifies and centralizes the configuration of Safe Exam Browser clients for exams. It interacts with a learning management or exam system for setting up and conducting e-assessments with Safe Exam Browser. It also improves security by allowing to monitor connected Safe Exam Browser clients in real time during e-assessments.
What is Safe Exam Browser (SEB)? What is Safe Exam Browser (SEB)?
-------------------------------- --------------------------------
`Safe Exam Browser <https://safeexambrowser.org/>`_ (SEB) is an application to carry out e-assessments safely. The free-ware application is available for Windows, macOS and iOS. It turns any computer temporarily into a secure workstation. It controls access to resources like system functions, other websites and applications and prevents unauthorized resources being used during an exam. Safe Exam Browser can work with Open edX to control what a student can access during a Open edX quiz attempt. With the SEB Open edX plugin you activate the SEB support in Open edX and now only students using an approved version of SEB and the correct settings will be able to access the quiz in your Open edX course. The Safe Exam Browser is offered under a Mozilla Public License and supported by the `SEB Alliance <https://safeexambrowser.org/alliance/>`_. `Safe Exam Browser <https://safeexambrowser.org/>`_ (SEB) is an application to carry out e-assessments safely. The freeware application is available for Windows, macOS and iOS. It turns any computer temporarily into a secure workstation. It controls access to resources like system functions, other websites and applications and prevents unauthorized resources being used during an exam. Safe Exam Browser can work with Open edX to control what a student can access during a Open edX quiz attempt. With the SEB Open edX plugin you activate the SEB support in Open edX and now only students using an approved version of SEB and the correct settings will be able to access the quiz in your Open edX course. The Safe Exam Browser is offered under a Mozilla Public License and supported by the `SEB Alliance <https://safeexambrowser.org/alliance/>`_.
What is Safe Exam Browser Server (SEB Server)? What is Safe Exam Browser Server (SEB Server)?
@ -23,15 +34,15 @@ What is Safe Exam Browser Server (SEB Server)?
While the interaction with SEB is well known in Learning Management Systems (LMS) like `Open edX <https://open.edx.org/>`_, While the interaction with SEB is well known in Learning Management Systems (LMS) like `Open edX <https://open.edx.org/>`_,
`Moodle <https://moodle.org/>`_ etc. the SEB Server is an entirely new component to set up secured online exams. `Moodle <https://moodle.org/>`_ etc. the SEB Server is an entirely new component to set up secured online exams.
It interacts with the assessments system/LMS as well as with SEB on exam clients. It supports exam scenarios on student owned devices (BYOD) It interacts with the assessments system/LMS as well as with SEB on exam clients.It supports exam scenarios on student owned devices (BYOD)
and on managed devices. and on managed devices.
SEB Server is a modern webservice with a REST API and a GUI service on top of it. SEB Server is written in Java and uses Docker for installation and setup. SEB Server is a modern webservice with a REST API and a GUI service on top of it. SEB Server is written in Java and uses Docker for installation and setup.
SEB Server provides a range of basic functionalities: SEB Server provides a range of basic functionalities:
- Built-in institutional multitenancy - Built-in institutional multitenancy
- Linking of multiple Learning Management Systems (LMS). Currently supported LMS: `Open edX <https://open.edx.org/>`_, `Moodle <https://moodle.org/>`_, `OLAT <https://www.olat.org/>`_, `ANS <https://ans.app/>`_ - Linking of multiple Learning Management Systems (LMS). Currently supported: `Open edX <https://open.edx.org/>`_
- Accessing the Course/Exam-API of a linked LMS to import a courses or exams for managing with SEB Server - Accessing the Course/Exam-API of a linked LMS to import a courses or exams for managing with SEB Server
- Creation and administration of SEB Client Configurations that can be used to startup a SEB and that contains SEB Server connection information for a SEB Client - Creation and administration of SEB Client Configurations that can be used to startup a SEB and that contains SEB Server connection information for a SEB Client
- Creation and administration of SEB Exam Configurations that can be bound to an imported Exam to automatically configure a SEB Client that connects to an exam that is managed by SEB Server - Creation and administration of SEB Exam Configurations that can be bound to an imported Exam to automatically configure a SEB Client that connects to an exam that is managed by SEB Server
@ -42,56 +53,92 @@ The image below shows a very simplified diagram that locates the SEB Server in a
Safe Exam Browser (SEB). The SEB Server communicates with the LMS for managing and prepare exams as well as with the SEB Client to ensure Safe Exam Browser (SEB). The SEB Server communicates with the LMS for managing and prepare exams as well as with the SEB Client to ensure
a more automated and secure setup for high-stake exams. a more automated and secure setup for high-stake exams.
.. image:: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-1.5/docs/images/setup_1.png .. image:: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/seb-sebserver-lms.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-1.5/docs/images/setup_1.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/seb-sebserver-lms.png
SEB Server Version 2.0 is out SEB Server Version 1.1.0 is out
------------------------------- -------------------------------
With the new SEB Server release, SEB Server makes a major version change from 1.x to 2.x. This is mainly because of the new New features:
Screen Proctoring feature for SEB integrated into SEB Server and the removal of live proctoring with Zoom and Jitsi Meet
that is no longer available for SEB Server version 2.x.
For a migration from a running SEB Server setup with version 1.x to new major version 2.0, please also read the `migration guide <https://seb-server-setup.readthedocs.io/en/latest/major-migration.html>`_. - Moodle integration part 1 (Course Access)
- Live proctoring with Jitsi Meet integration (Prototype)
New Features: - Deletion of user accounts
- Screen Proctoring with SEB and SEB Server. Can be enabled and configured for an Exam. SEB takes and sends screen shots plus Metadata to SEB Server. With monitoring and search functionality. - Deletion of exams
- Moodle Integration: SEB Server Exam creation from Moodle site with new SEB Server Moodle Plugin 2.0. - User registration rate limit
- Moodle Integration: Auto Login to SEB Server monitoring for Moodle Teacher with dedicated privileges. Comes with Moodle Plugin 2.0 - Inform user about unpublished chances in exam configuration settings
- Exam Test Run. There is now the possibility to apply an test run for an Exam that is in coming up status. Exam is then in "Running" like state and SEB clients can connect as well as supporter can monitor the exam. - Added "Ignore SEB Service" attributes in exam configuration settings
- Additional monitoring indicator (WIFI and battery status)
Improvements: - Notification events (experimental)
- Improvement of user ID resolution and handshake completion for SEB connecting with SEB-Server. SEB client now sent as much client information as possible and finish up the SEB Server handshake more quickly. - Download/Export Connection Configuration from Exam page to start an exam directly "Export Exam Connection Configuration"
- Connection Configuration Improve (or remove) Date Filter.
- DB Migration Table charset fix for all tables, set to "utf8mb4_general"
- New SEB Settings in SEB Server GUI for version 2.0
- Table sort direction selection and table column length selection stick to User Session
Bugfixes: Bugfixes:
- Missing Pending Notification Page Update in Monitoring Detail view
- Importing an exam without template throws error - Monitoring table update, incorrect table rendering after status changed
- LMS name resolving sometimes gets "null" values for names - Remove caching for distributed setup
- New Ready State is not involved within the Filter numbers - Add lookup and automated master service allocation for distributed setup
- Page of ASK Grants in Exam has table selection action problems
- Sorting of start and end-date in Assessment Tool Lookup not working as expected Changes:
- Running Exam without LMS is greyed out without reason
- "Client Configuration" is now named "Connection Configuration"
- "Export Exam Configuration" is now named "Export SEB Settings" and can be found in the "SEB Settings" view of an "Exam Configuration"
SEB Server Version 1.2.0 is out
-------------------------------
New features:
- Integrated X.509 certificate store to upload and use X.509 certificate for new and upcoming features
- Connection configuration encryption with X.509 certificate
- Additional exam configuration attributes of later added features of the SEB config-tool
- Default sorting and filtering for all lists
- Deleting of SEB client logs on the SEB Client Logs view
- Zoom meeting service integration for live proctoring (this is still an experimental feature)
- Ability to switch live proctoring features like town-hall, one-to-one room or broadcasting, on and off
Bugfixes:
- Exam configuration import gives more and clear information about the purpose of different imports
- Color picker is now initialized with selected color
- Fixed user-account deactivation on user-account list
- Fixed indicator list on exam shows only up to five entries
- Fixed none scrolling action pane
- Fixed exam import of Moodle LMS integration with different quizzes on same course
- Various bug-fixes and improvements for distributed setup of SEB Server (separated and scaled webservice and guiservice)
Changes:
- Updated MariaDB version for integrated setups from version 10.3 to 10.5
- Updated Spring Boot version from 2.1.0.RELEASE to 2.3.7.RELEASE
- Build pipeline automatically build the SEB Server docker image and put it to docker hub now
- New SEB Server docker setup (dockerhost) that pulls the needed images from docker-hub
SEB - SEB Server Compatibility SEB - SEB Server Compatibility
------------------------------ ------------------------------
The table below shows available and upcoming SEB client versions that has SEB Server integration support and are compatible with particular The table below shows available and upcoming SEB client versions that has SEB Server integration support and are compatible with particular
SEB Server versions. There is an entry for each platform with a beta or testing release date and an official release date. SEB Server version. There is an entry for each platform with a beta or testing release date and a official release date.
**SEB Server Version 2.0.x** **SEB Server Version 1.0.X**
.. csv-table:: .. csv-table::
:header: "Platform / OS", "Release Version" :header: "Platform / OS", "Beta/RC Version", "Release Version"
"SEB Client for iOS", "3.4 (3.3.3 without screen proctoring)" "SEB Client for iOS", "22. April 2020 - Version 2.1.50", "Q2 2021 - Version 2.5/3.0"
"SEB Client for Mac", "3.4" "SEB Client for Mac", "Q2 2021 - Version 3.1", "Q2 2021 - Version 3.1"
"SEB Client for Windows", "3.8" "SEB Client for Windows", "Q2 2020 - Version 3.1", "Q4 2020 - Version 3.1"
**SEB Server Version 1.1.X**
.. csv-table::
:header: "Platform / OS", "Beta/RC Version", "Release Version"
"SEB Client for iOS", "22. April 2020 - Version 2.1.50", "Q2 2021 - Version 2.5/3.0"
"SEB Client for Mac", "Q2 2021 - Version 3.1", "Q2 2021 - Version 3.1"
"SEB Client for Windows", "April 2021 - Version 3.2", "May 2021 - Version 3.2"
Install SEB Server Install SEB Server
------------------ ------------------
@ -103,62 +150,8 @@ Getting started with SEB Server
For a complete SEB Server user guide please go to `SEB Server User Guide <https://seb-server.readthedocs.io/en/latest/#>`_ For a complete SEB Server user guide please go to `SEB Server User Guide <https://seb-server.readthedocs.io/en/latest/#>`_
Project Background Project Background
------------------ ------------------
The SEB Server is currently build and maintained by `ETH Zürich <https://ethz.ch/en.html>`_ and by the `Swiss MOOC Service <https://www.swissmooc.ch/>`_ that is founded by leading Swiss universities EPFL, ETH, SUPSI, USI and HES-SO. The Swiss MOOC Service was financially supported from 2018-2020 by the `Swissuniversities´ P5 program <https://www.swissuniversities.ch/themen/digitalisierung/p-5-wissenschaftliche-information>`_. The SEB Server is currently build and maintained by the `Swiss MOOC Service <https://www.swissmooc.ch/>`_ that is founded by leading Swiss universities EPFL, ETH, SUPSI, USI and HES-SO. The Swiss MOOC Service was financially supported from 2018-2020 by the `Swissuniversities´ P5 program <https://www.swissuniversities.ch/themen/digitalisierung/p-5-wissenschaftliche-information>`_.
Contributing to SEB Server
---------------------------
We want to make contributing to this project as easy and transparent as possible, whether it's:
- Give us a star
- Reporting a bug
- Submitting a fix
- Proposing new features
- Becoming a SEB Alliance member
We use github to host code, to track issues and feature requests, as well as accept pull requests.
And we use `Github issues <https://github.com/SafeExamBrowser/seb-server/issues>`_ to track public bugs.
Report a bug by [opening a new issue]();
**Before enter a new bug-report, ensure the bug was not already reported**
Please fill and provide all the information suggested by the bug-report template
Great Bug Reports tend to have:
- A quick summary and/or background
- Steps to reproduce
- Be specific and give sample code if you can. Can also be Pseudocode.
- What you expected would happen
- What actually happens
- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
**We Use Git-Flow for Code Contributions**
Pull requests are the best way to propose changes to the codebase. We use `Github Flow <https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow>`_. We actively welcome your pull requests:
1. Fork the repo and create your branch from `development`. The development branch always has the newest changes.
2. If you've added code that should be tested, add tests.
3. If you introduce new API also add clear documentation.
4. Ensure the test suite passes.
5. Make sure your code lints.
6. Issue that pull request!
**Use a Consistent Coding Style**
Have a close look to the existing code stile that is used within SEB Server and adapt to it as close as possible.
We reserve the right to adapt contributed code to the code style matching SEB Server code style before or after a pull request.
**Any contributions you make will be under the Mozilla Public License Version 2.0**
In short, when you submit code changes, your submissions are understood to be under the same `Mozilla Public License <https://github.com/SafeExamBrowser/seb-server?tab=MPL-2.0-1-ov-file>`_ that covers the project. Feel free to contact the maintainers if that's a concern.
**Becoming a SEB Alliance member**
The `SEB Alliance <https://www.safeexambrowser.org/alliance/members.html>`_ is the body which sustains ongoing funding of the Safe Exam Browser open source project to continue its maintenance, development and support activities. ETH Zurich provides the infrastructure for the management and the software engineering of the SEB project and appoints an alliance manager who will provide administrative support to the SEB Alliance, and ensure the day-to-day running of the SEB Alliance. ETH Zurich leads the Alliance and offers different contribution levels to parties interested in the evolution of the SEB open source project.
More information about `joining <https://www.safeexambrowser.org/alliance/join.html>`_ the Alliance is available in our `benefits <https://www.safeexambrowser.org/alliance/benefits.html>`_ and `documents <https://www.safeexambrowser.org/alliance/documents.html>`_ section.

15
codecov.yml Normal file
View file

@ -0,0 +1,15 @@
coverage:
precision: 2
round: down
range: "40...100"
status:
project:
default:
threshold: 5%
patch: off
github_checks:
annotations: false
fixes:
-"::seb-server/"

View file

@ -1,4 +1,4 @@
FROM eclipse-temurin:17-jre FROM openjdk:11-jre-stretch
ENV SERVER_PORT="8080" ENV SERVER_PORT="8080"
ENV JMX_PORT= ENV JMX_PORT=
@ -38,4 +38,4 @@ CMD if [ "x${JMX_PORT}" = "x" ] ; \
--spring.config.location=file:/sebserver/config/spring/,classpath:/config/; \ --spring.config.location=file:/sebserver/config/spring/,classpath:/config/; \
fi fi
EXPOSE $SERVER_PORT $JMX_PORT EXPOSE $SERVER_PORT $JMX_PORT

View file

@ -1,4 +0,0 @@
About SEB Server
=====================
.. include:: ../README.rst

View file

@ -1,66 +1,66 @@
.. _certificates-label: .. _certificates-label:
Certificates Certificates
==================== ====================
Overview Overview
-------- --------
Import and store X.509 certificates within SEB Server is a new feature since SEB Server version 1.2. This allows an institutional administrator Import and store X.509 certificates within SEB Server is a new feature since SEB Server version 1.2. This allows an institutional administrator
or an exam administrator to upload and store certificates for further use within SEB Server. or an exam administrator to upload and store certificates for further use within SEB Server.
.. note:: .. note::
Certificates uploaded to SEB Server are stored in a secured certificate-store that is stored within the data base rather than a Certificates uploaded to SEB Server are stored in a secured certificate-store that is stored within the data base rather then a
usual file. The certificated store is password secured and only the binary data of the certificate store is placed into the usual file. The certificated store is password secured and only the binary data of the certificate store is places into the
database for security reasons. databease for securty reasons.
Once a certificate has been uploaded to SEB Server it can be used for various other features of SEB Server where a certificate is needed. Once a certificate has been uploaded to SEB Server it can be used for various other features of SEB Server where a certificate is needed.
One feature that also comes with the SEB Server version 1.2 is the ability to encrypt a connection configuration with a certificate One feature that also comes with the SEB Server version 1.2 is the ability to encrypt a connection configuration with a certificate
that has the right purpose (Identity) to do so. If you need this feature already, please have a look at: :ref:`connection-configuration-label`. that has the right purpose (Identity) to do so. If you need this feature already, please have a look at: :ref:`connection-configuration-label`
Other planed features are the import of certificate encrypted exam configurations as well as to embed certificates within an exam configuration Other planed features are the import of certificate encrypted exam configurations as well as to embed certificates within a exam configuration
to allow certificate pinning between SEB and LMS/Assessment Tool. to allow certificate pinning between SEB and LMS.
There is currently certificate upload support for two version of certificates: There is currently certificate upload support for two version of certificates:
**PEM** **PEM**
This are usually non password protected certificates in different file-formats. SEB Server currently supports the following PEM file-formats: This are usually non password protected certificates in different file-formats. SEB Server currently supports the following PEM file-formats:
- .pem - .pem
- .crt - .crt
- .cer - .cer
**PKCS12** **PKCS12**
This are usually password protected certificates in different file-formats. SEB Server currently supports the following PKCS12 file-formats: This are usually password protected certificates in different file-formats. SEB Server currently supports the following PKCS12 file-formats:
- .p12 - .p12
- .pfx - .pfx
.. image:: images/certificates/cert_list.png .. image:: images/certificates/cert_list.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/certificates/cert_list.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/certificates/cert_list.png
Use Cases Use Cases
--------- ---------
**Upload a certificate** **Upload a certificate**
- To upload and store a certificate of supported file type, please open the "SEB Configuration" section and select the "Certificates" page - To upload and store a certificate of supported file type, please open the "SEB Configuration" section and select the "Certificates" page
- You will see the list of known certificates from the SEB Server like in the picture above. - You will see the list of known certificates from the SEB Server like in the picture above.
- Choose "Import Certificate" from the right action pane and the upload dialog will open. - Choose "Import Certificate" from the right action pane and the upload dialog will open.
- Within the upload dialog, select the certificate file on your local machine that you want to upload. - Within the upload dialog, select the certificate file on your local machine that you want to upload.
- If the certificate is password protected, you will need to give the password to upload the certificate. - If the certificate is password protected, you will need to give the password to upload the certificate.
- Click on "OK" to start the import. - Chlick on "OK" to start the import.
- If the import is successful, the imported certificate will show up in the list. Otherwise, SEB Server will display an error message with the reason of failure. - If the import is successful the imported certificate will show up in the list. Otherwise SEB Server will display an error message with the reason of failure.
**Remove / delete a certificate** **Remove / delete a certificate**
- To permanently delete a stored certificate on SEB Server, please open the "SEB Configuration" section and select the "Certificates" page - To permanently delete a stored certificate on SEB Server, please open the "SEB Configuration" section and select the "Certificates" page
- You will see the list of known certificates from the SEB Server like in the picture above. - You will see the list of known certificates from the SEB Server like in the picture above.
- Please select the certificate you want to remove. - Please select the certificate you want to remove.
- Choose "Remove Selected Certificates" from the right action pane and a configuration dialog will appear. - Choose "Remove Selected Certificates" from the right action pane and a configuration dialog will appear.
- If you are sure to delete the selected certificate(s), click on "OK" to delete. - If you are sure to delete the selected certificate(s), click on "OK" to delete.
- The deleted certificates disappear form the certificates list. - The deleted certificates disappear form the certificates list.

View file

@ -43,7 +43,7 @@ extensions = [
'sphinx.ext.todo', 'sphinx.ext.todo',
'sphinx.ext.imgmath', 'sphinx.ext.imgmath',
'sphinx.ext.viewcode', 'sphinx.ext.viewcode',
'sphinx.ext.githubpages' 'sphinx.ext.githubpages',
] ]
# Add any paths that contain templates here, relative to this directory. # Add any paths that contain templates here, relative to this directory.

View file

@ -1,73 +1,73 @@
.. _config-template-label: .. _config-template-label:
Exam Configuration Templates Exam Configuration Templates
============================ ============================
With this feature you can create and manage templates for SEB exam configuration settings. You are able to mainly define default values for each SEB exam With this feature you can create and manage templates for SEB exam configuration settings. You are able to mainly define default values for each SEB exam
settings attribute for an exam config and you are also able to define whether the settings attribute shall be viewed on an exam configuration created from settings attribute for an exam config and you are also able to define whether the settings attribute shall be viewed on an exam configuration created from
the template or if it shall be hidden. the template or if it shall be hidden.
.. note:: .. note::
The exam configuration template feature is the most experimental feature in SEB Server for now and might change for the upcoming releases. The exam configuration template feature is the most experimental feature in SEB Server for now and my change for the upcoming releases.
To view all available exam configuration templates, go to the "SEB Configuration" section and click on the "Configuration Template" menu entry of the To view all available exam configuration templates go to the "SEB Configuration" section and click on the "Configuration Template" menu entry of the
left menu pane. SEB Server will then present you a list of all available exam configuration templates. You can filter and sort the list as usual to find left menu pane. SEB Server will then present you a list of all available exam configuration templates. You can filter and sort the list as usual to find
a specific template by name for example. a specific template by name for example.
.. image:: images/config_templates/list.png .. image:: images/config_templates/list.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/config_templates/list.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/config_templates/list.png
To create a new exam configuration template, use the "Add Configuration Template" action from the right action pane. You will see the creation form To create a new exam configuration template use the "Add Configuration Template" action from the right action pane. You will see the creation form
with a name and description for the new template. At least a unique name is mandatory, and the description is optional. with a name and description for the new template. At least a unique name is mandatory and the description is optional.
.. image:: images/config_templates/templateEdit.png .. image:: images/config_templates/templateEdit.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/config_templates/templateEdit.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/config_templates/templateEdit.png
To create and save the new exam configuration template use the "Save Configuration Template" action from the right action pane. The template will be To create and save the new exam configuration template use the "Save Configuration Template" action from the right action pane. The template will be
created with all default settings attribute and views, and you will see the configuration template view page. In the view page you will see the information created with all default settings attribute and views and you will see the configuration template view page. In the view page you will see the information
of the template within the page header following by a list of all exam configuration setting attributes available for a SEB exam configuration on the of the template within the page header following by a list of all exam configuration setting attributes available for a SEB exam configuration on the
SEB Server. The name of an attribute is composed of the internal attribute name followed by the display name of the attribute. SEB Server. The name of an attribute is composed of the internal attribute name followed by the display name of the attribute.
.. image:: images/config_templates/templateView.png .. image:: images/config_templates/templateView.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/config_templates/templateView.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/config_templates/templateView.png
The type of the attribute defines the input field type and cannot be changed in any way. The view defines the tab on which the settings attribute is placed. The type of the attribute defines the input field type and cannot be changed in any way. The view defines the tab on which the settings attribute is placed.
And the group defines the named group where a settings attribute belongs to. And the group defines the named group where a settings attribute belongs to.
.. note:: .. note::
For now, the "View" and "Group" properties of an settings attribute cannot be changed, just be set whether the settings attribute shall be shown For now the "View" and "Group" properties of an settings attribute cannot be changed, just be set whether the settings attribute shall be shown
on its defined view (tab) and within its defined position on the tab or if it shall be hidden at all. on its defined view (tab) and within its defined position on the tab or if it shall be hidden at all.
In a future version of SEB Server it might be possible to also place a settings attribute to another "View" and/or "Group" and also to a certain position In a future version of SEB Server it may possible to also place a settings attribute to another "View" and/or "Group" and also to a certain position
of the view grid. of the view grid.
To attach or detach a particular settings attribute for the template from the view to show or hide it in the configuration settings, select the specific To attach or detach a particular settings attribute for the template from the view to show or hide it in the configuration settings, select the specific
settings attribute from the list and use either the "Remove From View" action when you want to remove an attached one, settings attribute from the list and use either the "Remove From View" action when you want to remove an attached one,
or the "Attach To View" action when you want to attach a hidden settings attribute to the default view. or the "Attach To View" action when you want to attach a hidden settings attribute to the default view.
To define a default value for a specific attribute, select the attribute from the list and use the "Edit Attribute" action from the right action pane to open To define a default value for a specific attribute, select the attribute from the list and use the "Edit Attribute" action from the right action pane to open
the settings attribute in edit mode. Or just double click on the specific list entry of the settings attribute. the settings attribute in edit mode. Or just double click on the specific list entry of the settings attribute.
In the settings attribute edit page you see general information about the attribute on the upper part of the page and on the second part you see the In the settings attribute edit page you see general information about the attribute on the upper part of the page and on the second part you see the
input field if the settings attribute with the current default value set. To alter the default value just use the input field of the attribute to change input field if the settings attribute with the current default value set. To alter the default value just use the input field of the attribute to change
the value and the change will automatically be set as new default value. If you want to reset the default value of the settings attribute to the original the value and the change will automatically be set as new default value. If you want to reset the default value of the settings attribute to the original
default value, use the "Set Default Values" action from the right action pane to do so. You are also able to attach or detach the settings attribute from default value, use the "Set Default Values" action from the right action pane to do so. You are also able to attach or detach the settings attribute from
the view here by using the "Remove From View" or "Attach To View" actions from the right action pane. To go back to the exam configuration template view, the view here by using the "Remove From View" or "Attach To View" actions from the right action pane. To go back to the exam configuration template view
use the "View Configuration Template" action from the right action pane. use the "View Configuration Template" action from the right action pane.
.. image:: images/config_templates/templateAttribute.png .. image:: images/config_templates/templateAttribute.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/config_templates/templateAttribute.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/config_templates/templateAttribute.png
Back in the exam configuration template view you are able to create a new SEB exam configuration directly from this template by using the "Create Exam Configuration" Back in the exam configuration template view you are able to create a new SEB exam configuration directly from this template by using the "Create Exam Configuration"
action from the right action pane. The application will present you a creation dialog within a pop-up where you can define a name and description for the action from the right action pane. The application will present you a creation dialog within a pop-up where you can define a name and description for the
new SEB exam configuration. At least a unique name is mandatory. new SEB exam configuration. At least a unique name is mandatory.
.. image:: images/config_templates/createConfig.png .. image:: images/config_templates/createConfig.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/config_templates/createConfig.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/config_templates/createConfig.png
After defining a name and description for the new SEB exam configuration you can click on "OK" to do so, and the application will show you the new created After defines a name and description for the new SEB exam configuration you can click on "OK" to do so an the application will show you the new created
SEB exam configuration in the usual place. SEB exam configuration in the usual place.

View file

@ -2,26 +2,26 @@ SEB Configurations
================== ==================
There are two different kind of SEB specific configurations that must be defined and be put in place to support e-assessments with There are two different kind of SEB specific configurations that must be defined and be put in place to support e-assessments with
SEB and SEB Server. The :ref:`connection-configuration-label` is used to configure SEB with all needed information to securely connect to SEB Server SEB and SEB Server. The is used to configure SEB with all needed information to securely connect to SEB Server
and an Exam Configuration is used to configure SEB to access a running exam with SEB. The :ref:`connection-configuration-label` is only needed at least and an Exam Configuration is used to configure SEB to access a running exam with SEB. The is only needed at least
once for an institution and must be deployed as start-configuration on a managed SEB setup or can be placed as a download link within once for an institution and must be deployed as start-configuration on a managed SEB setup or can be placed as a download link within
an internal trusted server, that automatically loads within the SEB application and configures the SEB to connect to the SEB Server. an internal trusted server, that automatically loads within the SEB application and configures the SEB to connect to the SEB Server.
An exam configuration, as the name implies, is done for an exam and contains most of the known configuration attributes An exam configuration, as the name implies, is done for an exam and contains most of the known configuration attributes
from the latest `SEB Configuration Tool <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_. from the latest `SEB Configuration Tool <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_
Currently an exam configuration can only be applied to one Exam but can easily be copied to use with another exam. For detailed Currently an exam configuration can only be applied to one Exam but can easily be copied to use with another exam. For detailed
information about exam configuration see :ref:`exam-configuration-label`. information about exam configuration see :ref:`exam-configuration-label`
Within Configuration Templates, it is possible to create templates for exam configuration. Within the current version of SEB Server Within Configuration Templates, it is possible to create templates for exam configuration. Within the current version of SEB Server
there is the possibility to define different default value(s) for each exam configuration attribute and also to define if the attribute there is the possibility to define different default value(s) for each exam configuration attribute and also to define if the attribute
is been shown in the exam configuration or not. This allows an Exam Administrator to create an exam configuration template for exams is been shown in the exam configuration or not. This allows an Exam Administrator to create a exam configuration template for exams
with context defines default values and also to be able to only see change the attributes that are relevant for an exam configuration. with context defines default values and also to be able to only see change the attributes that are relevant for an exam configuration.
This feature is currently in an experimental state and may be changed and / or expanded within future releases of SEB Server. See This feature is currently in an experimental state and may be changed and / or expanded within future releases of SEB Server. See
:ref:`config-template-label`. :ref:`config-template-label`
An new feature since SEB Server version 1.2 is the integrated certificate store where an administrator is able to upload and register An new feature since SEB Server version 1.2 is the integrated certificate store where an administator is able to upload and register
certificates. The certificates can then be used to encrypt and secure a connection configuration for example. Or as planned for another certificates. The certificates can then be used to encrypt and secure a connection configuration for example. Or as planed for another
SEB Server release, to embed into an exam configuration for SEB to allow certificate pinning on SEB - LMS/Assessment Tool communication. SEB Server release, to embed into an exam configuration for SEB to allow certificate pinning on SEB - LMS communication.
.. toctree:: .. toctree::
@ -30,4 +30,4 @@ SEB Server release, to embed into an exam configuration for SEB to allow certifi
connection_config connection_config
exam_config exam_config
config_template config_template
certificates certificates

View file

@ -1,181 +1,156 @@
.. _connection-configuration-label: .. _connection-configuration-label:
Connection Configuration Connection Configuration
==================== ====================
Overview Overview
-------- --------
A connection configuration is needed to configure a SEB client to securely connect to the SEB Server and present a list of available exams A connection configuration is needed to configure a SEB client to securely connect to the SEB Server and present a list of available exams
for selection. At least one connection configuration is needed for an institution that can be exported and deployed with a SEB on a managed device setup for selection. At least one connection configuration is needed for an institution that can be exported and deployed with a SEB on a managed device setup
or can be made available within a download link on an internal or trusted server. Another scenario would be to send the connection configuration to or can be made available within a download link on a internal or trusted server. Another scenario would be to send the connection configuration to
individual students per mail with instructions on how to install SEB and start it with the configuration to automatically connect to the SEB Server. individual students per mail with instructions on how to install SEB and start it with the configuration to automatically connect to the SEB Server.
However, since the connection configuration is security relevant because it contains sensitive data to connect to SEB Server, However, since the connection configuration is security relevant because it contains sensitive data to connect to SEB Server,
there are different security level one can choose to apply within an internal safe e-assessment strategy. there are different security level one can choose to apply within a internal safe e-assessment strategy.
The lowest level of security is to just have one not encrypted connection configuration for the whole institution and for all e-assessments provided The lowest level of security is to just have one not encrypted connection configuration for the whole institution and for all e-assessments provided
at this institution with SEB Server. at this institution with SEB Server.
In this case the sensitive data is more exposed to be compromised and misused by others because of the missing password protection and it also takes In this case the sensitive data is more exposed to be compromised and misused by others because of the missing password protection and it also takes
more effort to deal with such an issue while there is only one connection configuration used by all e-assessments of the institution. If the one client more effort to deal with such an issue while there is only one connection configuration used by all e-assessments of the institution. If the one client
configuration has been compromised and a misuse has been detected, the concerned connection configuration can be deactivated to prevent further misuse. A configuration has been compromised and a misuse has been detected the concerned connection configuration can be deactivated to prevent further misuse. A
new one can be created and delivered or updated, but since only one configuration is used for the whole institution all actual download links have to new one can be created and delivered or updated but since it is only one configuration used for the institution all actual download links have to
be updated and all students awaiting a prepared exam have to be informed and supported with the new :ref:`exam-configuration-label`. be updated and all students awaiting a prepared exam has to be informed and supported with the new configuration (link)
The currently highest level of security is to have encrypted and different connection configurations for different e-assessment. The currently highest level of security is to have encrypted and different connection configuration for different e-assessment.
In this case the connection configuration is encrypted with a password that can be defined by an institutional- or exam-administrator while In this case the connection configuration is encrypted with a password that can be defined by a institutional- or exam-administrator while
creating the connection configuration. Once the SEB loads such a connection configuration it will first prompt the user about the password that must be creating the connection configuration. Once the SEB loads such a connection configuration it will fist prompt the user about the password that must be
given by the student to proceed and connect to the SEB Server. given by the student to proceed and connect to the SEB Server.
Usually, a connection configuration can be created or maintained by an institutional administrator or by an exam administrator. Exam supporter role holders have Usually a connection configuration can be created or maintained by an institutional administrator or by an exam administrator. Exam supporter role has
no access to connection configurations and a SEB administrator is able to see connection configurations of other institutions but not to create or modify them. no access to connection configurations and a SEB administrator is able to see connection configurations of other institutions but not to create or modify them.
You can see a list of all available connection configuration for an institution by going to the sub-section "Connection Configuration" You can see a list of all available connection configuration for an institution by going to the sub-section "Connection Configuration"
of the "Configuration" section on the menu on the left hand side. of the "Configuration" section on the menu on the left hand side.
.. image:: images/connection_config/list.png .. image:: images/connection_config/list.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/connection_config/list.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/connection_config/list.png
The list shows the name, the date of creation and the status of the connection configurations in a column. With SEB Server administrator role The list shows the name, the date of creation and the status of the connection configurations in a column. With SEB Server administrator role
also an institution column is shown because a SEB Server administrator is able to see all connection configurations of all institutions. also an institution column is shown because a SEB Server administrator is able to see all connection configurations of all institutions.
As usual, to filter the list use the filter inputs above and click on the lens symbol on the right to apply the filter and to clear the As usual, to filter the list use the filter inputs above and click on the lens symbol on the right to apply the filter and to clear the
filter use the clear symbol right to the lens symbol. See :ref:`gui-label` for more information about the list navigation. filter use the clear symbol right to the lens symbol. See :ref:`gui-label` for more information about the list navigation.
The image below shows the Connection Configuration form in the edit mode. To view the fallback related attributes, check the "With Fallback" attribute The image below shows the Connection Connection form in the edit mode. To view the fallback related attributes, check the "With Fallback" attribute
or remove selection to hide all fallback related attributes. or remove selection to hide all fallback related attributes.
.. image:: images/connection_config/new.png .. image:: images/connection_config/new.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/connection_config/new.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/connection_config/new.png
Short description of all attributes of a connection configuration: Short description of all attributes of a connection configuration:
- **Name**: The name of the connection configuration used to maintain connection configurations within the SEB Server application. - **Name**: The name of the connection configuration used to maintain connection configurations within the SEB Server application.
- **Configuration Purpose**: Defines the configuration purpose as described in `SEB Configuration <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_ section "Use SEB settings file for". - **Configuration Purpose**: Defines the configuration purpose as described in `SEB Configuration <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_ section "Use SEB settings file for".
**Starting an Exam**; Will cause SEB to use this connection configuration settings on startup but won't change local SEB settings. **Starting an Exam**; Will cause SEB to use this connection configuration settings on startup but won't change local SEB settings.
**Configuring a connection**; Will cause SEB to use this connection configuration settings and also save it as local SEB settings. **Configuring a connection**; Will cause SEB to use this connection configuration settings and also save it as local SEB settings.
- **Configuration Password**: Used to encrypt the connection configuration with a password. A SEB client will prompt this password while loading a password protected connection configuration. - **Configuration Password**: Used to encrypt the connection configuration with a password. A SEB client will prompt this password while loading a password protected connection configuration.
- **Encrypt with Certificate**: Since version 1.2. Used to encrypt the connection configuration with a certificate. The same certificate must be known by a SEB client to be able to load the configuration. - **Encrypt with Certificate**: Since version 1.2. Used to encrypt the connection configuration with a certificate. The same certificate must be known by a SEB client to be able to load the configuration.
- **With Fallback**: Select this to see and define a fallback strategy for SEB clients using this connection configuration in case of SEB Server service unavailability. - **With Fallback**: Select this to see and define a fallback strategy for SEB clients using this connection configuration in case of SEB Server service unavailability.
- **Fallback URL**: Defines a start URL that is loaded by the SEB client in a fallback case. - **Fallback URL**: Defines a start URL that is loaded by the SEB client in a fallback case.
- **Connection Attempts**: Defines the number of attempts a SEB client will try to unsuccessfully connect to the SEB Server service until it switches to the fallback case. - **Connection Attempts**: Defines the number of attempts a SEB client will try to unsuccessfully connect to the SEB Server service until it switches to the fallback case.
- **Interval**: Time interval (in milliseconds) a SEB client will wait after a unsuccessful connection attempt before starting a next connection attempt. - **Interval**: Time interval (in milliseconds) a SEB client will wait after a unsuccessful connection attempt before starting a next connection attempt.
- **Connection Timeout**: A overall timeout for SEB Server service connection. After this timeout runs out, starting from first connection attempt, SEB client will switch to the fallback case no matter if the number of attempts has exceeded or not. - **Connection Timeout**: A overall timeout for SEB Server service connection. After this timeout runs out, starting from fist connection attempt, SEB client will switches to the fallback case no matter if number of attempts has exceeded or not.
- **Fallback Password**: If set, a SEB client will prompt for this password before switching into the fallback case. - **Fallback Password**: If set, a SEB client will prompt for this password before switching into the fallback case.
- **Quit Password**: If set, a SEB client will prompt for this password when a user wants to exit SEB before in fallback case or before the SEB client has loaded an exam. - **Quit Password**: If set, a SEB client will prompt for this password when a user wants to exit SEB before in fallback case or before the SEB client has loaded an exam.
A connection configuration may also contain and define a fallback strategy that takes place when SEB Server service is not available while A connection configuration may also contain and define a fallback strategy that takes place when SEB Server service is not available while
a SEB client tries to connect to the SEB Server. a SEB client tries to connect to the SEB Server.
.. note:: .. note::
A fallback case only takes place when SEB client is within the connection process (handshake) with the SEB Server and the SEB Server service is unavailable.
A fallback case only takes place when SEB client is within the connection process (handshake) with the SEB Server and the SEB Server service is unavailable. If a SEB client is already connected to the SEB Server and the user has started an exam, the SEB will just proceed with the exam even
If a SEB client is already connected to the SEB Server and the user has started an exam, the SEB will just proceed with the exam even when the SEB Server connection is (temporarily) unavailable.
when the SEB Server connection is (temporarily) unavailable.
The fallback strategy contains some connection attributes that define until when a SEB client considering SEB Server service as unavailable as
The fallback strategy contains some connection attributes that define until when a SEB client considering SEB Server service as unavailable as well as attributes that defines how a SEB client has to proceed in the fallback case. How a SEB client reacts to a fallback case differs on the
well as attributes that defines how a SEB client has to proceed in the fallback case. How a SEB client reacts to a fallback case differs on the configuration settings in the following ways:
configuration settings in the following ways:
- Connection configuration with "Configuring a Client" setting and no fallback strategy:
- Connection configuration with "Configuring a Client" setting and no fallback strategy: Show warning message with options "retry" and "quit".
Show warning message with options "retry" and "quit".
- Connection configuration with "Configuring a Client" setting and fallback strategy:
- Connection configuration with "Configuring a Client" setting and fallback strategy: Show warning with options "retry", "fallback" (load Fallback URL) and "quit".
Show warning with options "retry", "fallback" (load Fallback URL) and "quit".
- Connection configuration with "Starting an Exam" setting and no fallback (without local client configuration):
- Connection configuration with "Starting an Exam" setting and no fallback (without local client configuration): Show warning message with options "retry" and "quit".
Show warning message with options "retry" and "quit".
- Connection configuration with "Starting an Exam" setting and no fallback (with local client configuration):
- Connection configuration with "Starting an Exam" setting and no fallback (with local client configuration): Show warning message with options "retry", "load local settings" and "quit".
Show warning message with options "retry", "load local settings" and "quit".
- Connection configuration with "Starting an Exam" setting and fallback strategy:
- Connection configuration with "Starting an Exam" setting and fallback strategy: Show warning with options "retry", "fallback" (load Fallback URL) and "quit".
Show warning with options "retry", "fallback" (load Fallback URL) and "quit".
**New: Exam Selection for dedicated Client Configurations** Use Cases
---------
This is a new feature since SEB Server Version 1.6. and allows to select existing exams within a Connection Configuration to reduce the possible
Exams that SEB presents to a student when a Connection Configuration is loaded by SEB that has no dedicated Exam preselection (downloaded from the Exam view) **Create Connection Configuration**
In this case SEB always presented all currently running Exams from the SEB Server to the student for selection. With this
feature it is now possible to reduce this choice for a specific Client Configuration by selecting the Exams that shall be shown to a student As an Institutional Administrator you should create a new secure connection configuration for the upcoming semester. The setup shall operate with
when SEB loads the respective Connection Configuration. secure configurations because the configuration file may be exposed to the public Internet. And the setup shall also have a proper fallback
strategy where SEB clients uses the a given start URL in fallback case.
.. note::
- Sign in as an Institutional Administrator and select the "Connection Configuration" sub-menu of the "SEB Configuration" main-menu on the left.
Since the Exam selection is stored with SEB Server and not exported to an Connection Configuration it is also possible - Use the "Add Connection Configuration" on the right action pane to create a new connection configuration.
to change the Exam selection for a certain Connection Configuration after the Connection Configuration was downloaded. - Give the new connection configuration a name that not already exists and select "Start an Exam" for "Configuration Purpose".
SEB will always present the running exams exclusively from actual Exam selection from Connection Configuration on the SEB Server. This will ensure that a SEB client that uses this configuration will not override the local configuration that then can be used on fallback.
- Give a password to ensure security and to encrypt the connection configuration on export. A SEB client will prompt for the password while loading this configuration.
If an Connection Configuration has no Exam selection all still running exams are presented to the student as it was before. - Check "With Fallback" to show all the fallback related attributes.
- Define a fallback URL that will be used by a SEB client as start URL in the fallback case.
To select dedicated Exams for a Connection Configuration you can go to the Connection Configuration edit view and select - Define also fallback case, how many connection attempts on what interval a SEB client shall try before going into fallback mode. You can also define a overall "Connection Timeout" if lapsed a SEB client will also go into the fallback mode. A SEB client will fall-back on either the attempt or the timeout trigger.
these exams with the multi selector. It is also possible to filter the list by typing in the letters containing in the Exam name of interest. - When a SEB client goes to fallback mode it will prompt the user as described in the case list above. To prevent further fallback options with a password prompt, give a "Fallback Password" and / or a "Quit Password" that a SEB client will prompt on either the fallback- or the quit-option.
- After all details are correctly been entered, use the "Save Connection Configuration" action on the right action pane to save the new connection configuration.
.. image:: images/connection_config/examSelection.png - Now the new connection configuration is created but not active for now and therefore cannot be exported yet.
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/connection_config/examSelection.png **Activate and export Connection Configuration**
A connection configuration for the upcoming semester has been created so far but was not active until now because of security reasons.
Now we want to activate this connection configuration and export it to make it accessible by a download link on a public server.
Use Cases
--------- - Sign in as an Institutional Administrator and select the "Connection Configuration" sub-menu of the "SEB Configuration" main-menu on the left.
- Use the list filter and / or the list navigation to find the needed connection configuration.
**Create Connection Configuration** - Double-click on the list entry or use the "View Connection Configuration" action on the right for a selected list row, to show the details of a specific Connection configuration.
- Then either on the list or in the view mode of the form, use the "Activate Connection Configuration" action on the right action pane to activate the connection configuration
As an Institutional Administrator you should create a new secure connection configuration for the upcoming semester. The setup shall operate with - Now there is a "Export Connection Configuration" action in the detail view of the connection configuration. Use the "Export Connection Configuration" action to start a download dialog. Choose "Save As" and download the file with the name "SEBServerSettings.seb".
secure configurations because the configuration file may be exposed to the public Internet. And the setup shall also have a proper fallback - This file can now be published as download-link within a public server where SEB user can click and start the download and startup of the SEB client automatically.
strategy where SEB clients use a given start URL in fallback case.
**Deactivate a Connection Configuration**
- Sign in as an Institutional Administrator and select the "Connection Configuration" sub-menu of the "SEB Configuration" main menu on the left.
- Use the "Add Connection Configuration" on the right action pane to create a new connection configuration. The semester has ended and for security reasons we don't want that SEB clients with a connection configuration for the ended semester
- Give the new connection configuration a name that not already exists and select "Start an Exam" for "Configuration Purpose". are able to connect to SEB Server anymore. For this we just have to deactivate the connection configuration for that semester. A SEB client
This will ensure that a SEB client that uses this configuration will not override the local configuration that then can be used on fallback. that connects with this connection configuration will then receive an HTTP 401 Unauthorized response.
- Give a password to ensure security and to encrypt the connection configuration on export. A SEB client will prompt for the password while loading this configuration.
- Check "With Fallback" to show all the fallback related attributes. - Sign in as an Institutional Administrator and select the "Connection Configuration" sub-menu of the "SEB Configuration" main-menu on the left.
- Define a fallback URL that will be used by a SEB client as start URL in the fallback case. - Use the list filter and / or the list navigation to find the needed connection configuration and select the row of this connection configuration.
- Define also fallback case, how many connection attempts on what interval a SEB client shall try before going into fallback mode. You can also define an overall "Connection Timeout" if lapsed a SEB client - Now use the "Deactivate Connection Configuration" action from the right action pane to deactivate the connection configuration.
will also go into the fallback mode. A SEB client will fall back on either the attempt or the timeout trigger. - The connection configuration is now deactivated and SEB client using this connection configuration are not able to connect to SEB Server anymore.
- When a SEB client goes to fallback mode it will prompt the user as described in the case list above. To prevent further fallback options with a password prompt, give a "Fallback Password" and / or a "Quit Password" that a SEB client will prompt on either the fallback- or the quit-option.
- After all details have correctly been entered, use the "Save Connection Configuration" action on the right action pane to save the new connection configuration. **Encrypt the Connection Configuration by password or certificate**
- Now the new connection configuration is created but not active for now and therefore cannot be exported yet.
To secure the used connection configuration you want to encrypt it with either password or certificate encryption. If you encrypt a connection
**Activate and export Connection Configuration** configuration by password, SEB will promt the user for the password while loading the configuration whereas by using certificate encryption,
a SEB client must know the same certificate that is been used for encryption while loading the configuration.
A connection configuration for the upcoming semester has been created so far but was not active until now because of security reasons.
Now we want to activate this connection configuration and export it to make it accessible by a download link on a public server. - Sign in as an institutional administrator and select the "Connection Configuration" sub-menu of the "SEB Configuration" main-menu on the left.
- Create an new connection configuration or use the list filter and / or the list navigation to find the needed connection configuration.
- Sign in as an Institutional Administrator and select the "Connection Configuration" sub-menu of the "SEB Configuration" main menu on the left. - Fill in the settings as usual and for password encryption define a password in the "Configuration Password" field and confirm the password in the "Confirm Password" field.
- Use the list filter and / or the list navigation to find the needed connection configuration. - For a certificate based encryption select one of the given certificates within the "Encrypt with Certificate" setting.
- Double-click on the list entry or use the "View Connection Configuration" action on the right for a selected list row, to show the details of a specific Connection configuration. - To upload new certificates that can be used for encryption, please refer to: :ref:`certificates-label`
- Then either on the list or in the view mode of the form, use the "Activate Connection Configuration" action on the right action pane to activate the connection configuration - "Use asymmetric only encryption" if you use SEB Clients with version before 2.2. For more details on this subject please see: `SEB Configuration <https://safeexambrowser.org/developer/seb-file-format.html>`_
- Now there is a "Export Connection Configuration" action in the detail view of the connection configuration. Use the "Export Connection Configuration" action to start a download dialog. Choose "Save As" and download the file with the name "SEBServerSettings.seb". - Save and activate the connection configuration. The connection configuration will then be encrypted by either password or certificate on export.
- This file can now be published as download link within a public server where SEB user can click and start the download and startup of the SEB client automatically.
.. image:: images/connection_config/encrypt.png
**Deactivate a Connection Configuration** :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/connection_config/encrypt.png
The semester has ended and for security reasons we don't want that SEB clients with a connection configuration for the ended semester
are able to connect to SEB Server anymore. For this we just have to deactivate the connection configuration for that semester. A SEB client
that connects with this connection configuration will then receive an HTTP 401 Unauthorized response.
- Sign in as an Institutional Administrator and select the "Connection Configuration" sub-menu of the "SEB Configuration" main menu on the left.
- Use the list filter and / or the list navigation to find the needed connection configuration and select the row of this connection configuration.
- Now use the "Deactivate Connection Configuration" action from the right action pane to deactivate the connection configuration.
- The connection configuration is now deactivated and SEB client using this connection configuration are not able to connect to SEB Server anymore.
**Encrypt the Connection Configuration by password or certificate**
To secure the used connection configuration you want to encrypt it with either password or certificate encryption. If you encrypt a connection
configuration by password, SEB will prompt the user for the password while loading the configuration whereas by using certificate encryption,
a SEB client must know the same certificate that is been used for encryption while loading the configuration.
- Sign in as an institutional administrator and select the "Connection Configuration" sub-menu of the "SEB Configuration" main menu on the left.
- Create a new connection configuration or use the list filter and / or the list navigation to find the needed connection configuration.
- Fill in the settings as usual and for password encryption define a password in the "Configuration Password" field and confirm the password in the "Confirm Password" field.
- For a certificate-based encryption select one of the given certificates within the "Encrypt with Certificate" setting.
- To upload new certificates that can be used for encryption, please refer to: :ref:`certificates-label`
- "Use asymmetric only encryption" if you use SEB Clients with version before 2.2. For more details on this subject please see: `SEB Configuration <https://safeexambrowser.org/developer/seb-file-format.html>`_
- Save and activate the connection configuration. The connection configuration will then be encrypted by either password or certificate on export.
.. image:: images/connection_config/encrypt.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/connection_config/encrypt.png

View file

@ -1,20 +1,20 @@
Prepare Exam Prepare Exam
============= =============
This chapter is about setting up and prepare a already imported exam on SEB Server. If you don't have imported a course or quiz from LMS/Assessment Tool This chapter is about setting up and prepare a already imported exam on SEB Server. If you don't have imported a course or quiz from LMS
as an exam into SEB Server, please see the previous chapter for detailed guidance about hot to import an exam. as an exam into SEB Server, please see the previous chapter for detailed guidance about hot to import an exam.
To find a specific exam that has already been imported, go to "Exam Administration" / "Exam" on the navigation menu on the left hand side to To find a specific exam that has already been imported, go to "Exam Administration" / "Exam" on the navigation menu on the left hand side to
see a list of all available exams. You are able to filter and sort the list as usual to find to right course for import. see a list of all available exams. You are able to filter and sort the list as usual to find to right course for import.
.. note:: .. note::
The Date-Filter above "Start-Time" is usually set to the date one year before now or to some other default date in the past The "Start-Time" filter is usually set to the date one year before now or to some other default date in the past. The list shows only
and is applied to the end-date of the exam or quiz. The list shows all running or up-coming exams and only hides finished or the courses that has a start-time after that time. If you have long running courses and it may possible that a course has been stated
archived exams that has an end-date before the Date-Filter date. a year or two ago, you habe to adapt this "Start-Time" filter to view those courses that has been started before.
Double click on the list entry of the exam or select the list entry and use the "View Exam" action of the action pane on the right hand side to Double click on the list entry of the exam or select the list entry and use the "View Exam" action of the action pain on the right hand side to
open the exam in the detail view. Within the detail view of the exam you are able to edit the exam attributes, apply SEB exam configuration and open the exam in the detail view. Within the detail view of the exam you are able to edit the exam attribute, apply SEB exam configuration and
indicators for monitoring as well as defining details of the SEB restriction if this feature is available from the LMS/Assessment Tool. indicators for monitoring as well as defining details of the SEB restriction if this feature is available from the LMS.
.. note:: .. note::
If an exam is already running but is missing some essential setup, this is noted by the system. In the exam detail view the system If an exam is already running but is missing some essential setup, this is noted by the system. In the exam detail view the system
@ -23,20 +23,20 @@ indicators for monitoring as well as defining details of the SEB restriction if
.. image:: images/exam/examNotReady.png .. image:: images/exam/examNotReady.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examNotReady.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/examNotReady.png
At the beginning of the page - if there is no note - you see all the details of the exam. At the beginning of the page - if there is no note - you see all the details of the exam.
- **Name**: Is the name of the course, defines on the LMS/Assessment Tool - **Name**: Is the name of the course, defines on the LMS
- **LMS/Assessment Tool Setup**: Is the name of the LMS/Assessment Tool Setup on the SEB Server from which the course was imported - **LMS Setup**: Is the name of the LMS Setup on the SEB Server from which the course was imported
- **Start-Time**: Is the date and time when the exam is starting. This is defined on the LMS/Assessment Tool - **Start-Time**: Is the date and time when the exam is starting. This is defined on the LMS
- **End-Time**: Is the date and time when the exam ends. This is defined on the LMS/Assessment Tool - **End-Time**: Is the date and time when the exam ends. This is defined on the LMS
- **LMS/Assessment Tool Exam Identifier**: Is the identity of the course on the LMS/Assessment Tool (external identifier/primary key) - **LMS Exam Identifier**: Is the identity of the course on the LMS (external identifier/primary key)
- **LMS/Assessment Tool Exam URL**: Is the start URL of the course/exam - **LMS Exam URL**: Is the start URL of the course/exam
To edit the SEB Server relevant attributes you can use To edit the SEB Server relevant attributes you can use
the "Edit Exam" action from the action pane on the right hand side to switch to the exam edit mode. In the exam edit mode you can modify the "Edit Exam" action from the action pain on the right hand side to switch to the exam edit mode. In the exam edit mode you can modify
the type of the exam "Exam Type". The exam type has currently only informational character and has no implication on SEB Server side but may be the type of the exam "Exam Type". The exam type has currently only informational character and has no implication on SEB Server side but may be
used in the future to apply to different exam scenarios for SEB Server and SEB. Here you can also manage the accounts that shall be able to used in the future to apply to different exam scenarios for SEB Server and SEB. Here you can also manage the accounts that shall be able to
support and monitor the exam. To do so, use the multi combo selection within the "Exam Supporter" attribute. Click in the support and monitor the exam. To do so, use the multi combo selection within the "Exam Supporter" attribute. Click in the
@ -52,11 +52,7 @@ Apply SEB Exam Configuration
Just below the exam details you will find the list of applied SEB exam configurations. Currently the number of SEB exam configurations that can be applied Just below the exam details you will find the list of applied SEB exam configurations. Currently the number of SEB exam configurations that can be applied
to an exam is restricted to one since it is not yet possible to apply a SEB exam configuration not just to the exam but also to a specific user or a to an exam is restricted to one since it is not yet possible to apply a SEB exam configuration not just to the exam but also to a specific user or a
specific group of users. This feature may come with a future release of seb server. But for now you are able to apply just one SEB exam configuration specific group of users. This feature may come with a future release of seb server. But for now you are able to apply just one SEB exam configuration
to the exam and this configuration gets delivered to all the SEB clients that connect to the SEB Server and participate to the exam. to the exam and this configuration gets delivered to all the SEB clients that connect to the SEB server and participate to the exam.
.. image:: images/exam/examConfigAdd.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/examConfigAdd.png
To apply a SEB exam configuration to an exam use the "Add Exam Configuration" action on the right action pane. A pop-up will prompt you to select an To apply a SEB exam configuration to an exam use the "Add Exam Configuration" action on the right action pane. A pop-up will prompt you to select an
SEB exam configuration by a drop-down selection. The drop-down box will present you all SEB exam configurations that are in state "Ready To Use" and SEB exam configuration by a drop-down selection. The drop-down box will present you all SEB exam configurations that are in state "Ready To Use" and
@ -70,22 +66,12 @@ the pop-up shows the description and the status of the selected configuration.
.. image:: images/exam/addExamConfig.png .. image:: images/exam/addExamConfig.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/addExamConfig.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/addExamConfig.png
There is also the possibility to encrypt the SEB exam configuration by a password. This is done before the SEB configuration is send to a connecting There is also the possibility to encrypt the SEB exam configuration by a password. This is done before the SEB configuration is send to a connecting
SEB client. Since in the most cases the SEB client connections are over HTTPS / TSL there is already a good protection in place and an SEB client. Since in the moste cases the SEB client connections are over HTTPS / TSL there is alrady a good protection in place and an
additional encryption of the SEB exam configuration is not recommended. Anyway, if you decide the use the additional password encryption, the SEB additional encryption of the SEB exam configuration is not recommended. Anyways, if you decide the use the additional password encryption, the SEB
client that receives the encrypted SEB exam configuration will prompt the user for the password to proceed and connect to the LMS/Assessment Tool. client that receives the encrypted SEB exam configuration will prompt the user for the password to proceed and connect to the LMS.
With SEB Server Version 1.6 it is possible to change the Exam Configuration encryption password of an applied Exam Configuration.
The new action "Edit Encryption Password" can be used to open up the original apply dialog and to change the password:
.. note::
The Encryption Password for applied Exam Configuration can only be changes when there are no active SEB clients available for the exam.
.. image:: images/exam/editEncryptionPassword.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/editEncryptionPassword.png
.. note:: .. note::
If you need to use the same SEB exam configuration for different exams, you can just make a copy of a SEB exam configuration that is already used If you need to use the same SEB exam configuration for different exams, you can just make a copy of a SEB exam configuration that is already used
@ -96,19 +82,25 @@ The new action "Edit Encryption Password" can be used to open up the original ap
generate a copy of the original SEB exam configuration with the new name and description and will lead you to the details page of the copy configuration. generate a copy of the original SEB exam configuration with the new name and description and will lead you to the details page of the copy configuration.
Click the "OK" button on the pop-up to apply the selected SEB exam configuration. You will see the applied SEB exam configuration in the list. Click the "OK" button on the pop-up to apply the selected SEB exam configuration. You will see the applied SEB exam configuration in the list.
If the automated SEB restriction feature is supported by the LMS/Assessment Tool of the exam, the application of a SEB exam configuration will automatically update If the automated SEB restriction feature is supported by the LMS of the exam, the application of a SEB exam configuration will automatically update
the SEB restriction details with the generated Config-Key. See :ref:`sebRestriction-label` for more information. the SEB restriction details with the generated Config-Key. See :ref:`sebRestriction-label` for more information.
.. image:: images/exam/examConfig.png .. image:: images/exam/examWithConfig.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examConfig.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/examWithConfig.png
To just generate the Config-Key for testing purposes or to manually apply it on an LMS/Assessment Tool without the automated SEB restriction feature you can When a SEB exam configuration is applied to the exam you are able to export the SEB exam configuration XML in plain text or the generated Config-Key for
testing purposes. Just select the SEB exam configuration in the list to activate the action on the action pain on the right side and use the
appropriate action. The SEB exam configuration export action will instruct the browser to open a download dialog. How the download is applied is up the
the browser of use. Usually you are able to either save the file or open it up with a application. If you have already installed the Safe Exam Browser on
your device, the browser probably associates the download file already with the SEB client application.
To just generate the Config-Key for testing purposes or to manually apply it on an LMS without the automated SEB restriction feature you can
use the "Export Config-Key" action to generate the key. The Config-Key is presented by a pop-up and can be selected and copied to the clip-board. use the "Export Config-Key" action to generate the key. The Config-Key is presented by a pop-up and can be selected and copied to the clip-board.
For more information about the Config-Key its purpose and use, please visit the `SEB documentation <https://www.safeexambrowser.org/developer/seb-config-key.html>`_. For more information about the Config-Key its purpose and use, please visit the `SEB documentation <https://www.safeexambrowser.org/developer/seb-config-key.html>`_.
To remove an already applied SEB exam configuration from the exam, select the SEB exam configuration in the table and use the "Delete Exam Configuration" To remove an already applied SEB exam configuration from the exam, select the SEB exam configuration in the table and use the "Delete Exam Configuration"
action form the right action pane. If the automated SEB restriction feature is supported by the LMS/Assessment Tool of the exam, the removal of a SEB exam configuration will action form the right action pane. If the automated SEB restriction feature is supported by the LMS of the exam, the removal of a SEB exam configuration will
automatically update the SEB restriction details and remove the Config-Key form the restriction details. See :ref:`sebRestriction-label` for more information. automatically update the SEB restriction details and remove the Config-Key form the restriction details. See :ref:`sebRestriction-label` for more information.
Once you have removed a SEB exam configuration from the exam you are able to apply another one to the exam. Once you have removed a SEB exam configuration from the exam you are able to apply another one to the exam.
@ -159,29 +151,6 @@ your institution use the type information of the exam to set them into context.
- When you have selected a exam configuration the dialog shows you some additional information about the exam configuration. - When you have selected a exam configuration the dialog shows you some additional information about the exam configuration.
- If you want or need to put an password protected encryption to the exam configuration for this exam you can do so by give the password for the encryption also within the attachment dialog. Be aware that every SEB client that will receive an encrypted exam configuration from the SEB Server will prompt the user to give the correct password. In most cases an encryption of the exam configuration is not needed, because a secure HTTPS connection form SEB client to SEB Server is already in place. - If you want or need to put an password protected encryption to the exam configuration for this exam you can do so by give the password for the encryption also within the attachment dialog. Be aware that every SEB client that will receive an encrypted exam configuration from the SEB Server will prompt the user to give the correct password. In most cases an encryption of the exam configuration is not needed, because a secure HTTPS connection form SEB client to SEB Server is already in place.
**Archive an exam**
Since SEB Server version 1.4 it is possible to archive an exam that has been finished. An archived exam and all its data is still available
on the SEB Server but read only and the exam is not been updated from the LMS/Assessment Tool data anymore and it is not possible to run this exam again.
This is a good use-case to organize your exams since archived exam are not shown in the Exam list with the default filter anymore. They are
only shown if the status filter of the exam list is explicitly set to Archived status. An they are shown within the new "Finished Exam"
section in the monitoring view.
.. image:: images/exam/archiveExamsFilter.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/archiveExamsFilter.png
This is also a good use-case if you want to remove an LMS/Assessment Tool and LMS/Assessment Tool Setup but still want to be able to access the exams data on the SEB Server.
In this case you can archive all exams from that LMS/Assessment Tool Setup before deactivating or deleting the respective LMS/Assessment Tool Setup.
To archive a finished exam you just have to use the "Archive Exam" action on the right action pane of the exam view:
.. image:: images/exam/archiveExam1.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/archiveExam1.png
**Delete an exam** **Delete an exam**
If you have "Exam Administrator" privileges you are able to entirely delete an existing exam and its dependencies. If you have "Exam Administrator" privileges you are able to entirely delete an existing exam and its dependencies.
@ -196,7 +165,7 @@ If you have "Exam Administrator" privileges you are able to entirely delete an e
.. image:: images/exam/deleteExam.png .. image:: images/exam/deleteExam.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/deleteExam.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/deleteExam.png
- Within the delete exam dialog you see a list of a dependencies that also will be deleted. Please check them carefully before deletion. - Within the delete exam dialog you see a list of a dependencies that also will be deleted. Please check them carefully before deletion.
- Use the below action to either delete the exam or cancel the action and go back to the exam view. - Use the below action to either delete the exam or cancel the action and go back to the exam view.

View file

@ -1,85 +0,0 @@
.. _examASK-label:
SEB App-Signature-Key
=====================
The SEB App-Signature-Key (ASK) is a new security key accordingly to the already known Browser-Exam-Key (BEK) used by SEB to restrict access and
ensure SEB client integrity for a SEB Server based setup. This feature is available since SEB Server 1.5 and the respective compatible SEB clients
noted within the SEB Server compatibility section of the SEB Server about page.
The main goal by using ASK for an exam with SEB and SEB Server is to ensure SEB client integrity. Since there is a unique ASK for every official SEB
release and build and the ASK is been created at runtime and securely sent to SEB Server, it will prove the SEBs integrity. Additional to this particular
ASK grant check, SEB Server will also make a heuristic check and considers an ASK as trusted if a particular number of SEB clients with the same
ASK has been connected to SEB Server. Since manipulation of the SEB application in any way, will change the ASK of that SEB, SEB Server can recognize
SEB clients with different singular ASKs and mark it as not granted as long as an exam administrator or supporter has not granted this specific ASK.
All explicitly granted ASK on the SEB Server are considered as trusted and SEB connecting with respective ASK will automatically get the grant and are
marked as usual as Active connection.
App-Signature-Key Setup
-----------------------
You can enable ASK grant check per exam within your exam set up page. Use the new "App Signature Key" action on the left action pane to open the settings
for this feature.
.. image:: images/exam/examASK.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examASK.png
Within this settings page you can enable or disable the feature any time also during a running exam. On the exam page you can see if the feature is enabled
when the shield-icon is not strike-through.
Within the settings "Numerical Trust Threshold" you can set the threshold for the heuristic check that is applied if there is no explicit grant for an
particular ASK. This means if more SEB clients with the same ASK has been connected to an running exam as this threshold points out, all that SEB clients
will be considered as trusted since one can say, that manipulated SEB clients has also a single unique ASK while official builds of SEB will all have the same
ASK for the same build.
.. image:: images/exam/examASKedit.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examASKedit.png
In the following list you can see all APK that has been sent to the SEB Server by connected SEB clients. For a particular ASK you can also see
how many SEB Clients has been sent this ASK and has the same signature.
Within this list you can explicitly grant a particular ASK by selecting the ASK from the list and using the "Add Security Grant" action from the
right action pane. You will see a pop-up with the specific ASK hash to be granted and all SEB client connections listed that has sent this ASK
below. You can give a name for the grant and save the grant by using "OK" action of the grant pop-up or cancel.
.. image:: images/exam/examASKgrant.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examASKgrant.png
You see all granted ASKs within the second list with the ASK hash and the name that was given on grant. All explicitly granted ASKs from that list are
considered trusted for the exam. And future SEB client connection that connects with one of the ASKs from this list are granted. All SEB clients that
are connecting to the exam with different ASK will apply to the heuristic check using the given "Numerical Trust Threshold".
Monitoring with App-Signature-Key
---------------------------------
When the App-Signature-Key check is enabled for an exam, SEB Server will check the ASK sent by a connecting SEB and mark it within the "Status"
column of the monitoring table. The App-Signature-Key check is processed in batch for newly connected SEB clients but not within the SEB connecting process
itself. So when a new SEB client connection appears in the monitoring, the check will probably not be done yet for this new connection. This is marked
with "(No ASK Grant) tag after the status name. This will stay so when SEB has not sent an ASK and SEB Server is not able to apply the check on that
SEB connection. If SEB has sent an ASK, the check will be processed within the next ASK update and the connection gets either granted or denied. Denied
SEB connections are marked red and with the tag "- ASK Grant Denied" after the status name.
.. image:: images/exam/examASKMonitoring1.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examASKMonitoring1.png
In the detail view of a SEB client connection you can see this too and you are able to apply a grant for a denied APK afterwards by using the
"Grant App Signature Key" action from the right action pane. This will open a pop-up with the ASK hash and an input field for the name of the
grant.
.. image:: images/exam/examASKMonitoring2.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examASKMonitoring2.png
.. image:: images/exam/examASKMonitoring3.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examASKMonitoring3.png
After you have granted a unknown ASK, the grant is also applied to the respective SEB connection and to all following SEB connections that
come with the same ASK. The grants can be modified within the Exam view as described above.

View file

@ -1,89 +0,0 @@
.. _examClientgroups-label:
SEB Client Groups
=================
SEB client groups are a new feature since SEB Server 1.5 release and allows you to group SEB client connection to specified groups that are
graphically tagged in the exam monitoring view and can be shown or hided by usual filter on the exam monitoring view. Currently there are
two different group types to group up SEB clients or SEB users, one is the the IP-Address (Internet Protocol Address) group and a second one
is the SEB OS (Operating System) grouping.
With the IP-Address grouping type you are able to create group SEB clients/users by an IP-Address range. You can make different groups out of
different IP-Address ranges (that ideally not overlap each other) and give them dedicated colors for identification. This group type is useful for example
if your infrastructure is dedicated to exam-rooms with given (W)LAN and static IP-Address ranges for that rooms. In this case you can map the rooms
to SEB groups by the IP Address range of that room and therefore are able to monitor you exam per room.
With the SEB OS grouping type you are able to group SEB clients/users by the type of the operating system of the device that is used to apply to an exam
with SEB. This is useful if you want to monitor and support your exam and participants by operating system type what make sense since support might be different
for different operating system.
.. note::
Since the grouping is as flexible as possible, it might be that a SEB user applies to no, one ore many groups. For example if you combine the above
described grouping type for IP ranges and SEB OS then one SEB user will apply to a certain IP range group type and also to a certain SEB OS group type.
This is possible and will also be displayed respectively within the monitoring view.
Setup SEB Client Groups
-----------------------
SEB client groups can be set up with the Exam view on SEB Server. Additionally it is also possible to pre-define SEB client groups for Exam Templates that
would be applied to an Exam while import with template as usual. Creating and managing SEB client groups for Exam Templates is exactly the same as for Exams.
Client groups are located on an Exam setup page after the indicators at the end of the page.
.. image:: images/exam/examClientgroupAdd.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examClientgroupAdd.png
To add a new SEB Client Group use the respective action from the right action pane. You will be presented with the SEB Client Group edit page
where you are able to give the new SEB Client Group a name and choose a type of the client group that you want to create.
You can also choose a color that is applied in the monitoring view within the "Client Group" column where all client groups that matches a
specified SEB client connection are displayed.
When you select the type of the SEB Client Group you want to create, other type specific inputs will appear together with a short description of
the group type. With the additional, specific inputs, the SEB Client Group can be specified further and finally be saved and applied to the Exam.
.. image:: images/exam/examClientgroupIP.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examClientgroupIP.png
For the IP range group type you can give a valid IP range defined with a start IP address and an end IP address. This two inputs are mandatory
and must be valid IPv4 addresses. The range must be a valid range and will be inclusive on the IP match (range-start >= IP <= range-end).
For the SEB OS grouping type you have to choose the OS type from the given types that are available to specify the client group.
.. image:: images/exam/examClientgroupWin.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examClientgroupWin.png
If you have finished up your SEB Client Group definition you can save it with the "Save" action from the right action pane or cancel the modifications and
go back to the Exam page. You will see your created SEB Client Groups within its respective section on the Exam page and are able to edit them again, or delete
a certain SEB Client group from the list.
.. image:: images/exam/examClientgroups.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examClientgroups.png
Monitoring with SEB Client Groups
---------------------------------
When SEB groups are defined within your exam, you will find the SEB groups also in your monitoring view of the running exam. In the additional column
named "Client Groups(s)" after "User Name or Session", you will see the applied SEB client groups of each SEB connection. This can be none, one ore more
depending on what group(s) a particular SEB applies to.
.. image:: images/exam/examClientgroupMonitoring1.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examClientgroupMonitoring1.png
With the "Client Group Filter" on the right action pane, you are able to show/hide individual groups. With this filtering you can adapt your monitoring view
for specialized monitoring view, to only see SEB client connection from one particular room for example or of one particular client OS.
.. note::
For the Client Group Filter, show has always the higher priority. Since a SEB client can apply to more then one group, all groups that a SEB client
belongs to has to be hiden (filter) before the SEB client connection is hided from the monitoring view. So if you have two different group types like
in the example, where a SEB client can belong to Room E1 as well as belong to Windows OS, both groups must be hidden to hide the client connection.
If only Windows is hidden but Room E1 not, the SEB client connection will still be shown since it belongs to at least one group that is not hided.
.. image:: images/exam/examClientgroupMonitoring2.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examClientgroupMonitoring2.png

View file

@ -1,296 +1,246 @@
.. _exam-configuration-label: .. _exam-configuration-label:
Exam Configuration Exam Configuration
================== ==================
Overview Overview
-------- --------
An exam configuration defines all the SEB settings for an exam. A SEB client that is connecting to SEB Server An exam configuration defines all the SEB settings for an exam. A SEB client that is connecting to SEB Server
and an exam defined by the SEB Server is downloading this exam configuration from SEB Server and reconfigure itself before accessing the and an exam defined by the SEB Server is downloading this exam configuration from SEB Server and reconfigure itself before accessing the
exam on the learning management system (LMS/Assessment Tool) and present it to the user. exam on the learning management system (LMS) and present it to the user.
.. note:: .. note::
For more information and detailed description of the SEB settings, see `SEB Configuration <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_. For more information and detailed description of the SEB settings, see `SEB Configuration <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_.
Currently not all settings are available, and some have different uses. For details about differences see :ref:`setting-dif-label` Currently not all settings are available and some has different uses. For details about differences see :ref:`setting-dif-label`
An exam administrator is able to create, modify and maintain exam configurations while the SEB Server administrator and the institutional administrator An exam administrator is able to create, modify and maintain exam configurations while the SEB Server administrator and the institutional administrator
role have only read access either for all exam configurations or for the exam configurations of the institution. role have only read access either for all exam configurations or for the exam configurations of the institution.
An exam supporter role is able to see and modify only the exam configurations to which the user-account is assigned as supporter. A exam supporter role is able to see and modify only the exam configurations to which the user-account is assigned as supporter.
To view the list of available exam configuration go the sub-menu "Exam Configuration" within the menu "SEB Configurations" on the left To view the list of available exam configuration go the the sub-menu "Exam Configuration" within the menu "SEB Configurations" on the left
hand side. The list shows the name, the description, and the status of the exam configurations in a column. With SEB Server administrator role hand side. The list shows the name, the description and the status of the exam configurations in a column. With SEB Server administrator role
also an institution column is shown because a SEB Server administrator is able to see all exam configurations of all institutions. also an institution column is shown because a SEB Server administrator is able to see all exam configurations of all institutions.
As usual, to filter the list use the filter inputs above and click on the lens symbol on the right to apply the filter and to clear the As usual, to filter the list use the filter inputs above and click on the lens symbol on the right to apply the filter and to clear the
filter use the clear symbol right to the lens symbol. See :ref:`gui-label` for more information about the list navigation. filter use the clear symbol right to the lens symbol. See :ref:`gui-label` for more information about the list navigation.
.. image:: images/exam_config/list.png .. image:: images/exam_config/list.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_config/list.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam_config/list.png
To view details of a specific exam configuration either double-click on a list entry or select a list entry and use the "View Exam Configuration" To view details of a specific exam configuration either double-click on a list entry or select a list entry and use the "View Exam Configuration"
action from the right action pane. In the detail view all general settings are shown and also a list of exams that uses this exam configuration. action from the right action pane. In the detail view all general settings are shown and also a list of exams that uses this exam configuration.
In the current version of SEB Server, an exam configuration can only be assigned to one exam. In the current version of SEB Server, an exam configuration can only be assigned to one exam.
.. note:: .. note::
For the actual SEB Server version, it is not possible to assign the same exam configuration to more then one exam. This because it shall be For the actual SEB Server version it is not possible to assign the same exam configuration to more then one exam. This because it shall be
possible to change configuration settings for running exams when no active SEB clients are connected within the specified exam. This is possible to change configuration settings for running exams when no active SEB clients are connected within the specified exam. This is
manageable for one exam but is going to become confusing if more exams are involved. manageable for one exam but is going to become confusing if more exams are involved.
But there is the possibility to copy an existing exam configuration to use the same for another exam. But there is the possibility to copy an existing exam configuration to use the same for another exam.
The status of an exam configuration defines its visibility and assignment possibilities. If an exam configuration is still in the creation process The status of an exam configuration defines its visibility and assignment possibilities. If an exam configuration is still in the creation process
and shall not be to an exam yet, it should stay in the "Under Construction" status. and shall not be to an exam yet, it should stay in the "Under Construction" status.
This is the default status while creating a new exam configuration. Once an exam configuration is done and ready for assignment, one can change this This is the default status while creating a new exam configuration. Once a exam configuration is done and ready for assignment, one can change this
status to "Ready To Use". Exam configurations within this status are available for selection and assignment on exams. When an exam configuration status to "Ready To Use". Exam configurations wihtin this status are available for selection and assignment on exams. When a exam configuration
is assigned to an exam, the status changes automatically to "In Use" and the SEB settings of the exam configuration will appear only in read mode for default. is assigned to an exam the status changes automatically to "In Use" and the SEB settings of the exam configuration will appear only in read mode for default.
.. image:: images/exam_config/view.png .. image:: images/exam_config/view.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_config/view.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam_config/view.png
An exam configuration has a general settings part (like other domain objects has within SEB Server) that defines the name, description and status An exam configuration has a general settings part (like other domain objects has within SEB Server) that defines the name, description and status
of the exam configuration that are used to maintain the exam configurations SEB Server internally. And an exam configuration has, separated from of the exam configuration that are used to maintain the exam configurations SEB Server internally. And a exam configuration has, separated from
the general settings, the SEB settings that contains most of the SEB setting attributes as they are provided by the SEB. the general settings, the SEB settings that contains most of the SEB setting attributes as they are provided by the SEB.
.. note:: .. note::
For more information and detailed description of the SEB setting attributes, see `SEB Configuration <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_. For more information and detailed description of the SEB setting attributes, see `SEB Configuration <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_.
Currently not all settings are available, and some have different uses. For details about differences see :ref:`setting-dif-label` Currently not all settings are available and some has different uses. For details about differences see :ref:`setting-dif-label`
The SEB settings differ from the general form-settings also in how they are managed and stored on server-side. Unlike the form-settings, The SEB settings differ from the general form-settings also in how they are managed and stored on server-side. Unlike the form-settings,
the SEB settings are arranged like they are in the SEB Configuration Tool for Windows and they are stored while modifying. This means, the SEB settings are arranged like they are in the SEB Configuration Tool for Windows and they are stored while modifying. This means,
an entered value for an attribute is immediately sent to and stored by the SEB Server. There is no additional save action needed and a entered value for an attribute is immediately sent to and stored by the SEB Server. There is no additional save action needed and
no entered data will be lost. Instead, the "Save / Publish Settings" can be used to store the current setting in a new revision in the history no entered data will be lost. Instead the "Save / Publish Settings" can be used to store the current setting in a new revision in the history
while also publish them to exams that uses this exam configuration. while also publish them to exams that uses this exam configuration.
.. image:: images/exam_config/settings.png .. image:: images/exam_config/settings.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_config/settings.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam_config/settings.png
.. note:: .. note::
Changes in SEB settings must be published to be available on exports, exams, or other uses. Before publishing they are not Changes in SEB settings must be published to be available on exports, exams or other uses. Before publishing they are not
available for exams and SEB clients that connect to the SEB Server will still receive the last published version of the SEB settings. available for exams and SEB clients that connect to the SEB Server will still receive the last published version of the SEB settings.
To publish SEB setting changes, use the "Save / Publish Settings" action from the right action pane. To publish SEB setting changes use the "Save / Publish Settings" action from the right action pane.
.. note:: .. note::
Currently there is an "Undo" function to revert the changed made to the last published state. But there is no possibility yet to Currently there is an "Undo" function to revert the changed made to the last published state. But there is no possibility yet to
maintain the publishing history of an Exam Configuration but may be available in a future release of the SEB Server. maintain the publishing history of a Exam Configuration but may be available in a future release of the SEB Server.
Since an exam configuration can only be used by one exam it may be convenient to quickly copy an existing exam configuration that is in use Since an exam configuration can only be used by one exam it may be convenient to quickly copy an existing exam configuration that is in use
and use the copy of this exam configuration for another exam or to just change the settings to make a slightly different exam configuration. and use the copy of this exam configuration for another exam or to just change the settings to make a slightly different exam configuration.
The "Copy Exam Configuration" action can always be used no matter in what state the exam configuration may be at the moment. By using this The "Copy Exam Configuration" action can always be used no matter in what state the exam configuration may be at the moment. By using this
feature there will be a copy dialog shown as pop-up window where one has to give at least a new unique name for the copy. feature there will be a copy dialog shown as pop-up window where one has to give at least a new unique name for the copy. See :ref:`copy-config-label`
See :ref:`copy-config-label` for a detailed step by step guide. for detailed step by step guide.
A plain XML export of the SEB settings may be needed for testing. This is always possible by using the "Export SEB Settings" action A plain XML export of the SEB settings may be needed for testing. This is always possible by using the "Export SEB Settings" action
from the right action pane in the SEB settings view. This will start a usual browser download dialog handled by your browser to save or load the file. The default name from the right action pane in the SEB settings view. This will start a usual browser download dialog handled by your browser to save or load the file. The default name
of the file of an exam configuration is "SEBExamSettings.seb". of the file of a exam configuration is "SEBExamSettings.seb".
SEB Server supports also the `SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ that is used to validate the SEB configuration SEB Server supports also the `SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ that is used to validate the SEB configuration
on the LMS/Assessment Tool and adds a higher security level to the exam. This is supported if the specific type of LMS/Assessment Tool supports the automated SEB restriction feature. Anyways on the LMS adds a higher security level to the exam. This supported if the specific type of LMS supports the automated SEB restriction feature. Anyways
sometimes it may be needed to manually extract the `SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ for an exam configuration. sometimes it may be needed to manually extract the `SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ for a exam configuration.
Therefore, one can use the "Export Client-Key" action from the right action pane to generate the Config-Key from the actual saved SEB settings revision Therefore one can use the "Export Client-Key" action from the right action pane to generate the Config-Key form the actual saved SEB settings revision
of the exam configuration. The key will be presented by a pop-up dialog where it can be copied for further use. of the exam configuration. The key will be presented by a pop-up dialog where it can be copied for further use.
.. image:: images/exam_config/config_key.png .. image:: images/exam_config/settings.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_config/config_key.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam_config/config_key.png
Batch Actions Use Cases
------------- ---------
Within the Exam Configuration list page there are two different batch-actions with that it is able to apply one action to many selected exam configurations. **Create new Exam Configuration**
For list multi-selection documentation see :ref:`List Multi-Selection <listmultiselect>`. For the upcoming semester you have to create several new exam configurations for the different kind of exams your institution is going to provide
during the semester.
.. note::
For all batch actions it is the case that the process try to apply the selected action with a particular selected object. If the action is not possible for the respective - Sign into SEB Server with your exam administrator role account
object, the failure is ignored and the action will not be applied for such a selection. At the end of the batch action you can see for how many objects this - Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left hand side.
action has been failed. - You see a list of all available exam configuration.
- Use the "Add Exam Configuration" action on the action pane on the right hand side to create a new exam configuration
.. image:: images/exam_config/batch-actions.png - The creation form at least needs a unique name for the exam configuration. You can also add a description or hint to recognize and find this configuration more easily later on.
:align: center - In the "Status" field you are able to choose if the configuration is still under construction and cannot be added to exams yet, or if it is ready to use.
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_config/batch-actions.png - Save the form with the "Save Exam Configuration" action on the right action pane to create the configuration.
- After successfully saved the new exam configuration use "Edit SEB Settings" to open all the SEB settings that can be defined for a exam.
- For more information about the individual SEB settings see `SEB Configuration <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_.
- In the SEB settings view use the "Save / Publish Settings" action to save your settings.
**State Change**
.. note::
With this batch action you are able to change the state of all selected exam configurations to a specific target state. Changes in SEB settings are automatically sent to the server and stored within the open working revision of the settings.
To make a open working revision active and available for export, exams and other uses, you need to save / publish this settings exclusively
by using the "Save / Publish Settings" action. After using this action all the changes are saved in a historical revision and
.. image:: images/exam_config/batch-actions_statechange.png available for use. A new working revision will be created and all the changes until then will go into the new working revision.
:align: center To revert all the changes done since last save / publish use the "Undo" action.
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_config/batch-actions_statechange.png
**Export SEB Settings**
Within the batch-action pop-up you can see how many exam configurations you have selected for the action. Now you are able to select the target state
to where you would like to change all selected exam configurations state to. Then you can apply the batch action with "Change State" or cancel the batch-action. You want to test an exam configuration manually with a SEB client. Therefore you need to export the settings of an existing exam configuration and load
it with a SEB client or the SEB configuration tool.
While the batch action is running, you see the progress within the pop-up until the batch action has been finished. You also can see how many actions
has been applied and how many has failed. - Sign into SEB Server with your exam administrator role account
- Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left hand side.
.. image:: images/exam_config/batch-actions_statechange_finished.png - You see a list of all available exam configuration.
:align: center - Use the Filter above the list to narrow down the number of entries and to find a specific exam configuration.
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_config/batch-actions_statechange_finished.png - Open the exam configuration either by double-click on the list entry or be selecting the list entry and using the "View Exam Configuration" action.
- Open the SEB settings of the exam configuration by using the action on the right action pane.
- Use the "Export SEB Settings" action to start the export download.
**Reset To Template Settings** - Save the file or open it directly with SEB
With this batch-action you are able to reset all SEB Settings either to the respective Configuration Template default values, if the Exam Configuration **Import an Exam Configuration**
has such a Configuration Template, or to the overall SEB default Settings for exam configurations.
There is an existing SEB configuration file once created with the SEB config tool that must be imported to use with SEB Server.
Within the batch-action pop-up you can see how many exam configurations you have selected for the action. Now you are able to select the target state The SEB configuration files where created with the SEB configuration tool and are all saved with the purpose to start an exam (attribute).
to where you would like to change all selected exam configurations state to. Then you can apply the batch action with "Reset Settings" or cancel the batch-action.
- Sign into SEB Server with your exam administrator role account
While the batch action is running, you see the progress within the pop-up until the batch action has been finished. You also can see how many actions - Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left hand side.
has been applied and how many has failed. - Use the "Import Exam Configuration" action from the right action pane to start an upload dialog.
- Within the upload dialog use the file selector to select the SEB configuration file for importing.
Use Cases - Give a unique name for the imported exam configuration and a description (optional).
--------- - If the original SEB configuration is password protected, give the password that is needed to decrypt the configuration file.
- Use the OK action on the upload dialog to start the import.
**Create new Exam Configuration** - If the import was successful a new exam configuration with the given name exists.
For the upcoming semester you have to create several new exam configurations for the different kind of exams your institution is going to provide .. _copy-config-label:
during the semester.
**Copy an Exam Configuration**
- Sign into SEB Server with your exam administrator role account.
- Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left-hand side. Since an exam configuration can only be used by one exam you have periodically to create a copy of an existing exam configuration
- You see a list of all available exam configuration. that is already attached to an exam. The copy can then be used to either make first some changes to the settings or add it directly
- Use the "Add Exam Configuration" action on the action pane on the right-hand side to create a new exam configuration to another exam that has to be configured for SEB.
- The creation form at least needs a unique name for the exam configuration. You can also add a description or hint to recognize and find this configuration more easily later on.
- In the "Status" field you are able to choose if the configuration is still under construction and cannot be added to exams yet, or if it is ready to use. - Sign into SEB Server with your exam administrator role account
- Save the form with the "Save Exam Configuration" action on the right action pane to create the configuration. - Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left hand side.
- After successfully saved the new exam configuration use "Edit SEB Settings" to open all the SEB settings that can be defined for a exam. - You see a list of all available exam configuration.
- For more information about the individual SEB settings see `SEB Configuration <https://www.safeexambrowser.org/windows/win_usermanual_en.html#configuration>`_. - Use the Filter above the list to narrow down the number of entries and to find a specific exam configuration.
- In the SEB settings view use the "Save / Publish Settings" action to save your settings. - Open the exam configuration either by double-click on the list entry or be selecting the list entry and using the "View Exam Configuration" action.
- Use the "Copy Exam Configuration" action from the right action pane to open up the copy dialog.
.. note:: - Within the copy dialog give a new unique name for the new exam configuration and a description if needed.
Changes in SEB settings are automatically sent to the server and stored within the open working revision of the settings. - Use "With History" apply the whole history of the original exam configuration to be copied or let it unchecked to just copy the last saved / published revision of the original.
To make an open working revision active and available for export, exams and other uses, you need to save / publish this settings exclusively - If all information is correct, use the "OK" button of the copy dialog to create the copy.
by using the "Save / Publish Settings" action. After using this action, all the changes are saved in a historical revision and
available for use. A new working revision will be created and all the changes until then will go into the new working revision. .. note:: If there where changes in the working revision of the exam configuration to copy, they will not be included in the copy.
To revert all the changes done since last save / publish use the "Undo" action. Only saved / published changes are included in the copy.
**Export SEB Settings** **Generate and Export the Config-Key of an Exam Configuration**
You want to test an exam configuration manually with a SEB client. Therefore, you need to export the settings of an existing exam configuration and load Usually the `SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ that is used to validate the SEB configuration
it with a SEB client or the SEB configuration tool. on the LMS is propagated automatically to a LMS by the SEB Server with the automated SEB restriction feature. But For testing purposes you need to generate and export the
`SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ and set it manually on the LMS.
- Sign into SEB Server with your exam administrator role account.
- Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left-hand side. - Sign into SEB Server with your exam administrator role account
- You see a list of all available exam configuration. - Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left hand side.
- Use the Filter above the list to narrow down the number of entries and to find a specific exam configuration. - You see a list of all available exam configuration.
- Open the exam configuration either by double-click on the list entry or be selecting the list entry and using the "View Exam Configuration" action. - Use the Filter above the list to narrow down the number of entries and to find a specific exam configuration.
- Open the SEB settings of the exam configuration by using the action on the right action pane. - Open the exam configuration either by double-click on the list entry or be selecting the list entry and using the "View Exam Configuration" action.
- Use the "Export SEB Settings" action to start the export download. - Use the "Export Config-Key" action from the right action pane to generate the Config-Key and open a dialog that presents this generated Config-Key.
- Save the file or open it directly with SEB. - Mark the Config-Key hash in the dialog with double-click and copy it (ctrl+c) to the clip-board.
**Import an Exam Configuration** .. note:: If there where changes in the working revision of the exam configuration to create the Config-Key from, they will not be included in the generation of the Config-Key.
Only saved / published changes are included in the Config-Key generation.
There is an existing SEB configuration file once created with the SEB config tool that must be imported to use with SEB Server.
The SEB configuration files were created with the SEB configuration tool and are all saved with the purpose to start an exam. **Changing SEB Settings of an Exam Configuration in Use**
- Sign into SEB Server with your exam administrator role account. There is an already fully configured exam within SEB Server that is currently running with a prepared exam configuration. You have now realized that
- Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left hand-side. some SEB settings are missing or wrong and has to be changed for the exam. This is possible but under some restrictions. See the note below.
- Use the "Import Exam Configuration" action from the right action pane to start an upload dialog.
- Within the upload dialog use the file selector to select the SEB configuration file for importing. .. note::
- Give a unique name for the imported exam configuration and a description (optional). When a exam configuration is applied to a currently running exam, the exam configuration is in "Used" state and the SEB settings of the exam configuration
- If the original SEB configuration is password protected, give the password that is needed to decrypt the configuration file. are in read only mode. Changing the SEB settings of a exam configuration during a running exam that has already connected clients can lead to unexpected
- Use the OK action on the upload dialog to start the import. behavior. SEB clients that has already been connected and are in a running session will work with the old configuration while SEB clients that are connecting
- If the import was successful a new exam configuration with the given name exists. after a SEB settings change will work with the new configuration. Also the automated SEB restriction with the changed `SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_
will be updated immediately after saving / publishing the configuration changes. This may also lead to unexpected behavior and eventually blocking of already connected SEB clients.
.. _copy-config-label: Therefore SEB Server restricts the change of SEB settings for configurations that are attached to an exam that is currently running to be only possible if there are no
active SEB client connections for this exam at the moment when save / publish the SEB setting changes.
**Copy an Exam Configuration**
- Sign into SEB Server with your exam administrator role account
Since an exam configuration can only be used by one exam you have periodically to create a copy of an existing exam configuration - To change the SEB Settings of an exam configuration that is attached to an currently running exam, make sure that there are no active SEB client connections.
that is already attached to an exam. The copy can then be used to either make first some changes to the settings or add it directly Go to the "Monitoring" section and find and view the concerned exam to make sure there are currently no active SEB client connections.
to another exam that has to be configured for SEB. - Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left hand side.
- You see a list of all available exam configuration.
- Sign into SEB Server with your exam administrator role account. - Use the Filter above the list to narrow down the number of entries and to find a specific exam configuration.
- Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left-hand side. - Open the exam configuration either by double-click on the list entry or be selecting the list entry and using the "View Exam Configuration" action.
- You see a list of all available exam configuration. - See that you currently are not able to edit the SEB settings. There is only a "View SEB Settings" action that opens the SEB settings in read-only mode.
- Use the Filter above the list to narrow down the number of entries and to find a specific exam configuration. - Use the "Edit Exam Configuration" action from the right action pane to open the edit mode of the exam configuration.
- Open the exam configuration either by double-click on the list entry or be selecting the list entry and using the "View Exam Configuration" action. - Change the status from "Used" to "Under Construction" to be able to edit the SEB settings again. There will be a message that tells you the implication with changing SEB settings within a exam configuration that is already used by a running exam.
- Use the "Copy Exam Configuration" action from the right action pane to open up the copy dialog. - After saving the exam configuration in "Under Construction" it is now possible to edit the SEB settings for this exam configuration.
- Within the copy dialog give a new unique name for the new exam configuration and a description if needed. - Use the "Edit SEB Settings" action from the right action pane to open the SEB settings form in the edit mode.
- Use "With History" apply the whole history of the original exam configuration to be copied or let it unchecked to just copy the last saved / published revision of the original. - Apply your changes to the settings and use "Save / Publish Settings" to make the settings take affect and trigger a configuration change to the exam. This will check first if there are currently no active SEB clients connected within the running exam that uses this exam configuration. If there is one or more active SEB client connected, the action will deny and inform you about the the active SEB clients.
- If all information is correct, use the "OK" button of the copy dialog to create the copy.
.. note:: If there were changes in the working revision of the exam configuration to copy, they will not be included in the copy. .. _setting-dif-label:
Only saved / published changes are included in the copy.
SEB Setting Differences
**Generate and Export the Config-Key of an Exam Configuration** -----------------------
Usually the `SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ that is used to validate the SEB configuration In the current version of SEB Server, there are some differences to some SEB settings as well as some SEB settings that are slightly different or not available at all on the SEB Server.
on the LMS/Assessment Tool is propagated automatically to a LMS/Assessment Tool by the SEB Server with the automated SEB restriction feature. But For testing purposes you need to generate and export the
`SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ and set it manually on the LMS/Assessment Tool. **SEB settings currently not supported by the SEB Server**
- Sign into SEB Server with your exam administrator role account. - Start URL: Since SEB Server has already been contacted by a SEB client when downloading the exam configuration this is not used by the exam configuration on SEB Server. But this can be used as fallback URL in the Connection Configuration.
- Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left-hand side. - Embedded Resource: There is currently no embedding supported within exam configurations on SEB Server.
- You see a list of all available exam configuration. - Additional Dictionaries: There are only the SEB client default dictionaries available in the current SEB Server version.
- Use the Filter above the list to narrow down the number of entries and to find a specific exam configuration. - Additional Resources: Additional resources are currently not available in the current SEB Server version.
- Open the exam configuration either by double-click on the list entry or be selecting the list entry and using the "View Exam Configuration" action. - Embedded Certificates: There is currently no certificate management possible on current SEB Server version.
- Use the "Export Config-Key" action from the right action pane to generate the Config-Key and open a dialog that presents this generated Config-Key. - Browser Exam Key: There is currently no possibility to generate the Browser Exam Key on the SEB Server. But an already generated Browser Exam Key may be used within the SEB restriction feature on the exam configuration if this feature is supported by the LMS in use.
- Mark the Config-Key hash in the dialog with double-click and copy it (ctrl+c) to the clipboard.
.. note:: If there were changes in the working revision of the exam configuration to create the Config-Key from, they will not be included in the generation of the Config-Key. **SEB settings that has a slightly different form or handling in SEB Server comparing to the SEB configuration tool**
Only saved / published changes are included in the Config-Key generation.
- Download Directory OSX: Since it is not possible within a web-service to choose a local directory on a remote device this is just a text input where one has to give the full-path to the directory on the client device in text form.
**Changing SEB Settings of an Exam Configuration in Use** - Log Directory OSX, Log Directory Win: Since it is not possible within a web-service to choose a local directory on a remote device this is just a text input where one has to give the full-path to the directory on the client device in text form.
- Permitted Processes / Executable: This is also just a text input field where one can give the name of the process in text form.
There is an already fully configured exam within SEB Server that is currently running with a prepared exam configuration. You have now realized that
some SEB settings are missing or wrong and has to be changed for the exam. This is possible but under some restrictions. See the note below. **SEB settings from versions before 3.0 that are not supported anymore**
.. note:: - Permitted Processes / Window Handling Process
When an exam configuration is applied to a currently running exam, the exam configuration is in "Used" state and the SEB settings of the exam configuration
are in read only mode. Changing the SEB settings of an exam configuration during a running exam that has already connected clients can lead to unexpected
behavior. SEB clients that have already been connected and are in a running session will work with the old configuration while SEB clients that are connecting
after a SEB settings change will work with the new configuration. Also, the automated SEB restriction with the changed `SEB Config-Key <https://safeexambrowser.org/developer/seb-config-key.html>`_
will be updated immediately after saving / publishing the configuration changes. This may also lead to unexpected behavior and eventually blocking of already connected SEB clients.
Therefore, SEB Server restricts the change of SEB settings for configurations that are attached to an exam that is currently running to be only possible if there are no
active SEB client connections for this exam at the moment when save / publish the SEB setting changes.
- Sign into SEB Server with your exam administrator role account.
- To change the SEB Settings of an exam configuration that is attached to a currently running exam, make sure that there are no active SEB client connections.
Go to the "Monitoring" section and find and view the concerned exam to make sure there are currently no active SEB client connections.
- Navigate to the "Exam Configuration" menu within the SEB Configuration section on the left-hand side.
- You see a list of all available exam configuration.
- Use the Filter above the list to narrow down the number of entries and to find a specific exam configuration.
- Open the exam configuration either by double-click on the list entry or be selecting the list entry and using the "View Exam Configuration" action.
- See that you currently are not able to edit the SEB settings. There is only a "View SEB Settings" action that opens the SEB settings in read-only mode.
- Use the "Edit Exam Configuration" action from the right action pane to open the edit mode of the exam configuration.
- Change the status from "Used" to "Under Construction" to be able to edit the SEB settings again. There will be a message that tells you the implication with changing SEB settings within an exam configuration that is already
used by a running exam.
- After saving the exam configuration in "Under Construction" it is now possible to edit the SEB settings for this exam configuration.
- Use the "Edit SEB Settings" action from the right action pane to open the SEB settings form in the edit mode.
- Apply your changes to the settings and use "Save / Publish Settings" to make the settings take affect and trigger a configuration change to the exam. This will check first if there are currently no active SEB clients connected within the running exam that uses this exam configuration. If there is one or more active SEB client connected, the action will deny and inform you about the active SEB clients.
.. _setting-dif-label:
SEB Setting Differences
-----------------------
In the current version of SEB Server, there are some differences to some SEB settings as well as some SEB settings that are slightly different or not available at all on the SEB Server.
**SEB settings currently not supported by the SEB Server**
- Start URL: Since SEB Server has already been contacted by a SEB client when downloading the exam configuration this is not used by the exam configuration on SEB Server. But this can be used as fallback URL in the Connection Configuration.
- Embedded Resource: There is currently no embedding supported within exam configurations on SEB Server.
- Additional Dictionaries: There are only the SEB client default dictionaries available in the current SEB Server version.
- Additional Resources: Additional resources are currently not available in the current SEB Server version.
- Embedded Certificates: There is currently no certificate management possible on current SEB Server version.
- Browser Exam Key: There is currently no possibility to generate the Browser Exam Key on the SEB Server. But an already generated Browser Exam Key may be used within the SEB restriction feature on the exam configuration if this feature is supported by the LMS/Assessment Tool in use.
**SEB settings that have a slightly different form or handling in SEB Server comparing to the SEB configuration tool**
- Download Directory OSX: Since it is not possible within a web-service to choose a local directory on a remote device this is just a text input where one has to give the full-path to the directory on the client device in text form.
- Log Directory OSX, Log Directory Win: Since it is not possible within a web-service to choose a local directory on a remote device this is just a text input where one has to give the full-path to the directory on the client device in text form.
- Permitted Processes / Executable: This is also just a text input field where one can give the name of the process in text form.
**SEB settings from versions before 3.0 that are not supported anymore**
- Permitted Processes / Window Handling Process

View file

@ -1,39 +1,28 @@
Import LMS/Assessment Tool Course as Exam in SEB Server Import LMS Course as Exam in SEB Server
======================================= =======================================
To be able to configure and manage a course or parts of a course existing on a LMS/Assessment Tool as an exam on SEB Server we first need to import To be able to configure and manage a course or parts of a course existing on a LMS as an exam on SEB Server we first need to import
an exam from the one of the available courses from a LMS/Assessment Tool that has been setup to use within the SEB Server. an exam from the one of the available courses from a LMS that has been setup to use within the SEB Server.
.. note:: .. note::
If you don't have already set up a LMS/Assessment Tool binding within SEB Server and your institution, you have to do this first. If you don't have already set up a LMS binding within SEB Server and your institution, you have to do this first.
More information about setting up a LMS/Assessment Tool binding can be found in the chapter :ref:`lms-setup-label` More information about setting up a LMS binding can be found in the chapter :ref:`lms-setup-label`
You will find the list of available courses provided from all LMS/Assessment Tool that are bound within your institution by going to the "Exam Administration" You will find the list of available courses provided form all LMS that are bound within your institution by going to the "Exam Administration"
section on the left hand side and choosing "LMS/Assessment Tool Exam Lookup". The SEB Server will present you the list of all available courses and you section on the left hand side and choosing "LMS Exam Lookup". The SEB Server will present you the list of all available courses and you
are able to filter and sort the list as usual to find to right course for import. are able to filter and sort the list as usual to find to right course for import.
.. note:: .. note::
The “Start-Time” filter is usually set to the date one year before now or to some other default date in the past. The "Start-Time" filter is usually set to the date one year before now or to some other default date in the past. The list shows only
The list shows only the courses that has a start-time after that time. If you have long running courses and it may the courses that has a start-time after that time. If you have long running courses and it may possible that a course has been stated
possible that a course has been stated a year or two ago, you have to adapt this “Start-Time” filter to view those a year or two ago, you habe to adapt this "Start-Time" filter to view those courses that has been started before.
courses that has been started before.
.. image:: images/exam/lmsExamLookup.png .. image:: images/exam/lmsExamLookup.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/lmsExamLookup.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/lmsExamLookup.png
You can view more details of a course by double-click on the specific list entry or by selecting the list entry and click the "Show LMS/Assessment Tool Exam Details" You can view more details of a course by double-click on the specific list entry or by selecting the list entry and click the "Show LMS Exam Details"
action form the action pane on the right hand side. The application will open a pop-up with available detail information of the course. action form the action pain on the right hand side. The application will open a pop-up with available detail information of the course.
Since SEB Server version 1.5 the data-fetching-process to get all course data from bounded LMS/Assessment Tools works as a background task and
the UI request will return anyway no matter if all data has been fetched already and presents the already available data.
If the background task is still running and fetching data, SEB Server will indicate that with a message note on top of the page
with the ability to reload the page by clicking on the respective icon in the note. With this approach you can now see whether all data
are available and fetched or not.
.. image:: images/exam/lmsExamLookupLate.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/lmsExamLookupLate.png
To import a course as an exam find the specific course on the list by using the filter and select the list entry. Use the "Import As Exam" action To import a course as an exam find the specific course on the list by using the filter and select the list entry. Use the "Import As Exam" action
from the action pane on the right hand side. from the action pane on the right hand side.
@ -41,29 +30,26 @@ from the action pane on the right hand side.
.. note:: .. note::
If a course has already ended (End-Time passed) it is not possible to import this course and an appropriate message is shown. If a course has already ended (End-Time passed) it is not possible to import this course and an appropriate message is shown.
On import, the application is creating an exam on SEB Server with a reference to the imported course on the LMS/Assessment Tool. All course specific data On import, the application is creating an exam on SEB Server with a reference to the imported course on the LMS. All course specific data
like name, description, start-, end-time and course-identifier will not be stored on the SEB Server but always be referenced by the underling course. like name, description, start-, end-time and course-identifier will not be stored on the SEB Server but always be referenced by the underling course.
This means, that the course data has to be modified on the LMS/Assessment Tool side as usual and the SEB Server always takes the actual data from the LMS/Assessment Tool for the This means, that the course data has to be modified on the LMS side as usual and the SEB Server always takes the actual data from the LMS for the
course. This has the advantages of the principle of single responsibility and prevents synchronization issues. course. This has the advantages of the principle of single responsibility and prevents synchronization issues.
You will see the creation page of the new exam with additional information from LMS/Assessment Tool: You will see the creation page of the new exam with additional information:
- **Name**: Is the name of the course, defines on the LMS/Assessment Tool - **Name**: Is the name of the course, defines on the LMS
- **LMS/Assessment Tool Setup**: Is the name of the LMS/Assessment Tool Setup on the SEB Server from which the course was imported - **LMS Setup**: Is the name of the LMS Setup on the SEB Server from which the course was imported
- **Start-Time**: Is the date and time when the exam is starting. This is defined on the LMS/Assessment Tool - **Start-Time**: Is the date and time when the exam is starting. This is defined on the LMS
- **End-Time**: Is the date and time when the exam ends. This is defined on the LMS/Assessment Tool - **End-Time**: Is the date and time when the exam ends. This is defined on the LMS
- **LMS/Assessment Tool Exam Identifier**: Is the identity of the course on the LMS/Assessment Tool (external identifier/primary key) - **LMS Exam Identifier**: Is the identity of the course on the LMS (external identifier/primary key)
- **LMS/Assessment Tool Exam URL**: Is the start URL of the course/exam - **LMS Exam URL**: Is the start URL of the course/exam
You are now able to either choose an existing :ref:`exam-template-label` to initialize the new exam with the settings defined within the template You are now able to initially choose a type for the exam - "Exam Type" - that is currently only used
or to set the needed settings only for this exam. If you choose a template, the settings from the template will automatically be added to the exam for informational purpose and has no further restrictions or consequences on handling on in SEB Server.
on creation and you are still able to modify them afterwards.
Initially choose a type for the exam - "Exam Type" - that is currently only used for informational purpose and has no further restrictions or consequences on handling on in SEB Server.
.. image:: images/exam/importExam.png .. image:: images/exam/importExam.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/importExam.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/importExam.png
Furthermore you can select and apply all exam supporter that shall be able to see and support this exam while running. To do so, click in the Furthermore you can select and apply all exam supporter that shall be able to see and support this exam while running. To do so, click in the
input field of the attribute "Exam Supporter" to see a drop down list of all available users for selection. To filter the drop down list, start input field of the attribute "Exam Supporter" to see a drop down list of all available users for selection. To filter the drop down list, start
@ -71,16 +57,19 @@ typing characters of the name of the user-account you want to apply to automatic
specified user that will be added to the list below the input field. To add another user to the selection just click again into the input field specified user that will be added to the list below the input field. To add another user to the selection just click again into the input field
and select another user. To remove a selected user from the selection-list, double-click on the specified entry of the selection-list. and select another user. To remove a selected user from the selection-list, double-click on the specified entry of the selection-list.
.. note::
At least one user account must be selected for the attribute "Exam Supporter". You are able to change this also later on by editing the exam.
To confirm the import use the "Save Exam" action of the action pane on the right hand side or use "Cancel" if you want to abort the import of the To confirm the import use the "Save Exam" action of the action pane on the right hand side or use "Cancel" if you want to abort the import of the
exam and go back to the course list. If you have confirmed and successfully imported the exam, you will see the exam overview page where you are able exam and go back to the course list. If you have confirmed and successfully imported the exam, you will see the exam overview page where you are able
to edit the details of the exam, apply SEB restrictions of supported by the LMS/Assessment Tool, apply a SEB exam configuration for the exam and define indicators to edit the details of the exam, apply SEB restrictions of supported by the LMS, apply a SEB exam configuration for the exam and define indicators
for monitoring the exam later on. for monitoring the exam later on.
.. image:: images/exam/examReady.png .. image:: images/exam/examReady.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examReady.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/examReady.png
How all this different aspects of the exam are defined and prepared is part of the next chapters. How all this different aspects of the exam are defined and prepared is part of the next chapter.
Use Cases Use Cases
@ -88,11 +77,11 @@ Use Cases
**Import a course as exam** **Import a course as exam**
To start setting up a course or quiz form an existing LMS/Assessment Tool as e-assessment with SEB and SEB Server you have to find this course or quiz on the To start setting up a course or quiz form an existing LMS as e-assessment with SEB and SEB Server you have to find this course or quiz on the
SEB Server and import it as exam. Define a type and apply exam supporter. SEB Server and import it as exam. Define a type and apply exam supporter.
- Login as an exam administrator and go to the "LMS/Assessment Tool Exam Lookup" page under the "Exam Administration" section. - Login as an exam administrator and go to the "LMS Exam Lookup" page under the "Exam Administration" section.
- If you are not sure if the LMS/Assessment Tool that runs your course has already been setup within the SEB Server, go first to the "LMS/Assessment Tool Setup" page and try to find the particular LMS/Assessment Tool in the list. If you can't find it, please contact an institutional administrator or setup the LMS/Assessment Tool by yourself as described in :ref:`lms-setup-label`. - If you are not sure if the LMS that runs your course has already been setup within the SEB server, go first to the "LMS Setup" page and try to find the particular LMS in the list. If you can't find it, please contact an institutional administrator or setup the LMS by yourself as described in :ref:`lms-setup-label`.
- Find your course or quiz by using the filter of the list and the list navigation as usual. - Find your course or quiz by using the filter of the list and the list navigation as usual.
- Double click on the list entries to get all information about a particular course or quiz. - Double click on the list entries to get all information about a particular course or quiz.
- Once you have found the course or quiz, select it on the list and use the "Import Exam" action on the right action pane. - Once you have found the course or quiz, select it on the list and use the "Import Exam" action on the right action pane.

View file

@ -3,23 +3,10 @@
Monitoring Indicators Monitoring Indicators
===================== =====================
For monitoring connected SEB clients, SEB Server supports some indicators that can be defined within an exam and that are shown and measured during an For monitoring connected SEB clients, SEB server supports some indicators that can be defined within an exam and that are shown and measured during an
exam. When you import, the application automatically creates a default ping-indicator for the exam. You are able to modify this default indicator and also exam. When you import, the application automatically creates a default ping-indicator for the exam. You are able to modify this default indicator and also
add some other indicators to the exam to be able to get notified while monitoring an exam session. add some other indicators to the exam to be able to get notified while monitoring a exam session.
.. image:: images/exam/examIndicators.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examIndicators.png
To add a new indicator to the exam you can use the "Add Indicator" action from the right action pane. In the indicator edit page you are able to give the
new indicator a name. This name will be displayed in the SEB client connection table on monitoring section as column name for the column of this
indicator. Then you are able to choose a "Type" that specifies the type of indicator. Choose this from a drop-down selection of supported indicators.
If you have selected one indicator type, a description will be shown just below the "Type" attribute.
.. image:: images/exam/editIndicator.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/editIndicator.png
The type of indicators are pre-defined within the SEB Server and restricts the number of available indicators that can be used. Currently following The type of indicators are pre-defined within the SEB Server and restricts the number of available indicators that can be used. Currently following
indicators are supported: indicators are supported:
@ -27,27 +14,29 @@ indicators are supported:
This can be used to monitor constant SEB client connections and get notified when a SEB client connection gets lost for some defined This can be used to monitor constant SEB client connections and get notified when a SEB client connection gets lost for some defined
time or when a SEB client connection that has been list is back again. time or when a SEB client connection that has been list is back again.
This indicator is used as default indicator and automatically applied to the exam on import. You are able to modify this indicator This indicator is used as default indicator and automatically applied to the exam on import. You are able to modify this indicator
and also delete it but we recommend to have this basic indicator in place for every exam. and also delete it but we recommend to have this basic indicator in place for every exam.
- **Battery Status**: This indicator measures the battery load of a SEB client that is not connected to the power grid and can warn you
about SEB clients running on devices with low battery load.
- **WiFi Status** This indicator measures the WiFi connection status for connected SEB client that connects over WiFi and can warn you
about low WiFi connection issues.
- **Errors**: This indicator measures the number of error-logs a specified SEB client is sending to the SEB Server. - **Errors**: This indicator measures the number of error-logs a specified SEB client is sending to the SEB Server.
- **Warnings**: This indicator measures the number of warning-logs a specified SEB client is sending to the SEB Server. - **Warnings**: This indicator measures the number of warning-logs a specified SEB client is sending to the SEB Server.
- **Info Log**: This indicator measures if specific SEB client info log events that are sent to SEB Server.
This indicator is mostly useful with addition tag information to specify specially tagged SEB info logs.
You can define a "Default Color" for the indicator. An indicator which measured value has not reached any defines threshold will be shown in this
color on the SEB client connection table of the monitoring section.
You can define thresholds for each indicator. A threshold is defined by an indication-color and by a threshold-value. On the monitoring side, the You can define thresholds for each indicator. A threshold is defined by an indication-color and by a threshold-value. On the monitoring side, the
indicator for each SEB client connection with change to the threshold color when the measured indicator value has reached the threshold-value. indicator for each SEB client connection with change to the threshold color when the measured indicator value has reached the threshold-value.
To add a new indicator to the exam you can use the "Add Indicator" action from the right action pane. In the indicator edit page you are able to give the
new indicator a name. This name will be displayed in the SEB client connection table on monitoring section as column name for the column of this
indicator. Then you are able to choose a "Type" that specifies the type of indicator. Choose this from a drop-down selection of supported indicators.
If you have selected one indicator type, a description will be shown just below the "Type" attribute.
You can define a "Default Color" for the indicator. An indicator which measured value has not reached any defines threshold will be shown in this
color on the SEB client connection table of the monitoring section.
.. note:: .. note::
To select a color click on the brush-palette icon of the color input field to open up a color chooser pop-up window. Within the color chooser To select a color click on the brush-palette icon of the color input field to open up a color chooser pop-up window. Within the color chooser
you can select one of the basic colors provided by the chooser or by defining the red, green and blue part of the color. you can select one of the basic colors provided by the chooser or by defining the red, green and blue part of the color.
.. image:: images/exam/editIndicator.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/editIndicator.png
Below the default color you see a list of thresholds. Use the plus sign icon to add a new threshold to the list and on an existing threshold use Below the default color you see a list of thresholds. Use the plus sign icon to add a new threshold to the list and on an existing threshold use
the minus sign icon to remove a particular threshold form the list. A threshold has a threshold-value and a threshold-color. The threshold value the minus sign icon to remove a particular threshold form the list. A threshold has a threshold-value and a threshold-color. The threshold value
@ -93,5 +82,5 @@ Use Cases
- Use the filter to find the exam on that you have to change the supporter assignments. - Use the filter to find the exam on that you have to change the supporter assignments.
- Double click the list entry of the exam to go to the exam details page. Check if you are on the right exam. - Double click the list entry of the exam to go to the exam details page. Check if you are on the right exam.
- Scroll down to the indicator section of the exam details page and find the indicator you want to delete. - Scroll down to the indicator section of the exam details page and find the indicator you want to delete.
- Select the indicator from the list and use the "Delete Indicator" action from the right action pane to delete the indicator. - Select the indicator from the list ans use the "Delete Indicator" action from the right action pane to delete the indicator.

View file

@ -1,47 +0,0 @@
Exam List
=========
The exam list is shown directly within the "Exam" entry of the "Exam Administration" menu. You will have the usual filter and sort functionality
of lists within SEB Server. You can see exams that are running but has not complete setup yet, marked in read in the list. Additionally you see
Exams that currently has no connection to its origin LMS/Assessment Tool grayed in the list. This exams are not available on the LMS/Assessment Tool either because they didn't
exists anymore on the LMS/Assessment Tool or the SEB Server cannot connect to the LMS/Assessment Tool anymore. As soon as the SEB Server is able to get the LMS/Assessment Tool data again for a
once unreachable exam, the respective exam would change back to normal and is not grayed anymore.
.. image:: images/exam/examList.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examList.png
Sometimes an entire LMS/Assessment Tool is not available and a lot of exams are grayed. In this case you can use the new filter "Show/Hide Missing Exams" from the
action pane on the right to filter out this exams from the list.
.. image:: images/exam/examListHideMissing.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examListHideMissing.png
To get more information about what is missing for an exam that is marked in red, just open the exam by select and use "View Exam" or by double-click
on the list entry. In the Exam view page you will see a warning message pointing out all the missing things to setup the exam.
.. note::
The list in the default filter shows you all exams except the archived ones. If you want to show the archived exams you can use the status
filter and choose "Archived" from the combo selection. If you want to show all active exams again, you can choose "All" in the status filter.
Exam Batch Actions
------------------
Since SEB Server version 1.5 there are two new batch action for exams within the exam list page for archiving and deleting exams in a batch.
As usual for batch actions you can select multiple exam list entries while also page through the list. After you have selected all exams that
you want to archive or delete, select the respective batch action on the right action pane to open the batch action pop-up.
.. image:: images/exam/examBatchArchive.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examBatchArchive.png
You see your selection again within a list on the pop-up and when ready you can start the batch action and apply it to every selected exam
that is in a valid state to apply the action.
.. note::
For batch-action the same validation is done like for the single action delete and archive. Archive of an exam is only possible if it
is not currently running but finished or up-coming. Delete is always possible and you have to be carefully while deleting exams in batch.
After you have started the batch-action the result pop-up of the batch-action will show you the progress and how many has been processed and
also how many as failed due to invalid state for batch-action or due to an error.

88
docs/exam_proctoring.rst Normal file
View file

@ -0,0 +1,88 @@
.. _sebProctoringSettings-label:
Live Proctoring
===============
Live proctoring is a new and yet experimental feature of SEB and SEB Server. The main goal of the live proctoring feature is to support the integration
of an external meeting service like Jitsi Meet or Zoom for example, within a SEB and SEB Server setup for an exam.
In this scenario a SEB client is able to join a meeting and send audio and video data to the meeting where a proctor can watch the students during
an exam within this meeting(s). The role of SEB Server in this scenario is mainly to bind a particular meeting service and automatically create
meeting rooms, instruct connected SEB clients to join a certain meeting room. SEB Server can also instruct SEB clients to participate in the meeting by
allowing connected SEB clients to receive audio and video as well as enabling chat functionality.
.. note::
This feature is still in a prototype state and not all functionality meight work as expected. Basically the meeting features
are given or restricted by the meeting service that is used and the API and GUI that is given by that meeting service client
To be able to use the integrated live proctoring feature with SEB and SEB Server you need an external meeting service that can be used by the SEB Server to automatically create meetings.
If this feature is enabled, you are able to setup a live proctoring service for a specified exam that can be used in the monitoring later on while the exam is running and SEB clients are connected.
Currently supported meeting services are:
- `Jitsi Meet <https://jitsi.org/jitsi-meet/>`_ with JWT token authentication enabled.
- `Zoom meeting service <https://zoom.us/>`_ with an account plan that fits your need and supports the `Zoom API and Client SDKs <https://marketplace.zoom.us/docs/sdk/native-sdks/developer-accounts>`_.
To bind and setup a live proctoring service in SEB Server for an exam, go to the view page of the exam and use the "Proctoring Settings" action on the right action pain to open up the proctoring settings dialog.
.. image:: images/exam/proctoringSettings.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/proctoringSettings.png
Within the proctoring settings dialog you are able switch the service on and off by using the "Proctoring enabled" checkbox. You also see if the proctoring service is enabled within
the action icon that is either an eye when active or a slashed eye when not active.
To define and bind a service you have to chose a service type from the available service types. And you need to give the API access credentials like "Application Key" and "Secret" for
the external meeting service. SEB Server will then try to connect to the meeting service with these credentials to automatically create meetings/rooms for proctoring.
Within the "Collecting Room Size" field you can define the number of maximal participants that shall be collected within one proctoring room. SEB Server will automatically
create these collecting rooms while SEB clients are connecting to the running exam in the monitoring view.
After you have all the settings set, use "OK" to confirm the settings. SEB Server will then try to connect to the meeting service with the given settings and check the access.
The SEB client settings for proctoring can be found in the "Exam Configuration" "SEB Settings". There is a new tab with the name "Proctoring" where all SEB settings for proctoring are available.
These settings are directly used by a SEB client that supports the proctoring feature. SEB will initialize with this settings when connecting to SEB Server and also will use this settings as default settings during an exam.
.. image:: images/exam/proctoringSEBSettings.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/proctoringSEBSettings.png
Since SEB Server version 1.2 there is also an Zoom service section that let you define the default SEB settings for a Zoom proctoring setup.
Please be aware that not all of the settings are functioning yet. Please refer to the the settings tooltip to get a actual description of
a particular SEB feature setting
**Jitsi Meet***
To setup and configure a Jitsi Meet service for testing you can refer to the `Docker installation documentation <https://jitsi.github.io/handbook/docs/devops-guide/devops-guide-docker>`_
.. note::
The Jitsi Meet integration works only with JWT authentication. Please refer to the above documentation for how to setup JWT authentication.
**Zoom**
To integrate Zoom meetings as a live proctoring service within SEB Server you need to have an appropriate Zoom account with API and SDK access.
`Zoom API and Client SDKs <https://marketplace.zoom.us/docs/sdk/native-sdks/developer-accounts>`_.
Then you need to setup the Zoom account to run with JWT apps as described:
- Login into your Zoom account and use "App Marketplace" to setup an API app account
.. image:: images/exam/zoom1.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/zoom1.png
- Within the Zoom Marketplace use "Develop" and select "Build App".
.. image:: images/exam/zoom2.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/zoom2.png
- Choose either JWT or SDK or both if needed for exams with different SEB clients
.. image:: images/exam/zoom3.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/zoom3.png
- Follow the instructions to create the API account and use the "App Key" and "App Secret" or SDK Key and SDK Secret within the setup in SEB Server
.. image:: images/exam/zoom4.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/zoom4.png

View file

@ -1,42 +0,0 @@
.. _sebExamQuitPassword-label:
Exam Quit Password (New)
========================
Since SEB Server Version 1.6 it is possible to set the quit-password (usually set in the Exam Configuration/SEB Settings) while
creating or importing an Exam as well as for an existing exam. This is convenient if you want to use a different quit password for each exam
and when using Exam Templates to create Exams.
The quit password within the exam corresponds with the quit-password of an applied Exam Configuration. Thies means, if you change the
password on either site, it will be reflected on the other site. And, in the case a new Exam Configuration is applied an already set
quit password in Exam will have prior order against the a quit password set in the Exam Configuration. In any case the there
is no different quit password in the Exam Configuration then in the Exam. SEB Server guarantees that the quit password is always synchronized
within the following rules:
- Exam has no Exam Configuration but defines the quit password
- An Exam Configuration that is applied to the Exam will get the quit password from the Exam in the SEB Settings.
- An Exam Configuration that already has a quit password set and gets applied to the Exam will also get the quit password from the Exam with notify the user about the change.
- Exam has no Exam Configuration and no quit password set
- The Exam will get the quit password from the Exam Configuration if the Exam Configuration has defined such
- Quit Password is changed in the Exam edit view
- On save of the exam the applied Exam Configuration also gets the new quit-password
- Quit Password is changed in the Exam Configuration SEB Settings
- On Save / Publish of the Exam Configuration SEB Settings, an applied Exam will get the newly set quit password from the configuration
The quit password can be set on Exam creation or import:
.. image:: images/exam/quitPasswordImport.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/quitPasswordImport.png
As well as in the Exam edit view:
.. image:: images/exam/quitPasswordEdit.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/quitPasswordEdit.png
If the Exam was created from an LMS/Assessment Tool with SEB Server integration that allows to send the quit-password
to the LMS/Assessment Tool for display, SEB Server sends a new quit-password as on save. The LMS/Assessment Tool should
therefore also display always the actual quit password.

View file

@ -3,7 +3,7 @@
Automated SEB Restriction Automated SEB Restriction
========================= =========================
If the corresponding LMS/Assessment Tool of an exam supports the automated SEB restriction feature, the SEB restriction can be managed within the exam details page. If the corresponding LMS of an exam supports the automated SEB restriction feature, the SEB restriction can be managed within the exam details page.
To navigate to the exam details page of an exam go to the "Exam" page under the "Exam Administration", find the specified exam in the list by using To navigate to the exam details page of an exam go to the "Exam" page under the "Exam Administration", find the specified exam in the list by using
the list filter and double click on the list entry of the exam you want to open the details page. the list filter and double click on the list entry of the exam you want to open the details page.
@ -11,35 +11,35 @@ In the exam details page you will see two action related to the SEB restriction
.. image:: images/exam/sebRestriction.png .. image:: images/exam/sebRestriction.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/sebRestriction.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/sebRestriction.png
Use the "Apply SEB Lock" on an exam that has not already locked the course for SEB on the LMS/Assessment Tool to do apply the restriction and lock the course or quiz Use the "Apply SEB Lock" on an exam that has not already locked the course for SEB on the LMS to do apply the restriction and lock the course or quiz
for SEB access only. This will call the SEB course restriction API on the LMS/Assessment Tool and will send all information to lock the course on the LMS/Assessment Tool. for SEB access only. This will call the SEB course restriction API on the LMS and will send all information to lock the course on the LMS.
On an exam where the restriction lock is already in place, use the "Release SEB Lock" action to remove the restriction in the LMS/Assessment Tool and unlock the course. On an exam where the restriction lock is already in place, use the "Release SEB Lock" action to remove the restriction in the LMS and unlock the course.
.. note:: .. note::
If the exam is already running on import the system will automatically restrict the course on the LMS/Assessment Tool with the available restriction details. If the exam is already running on import the system will automatically restrict the course on the LMS with the available restriction details.
Use the "SEB Restriction Details" action to open up a dialog to define all SEB restriction details that the LMS/Assessment Tool of the exam and its SEB course Use the "SEB Restriction Details" action to open up a dialog to define all SEB restriction details that the LMS of the exam and its SEB course
restriction API is supporting. There are two global restriction details that are SEB specific and should be supported by every LMS/Assessment Tool that serves restriction API is supporting. There are two global restriction details that are SEB specific and should be supported by every LMS that serves
a course restriction API for SEB. The `Config Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ and the `Browser Exam Key <https://safeexambrowser.org/developer/documents/SEB-Specification-BrowserExamKey.pdf>`_. a course restriction API for SEB. The `Config Key <https://safeexambrowser.org/developer/seb-config-key.html>`_ and the `Browser Exam Key <https://safeexambrowser.org/developer/documents/SEB-Specification-BrowserExamKey.pdf>`_.
The Config Key is automatically generated by the exam configuration that is applied to the exam. And the Browser Exam Key can be applied within a The Config Key is automatically generated by the exam configuration that is applied to the exam. And the Browser Exam Key can be applied within a
comma separated list if needed. comma separated list if needed.
.. image:: images/exam/sebRestrictionDetails.png .. image:: images/exam/sebRestrictionDetails.png
:align: center :align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/sebRestrictionDetails.png :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/sebRestrictionDetails.png
**SEB restriction on Open edX** **SEB restriction on Open edX**
To be able to use the SEB restriction feature with an Open edX LMS/Assessment Tool, you need to install the `SEB Open edX plugin <https://seb-openedx.readthedocs.io/en/latest/index.html>`_ To be able to use the SEB restriction feature with a Open edX LMS, you need to install the `SEB Open edX plugin <https://seb-openedx.readthedocs.io/en/latest/index.html>`_
from eduNEXT. Please consult the documentation for installing the `SEB Open edX plugin <https://seb-openedx.readthedocs.io/en/latest/index.html>`_ as well as for the from eduNEXT. Please consult the documentation for installing the `SEB Open edX plugin <https://seb-openedx.readthedocs.io/en/latest/index.html>`_ as well as for the
use of all additional supported restriction attributes. use of all additional supported restriction attributes.
.. note:: .. note::
If you change the attached exam configuration either by changing the attachment or by changing the attributes of a attached exam configuration If you change the attached exam configuration either by changing the attachment or by changing the attributes of a attached exam configuration
for an exam that has the SEB restriction in place, the Config Key generated from the exam config that is also changing, will automatically be for an exam that has the SEB restriction in place, the Config Key generated from the exam config that is also changing, will automatically be
updated on the LMS/Assessment Tool. Therefore such an action that triggers an update may take some more time to complete as when the restriction is not in place. updated on the LMS. Therefore such an action that triggers an update may take some more time to complete as when the restriction is not in place.
Use Cases Use Cases
@ -53,7 +53,7 @@ Use Cases
- Use the "SEB Restriction Details" action from the right action pane to open the restriction details dialog. - Use the "SEB Restriction Details" action from the right action pane to open the restriction details dialog.
- In the restriction details dialog you will see all supported restriction attributes and you can define the restriction for your needs. - In the restriction details dialog you will see all supported restriction attributes and you can define the restriction for your needs.
- To apply the new restriction details use the "OK" action of the dialog or use the "Cancel" action to abort and close the dialog. - To apply the new restriction details use the "OK" action of the dialog or use the "Cancel" action to abort and close the dialog.
- When the SEB restriction is active on the LMS/Assessment Tool, the system will automatically update the SEB restriction with the new details on the LMS/Assessment Tool. - When the SEB restriction is active on the LMS, the system will automatically update the SEB restriction with the new details on the LMS.
- If the SEB restriction is not active in this moment, the details will be saved and applied when the restriction is activated. - If the SEB restriction is not active in this moment, the details will be saved and applied when the restriction is activated.
@ -62,9 +62,9 @@ Use Cases
- Login as an exam administrator and go to the "Exam" page under the "Exam Administration" section. - Login as an exam administrator and go to the "Exam" page under the "Exam Administration" section.
- Use the filter to find the exam on that you have to change the supporter assignments. - Use the filter to find the exam on that you have to change the supporter assignments.
- Double click the list entry of the exam to go to the exam details page. Check if you are on the right exam. - Double click the list entry of the exam to go to the exam details page. Check if you are on the right exam.
- Use the "Apply SEB Lock" action from the right action pane to activate the SEB restriction lock for this course on the LMS/Assessment Tool. - Use the "Apply SEB Lock" action from the right action pane to activate the SEB restriction lock for this course on the LMS.
- Use the "Release SEB Lock" action from the right action pane to deactivate the SEB restriction lock for this course on the LMS/Assessment Tool. - Use the "Release SEB Lock" action from the right action pane to deactivate the SEB restriction lock for this course on the LMS.
.. note:: .. note::
If a SEB restriction lock is active on the LMS/Assessment Tool, every change on the exam or related components that will affect a change on the restriction If a SEB restriction lock is active on the LMS, every change on the exam or related components that will affect a change on the restriction
details will automatically be updated on the LMS/Assessment Tool. You don't have to apply the SEB restriction lock again for update. details will automatically be updated on the LMS. You don't have to apply the SEB restriction lock again for update.

View file

@ -1,129 +0,0 @@
.. _exam-template-label:
Exam Template
==================
Overview
--------
Exam templates are a new, useful feature available since SEB Server version 1.3. Within exam templates it is possible to create specific named templates that can be
used by an exam import from LMS/Assessment Tool course/quiz and define default settings and indicators that are automatically be applied on the exam import.
Furthermore, exam templates gives you the possibility to map exam configuration template to automatically create and map an exam configuration for an exam on import.
This is very convenient if you have a lot of exams to set up that all have the same or similar settings. In such a case you can create an exam template
with all the common settings for that exams and use it on exam import.
Exam templates can be created and managed just like other SEB Server documents within its list/library. The list can be filtered by name and type of the exam template
and also shows which one is the default for the institution.
.. image:: images/exam_template/list.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_template/list.png
.. note::
The "Default Template" flag indicates the one exam template that is the default template for an institution. This just means that this template
is preselected on the exam import if it exists.
Create new Exam Template
------------------------
To create a new exam template please use the "Add Exam Template" action on the right action pane in the "Exam Template" list view.
SEB Server will then present you the exam template creation view on that some initial settings can be made.
.. image:: images/exam_template/new.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_template/new.png
- **Name** The name of the exam template to identify it in the list/library
- **Description** A short description ideally describing the purpose of the exam template
- **Institutional Default** This flag indicated if the exam template shall become the default exam template for the institution.
- **Exam Type** Here you can set the exam type that shall be used when an exam is imported within this template
- **Configuration Template** Select an existing exam configuration template. This template will be used to automatically create and map an exam configuration for an exam that is imported with this template
- **Exam Supporter** Add a list of available exam supporter to the template. These exam supporter will then be assigned to an exam that is imported with this template
After having done all the initial settings, the exam template can be created by saving the settings. SEB Server will then present you the exam template administration
view that looks similar to the exam administration view.
.. image:: images/exam_template/view.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_template/view.png
Here you can edit the settings done before by using the "Edit Exam Template" action form the right action pane.
You can also delete an exam template entirely by using the "Delete Exam Template" action from the right action pane.
And you are able to add/edit/remove monitoring indicators for the exam template just like you would do for exams in the exam administration view.
.. image:: images/exam_template/indicator.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_template/indicator.png
TODO Screen Proctoring Settings
Import Exam with Template
-------------------------
Once one or more exam template exists, you are able to select one while importing an exam from the LMS/Assessment Tool in the "LMS/Assessment Tool Exam Lookup" section. Just as usual
use the "Import as Exam" action for a LMS/Assessment Tool exam that you want to import.
.. image:: images/exam_template/select1.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam_template/select1.png
Now there is a new selector field named "Exam Template" where you can choose the exam template to use on import. When you select one the template attributes
like "Exam Type" or "Exam Supporter" are automatically applied from the template settings. You are still able to edit the settings e.g. add more or remove supporter.
If all settings are correct, use the "Save Exam" action from the right action pane to finish up the import. On this step, if the template defines some indicators,
this indicators are automatically be created and applied for the exam. The same applies to an exam configuration template that is defined by the exam template, a
new Exam Configuration is automatically created by the system from that configuration template and the new exam configuration is applied to the exam.
.. note::
When an Exam Configuration is automatically be created during an exam import with template, the name for that new Exam Configuration is dynamically
generated with the current date and the name of the exam. Also an appropriate description for the Exam Configuration is generated.
It is surely possible to just change the name or description of the generated Exam Configuration afterwards.
After successful exam import you see the exam administration view just as usual but with auto generated configuration and indicators from the template.
After import you can modify the exam setup as usual by changing, removing or adding settings or indicators to the exam. This will not have any effect to the selected exam template
that is only used and applied within the import process at the moment. But the exam template that has been used on import is always been shown on the exam
overview as a reference.
.. note::
A Change in a template is not reflected within already existing exams that used that template on import.
But it will affect all future exams that use this template on import.
Use Cases
---------
**Create an Exam Template for Exams of type XY**
As an Exam Administrator you want to create an exam template that can be used as template for all exams of type XY that are conducted with SEB and SEB Server within your institution.
Since all exams of type XY has the same setup and almost the same settings, the SEB Exam Configuration differ only in some settings, this would be
a of great help while shorten the setup process and reduces the work that must be done to setup such an exam of type XY later on.
- Preparation: `Create a Configuration Template <https://seb-server.readthedocs.io/en/latest/config_template.html#config-template-label>`_ that can later be used with the Exam Template.
- Sign in as an Exam Administrator and select the "Exam Template" sub-menu of the "Exam Administration" section in the left menu pane.
- Here you can see the already existing Exam Template within the usual list.
- Use the "Add Exam Template" action to create a new exam template. SEB Server will then present you template initialization form just like the one for importing an exam.
- Here you can give a common name and useful description to identify the new exam template afterwards.
- Also select a type tag and add exam supporter to the template that will be applied to an exam that is imported with this exam later on.
- Now select the previously prepared "Configuration Template" that shall be used by this template. On import of an exam with this template, SEB Server will automatically create a Exam Configuration out of this template and assign it to the imported exam.
- After all initial settings are made correctly you can save the exam template with the "Save" action on the right action pane.
- Add additional indicators to the exam template just like you do in a usual exam administration. These indicators will be copied and applied to an exam that is imported with this template.
- You can change the initial settings any-time by edit the exam template. Use the "Edit" action form the right action pane to do so.
**Use an existing Exam Template on Exam import**
- Sign in as an Exam Administrator and select the "LMS/Assessment Tool Exam Lookup" sub-menu of the "Exam Administration" section in the left menu pane.
- Here you can see all exams form the LMS/Assessment Tool that are bound to the SEB Server. Select the specific exam that you want to import.
- Use "Import as Exam" from the right action pane to import that exam from the LMS/Assessment Tool as usual.
- In the exam import initialization step you now have a new selector to select an Exam Template that shall be applied.
- If there is a default Exam Template defined for the institution, this is pre-selected and already applied. If not you have to select the template of your choice.
- By selecting an Exam Template the template attributes are already applied and you see the respective attributes in the exam settings.
- Now you can still change the settings the shall differ to the one from the template.
- While saving the exam, the import will be finished up. SEB Server creates a new exam configuration from the defined configuration template and map it to the exam as well as applying the indicators and the rest of the settings defined within the template.

View file

@ -1,30 +0,0 @@
Exam Test-Run (New)
--------------------------------
With the new SEB Server version 2.0 there is a new feature Test-Run for none running / upcoming exams. Since upcoming
Exams on SEB Server are not available for SEB connections and Monitoring one have to has to change the course start date
to apply testing beforehand of an Exam.Server
With new new Rest-Run feature it is now possible to change an Exam in upcoming status to a dedicated Test-Run status where
SEB clients are able to connect and SEB Server Exam Administrator or Supporter are able to Monitor the Exam as long a
the Exam stays within this Test-Run status.
You can set an Exam into Test-Run status by using the respective action on the Exam view:
.. image:: images/exam/examEnableTestrun.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examEnableTestrun.png
After enable Test-Run for an Exam, you can see an information at the top if the Exam view that informs you about the
Test Run status of the Exam.
After testing is done you can disable the Test-Run status just by using the respective action on the right and the Exam
goes back to up-coming status and is not available anymore for SEB connections and Monitoring.
.. image:: images/exam/examEnableTestrun.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examEnableTestrun.png
.. note::
If an Exam changes to Running status due to the start time passing and is still in status Test-Run, SEB Sever will
automatically change the Exam from Test-Run to Running status and all features of a running Exam are available.

View file

@ -1,69 +0,0 @@
.. _sebExamWithURL-label:
Exam With URL (New)
========================
This is a new feature since SEB Server Version 1.6 and allows to create SEB Server Exams without the need of a
dedicated LMS/Assessment Tool integration but by providing an course URL, start- and end-type by its own.
SEB will then the given URL use as a start URL and just forward to the given URL page as usual. This of course has
some limitations in comparison to a Exam with LMS/Assessment Tool integration that are described at the end of
this chapter.
To create a new Exam with URL please select the Exam tab on the left menu pane and the "Add Exam with URL" Action
on the right action pane. Click on the action to open the creation view. This is the same view as on Exam import
put with some fields you have to provide instead of they coming from LMS/Assessment Tool.
.. image:: images/exam/examWithURL.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examWithURL.png
.. image:: images/exam/examWithURLNew.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examWithURLNew.png
You are now able to either choose an existing :ref:`exam-template-label` to initialize the new exam with the settings defined within the template
or to set the needed settings only for this exam. If you choose a template, the settings from the template will automatically be added to the exam
on creation and you are still able to modify them afterwards.
For this kind of Exam you also have to provide additional data that usually comes from LMS/Assessment Tool.
- The name of the Exam - mandatory
- A description of the Exam - optional
- The start date and time of the Exam - mandatory
- The end date and time of the Exam - optional
Initially also choose a type for the exam - "Exam Type" - that is currently only used for informational purpose and has no further restrictions or consequences on handling on in SEB Server.
Furthermore you can select and apply all exam supporter that shall be able to see and support this exam while running. To do so, click in the
input field of the attribute "Exam Supporter" to see a drop down list of all available users for selection. To filter the drop down list, start
typing characters of the name of the user-account you want to apply to automatically filter the list. Click on the drop-down list entry to select the
specified user that will be added to the list below the input field. To add another user to the selection just click again into the input field
and select another user. To remove a selected user from the selection-list, double-click on the specified entry of the selection-list.
To finally create the new Exam use the save action from the right action pane. New you are in the usual Exam view and can
go one with setting up your Exam.
.. image:: images/exam/examWithURLView.png
:align: center
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/dev-2.0/docs/images/exam/examWithURLView.png
If you want to edit the Exam settings please use the edit action on the right action pane. Here you can also modify
the data that usually comes from LMS/Assessment Tool. You can change name, start- and end-date directly here within
the Exam on the SEB Server.
**Restrictions**
There are a few restrictions for an Exam with URL. First of all, since there os no LMS/Assessment Tool binding available,
SEB Server cannot call an LMS/Assessment Tool and restrict access for SEB only with either Config Key or Browser Exam key.
If an LMS/Assessment Tool supports such, one is of course be able to put the Config Key from SEB Server to the LMS manually
by copy und past it.
The other restriction is about the student login name resolving that is used and shown in the monitoring view of SEB Server.
Since this login name resolving needs a LMS/Assessment Tool binding to request the students LMS account name by SEB Server
this is not possible with this setup. But SEB Server will display other information within the User Name or Session column
of the SEB Server monitoring. SEB Server will show either the client IP address or the client machine name or the client
user device login, depending on what SEB is able to sends to the SEB Server.

View file

@ -1,28 +1,19 @@
Exams Exams
===== =====
Within an exam in SEB Server all threads come together to set up a e-assessment with Safe Exam Browser and SEB Server. An exam can be imported Within an exam in SEB server all threads come together to set up a e-assessment with Safe Exam Browser and SEB Server. An exam can be imported
from a course that exists on an LMS/Assessment Tool that was bound with a LMS/Assessment Tool Setup. An exam configuration that was formerly created can be attached to the exam by from a course that exists on an LMS that was binded with a LMS Setup. An exam configuration that was formerly created can be attached to the exam by
choosing one from the library. Indicators can be defined that are shown in the monitoring section while monitoring a running exam. And if choosing one from the library. Indicators can be defined that are shown in the monitoring section while monitoring a running exam. And if
the API of the specified LMS/Assessment Tool integration supports individual SEB restriction attributes for a e-assessment, this can also be defined and managed the API of the specified LMS integration supports individual SEB restriction attributes for a e-assessment, this can also be defined and managed
on the exam management of SEB Server. on the exam management of SEB Server.
We will go through all the steps to setting up an exam for Safe Exam Browser with SEB Server one by one. We will go through all the steps to setting up an exam for Safe Exam Browser with SEB Server one by one.
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
exam_import exam_import
exam_with_url
exam exam
exam_quit_password
exam_indicator exam_indicator
exam_clientgroups
exam_ask
exam_restriction exam_restriction
exam_screen_proctoring exam_proctoring
exam_list
exam_template
exam_testrun
screen_proctoring

Binary file not shown.

Before

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 83 KiB

After

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 63 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 75 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 85 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 75 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 57 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 75 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 84 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 76 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 99 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 96 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 86 KiB

After

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 84 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 75 KiB

After

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 105 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 49 KiB

BIN
docs/images/exam/zoom1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB

BIN
docs/images/exam/zoom2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 192 KiB

BIN
docs/images/exam/zoom3.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 102 KiB

BIN
docs/images/exam/zoom4.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 53 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 78 KiB

After

Width:  |  Height:  |  Size: 53 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 69 KiB

After

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 78 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 78 KiB

After

Width:  |  Height:  |  Size: 94 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 61 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 27 KiB

Some files were not shown because too many files have changed in this diff Show more