cfdocs.org /

Description

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

Category

Security tags

Syntax

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

See also

cflogin, cflogout, GetAuthUser, GetUserRoles, IsUserInAnyRole, IsUserInRole, IsUserLoggedIn, Securing Applications in the Developing ColdFusion Applications

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.

Attributes

Attribute

Req/Opt

Default

Description

name

Required

A user name.

password

Required

A user password.

roles

Required

A comma-delimited list of role identifiers.

ColdFusion processes spaces in a list element as part of the element.

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.