org.apache.sshd.server.auth

Class AbstractUserAuth

java.lang.Object

org.apache.sshd.common.util.logging.AbstractLoggingBean

org.apache.sshd.server.auth.AbstractUserAuth

All Implemented Interfaces:

UserAuthInstance<ServerSession>, UsernameHolder, NamedResource, UserAuth, ServerSessionHolder

Direct Known Subclasses:

UserAuthGSS, UserAuthHostBased, UserAuthKeyboardInteractive, UserAuthNone, UserAuthPassword, UserAuthPublicKey

public abstract class AbstractUserAuth
extends AbstractLoggingBean
implements UserAuth

Author:

Apache MINA SSHD Project

Field Summary

Fields inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

log

Fields inherited from interface org.apache.sshd.common.NamedResource

BY_NAME_COMPARATOR, NAME_EXTRACTOR

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractUserAuth(String name)

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.
protected abstract Boolean	doAuth(Buffer buffer, boolean init)
String	getName()
ServerSession	getServerSession()
String	getService()
ServerSession	getSession()
String	getUsername()
Boolean	next(Buffer buffer) Handle another step in the authentication process.
String	toString()

Methods inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

getSimplifiedLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.sshd.common.NamedResource

findByName, getNameList, getNames, removeByName

Constructor Detail

AbstractUserAuth

protected AbstractUserAuth(String name)

Method Detail

getName

public final String getName()

Specified by:

getName in interface NamedResource

Returns:

The resource name

getUsername

public String getUsername()

Specified by:

getUsername in interface UsernameHolder

Returns:

The attached username - may be null/empty if holder not yet initialized

getService

public String getService()

getServerSession

public ServerSession getServerSession()

Specified by:

getServerSession in interface ServerSessionHolder

Returns:

The underlying ServerSession used

getSession

public ServerSession getSession()

Specified by:

getSession in interface UserAuthInstance<ServerSession>

Returns:

The current session for which the authentication is being tracked. Note: may be null if the instance has not been initialized yet

auth

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

Description copied from interface: UserAuth

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.

Specified by:

auth in interface UserAuth

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:

Exception - if the authentication fails

next

public Boolean next(Buffer buffer)
             throws Exception

Description copied from interface: UserAuth

Handle another step in the authentication process.

Specified by:

next in interface UserAuth

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

destroy

public void destroy()

Description copied from interface: UserAuth

Free any system resources used by the module.

Specified by:

destroy in interface UserAuth

doAuth

protected abstract Boolean doAuth(Buffer buffer,
                                  boolean init)
                           throws Exception

Throws:

Exception

toString

public String toString()

Overrides:

toString in class Object