About Local Database

The Local Database action can read and write information about a user in a local user database.

Note: Changes that an administrator makes to a local user database, whether from the Configuration utility or the command line, can override the changes that this action makes.

A Local Database action provides the following configuration elements and options:

LocalDB Instance

Specifies a local user database instance from a list.

User Name

Specifies a user name from a list.

Note: The same user name can exist in more than one local user database.

Allow User Create

Specifies whether to create a user dynamically when trying to write information for a user that is not in the database already.

Note: Dynamically created users exist temporarily and are regularly purged from the database. Static users, created by an administrator using the Configuration Utility or the command line, are not purged.

Add new entry

Specify actions that read from and write to specific database properties.

An entry includes these elements:

Action

Specifies Read or Write.

Destination

Specifies where to store the value that is being read or written.For the Read action, Destination specifies a variable; the value that is read from the database is stored in this variable. The default variables are:

• session.localdb.groups

• session.localdb.locked_out

• session.localdb.login_failures

  Note: Alternatively, the variable can be any text string. When using non-default variables, verify the expressions used in any other item that reads or manipulates local database variables in the same session; ensure that the expressions use the same string.

For the Write action, Destination specifies a DB property (selectable from a list). The value of an expression is stored in this DB property. The DB Property list includes these items:

• locked_out - a number; when 0, the user is not locked out. When greater than 0, the user is locked out.

• login_failures - a number; the number of login failures currently recorded for the user.

• groups - text; names of membership groups specified for the user in the local user database.

  Note: Groups specified in the local user database are not verified against external systems.

Source

Specifies where to get the value to read or to write. For Read, specifies a database property (selectable from a list) to read. For Write, specifies an expression, the value of which will be written.