Purpose: This document describes the process of retrieving the global preferences from the database for use within the application.
Overview
All global preferences are stored within the MicroFour.StrataFrame.Security.SecurityBasics static class. The properties are stored in the database within the SFSPreferences table.
Retrieving Global Preferences from the Database
A shared (static) method is provided to retrieve global preferences from the database. Executing MicroFour.StrataFrame.Security.BusinessObjects.SFSPreferencesBO.RetrieveSecurityPreferences() retrieves the preferences from the SFSPreferences table in the database and populates the properties in the SecurityBasics class.
Global Preferences Properties
The global preferences are accessed through the following properties on the SecurityBasics class:
| Property | Database Field | Description |
|---|---|---|
| AllowWindowsAuth | sp_AlowWindowsAuth | Determines whether the application as a whole will allow users to be authenticated against active directory. Also determines whether the domain combo box will be shown on the logon form. |
| InvalidLogonRetryDelay | sp_WaitTimeAfterLogonFailure | The time that the logon form will be disabled after a user enters a bad user name and password. |
| MaximumInvalidLogonAttempts | sp_MaxInvalidLogonAttempts | The maximum number of times that an end-user can enter an incorrect password for the same user name before the user is deactivated. |
| MaximumInvalidLogonAttemptsTime | sp_MaxInvalidLogonAttemptsTime | The TimeSpan that specifies the amount of time in which the MaximumInvalidLogonAttempts must occur for the account to be disabled. |
| PasswordMaximumAge | sp_PwMaxAge | The maximum age of a password before it must be changed (the amount of time after which a password will expire). |
| PasswordMaximumLength | sp_PwMaxLength | The maximum length of newly created passwords within the application. |
| PasswordMinimumAge | sp_PwMinAge | The minimum amount of time that an end-user must wait between password changes. |
| PasswordMinimumLength | sp_PwMinLength | The minimum length of newly created passwords within the application. |
| PasswordMustBeComplex | sp_PwAreComplex | Determines whether newly created passwords must follow the password complexity rules specified by Windows® Server 2003. |
| SessionTimeout | sp_SessionTimeout | The default time that a user's session can remain idle before the session will timeout and lock. (Session locking must be enabled for a user's session to lock.) |
| UniquePasswordsBeforeRepeat | sp_PwBeforeRepeat | The number of unique passwords that an end-user must supply before they can repeat a password within their password history. |