org.apache.sshd.common.config.keys

Class AuthorizedKeyEntry

java.lang.Object

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

org.apache.sshd.common.config.keys.AuthorizedKeyEntry

All Implemented Interfaces:

Serializable

public class AuthorizedKeyEntry
extends PublicKeyEntry

Represents an entry in the user's authorized_keys file according to the OpenSSH format. Note: equals/hashCode check only the key type and data - the comment and/or login options are not considered part of equality

Author:

Apache MINA SSHD Project

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.sshd.common.config.keys.PublicKeyEntry

COMMENT_CHAR, STD_KEYFILE_FOLDER_NAME

Constructor Summary

Constructors

Constructor and Description
AuthorizedKeyEntry()

Method Summary

Modifier and Type	Method and Description
PublicKey	appendPublicKey(Appendable sb, PublicKeyEntryResolver fallbackResolver)
boolean	equals(Object obj)
static PublickeyAuthenticator	fromAuthorizedEntries(PublicKeyEntryResolver fallbackResolver, Collection<? extends AuthorizedKeyEntry> entries)
String	getComment()
Map<String,String>	getLoginOptions()
int	hashCode()
static AuthorizedKeyEntry	parseAuthorizedKeyEntry(String value)
static NavigableMap<String,String>	parseLoginOptions(String options)
static List<AuthorizedKeyEntry>	readAuthorizedKeys(BufferedReader rdr)
static List<AuthorizedKeyEntry>	readAuthorizedKeys(File file) Reads read the contents of an authorized_keys file
static List<AuthorizedKeyEntry>	readAuthorizedKeys(InputStream in, boolean okToClose) Reads read the contents of an authorized_keys file
static List<AuthorizedKeyEntry>	readAuthorizedKeys(Path path, OpenOption... options) Reads read the contents of an authorized_keys file
static List<AuthorizedKeyEntry>	readAuthorizedKeys(Reader rdr, boolean okToClose) Reads read the contents of an authorized_keys file
static List<AuthorizedKeyEntry>	readAuthorizedKeys(String filePath) Reads read the contents of an authorized_keys file
static List<AuthorizedKeyEntry>	readAuthorizedKeys(URL url) Reads read the contents of an authorized_keys file
static List<PublicKey>	resolveAuthorizedKeys(PublicKeyEntryResolver fallbackResolver, Collection<? extends AuthorizedKeyEntry> entries)
void	setComment(String value)
void	setLoginOptions(Map<String,String> value)
String	toString()

Methods inherited from class org.apache.sshd.common.config.keys.PublicKeyEntry

appendPublicKeyEntry, getDefaultKeysFolderPath, getKeyData, getKeyType, isEquivalent, parsePublicKeyEntry, parsePublicKeyEntry, resolvePublicKey, setKeyData, setKeyType, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AuthorizedKeyEntry

public AuthorizedKeyEntry()

Method Detail

getComment

public String getComment()

setComment

public void setComment(String value)

getLoginOptions

public Map<String,String> getLoginOptions()

setLoginOptions

public void setLoginOptions(Map<String,String> value)

appendPublicKey

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

Overrides:

appendPublicKey in class PublicKeyEntry

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:

PublicKeyEntry.resolvePublicKey(PublicKeyEntryResolver)

hashCode

public int hashCode()

Overrides:

hashCode in class PublicKeyEntry

equals

public boolean equals(Object obj)

Overrides:

equals in class PublicKeyEntry

toString

public String toString()

Overrides:

toString in class PublicKeyEntry

fromAuthorizedEntries

public static PublickeyAuthenticator fromAuthorizedEntries(PublicKeyEntryResolver fallbackResolver,
                                                           Collection<? extends AuthorizedKeyEntry> entries)
                                                    throws IOException,
                                                           GeneralSecurityException

Throws:

IOException

GeneralSecurityException

resolveAuthorizedKeys

public static List<PublicKey> resolveAuthorizedKeys(PublicKeyEntryResolver fallbackResolver,
                                                    Collection<? extends AuthorizedKeyEntry> entries)
                                             throws IOException,
                                                    GeneralSecurityException

Throws:

IOException

GeneralSecurityException

readAuthorizedKeys

public static List<AuthorizedKeyEntry> readAuthorizedKeys(URL url)
                                                   throws IOException

Reads read the contents of an authorized_keys file

Parameters:

url - The URL to read from

Returns:

A List of all the AuthorizedKeyEntry-ies found there

Throws:

IOException - If failed to read or parse the entries

See Also:

readAuthorizedKeys(InputStream, boolean)

readAuthorizedKeys

public static List<AuthorizedKeyEntry> readAuthorizedKeys(File file)
                                                   throws IOException

Reads read the contents of an authorized_keys file

Parameters:

file - The File to read from

Returns:

A List of all the AuthorizedKeyEntry-ies found there

Throws:

IOException - If failed to read or parse the entries

See Also:

readAuthorizedKeys(InputStream, boolean)

readAuthorizedKeys

public static List<AuthorizedKeyEntry> readAuthorizedKeys(Path path,
                                                          OpenOption... options)
                                                   throws IOException

Reads read the contents of an authorized_keys file

Parameters:

path - Path to read from

options - The OpenOptions to use - if unspecified then appropriate defaults assumed

Returns:

A List of all the AuthorizedKeyEntry-ies found there

Throws:

IOException - If failed to read or parse the entries

See Also:

readAuthorizedKeys(InputStream, boolean), Files.newInputStream(Path, OpenOption...)

readAuthorizedKeys

public static List<AuthorizedKeyEntry> readAuthorizedKeys(String filePath)
                                                   throws IOException

Reads read the contents of an authorized_keys file

Parameters:

filePath - The file path to read from

Returns:

A List of all the AuthorizedKeyEntry-ies found there

Throws:

IOException - If failed to read or parse the entries

See Also:

readAuthorizedKeys(InputStream, boolean)

readAuthorizedKeys

public static List<AuthorizedKeyEntry> readAuthorizedKeys(InputStream in,
                                                          boolean okToClose)
                                                   throws IOException

Reads read the contents of an authorized_keys file

Parameters:

in - The InputStream

okToClose - true if method may close the input stream regardless of whether successful or failed

Returns:

A List of all the AuthorizedKeyEntry-ies found there

Throws:

IOException - If failed to read or parse the entries

See Also:

readAuthorizedKeys(Reader, boolean)

readAuthorizedKeys

public static List<AuthorizedKeyEntry> readAuthorizedKeys(Reader rdr,
                                                          boolean okToClose)
                                                   throws IOException

Reads read the contents of an authorized_keys file

Parameters:

rdr - The Reader

okToClose - true if method may close the input stream regardless of whether successful or failed

Returns:

A List of all the AuthorizedKeyEntry-ies found there

Throws:

IOException - If failed to read or parse the entries

See Also:

readAuthorizedKeys(BufferedReader)

readAuthorizedKeys

public static List<AuthorizedKeyEntry> readAuthorizedKeys(BufferedReader rdr)
                                                   throws IOException

Parameters:

rdr - The BufferedReader to use to read the contents of an authorized_keys file

Returns:

A List of all the AuthorizedKeyEntry-ies found there

Throws:

IOException - If failed to read or parse the entries

See Also:

parseAuthorizedKeyEntry(String)

parseAuthorizedKeyEntry

public static AuthorizedKeyEntry parseAuthorizedKeyEntry(String value)
                                                  throws IllegalArgumentException

Parameters:

value - Original line from an authorized_keys file

Returns:

AuthorizedKeyEntry or null if the line is null/empty or a comment line

Throws:

IllegalArgumentException - If failed to parse/decode the line

See Also:

PublicKeyEntry.COMMENT_CHAR

parseLoginOptions

public static NavigableMap<String,String> parseLoginOptions(String options)