net.schmizz.sshj.userauth

Class UserAuthImpl

java.lang.Object

net.schmizz.sshj.AbstractService

net.schmizz.sshj.userauth.UserAuthImpl

All Implemented Interfaces:

ErrorNotifiable, SSHPacketHandler, Service, UserAuth

public class UserAuthImpl
extends AbstractService
implements UserAuth

UserAuth implementation.

Nested Class Summary

Nested classes/interfaces inherited from interface net.schmizz.sshj.common.ErrorNotifiable

ErrorNotifiable.Util

Field Summary

Fields inherited from class net.schmizz.sshj.AbstractService

log, name, trans

Constructor Summary

Constructors

Constructor and Description
UserAuthImpl(Transport trans)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	authenticate(java.lang.String username, Service nextService, AuthMethod method, int timeoutMs) Attempt to authenticate username using each of methods in order.
java.lang.Iterable<java.lang.String>	getAllowedMethods() The available authentication methods.
java.lang.String	getBanner() Returns the authentication banner (if any).
boolean	hadPartialSuccess()
void	handle(Message msg, SSHPacket buf) Delegate handling of some SSH packet to this object.
void	notifyError(SSHException error) Notifies this object of an error.

Methods inherited from class net.schmizz.sshj.AbstractService

getName, notifyUnimplemented, request

Methods inherited from class java.lang.Object

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

Constructor Detail

UserAuthImpl

public UserAuthImpl(Transport trans)

Method Detail

authenticate

public boolean authenticate(java.lang.String username,
                   Service nextService,
                   AuthMethod method,
                   int timeoutMs)
                     throws UserAuthException,
                            TransportException

Description copied from interface: UserAuth

Attempt to authenticate 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.

Further attempts may also be made by catching UserAuthException and retrying with this method.

Specified by:

authenticate in interface UserAuth

Parameters:

username - the user to authenticate

nextService - the service to set on successful authentication

method - the AuthMethod's to try

Returns:

whether authentication was successful

Throws:

UserAuthException - in case of authentication failure

TransportException - if there was a transport-layer error

getBanner

public java.lang.String getBanner()

Description copied from interface: UserAuth

Returns the authentication banner (if any). In some cases this is available even before the first authentication request has been made.

Specified by:

getBanner in interface UserAuth

Returns:

the banner, or an empty string if none was received

hadPartialSuccess

public boolean hadPartialSuccess()

Specified by:

hadPartialSuccess in interface UserAuth

Returns:

whether authentication was partially successful. Some server's may be configured to require multiple authentications; and this value will be true if at least one of the method supplied succeeded.

getAllowedMethods

public java.lang.Iterable<java.lang.String> getAllowedMethods()

Description copied from interface: UserAuth

The available authentication methods. This is only defined once an unsuccessful authentication has taken place.

Specified by:

getAllowedMethods in interface UserAuth

handle

public void handle(Message msg,
          SSHPacket buf)
            throws SSHException

Description copied from interface: SSHPacketHandler

Delegate handling of some SSH packet to this object.

Specified by:

handle in interface SSHPacketHandler

Overrides:

handle in class AbstractService

Parameters:

msg - the SSH message identifier

buf - SSHPacket containing rest of the request

Throws:

SSHException - if there is a non-recoverable error

notifyError

public void notifyError(SSHException error)

Description copied from interface: ErrorNotifiable

Notifies this object of an error.

Specified by:

notifyError in interface ErrorNotifiable

Overrides:

notifyError in class AbstractService