org.apache.sshd.client.auth.hostbased

Interface HostBasedAuthenticationReporter

public interface HostBasedAuthenticationReporter

Provides report about the client side host-based authentication progress

Author:

Apache MINA SSHD Project

See Also:

RFC-4252 section 9

Method Summary

Modifier and Type	Method and Description
default void	signalAuthenticationAttempt(ClientSession session, String service, KeyPair identity, String hostname, String username, byte[] signature) Sending the initial request to use host based authentication
default void	signalAuthenticationExhausted(ClientSession session, String service, String hostname, String username) Signals end of host based attempts and optionally switching to other authentication methods.
default void	signalAuthenticationFailure(ClientSession session, String service, KeyPair identity, String hostname, String username, boolean partial, List<String> serverMethods)
default void	signalAuthenticationSuccess(ClientSession session, String service, KeyPair identity, String hostname, String username)

Method Detail

signalAuthenticationAttempt

default void signalAuthenticationAttempt(ClientSession session,
                                         String service,
                                         KeyPair identity,
                                         String hostname,
                                         String username,
                                         byte[] signature)
                                  throws Exception

Sending the initial request to use host based authentication

Parameters:

session - The ClientSession

service - The requesting service name

identity - The KeyPair identity being attempted

hostname - The host name value sent to the server

username - The username value sent to the server

signature - The signature data that is being sent to the server

Throws:

Exception - If failed to handle the callback - Note: may cause session close

signalAuthenticationExhausted

default void signalAuthenticationExhausted(ClientSession session,
                                           String service,
                                           String hostname,
                                           String username)
                                    throws Exception

Signals end of host based attempts and optionally switching to other authentication methods. Note: neither signalAuthenticationSuccess nor signalAuthenticationFailure are invoked.

Parameters:

session - The ClientSession

service - The requesting service name

hostname - The host name value sent to the server

username - The username value sent to the server

Throws:

Exception - If failed to handle the callback - Note: may cause session close

signalAuthenticationSuccess

default void signalAuthenticationSuccess(ClientSession session,
                                         String service,
                                         KeyPair identity,
                                         String hostname,
                                         String username)
                                  throws Exception

Parameters:

session - The ClientSession

service - The requesting service name

identity - The KeyPair identity being attempted

hostname - The host name value sent to the server

username - The username value sent to the server

Throws:

Exception - If failed to handle the callback - Note: may cause session close

signalAuthenticationFailure

default void signalAuthenticationFailure(ClientSession session,
                                         String service,
                                         KeyPair identity,
                                         String hostname,
                                         String username,
                                         boolean partial,
                                         List<String> serverMethods)
                                  throws Exception

Parameters:

session - The ClientSession

service - The requesting service name

identity - The KeyPair identity being attempted

hostname - The host name value sent to the server

username - The username value sent to the server

partial - true if some partial authentication success so far

serverMethods - The List of authentication methods that can continue

Throws:

Exception - If failed to handle the callback - Note: may cause session close