com.cloudbees.jenkins.plugins.sshcredentials.impl

Class JSchSSHPasswordAuthenticator

java.lang.Object

com.cloudbees.jenkins.plugins.sshcredentials.SSHAuthenticator<JSchConnector,com.cloudbees.plugins.credentials.common.StandardUsernamePasswordCredentials>

com.cloudbees.jenkins.plugins.sshcredentials.impl.JSchSSHPasswordAuthenticator

public class JSchSSHPasswordAuthenticator
extends SSHAuthenticator<JSchConnector,com.cloudbees.plugins.credentials.common.StandardUsernamePasswordCredentials>

Since:

25/10/2012 13:57

Author:

stephenc

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JSchSSHPasswordAuthenticator.Factory Extension point to allow plugging in SSHAuthenticator implementations for the many SSH client libraries available.

Nested classes/interfaces inherited from class com.cloudbees.jenkins.plugins.sshcredentials.SSHAuthenticator

SSHAuthenticator.Mode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JSchSSHPasswordAuthenticator(JSchConnector connection, com.cloudbees.plugins.credentials.common.StandardUsernamePasswordCredentials user)
protected	JSchSSHPasswordAuthenticator(JSchConnector connection, com.cloudbees.plugins.credentials.common.StandardUsernamePasswordCredentials user, String username)

Method Summary

Modifier and Type	Method and Description
boolean	canAuthenticate() Returns true if the bound connection is in a state where authentication can be tried using the supplied credentials.
protected boolean	doAuthenticate() SPI for authenticating the bound connection using the supplied credentials.
SSHAuthenticator.Mode	getAuthenticationMode() Returns the mode of authentication that this SSHAuthenticator supports.

Methods inherited from class com.cloudbees.jenkins.plugins.sshcredentials.SSHAuthenticator

authenticate, authenticate, authenticateOrFail, filter, getConnection, getListener, getPrivateKeys, getUser, getUsername, isAuthenticated, isSupported, matcher, matcher, newInstance, newInstance, newInstance, setListener

Methods inherited from class java.lang.Object

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

Constructor Detail

JSchSSHPasswordAuthenticator

protected JSchSSHPasswordAuthenticator(@NonNull
                                       JSchConnector connection,
                                       @NonNull
                                       com.cloudbees.plugins.credentials.common.StandardUsernamePasswordCredentials user)

JSchSSHPasswordAuthenticator

protected JSchSSHPasswordAuthenticator(@NonNull
                                       JSchConnector connection,
                                       @NonNull
                                       com.cloudbees.plugins.credentials.common.StandardUsernamePasswordCredentials user,
                                       @CheckForNull
                                       String username)

Method Detail

getAuthenticationMode

@NonNull
public SSHAuthenticator.Mode getAuthenticationMode()

Description copied from class: SSHAuthenticator

Returns the mode of authentication that this SSHAuthenticator supports.

Overrides:

getAuthenticationMode in class SSHAuthenticator<JSchConnector,com.cloudbees.plugins.credentials.common.StandardUsernamePasswordCredentials>

Returns:

the mode of authentication that this SSHAuthenticator supports.

canAuthenticate

public boolean canAuthenticate()

Description copied from class: SSHAuthenticator

Returns true if the bound connection is in a state where authentication can be tried using the supplied credentials.

Subclasses can override this if they can tell whether it is possible to make an authentication attempt, default implementation is one-shot always.

Overrides:

canAuthenticate in class SSHAuthenticator<JSchConnector,com.cloudbees.plugins.credentials.common.StandardUsernamePasswordCredentials>

Returns:

true if the bound connection is in a state where authentication can be tried using the supplied credentials.

doAuthenticate

protected boolean doAuthenticate()

Description copied from class: SSHAuthenticator

SPI for authenticating the bound connection using the supplied credentials.

As a guideline, authentication errors should be reported to SSHAuthenticator.getListener() before this method returns with false. This helps an user better understand what is tried and failing. Logging can be used in addition to this to capture further details. (in contrast, please avoid reporting a success to the listener to improve S/N ratio)

Specified by:

doAuthenticate in class SSHAuthenticator<JSchConnector,com.cloudbees.plugins.credentials.common.StandardUsernamePasswordCredentials>

Returns:

true if and only if authentication was successful.