User Guide

230 Chapter 2: ColdFusion Tags

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 Developing ColdFusion MX 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

cflogin 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

can specify that login information be stored in the Session scope.

Example

See cflogin on page 228.

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.