org.apache.sshd.server.keyprovider

Class AbstractGeneratorHostKeyProvider

java.lang.Object

org.apache.sshd.common.util.logging.AbstractLoggingBean

org.apache.sshd.common.keyprovider.AbstractKeyPairProvider

org.apache.sshd.server.keyprovider.AbstractGeneratorHostKeyProvider

All Implemented Interfaces:

AlgorithmNameProvider, KeyIdentityProvider, KeyPairProvider, KeySizeIndicator

Direct Known Subclasses:

BouncyCastleGeneratorHostKeyProvider, SimpleGeneratorHostKeyProvider

public abstract class AbstractGeneratorHostKeyProvider
extends AbstractKeyPairProvider
implements AlgorithmNameProvider, KeySizeIndicator

Holds a single KeyPair which is generated the 1st time loadKeys(SessionContext) is called. If there is a file backing it up and the file exists, the key is loaded from it. Otherwise a new key pair is generated and saved (provided a path is configured and isOverwriteAllowed()

Author:

Apache MINA SSHD Project

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_ALGORITHM
static boolean	DEFAULT_ALLOWED_TO_OVERWRITE

Fields inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

log

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

ECDSA_SHA2_NISTP256, ECDSA_SHA2_NISTP384, ECDSA_SHA2_NISTP521, EMPTY_KEYPAIR_PROVIDER, SSH_DSS, SSH_DSS_CERT, SSH_ECDSA_SHA2_NISTP256_CERT, SSH_ECDSA_SHA2_NISTP384_CERT, SSH_ECDSA_SHA2_NISTP521_CERT, SSH_ED25519, SSH_ED25519_CERT, SSH_RSA, SSH_RSA_CERT

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

EMPTY_KEYS_PROVIDER

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractGeneratorHostKeyProvider()

Method Summary

Modifier and Type	Method and Description
void	clearLoadedKeys()
protected Iterable<KeyPair>	doReadKeyPairs(SessionContext session, NamedResource resourceKey, InputStream inputStream)
protected abstract void	doWriteKeyPair(NamedResource resourceKey, KeyPair kp, OutputStream outputStream)
protected KeyPair	generateKeyPair(String algorithm)
String	getAlgorithm()
int	getKeySize()
AlgorithmParameterSpec	getKeySpec()
Path	getPath()
boolean	hasStrictFilePermissions()
boolean	isOverwriteAllowed()
protected Iterable<KeyPair>	loadFromFile(SessionContext session, String alg, Path keyPath)
List<KeyPair>	loadKeys(SessionContext session) Load available keys.
protected Iterable<KeyPair>	readKeyPairs(SessionContext session, Path keyPath, OpenOption... options)
protected Iterable<KeyPair>	resolveKeyPairs(SessionContext session, Path keyPath)
void	setAlgorithm(String algorithm)
protected void	setFilePermissions(Path path) Restricts the file permissions such that only the owner can access the file.
void	setKeySize(int keySize)
void	setKeySpec(AlgorithmParameterSpec keySpec)
void	setOverwriteAllowed(boolean overwriteAllowed)
void	setPath(Path path)
void	setStrictFilePermissions(boolean strict) Sets whether this AbstractGeneratorHostKeyProvider shall enforce that a newly created host key file has file access permissions that allow only the owner to access it.
protected void	writeKeyPair(KeyPair kp, Path keyPath)

Methods inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

debug, debug, debug, debug, debug, error, error, error, error, error, getSimplifiedLogger, info, info, warn, warn, warn, warn, warn, warn, warn, warn

Methods inherited from class java.lang.Object

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

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

getKeyTypes, loadKey, wrap, wrap

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

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

Field Detail

DEFAULT_ALGORITHM

public static final String DEFAULT_ALGORITHM

See Also:

Constant Field Values

DEFAULT_ALLOWED_TO_OVERWRITE

public static final boolean DEFAULT_ALLOWED_TO_OVERWRITE

See Also:

Constant Field Values

Constructor Detail

AbstractGeneratorHostKeyProvider

protected AbstractGeneratorHostKeyProvider()

Method Detail

getPath

public Path getPath()

setPath

public void setPath(Path path)

getAlgorithm

public String getAlgorithm()

Specified by:

getAlgorithm in interface AlgorithmNameProvider

setAlgorithm

public void setAlgorithm(String algorithm)

getKeySize

public int getKeySize()

Specified by:

getKeySize in interface KeySizeIndicator

Returns:

The number of bits used in the key

setKeySize

public void setKeySize(int keySize)

getKeySpec

public AlgorithmParameterSpec getKeySpec()

setKeySpec

public void setKeySpec(AlgorithmParameterSpec keySpec)

isOverwriteAllowed

public boolean isOverwriteAllowed()

setOverwriteAllowed

public void setOverwriteAllowed(boolean overwriteAllowed)

hasStrictFilePermissions

public boolean hasStrictFilePermissions()

setStrictFilePermissions

public void setStrictFilePermissions(boolean strict)

Sets whether this AbstractGeneratorHostKeyProvider shall enforce that a newly created host key file has file access permissions that allow only the owner to access it. By default true.

Parameters:

strict - whether to restrict file permissions to owner-only access

clearLoadedKeys

public void clearLoadedKeys()

loadKeys

public List<KeyPair> loadKeys(SessionContext session)

Description copied from interface: KeyIdentityProvider

Load available keys.

Specified by:

loadKeys in interface KeyIdentityProvider

Parameters:

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

Returns:

an Iterable instance of available keys - ignored if null

resolveKeyPairs

protected Iterable<KeyPair> resolveKeyPairs(SessionContext session,
                                            Path keyPath)
                                     throws IOException,
                                            GeneralSecurityException

Throws:

IOException

GeneralSecurityException

loadFromFile

protected Iterable<KeyPair> loadFromFile(SessionContext session,
                                         String alg,
                                         Path keyPath)
                                  throws IOException,
                                         GeneralSecurityException

Throws:

IOException

GeneralSecurityException

readKeyPairs

protected Iterable<KeyPair> readKeyPairs(SessionContext session,
                                         Path keyPath,
                                         OpenOption... options)
                                  throws IOException,
                                         GeneralSecurityException

Throws:

IOException

GeneralSecurityException

doReadKeyPairs

protected Iterable<KeyPair> doReadKeyPairs(SessionContext session,
                                           NamedResource resourceKey,
                                           InputStream inputStream)
                                    throws IOException,
                                           GeneralSecurityException

Throws:

IOException

GeneralSecurityException

writeKeyPair

protected void writeKeyPair(KeyPair kp,
                            Path keyPath)
                     throws IOException,
                            GeneralSecurityException

Throws:

IOException

GeneralSecurityException

setFilePermissions

protected void setFilePermissions(Path path)
                           throws IOException

Restricts the file permissions such that only the owner can access the file.

Parameters:

path - Path of a newly created (empty) host key file

Throws:

IOException - on errors

doWriteKeyPair

protected abstract void doWriteKeyPair(NamedResource resourceKey,
                                       KeyPair kp,
                                       OutputStream outputStream)
                                throws IOException,
                                       GeneralSecurityException

Throws:

IOException

GeneralSecurityException

generateKeyPair

protected KeyPair generateKeyPair(String algorithm)
                           throws GeneralSecurityException

Throws:

GeneralSecurityException