org.apache.sshd.common.keyprovider

Interface KeyPairProvider

All Superinterfaces:

KeyIdentityProvider

All Known Implementing Classes:

AbstractGeneratorHostKeyProvider, AbstractKeyPairProvider, AbstractResourceKeyPairProvider, BouncyCastleGeneratorHostKeyProvider, BuiltinClientIdentitiesWatcher, ClassLoadableResourceKeyPairProvider, ClientIdentitiesWatcher, DefaultClientIdentitiesWatcher, FileKeyPairProvider, MappedKeyPairProvider, SimpleGeneratorHostKeyProvider

public interface KeyPairProvider
extends KeyIdentityProvider

Provider for key pairs. This provider is used on the server side to provide the host key, or on the client side to provide the user key.

Author:

Apache MINA SSHD Project

Field Summary

Fields

Modifier and Type	Field and Description
static String	ECDSA_SHA2_NISTP256 SSH identifier for EC keys in NIST curve P-256
static String	ECDSA_SHA2_NISTP384 SSH identifier for EC keys in NIST curve P-384
static String	ECDSA_SHA2_NISTP521 SSH identifier for EC keys in NIST curve P-521
static KeyPairProvider	EMPTY_KEYPAIR_PROVIDER A KeyPairProvider that has no keys
static String	SSH_DSS SSH identifier for DSA keys
static String	SSH_DSS_CERT
static String	SSH_ECDSA_SHA2_NISTP256_CERT
static String	SSH_ECDSA_SHA2_NISTP384_CERT
static String	SSH_ECDSA_SHA2_NISTP521_CERT
static String	SSH_ED25519 SSH identifier for ED25519 elliptic curve keys
static String	SSH_ED25519_CERT
static String	SSH_RSA SSH identifier for RSA keys
static String	SSH_RSA_CERT SSH identifier for openssh cert keys

Fields inherited from interface org.apache.sshd.common.keyprovider.KeyIdentityProvider

EMPTY_KEYS_PROVIDER

Method Summary

Modifier and Type	Method and Description
default Iterable<String>	getKeyTypes(SessionContext session)
default KeyPair	loadKey(SessionContext session, String type) Load a key of the specified type which can be "ssh-rsa", "ssh-dss", or "ecdsa-sha2-nistp{256,384,521}".
static KeyPairProvider	wrap(Iterable<KeyPair> pairs) Wrap the provided KeyPairs into a KeyPairProvider
static KeyPairProvider	wrap(KeyPair... pairs) Wrap the provided KeyPairs into a KeyPairProvider

Methods inherited from interface org.apache.sshd.common.keyprovider.KeyIdentityProvider

exhaustCurrentIdentities, isEmpty, iterableOf, loadKeys, multiProvider, multiProvider, resolveKeyIdentityProvider, wrapKeyPairs, wrapKeyPairs

Field Detail

SSH_RSA

static final String SSH_RSA

SSH identifier for RSA keys

See Also:

Constant Field Values

SSH_DSS

static final String SSH_DSS

SSH identifier for DSA keys

See Also:

Constant Field Values

SSH_ED25519

static final String SSH_ED25519

SSH identifier for ED25519 elliptic curve keys

See Also:

Constant Field Values

ECDSA_SHA2_NISTP256

static final String ECDSA_SHA2_NISTP256

SSH identifier for EC keys in NIST curve P-256

ECDSA_SHA2_NISTP384

static final String ECDSA_SHA2_NISTP384

SSH identifier for EC keys in NIST curve P-384

ECDSA_SHA2_NISTP521

static final String ECDSA_SHA2_NISTP521

SSH identifier for EC keys in NIST curve P-521

SSH_RSA_CERT

static final String SSH_RSA_CERT

SSH identifier for openssh cert keys

See Also:

Constant Field Values

SSH_DSS_CERT

static final String SSH_DSS_CERT

See Also:

Constant Field Values

SSH_ED25519_CERT

static final String SSH_ED25519_CERT

See Also:

Constant Field Values

SSH_ECDSA_SHA2_NISTP256_CERT

static final String SSH_ECDSA_SHA2_NISTP256_CERT

See Also:

Constant Field Values

SSH_ECDSA_SHA2_NISTP384_CERT

static final String SSH_ECDSA_SHA2_NISTP384_CERT

See Also:

Constant Field Values

SSH_ECDSA_SHA2_NISTP521_CERT

static final String SSH_ECDSA_SHA2_NISTP521_CERT

See Also:

Constant Field Values

EMPTY_KEYPAIR_PROVIDER

static final KeyPairProvider EMPTY_KEYPAIR_PROVIDER

A KeyPairProvider that has no keys

Method Detail

loadKey

default KeyPair loadKey(SessionContext session,
                        String type)
                 throws IOException,
                        GeneralSecurityException

Load a key of the specified type which can be "ssh-rsa", "ssh-dss", or "ecdsa-sha2-nistp{256,384,521}". If there is no key of this type, return null

Parameters:

session - The SessionContext for invoking this load command - may be null if not invoked within a session context (e.g., offline tool).

type - the type of key to load

Returns:

a valid key pair or null if this type of key is not available

Throws:

IOException - If failed to read/parse the keys data

GeneralSecurityException - If failed to generate the keys

getKeyTypes

default Iterable<String> getKeyTypes(SessionContext session)
                              throws IOException,
                                     GeneralSecurityException

Parameters:

session - The SessionContext for invoking this load command - may be null if not invoked within a session context (e.g., offline tool).

Returns:

The available Iterable key types - never null

Throws:

IOException - If failed to read/parse the keys data

GeneralSecurityException - If failed to generate the keys

wrap

static KeyPairProvider wrap(KeyPair... pairs)

Wrap the provided KeyPairs into a KeyPairProvider

Parameters:

pairs - The available pairs - ignored if null/empty (i.e., returns EMPTY_KEYPAIR_PROVIDER)

Returns:

The provider wrapper

See Also:

wrap(Iterable)

wrap

static KeyPairProvider wrap(Iterable<KeyPair> pairs)

Wrap the provided KeyPairs into a KeyPairProvider

Parameters:

pairs - The available pairs Iterable - ignored if null (i.e., returns EMPTY_KEYPAIR_PROVIDER)

Returns:

The provider wrapper