User Guide

308 Chapter 2: ColdFusion Tags
cfNTauthenticate
Description
Authenticates a user name and password against the Windows NT domain on which the
ColdFusion server is running, and optionally retrieves the user’s groups.
Category
Security tags
Syntax
<cfNTauthenticate
username="username"
password="password"
domain="nt_domain"
result="result variable"
listGroups = "yes" or "no"
throwOnError = "yes" or "no">
See also
cflogin
, cfloginuser, IsUserInRole, GetAuthUser
History
ColdFusion MX 7: Added this tag.
Attributes
Usage
Use this function to authenticate a user against a Windows NT domain and optionally get the
user’s groups. This function does not work with the Microsoft Active Directory directory service,
and does nothing on UNIX and Linux systems. You typically use this tag inside a
cflogin tag to
authenticate the user for a
cfloginuser tag, as shown in the example.
Attribute Req/Opt Default Description
name Required User’s login name.
password Required User’s password.
domain Required Domain against which to authenticate the user. The
ColdFusion J2EE server must be running on this
domain.
result Optional cfntauthenticate Name of the variable in which to return the results.
listGroups Optional No Boolean value specifying whether to include a
comma-delimited list of the user’s groups in the result
structure.
throwOnError Optional No Boolean value specifying whether to throw an
exception if the validation fails. If this attribute is Yes,
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.