org.apache.sshd.common.config.keys

Class PublicKeyEntry

java.lang.Object

org.apache.sshd.common.config.keys.PublicKeyEntry

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

AuthorizedKeyEntry

public class PublicKeyEntry
extends Object
implements Serializable

Represents a PublicKey whose data is formatted according to the OpenSSH format:

 <key-type> <base64-encoded-public-key-data>
 

Author:

Apache MINA SSHD Project

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static char	COMMENT_CHAR Character used to denote a comment line in the keys file
static String	STD_KEYFILE_FOLDER_NAME Standard folder name used by OpenSSH to hold key files

Constructor Summary

Constructors

Constructor and Description
PublicKeyEntry()
PublicKeyEntry(String keyType, byte... keyData)

Method Summary

Modifier and Type	Method and Description
PublicKey	appendPublicKey(Appendable sb, PublicKeyEntryResolver fallbackResolver)
static <A extends Appendable> A	appendPublicKeyEntry(A sb, PublicKey key) Encodes a public key data the same way as the parsePublicKeyEntry(String) expects it
boolean	equals(Object obj)
static Path	getDefaultKeysFolderPath()
byte[]	getKeyData()
String	getKeyType()
int	hashCode()
protected boolean	isEquivalent(PublicKeyEntry e)
static <E extends PublicKeyEntry> E	parsePublicKeyEntry(E entry, String encData)
static PublicKeyEntry	parsePublicKeyEntry(String encData)
PublicKey	resolvePublicKey(PublicKeyEntryResolver fallbackResolver)
void	setKeyData(byte[] value)
void	setKeyType(String value)
String	toString()
static String	toString(PublicKey key)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

COMMENT_CHAR

public static final char COMMENT_CHAR

Character used to denote a comment line in the keys file

See Also:

Constant Field Values

STD_KEYFILE_FOLDER_NAME

public static final String STD_KEYFILE_FOLDER_NAME

Standard folder name used by OpenSSH to hold key files

See Also:

Constant Field Values

Constructor Detail

PublicKeyEntry

public PublicKeyEntry()

PublicKeyEntry

public PublicKeyEntry(String keyType,
                      byte... keyData)

Method Detail

getKeyType

public String getKeyType()

setKeyType

public void setKeyType(String value)

getKeyData

public byte[] getKeyData()

setKeyData

public void setKeyData(byte[] value)

resolvePublicKey

public PublicKey resolvePublicKey(PublicKeyEntryResolver fallbackResolver)
                           throws IOException,
                                  GeneralSecurityException

Parameters:

fallbackResolver - The PublicKeyEntryResolver to consult if none of the built-in ones can be used. If null and no built-in resolver can be used then an InvalidKeySpecException is thrown.

Returns:

The resolved PublicKey - or null if could not be resolved. Note: may be called only after key type and data bytes have been set or exception(s) may be thrown

Throws:

IOException - If failed to decode the key

GeneralSecurityException - If failed to generate the key

appendPublicKey

public PublicKey appendPublicKey(Appendable sb,
                                 PublicKeyEntryResolver fallbackResolver)
                          throws IOException,
                                 GeneralSecurityException

Parameters:

sb - The Appendable instance to encode the data into

fallbackResolver - The PublicKeyEntryResolver to consult if none of the built-in ones can be used. If null and no built-in resolver can be used then an InvalidKeySpecException is thrown.

Returns:

The PublicKey or null if could not resolve it

Throws:

IOException - If failed to decode/encode the key

GeneralSecurityException - If failed to generate the key

See Also:

resolvePublicKey(PublicKeyEntryResolver)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

isEquivalent

protected boolean isEquivalent(PublicKeyEntry e)

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

parsePublicKeyEntry

public static PublicKeyEntry parsePublicKeyEntry(String encData)
                                          throws IllegalArgumentException

Parameters:

encData - Assumed to contain at least key-type base64-data (anything beyond the BASE64 data is ignored) - ignored if null/empty

Returns:

A PublicKeyEntry or null if no data

Throws:

IllegalArgumentException - if bad format found

See Also:

parsePublicKeyEntry(PublicKeyEntry, String)

parsePublicKeyEntry

public static <E extends PublicKeyEntry> E parsePublicKeyEntry(E entry,
                                                               String encData)
                                                        throws IllegalArgumentException

Type Parameters:

E - The generic entry type

Parameters:

entry - The PublicKeyEntry whose contents are to be updated - ignored if null

encData - Assumed to contain at least key-type base64-data (anything beyond the BASE64 data is ignored) - ignored if null/empty

Returns:

The updated entry instance

Throws:

IllegalArgumentException - if bad format found

toString

public static String toString(PublicKey key)
                       throws IllegalArgumentException

Parameters:

key - The PublicKey

Returns:

The OpenSSH encoded data

Throws:

IllegalArgumentException - If failed to encode

See Also:

appendPublicKeyEntry(Appendable, PublicKey)

appendPublicKeyEntry

public static <A extends Appendable> A appendPublicKeyEntry(A sb,
                                                            PublicKey key)
                                                     throws IOException

Encodes a public key data the same way as the parsePublicKeyEntry(String) expects it

Type Parameters:

A - The generic appendable class

Parameters:

sb - The Appendable instance to encode the data into

key - The PublicKey - ignored if null

Returns:

The updated appendable instance

Throws:

IOException - If failed to append the data

getDefaultKeysFolderPath

public static Path getDefaultKeysFolderPath()

Returns:

The default OpenSSH folder used to hold key files - e.g., known_hosts, authorized_keys, etc.