CFML Reference
ColdFusion Functions

IsAuthenticated

Description

Returns TRUE if the user is authenticated for a ColdFusion security context. If you specify a security context name, IsAuthenticated returns TRUE if the user is authenticated for it. See the Usage section for crucial information.

Category

Decision functions

Syntax

IsAuthenticated([security-context-name ]) 

See also

cfauthenticate, AuthenticatedContext, AuthenticatedUser, IsAuthorized

Parameters

Parameter	Description
security-context-name	Security context name

Usage

Before using IsAuthorized, ensure that advanced security is enabled in the ColdFusion Administrator, and define the security contexts.

Example

<!--- This example calls the IsAuthenticated function. --->
<!--- This code is from an Application.cfm file --->
<cfif NOT IsAuthenticated("Allaire")>
 <CFTRY>
 <CFAUTHENTICATE SECURITYCONTEXT = "Allaire" USERname = #user#
  PASSWORD = #pwd#>
 <CFCATCH type = "Security">
  <!--- the message to display --->
  <H3>Authentication error</H3>
  <cfoutput>
  <!--- Display the message. Alternatively, you might place
   code here to define the user to the security context. --->
  <P>#CFCATCH.message#
  </cfoutput>
 </CFCATCH>
 </CFTRY>
</cfif>
<CFAPPLICATION name = "Personnel">
</body>
</html> 

Copyright © 2001, Macromedia Inc. All rights reserved.