cfntauthenticate

Authenticates a user name and password against the
NT domain on which ColdFusion server is running,
and optionally retrieves the user's groups.

<cfntauthenticate username="" password="" domain="">

cfntauthenticate(username="", password="", domain="");

This tag requires Adobe ColdFusion 7 and up. Not supported on Lucee, etc.

Attribute Reference

username string
Required

User's login name.

password string
Required

User's login name.

domain string
Required

Domain against which to authenticate the user. The
ColdFusion J2EE server must be running on this domain.

result variableName
Default: `cfntauthenticate`

Name of the variable in which to return the results.
Default: cfntauthenticate

listgroups boolean
Default: `false`

Boolean value specifying whether to Include a
comma-delimited list of the user's groups in the
result structure.
Default: false

Values:

true
false

throwonerror boolean
Default: `false`

Boolean value specifying whether to throw an
exception if the validation fails. If this attribute is true,
ColdFusion throws an error if the user name or password is
invalid; the application must handle such errors in a
try/catch block or ColdFusion error handler page.
Default: false

Values:

true
false

Examples

Sample code using the cfntauthenticate tag

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

cfntauthenticate

Attribute Reference

username string Required

password string Required

domain string Required

result variableName Default: cfntauthenticate

listgroups boolean Default: false

throwonerror boolean Default: false

Examples Add An Example Sample code using the cfntauthenticate tag