SEB
Safe Exam Browser

Configuring SEB

Configuration files

There are two configuration files for SEB: Seb.ini and MsgHook.ini, both of them are located in the folder SEB.

Seb.ini is the main configuration file. Below is a working example.

HOOK_DLL=MsgHook.dll

MESSAGE_HOOK=1

EDIT_REGISTRY=0

REG_DISABLE_LOCK_WORKSTATION=0

REG_DISABLE_TASKMGR=0

REG_DISABLE_CHANGE_PASSWORD=0

REG_NO_CLOSE=0

REG_NO_LOGOFF=0

WIN9X_KILL_EXPLORER=1

WIN9X_SCREENSAVERRUNNING=0

NEW_DESKTOP=1

SHOW_WINKEYOX=0

STRONG_KILL_PROCESSES_BEFORE=firefox.exe

STRONG_KILL_PROCESSES_AFTER=firefox.exe

PROCESSES=Seb,SebFirefox/firefox.exe -profile SebFirefox/profile -chrome chrome://kiox/content/

AUTOSTART_PROCESS=Seb

SHUTDOWN_AFTER_AUTOSTART_PROCESS_TERMINATES=0

PROC_MONITORING=1


A Seb-Process is defined and started automatically (see PROCESSES and AUTOSTART_PROCESS).

SHOW_WINKEYOX=1

PROCESSES=Seb,SebFirefox/firefox.exe -profile SebFirefox/profile -chrome chrome://kiox/content/;Calc,calculator.exe


You can run SEB together with other applications, i.e. the calculator. In this case enable the application-chooser-window (set SHOW-WINKEYOX to 1) and add these external applications to PROCESSES after the Seb-entry. They must have the form [application1, path-to-application1/application1-name;application2,path-to-application2/application2-name;application3, path-to-application3/application3-name]. The applications are separeted by semicolon.

PROC_MONITORING=1


If PROC_MONITORING is enabled, all the running applications/processes are monitored. If someone tries to start an application that is not allowed (no entry in PROCESSES), this application is stopped. You can disable this behaviour (set PROC_MONITORING to 0).

MESSAGE_HOOK=1


If MESSAGE_HOOK is enabled, SEB catches shortcuts like Ctrl + Alt + Del or the right-mouse-click. In MsgHook.ini you can configure in more detail which shortcuts are allowed.


MsgHook.ini configures the message hooks. In this file you can define, how SEB interacts with the users.

DISABLE_CTRL_ESC=1

DISABLE_ALT_TAB=1

DISABLE_ALT_ESC=1

DISABLE_ALT_F4=1

DISABLE_START_MENU=1

DISABLE_RIGHT_MOUSE=1

DISABLE_F1=1

DISABLE_F2=1

DISABLE_F3=1

DISABLE_F4=1

DISABLE_F5=1

DISABLE_F6=1

DISABLE_F7=1

DISABLE_F8=1

DISABLE_F9=1

DISABLE_F10=1

DISABLE_F11=1

DISABLE_F12=1

DISABLE_ESCAPE=1

KILL_CALLER_HOTKEY=Winkeyox


In the example above, all the shortkeys are disabled (set to 1). That means that with this configuration, no shortkeys are allowed.

One exception is the SEB exit sequence, which allows for finishing the SEB at any point of time. It is a combination of three function keys which must be pressed in a certain order and then held down simultaneously (just like Ctrl + Alt + Del for starting the Windows Task Manager). By default, the SEB exit sequence is set to F3 + F11 + F6, which means the user must press and hold down the three function keys F3, F11, F6 in this exact order.

The SEB exit sequence can be customized in MsgHook.ini by setting the variables B1, B2 and B3. The function keys F1, F2, ..., F12 are coded as decimal values ("virtual key codes") according to the following table:

Function key Code
F1 112
F2 113
F3 114
F4 115
F5 116
F6 117
F7 118
F8 119
F9 120
F10 121
F11 122
F12 123

If we now set the variable B1 to 115:

B1=115

the first function key to be pressed changes from F3 to F4, since we changed the first variable B1, and 115 is the decimal value for the virtual key code for F4. Since we did not change B2 and B3, the second and third function key are left intact, so in summary the SEB exit sequence changes from the default sequence F3 + F11 + F6 to the custom sequence F4 + F11 + F6. With B2 and B3 you can change the other two function keys of the SEB exit sequence as well, for example the values

B1=115

B2=116

B3=117

will explicitly set the SEB exit sequence to F4 + F5 + F6.

Remark: If you want to admit third-party applications in SEB, you have to admit the shortkey Alt + Tab by setting

DISABLE_ALT_TAB=0

in MsgHook.ini, as well as setting

SHOW_WINKEYOX=1

in Seb.ini. In SEB, you must then press Alt + Tab, which will launch the Winkeyox popup window, from which you can choose the desired third-party application.


Connect between browser and test

When you start SEB the sourceforge site gets launched (default). To change the start URL of SEB you can open the folder SEB>SebFirefox and then double click on start-firefox.bat. Please note: The browser Firefox need to be closed first.

Fill in the URL to the LMS installation or a direct Link to the test, click OK and then close the window.

Get Safe Exam Browser at SourceForge.net. Fast, secure and Free Open Source software downloads