View comments | RSS feed

cfloginuser

Description

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

Category

Extensibility tags

Syntax

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

See also

cflogin, cflogout

History

New in ColdFusion MX: This tag is new.

Attributes

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.

Usage

If Basic HTTP Authentication is in use, ColdFusion checks the standard security data in the request header. The Cflogin scope within this tag contains the user name and password in the cflogin.name and cflogin.password variables.

Example

See cflogin.

ColdFusion 9 | ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 6

Comments are no longer accepted for ColdFusion MX. ColdFusion 8 is the current version.

Comments


kendoka said on Jan 21, 2003 at 11:59 PM :
If you wish to pass a db query result into ROLES you must use ToString() on numeric values. eg ROLES="#ToString(query.userRole)#" where the db field 'userRole' is not a string.
StefBiz said on Aug 4, 2003 at 8:58 PM :
I just think that you should mention that cflogin tag is based on cookie enable on the browser... and may be if there are two IE/NS open, the last login will take effect on both browser. Stephane
a440guy said on Jan 16, 2004 at 1:42 PM :
The entire paragraph under the heading "Usage" is unclear. It's completely useless. It communicates absolutely nothing.

"If Basic HTTP Authentication is in use, ColdFusion checks the standard security data in the request header"

What requested header? Users certainly don't request headers? Perhaps what is meant is "... in the HTTP headers of the requested page (or other resource)". But I'm only guessing.

What ARE the "standard security data"?

"The Cflogin scope within this tag contains the user name and password in the cflogin.name and cflogin.password variables."

What "Cflogin scope within this tag"? There is no inside to this tag that I can see. Does it mean "the scope of the enclosing CFLOGIN tag?

What cflogin structure is being refered to? Where is it; do I have to create it?
halL said on Jan 16, 2004 at 3:03 PM :
The ColdFusion MX (this) version of this reference page was poorly written, and the information in the Usage section actually applies to the cflogin tag.

Both the cflogin and cfloginuser pages were revised to reflect this and improve the clarity for ColdFusion MX 6.1. See http://livedocs.macromedia.com/coldfusion/6.1/htmldocs/tags-p73.htm and http://livedocs.macromedia.com/coldfusion/6.1/htmldocs/tags-p74.htm.

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6/CFML_Reference/Tags-pt170.htm