cfloginuser

Description

Identifies an authenticated user to ColdFusion. Specifies the user ID and roles. Used within a cflogin tag.

History

ColdFusion MX 6.1: Changed behavior: if the Session scope is enabled, and the cfapplication tag loginStorage attribute is set to Session, the login remains in effect until the session expires or the user is logged out by the cflogout tag. ColdFusion MX: Added this tag.

Syntax

<cfloginuser 
    name = "name" 
    password = "password" 
    roles = "roles">

Attributes

Attribute	Description	Required
name	A user name.	Required
password	A user password.	Required
roles	A comma-delimited list of role identifiers. ColdFusion processes spaces in a list element as part of the element.	Required

Usage

Used inside the cflogin tag to identify the authenticated user to ColdFusion. After you call this function, the GetAuthUser and IsUserInRole return the user name and role information.
Note: By default, the user information is stored as memory-only cookies. The cfapplication tag or the Application.cfc This.loginStorage variable can specify that login information is stored in the Session scope.

Example

See cflogin.

cfmldocs