Programming ColdFusion

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.

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.