Programming ColdFusion MX, 2nd Edition

Name

cfauthenticate

Synopsis

<cfauthenticate>

Authenticates a user within a given security context.

Attributes

securitycontext=" security_context "

The name of the security context to authenticate the user within. Required. Security contexts are defined in the ColdFusion Administrator.

username=" username "

The name of the user being authenticated. Required.

password=" password "

The password of the user being authenticated. Required.

authtype="Basic|x509"

The authentication type to use. Basic specifies a username/password while x509 specifies an x509 client certificate passed via SSL. Optional. The default is Basic.

setcookie="Yes|No"

If set to Yes, ColdFusion sets an encrypted cookie on the user’s browser that contains the username, security context, browser’s remote address, and HTTP user agent. Optional. The default is Yes.

throwonfailure="Yes|No"

Determines if ColdFusion should throw an exception if authentication fails. Optional. The default is Yes.