CFLOGINUSER  
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-string"
   roles = "roles">
 
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.

 
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 530.

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.