public interface UserAuth
Modifier and Type | Method and Description |
---|---|
void |
authenticate(String username,
Service nextService,
Iterable<AuthMethod> methods)
Attempt to authenticate
username using each of methods in order. |
String |
getBanner()
Returns the authentication banner (if any).
|
Deque<UserAuthException> |
getSavedExceptions() |
int |
getTimeout() |
boolean |
hadPartialSuccess() |
void |
setTimeout(int timeout)
Set the
timeout for any method to successfully authenticate before it is abandoned. |
void authenticate(String username, Service nextService, Iterable<AuthMethod> methods) throws UserAuthException, TransportException
username
using each of methods
in order. nextService
is the
Service
that will be enabled on successful authentication.
Authentication fails if there are no method available, i.e. if all the method failed or there were method
available but could not be attempted because the server did not allow them. In this case, a UserAuthException
is thrown with its cause as the last authentication failure. Other UserAuthException
's
which may have been ignored may be accessed via getSavedExceptions()
.
Further attempts may also be made by catching UserAuthException
and retrying with this method.username
- the user to authenticatenextService
- the service to set on successful authenticationmethods
- the AuthMethod
's to tryUserAuthException
- in case of authentication failureTransportException
- if there was a transport-layer errorString getBanner()
Deque<UserAuthException> getSavedExceptions()
int getTimeout()
timeout
for a method to successfully authenticate before it is abandoned.boolean hadPartialSuccess()
true
if at least one of the method supplied succeeded.void setTimeout(int timeout)
timeout
for any method to successfully authenticate before it is abandoned.timeout
- the timeout in secondsCopyright © 2009-2014. All Rights Reserved.