iaik.security.ec.common

Class EdPublicKey

java.lang.Object

iaik.x509.PublicKeyInfo

iaik.security.ec.common.AbstractECPublicKey

iaik.security.ec.common.EdPublicKey

All Implemented Interfaces:

iaik.asn1.ASN1Type, EdKey, Serializable, Cloneable, ECKey, ECPublicKey, Key, PublicKey

public class EdPublicKey
extends AbstractECPublicKey
implements EdKey

Representation of a public key for EdDSA/EdDH algorithms. It is derived from PublicKeyInfo which makes it suitable for use in X.509 certificates.

References:

[1] Algorithm Identifiers for Ed25519, Ed448, X25519 and X448 for use in the Internet X.409 Public Key Infrastructure. S. Josefsson and J. Schaad. https://tools.ietf.org/html/draft-ietf-curdle-pkix-04

Author:

Sebastian Ramacher

See Also:

EdKey, EdPublicKeySpec, X25519KeyPairGenerator, X448KeyPairGenerator, EdDSAPrivateKey, EdDSA25519KeyPairGenerator, EdDSA448KeyPairGenerator, Serialized Form

Field Summary

Fields inherited from class iaik.security.ec.common.AbstractECPublicKey

encodedPublicKey_, params_, w_

Fields inherited from class iaik.x509.PublicKeyInfo

public_key_algorithm

Fields inherited from interface java.security.interfaces.ECPublicKey

serialVersionUID

Constructor Summary

Constructors

Constructor and Description
EdPublicKey(iaik.asn1.ASN1Object keyObj) Creates a new public key from an ASN.1 object.
EdPublicKey(byte[] encoded) Creates a new public key from an ASN.1 encoded DER byte array.
EdPublicKey(EdParameterSpec params, byte[] wBytes) Creates a new public key object.
EdPublicKey(EdParameterSpec params, ECPoint w) Creates a new public key object.
EdPublicKey(EdParameterSpec params, ECPoint w, boolean check) Creates a new public key object.
EdPublicKey(EdPublicKeySpec keySpec) Creates a new public key object from a spec.
EdPublicKey(InputStream is) Reads the DER or BER encoded public key info from an input stream.

Method Summary

Modifier and Type	Method and Description
protected void	createEncodedPublicKey() Creates the ASN.1 public key structure.
protected void	decode(byte[] publicKey)
boolean	equals(Object obj)
String	getAlgorithm()
int	getKeyLength() Returns the key length of this ECKey.
EdParameterSpec	getParams() Returns the domain parameters of the associated elliptic curve.
byte[]	getWBytes() Return encoded public key point.
int	hashCode()
boolean	isValid() Determines whether this public key is valid, i.e.
String	toString()

Methods inherited from class iaik.security.ec.common.AbstractECPublicKey

encode, getW

Methods inherited from class iaik.x509.PublicKeyInfo

clone, createPublicKeyInfo, decode, getAlgorithmID, getEncoded, getFingerprint, getFormat, getPublicKey, getPublicKey, getPublicKey, getPublicKey, getPublicKey, getPublicKey, toASN1Object, writeTo

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.security.Key

getEncoded, getFormat

Constructor Detail

EdPublicKey

public EdPublicKey(EdParameterSpec params,
                   ECPoint w)

Creates a new public key object.

Parameters:

params - the domain parameters of the elliptic curve

w - the point on the curve, satisfying W = s*G

EdPublicKey

public EdPublicKey(EdParameterSpec params,
                   ECPoint w,
                   boolean check)

Creates a new public key object.

Parameters:

params - the domain parameters of the elliptic curve

w - the point on the curve, satisfying W = s*G

check - check if w is a valid point

EdPublicKey

public EdPublicKey(byte[] encoded)
            throws InvalidKeyException

Creates a new public key from an ASN.1 encoded DER byte array.

Parameters:

encoded - the byte array

Throws:

InvalidKeyException - thrown if the given encoded key could not be decoded

EdPublicKey

public EdPublicKey(iaik.asn1.ASN1Object keyObj)
            throws InvalidKeyException

Creates a new public key from an ASN.1 object.

Parameters:

keyObj - the ASN.1 object holding the public key information

Throws:

InvalidKeyException - if the given ASN1Object does not hold a valid EdDSA public key

EdPublicKey

public EdPublicKey(InputStream is)
            throws IOException,
                   InvalidKeyException

Reads the DER or BER encoded public key info from an input stream.

Parameters:

is - the input stream providing the data

Throws:

InvalidKeyException - if the provided key data is invalid

IOException - if the I/O error occurs

EdPublicKey

public EdPublicKey(EdPublicKeySpec keySpec)

Creates a new public key object from a spec.

Parameters:

keySpec - the key material

EdPublicKey

public EdPublicKey(EdParameterSpec params,
                   byte[] wBytes)

Creates a new public key object.

Parameters:

params - the domain parameters of the elliptic curve

wBytes - the (encoded) point on the curve, satisfying W = s*G

Method Detail

getParams

public EdParameterSpec getParams()

Description copied from interface: ECKey

Returns the domain parameters of the associated elliptic curve.

Specified by:

getParams in interface EdKey

Specified by:

getParams in interface ECKey

Overrides:

getParams in class AbstractECPublicKey

Returns:

the curve domain parameters

decode

protected void decode(byte[] publicKey)
               throws InvalidKeyException

Specified by:

decode in class iaik.x509.PublicKeyInfo

Throws:

InvalidKeyException

getAlgorithm

public String getAlgorithm()

Specified by:

getAlgorithm in interface Key

Specified by:

getAlgorithm in class iaik.x509.PublicKeyInfo

getKeyLength

public int getKeyLength()

Description copied from interface: ECKey

Returns the key length of this ECKey.

Returns:

the key length in bits

createEncodedPublicKey

protected void createEncodedPublicKey()

Description copied from class: AbstractECPublicKey

Creates the ASN.1 public key structure.

Specified by:

createEncodedPublicKey in class AbstractECPublicKey

hashCode

public int hashCode()

Overrides:

hashCode in class AbstractECPublicKey

equals

public boolean equals(Object obj)

Overrides:

equals in class AbstractECPublicKey

isValid

public boolean isValid()

Determines whether this public key is valid, i.e. the point is contained on the curve.

Specified by:

isValid in class AbstractECPublicKey

Returns:

true, iff the public key could be validated

toString

public String toString()

Overrides:

toString in class iaik.x509.PublicKeyInfo

getWBytes

public byte[] getWBytes()

Return encoded public key point.

Returns:

encoded public key