Method to authenticate a Subject (phase 1).

The implementation of this method authenticates a Subject. For example, it may prompt for Subject information such as a username and password and then attempt to verify the password. This method saves the result of the authentication attempt as private state within the LoginModule.

Returns:  true if the authentication succeeded, or false if this LoginModule should be ignored.

Exceptions:

LoginException

if the authentication fails