org.apache.sshd.server.auth.pubkey

Interface PublickeyAuthenticator

All Known Implementing Classes:

AcceptAllPublickeyAuthenticator, AuthorizedKeysAuthenticator, CachingPublicKeyAuthenticator, DefaultAuthorizedKeysAuthenticator, KeySetPublickeyAuthenticator, RejectAllPublickeyAuthenticator, StaticPublickeyAuthenticator

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface PublickeyAuthenticator

The PublickeyAuthenticator is used on the server side to authenticate user public keys.

Method Summary

Modifier and Type	Method and Description
boolean	authenticate(java.lang.String username, java.security.PublicKey key, ServerSession session) Check the validity of a public key.
static PublickeyAuthenticator	fromAuthorizedEntries(java.lang.Object id, ServerSession session, java.util.Collection<? extends AuthorizedKeyEntry> entries, PublicKeyEntryResolver fallbackResolver)

Method Detail

authenticate

boolean authenticate(java.lang.String username,
                     java.security.PublicKey key,
                     ServerSession session)
              throws AsyncAuthException

Check the validity of a public key.

Parameters:

username - the username

key - the key

session - the server session

Returns:

a boolean indicating if authentication succeeded or not

Throws:

AsyncAuthException - If the authentication is performed asynchronously

fromAuthorizedEntries

static PublickeyAuthenticator fromAuthorizedEntries(java.lang.Object id,
                                                    ServerSession session,
                                                    java.util.Collection<? extends AuthorizedKeyEntry> entries,
                                                    PublicKeyEntryResolver fallbackResolver)
                                             throws java.io.IOException,
                                                    java.security.GeneralSecurityException

Parameters:

id - Some kind of mnemonic identifier for the authenticator - used also in toString()

session - The ServerSession that triggered this call - may be null if invoked by offline tool (e.g., unit test) or session context unknown to caller.

entries - The entries to parse - ignored if null/empty

fallbackResolver - The public key resolver to use if none of the default registered ones works

Returns:

A wrapper with all the parsed keys

Throws:

java.io.IOException - If failed to parse the keys data

java.security.GeneralSecurityException - If failed to generate the relevant keys from the parsed data