User Guide

cfloginuser 281

cfloginuser

Description

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

cflogin tag.

See also

cflogin, cflogout, GetAuthUser, IsUserInRole, cfapplication,

Chapter 16,

“Securing Applications” in ColdFusion MX Developer’s Guide

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

Usage

Used inside the cflogin tag to identify the authenticated user to ColdFusion. After you call this

function, the

GetAuthUser and IsUserInRoles 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 be stored in the

Session scope.

Example

See cflogin on page 278.

Attribute Req/Opt Default Description

name Required A username.

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.