wwWebPage::Authenticate

Allows you to check whether the current request is authenticated and if not prompt for authentication.

This mechanism is fully self contained - it will:

  • Check for authentication
  • If not authenticated present an authentication dialog
  • After authentication is successful return you back to the original page

This mechanism simply defers to wwProcess.Authenticate.. The authentication mechanism used (Basic or wwUserSecurity) depends on the wwProcess.cAuthenticationMode property configured on your process class. The default is Basic (ie. Windows Authentication).

This simple method allows you to query the user's authentication in the OnLoad() of the page:

IF !THIS.Authenticate("ANY")  && Basic Auth 
	RETURN  && not validated - login dialog
ENDIF

*** Authenticated - move on

Typically you'd call this code from the OnLoad of the form right at the beginning of page processing.

o.Authenticate(lcValidUserName,lcErrorMessage)

Return Value

.T. or .F.

Parameters

lcValidUserName
A username or WCINI or ANY

lcErrorMessage
Error message to display if validation fails.


See also:

Class wwWebPage

© West Wind Technologies, 1996-2024 • Updated: 09/30/07
Comment or report problem with topic