Interface UserAuth

All Superinterfaces:

NamedResource, ServerSessionHolder, UserAuthInstance<ServerSession>, UsernameHolder

All Known Implementing Classes:

AbstractUserAuth, UserAuthGSS, UserAuthHostBased, UserAuthKeyboardInteractive, UserAuthNone, UserAuthPassword, UserAuthPublicKey

public interface UserAuth
extends ServerSessionHolder, UserAuthInstance<ServerSession>, UsernameHolder

Server side authentication mechanism.

Field Summary

Fields inherited from interface NamedResource

BY_NAME_COMPARATOR, NAME_EXTRACTOR

Method Summary

Modifier and Type	Method	Description
Boolean	auth(ServerSession session, String username, String service, Buffer buffer)	Try to authenticate the user.
void	destroy()	Free any system resources used by the module.
Boolean	next(Buffer buffer)	Handle another step in the authentication process.

Methods inherited from interface NamedResource

getName

Methods inherited from interface ServerSessionHolder

getServerSession

Methods inherited from interface UserAuthInstance

getSession

Methods inherited from interface UsernameHolder

getUsername

Method Details

auth

Boolean auth(ServerSession session,
 String username,
 String service,
 Buffer buffer)
      throws AsyncAuthException,
Exception

Try to authenticate the user. This methods should return a non null value indicating if the authentication succeeded. If the authentication is still ongoing, a null value should be returned.

Parameters:

session - the current ServerSession session

username - the user trying to log in

service - the requested service name

buffer - the request buffer containing parameters specific to this request

Returns:

true if the authentication succeeded, false if the authentication failed and null if not finished yet

Throws:

AsyncAuthException - if the service is willing to perform an asynchronous authentication

Exception - if the authentication fails

next

Boolean next(Buffer buffer)
      throws AsyncAuthException,
Exception

Handle another step in the authentication process.

Parameters:

buffer - the request buffer containing parameters specific to this request

Returns:

true if the authentication succeeded, false if the authentication failed and null if not finished yet

Throws:

AsyncAuthException - if the service is willing to perform an asynchronous authentication

Exception - if the authentication fails

destroy

void destroy()

Free any system resources used by the module.