Skip to content

WAM Custom Configuration Values

Professor Colin Turner edited this page Nov 21, 2025 · 1 revision

WAM Custom Configuration Values

There are a few configuration values that an installer may wish to tweak. You will find a reference for these here. Please note that rather than editing these in settings.py place them in local_settings.py in the same directory. These will override any global configuration, and more importantly this will prevent them being overwritten by new versions.

SECRET_KEY

This is a Django configuration variable. It's important you set it to anything that is different from the default installation for a production environment.

WAM_AUTO_EMAIL_FROM

Default: "[email protected]"

This email address will be used as the sender of automated emails from the system.

WAM_ADFS_AUTH

Default: False

Setting this to True will cause WAM to load urls and other functionality to enable Azure Authentication. You should (carefully) read the documentation here.

WAM_EXTERNAL_REGEX

Default: None

This is a configuration regular expression that will guide WAM when a User is automatically created as to whether the username matches an External Examiner. See also WAM_STAFF_REGEX. It is recommended that both are configured if possible.

If only this REGEX is configured, then Users are considered to be External Examiners on a match, and Staff otherwise. If both REGEXs are configured, then Users will be tested against both, and those not matching either will have login disabled.

WAM_STAFF_REGEX

Default: None

This is a configuration regular expression that will guide WAM when a User is automatically created as to whether the username matches an internal member of staff. See also WAM_EXTERNAL_REGEX. It is recommended that both are configured if possible.

If only this REGEX is configured, then Users are considered to be Staff on a match, and External Examiners otherwise. If both REGEXs are configured, then Users will be tested against both, and those not matching either will have login disabled.

WAM_URL

Default: "http://localhost"

This is the URL for your site, you should configure this unless you are testing.

Clone this wiki locally