Programming ColdFusion

Name

IsAuthenticated

Synopsis

IsAuthenticated([securitycontext])

Returns True if the user has been authenticated for the given securitycontext using CFAUTHENTICATE. ColdFusion returns True if the user has been authenticated or False if they haven’t. If no securitycontext is given, ColdFusion returns True if the user has been authenticated for any security context. The IsAuthenticated( ) function is commonly used within an Application.cfm file. In order to use the IsAuthenticated( ) function, Advanced Security needs to be enabled within the ColdFusion Administrator, and a valid security context must already be defined. The following example uses IsAuthenticated( ) to determine if a user is authenticated for a security context called Administrator:

<CFIF NOT IsAuthenticated("Administrator")>
  <CFAUTHENTICATE SECURITYCONTEXT="Administrator" 
                  USERNAME="#Form.username#"  PASSWORD="#Form.password#">
</CFIF>