org.eclipse.californium.elements.auth

Class RawPublicKeyIdentity

java.lang.Object

org.eclipse.californium.elements.auth.RawPublicKeyIdentity

All Implemented Interfaces:

Principal

public class RawPublicKeyIdentity
extends Object
implements Principal

A principal representing an authenticated peer's RawPublicKey.

Constructor Summary

Constructors

Constructor and Description
RawPublicKeyIdentity(byte[] subjectInfo) Creates a new instance for a given ASN.1 subject public key info structure.
RawPublicKeyIdentity(byte[] subjectInfo, String keyAlgorithm) Creates a new instance for a given ASN.1 subject public key info structure.
RawPublicKeyIdentity(PublicKey key) Creates a new instance for a given public key.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj) Checks if this instance is equal to another object.
PublicKey	getKey() Gets the raw public key.
String	getName() Gets the Named Information URI representing this raw public key.
byte[]	getSubjectInfo() Gets the key's ASN.1 encoded SubjectPublicKeyInfo.
int	hashCode() Creates a hash code based on the key's ASN.1 encoded SubjectPublicKeyInfo.
String	toString() Gets a string representation of this principal.

Methods inherited from class java.lang.Object

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

Constructor Detail

RawPublicKeyIdentity

public RawPublicKeyIdentity(PublicKey key)

Creates a new instance for a given public key.

Parameters:

key - the public key

Throws:

NullPointerException - if the key is null

RawPublicKeyIdentity

public RawPublicKeyIdentity(byte[] subjectInfo)
                     throws GeneralSecurityException

Creates a new instance for a given ASN.1 subject public key info structure.

The given subject info is expected to represent an EC public key.

Parameters:

subjectInfo - the ASN.1 encoded X.509 subject public key info.

Throws:

NullPointerException - if the subject info is null

GeneralSecurityException - if the JVM does not support the key algorithm used by the public key.

RawPublicKeyIdentity

public RawPublicKeyIdentity(byte[] subjectInfo,
                    String keyAlgorithm)
                     throws GeneralSecurityException

Creates a new instance for a given ASN.1 subject public key info structure.

Parameters:

subjectInfo - the ASN.1 encoded X.509 subject public key info.

keyAlgorithm - the algorithm name to verify, that the subject public key uses this key algorithm, or to support currently not supported key algorithms for serialization/deserialization. If null, use the to key algorithm provided by the ASN.1 DER encoded subject public key.

Throws:

NullPointerException - if the subject info is null

GeneralSecurityException - if the JVM does not support the given key algorithm.

Method Detail

getName

public final String getName()

Gets the Named Information URI representing this raw public key. The URI is created using the SHA-256 hash algorithm on the key's SubjectPublicKeyInfo as described in RFC 6920, section 2.

Specified by:

getName in interface Principal

Returns:

the named information URI

getKey

public final PublicKey getKey()

Gets the raw public key.

Returns:

the key

getSubjectInfo

public final byte[] getSubjectInfo()

Gets the key's ASN.1 encoded SubjectPublicKeyInfo.

Returns:

the subject info

toString

public String toString()

Gets a string representation of this principal. Clients should not assume any particular format of the returned string since it may change over time.

Specified by:

toString in interface Principal

Overrides:

toString in class Object

Returns:

the string representation

hashCode

public int hashCode()

Creates a hash code based on the key's ASN.1 encoded SubjectPublicKeyInfo.

Specified by:

hashCode in interface Principal

Overrides:

hashCode in class Object

Returns:

the hash code

equals

public boolean equals(Object obj)

Checks if this instance is equal to another object.

Specified by:

equals in interface Principal

Overrides:

equals in class Object

Returns:

true if the other object is a RawPublicKeyIdentity and has the same SubjectPublicKeyInfo as this instance