client configuration doku
This commit is contained in:
anhefti
parent
4e3fa44b49
commit
807ee5c092
3 changed files with 72 additions and 25 deletions
|
|
@ -29,12 +29,39 @@ of the "Configuration" section on the menu on the left hand side.
|
|||
.. image:: images/client_config/list.png
|
||||
:align: center
|
||||
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/client_config/list.png
|
||||
|
||||
The list shows the name, the date of creation and the status of the client 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 client 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
|
||||
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 Client 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.
|
||||
|
||||
.. image:: images/client_config/new.png
|
||||
:align: center
|
||||
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/client_config/new.png
|
||||
|
||||
Short description of all attributes of a Client Configuration:
|
||||
|
||||
- **Name**: The name of the Client Configuration used to maintain client 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".
|
||||
**Starting an Exam**; Will cause SEB to use this Client Configuration settings on startup but won't change local SEB settings.
|
||||
**Configuring a Client**; Will cause SEB to use this Client Configuration settings and also save it as local SEB settings.
|
||||
- **Configuration Password**: Used to encrypt the Client Configuration with a password. A SEB client will prompt this password while loading a password protected Client Configuration.
|
||||
- **With Fallback**: Select this to see and define a fallback strategy for SEB clients using this Client 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.
|
||||
- **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.
|
||||
- **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.
|
||||
- **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 Client 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.
|
||||
|
||||
.. note::
|
||||
A fallback only comes on action when SEB client is within the connection process 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
|
||||
when the SEB Server connection is (temporarily) unavailable.
|
||||
|
||||
|
|
@ -57,35 +84,54 @@ configuration settings in the following ways:
|
|||
- Client Configuration with "Starting an Exam" setting and fallback strategy:
|
||||
Show warning with options "retry", "fallback" (load Fallback URL) and "quit".
|
||||
|
||||
The image below shows the Client 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.
|
||||
|
||||
.. image:: images/client_config/new.png
|
||||
:align: center
|
||||
:target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/client_config/new.png
|
||||
|
||||
Short description of all attributes of a Client Configuration:
|
||||
|
||||
- Name: The name of the Client Configuration used to maintain client 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".
|
||||
Starting an Exam; Will cause SEB to use this Client Configuration settings on startup but won't change local SEB settings.
|
||||
Configuring a Client; Will cause SEB to use this Client Configuration settings and also save it as local SEB settings.
|
||||
- Configuration Password: Used to encrypt the Client Configuration with a password. A SEB client will prompt this password while loading a password protected Client Configuration.
|
||||
- With Fallback: Select this to see and define a fallback strategy for SEB clients using this Client 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.
|
||||
- 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.
|
||||
- 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.
|
||||
- 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.
|
||||
|
||||
Use Cases
|
||||
---------
|
||||
|
||||
**Create Client Configuration**
|
||||
|
||||
**Activate / Deactivate Client Configuration**
|
||||
As an Institutional Administrator one should create a new secure Client Configuration for the upcoming semester. The setup shall operate with
|
||||
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.
|
||||
|
||||
**Create secure Client Configuration with fallback strategy**
|
||||
- Sign in as an Institutional Administrator and select the "Client Configuration" sub-menu of the "SEB Configuration" main-menu on the left.
|
||||
- Use the "Add Client Configuration" on the right action pane to create a new Client Configuration.
|
||||
- Give the new Client Configuration a name that not already exists and select "Start an Exam" for "Configuration Purpose".
|
||||
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 Client 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.
|
||||
- Define a fallback URL that will be used by a SEB client as start URL in the fallback case.
|
||||
- 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.
|
||||
- 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 Client Configuration" action on the right action pane to save the new Client Configuration.
|
||||
- Now the new Client Configuration is created but not active for now and therefore cannot be exported yet.
|
||||
|
||||
**Activate and export Client Configuration**
|
||||
|
||||
A Client 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 Client 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 "Client 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 Client Configuration.
|
||||
- Double-click on the list entry or use the "View Client Configuration" action on the right for a selected list row, to show the details of a
|
||||
specific Client configuration.
|
||||
- Then either on the list or in the view mode of the form, use the "Activate Client Configuration" action on the right action pane to activate the Client Configuration
|
||||
- Now there is a "Export Client Configuration" action in the detail view of the Client Configuration. Use the "Export Client Configuration" action
|
||||
to start a download dialog. Choose "Save As" and download the file with the name "SEBClientSettings.seb".
|
||||
- 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.
|
||||
|
||||
**Deactivate a Client Configuration**
|
||||
|
||||
The semester has ended and for security reasons we don't want that SEB clients with a Client Configuration for the ended semester
|
||||
are able to connect to SEB Server anymore. For this we just have to deactivate the Client Configuration for that semester. A SEB client
|
||||
that connects with this Client Configuration will then receive an HTTP 401 Unauthorized response.
|
||||
|
||||
- Sign in as an Institutional Administrator and select the "Client 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 Client Configuration and select the row of this Client Configuration.
|
||||
- Now use the "Deactivate Client Configuration" action from the right action pane to deactivate the Client Configuration.
|
||||
- The Client Configuration is now deactivates und SEB client using this Client Configuration are not able to connect to SEB Server anymore.
|
||||
|
||||
**Export Client Configuration**
|
||||
|
|
|
|||
Binary file not shown.
|
Before Width: | Height: | Size: 48 KiB After Width: | Height: | Size: 48 KiB |
|
|
@ -103,6 +103,7 @@ On the current version, e-mail confirmation is not a feature of the SEB Server a
|
|||
|
||||
With the "Time Zone" one can choose a specific time zone for an user-account. All dates and times will then be showed within this specific time zone to the user.
|
||||
|
||||
.. _gui-label:
|
||||
|
||||
Graphical User Interface
|
||||
------------------------
|
||||
|
|
|
|||
Loading…
Reference in a new issue