org.apache.sshd.server.auth

Interface UserAuth

All Known Implementing Classes:

AbstractUserAuth, UserAuthGSS, UserAuthKeyboardInteractive, UserAuthNone, UserAuthPassword, UserAuthPublicKey

public interface UserAuth

Server side authentication mechanism.

Author:

Apache MINA SSHD Project

Method Summary

Modifier and Type	Method and 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.
String	getUserName() Get a user name which has been derived from the handshaking process, or the initial name if nothing has been found.
Boolean	next(Buffer buffer) Handle another step in the authentication process.

Method Detail

auth

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

Try to authenticate the user. This methods should return a non null object which is the user identity if the authentication succeeded. If the authentication failed, this method should throw an exception. If the authentication is still ongoing, a null value should be returned.

Parameters:

session - the current ssh 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:

Exception - if the authentication fails

next

Boolean next(Buffer buffer)
      throws 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:

Exception - if the authentication fails

getUserName

String getUserName()
            throws Exception

Get a user name which has been derived from the handshaking process, or the initial name if nothing has been found.

Returns:

The user name

Throws:

Exception - if the request fails

destroy

void destroy()

Free any system resources used by the module.