revalidate(String) method

This method authenticates a client user against the Java System Connection.

Syntax

public void revalidate ( String password ) throws LoginException

Parameters

password – The password for the current user, as entered on the client application.

Exceptions

LoginException class – if the login fails for any reason, or if the login succeeds but an exceptional condition exists (such as an expired or soon-to-be expired password).

Usage

This method is called when a user reconnects to the Agentry Server from a client application and the enableAuthentication option is set to true in the Java section of the Agentry.ini file. Override this method to implement logic to perform full validation of the user against a remote system.

This method should return normally if the authentication of the user succeeds. If authentication fails for any reason, the appropriate LoginException subclass should be thrown. An exception should also be thrown for other conditions such as expired or soon-to-be-expiring passwords. By default, this method throws PasswordInvalidException, which means that the password is not valid for the user.