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)
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 File	getDefaultKeysFolder()
byte[]	getKeyData()
String	getKeyType()
int	hashCode()
protected boolean	isEquivalent(PublicKeyEntry e)
static <E extends PublicKeyEntry> E	parsePublicKeyEntry(E entry, String data)
static PublicKeyEntry	parsePublicKeyEntry(String data)
PublicKey	resolvePublicKey()
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()
                           throws IOException,
                                  GeneralSecurityException

Returns:

The resolved PublicKey - never null. 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)
                          throws IOException,
                                 GeneralSecurityException

Parameters:

sb - The Appendable instance to encode the data into

Returns:

The PublicKey

Throws:

IOException - If failed to decode/encode the key

GeneralSecurityException - If failed to generate the key

See Also:

resolvePublicKey()

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 final PublicKeyEntry parsePublicKeyEntry(String data)
                                                throws IllegalArgumentException

Parameters:

data - 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 final <E extends PublicKeyEntry> E parsePublicKeyEntry(E entry,
                                                                     String data)
                                                              throws IllegalArgumentException

Type Parameters:

E - The generic entry type

Parameters:

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

data - 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

Returns:

The updated appendable instance

Throws:

IOException - If failed to append the data

getDefaultKeysFolder

public static File getDefaultKeysFolder()

Returns:

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