iaik.security.ec.eddsa

Class EdDSAPrivateKey

java.lang.Object

iaik.pkcs.pkcs8.PrivateKeyInfo

iaik.security.ec.common.AbstractECPrivateKey

iaik.security.ec.common.EdPrivateKey

iaik.security.ec.eddsa.EdDSAPrivateKey

All Implemented Interfaces:

iaik.asn1.ASN1Type, EdKey, Serializable, Cloneable, ECKey, ECPrivateKey, Key, PrivateKey, Destroyable

public final class EdDSAPrivateKey
extends EdPrivateKey

Representation of a private key for EdDSA algorithms and implementation of the ECPrivateKey interface. It is derived from PrivateKeyInfo, which makes it suitable for use with PKCS#8.

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:

Christian Hanser, Sebastian Ramacher

See Also:

EdKey, EdPublicKey, EdPublicKeySpec, EdDSAKeyPairGenerator, EdDSAPrivateKeySpec, Serialized Form

Field Summary

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

seed_

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

encodedPrivateKey_, params_, s_, w_

Fields inherited from class iaik.pkcs.pkcs8.PrivateKeyInfo

private_key_algorithm

Fields inherited from interface java.security.interfaces.ECPrivateKey

serialVersionUID

Constructor Summary

Constructors

Constructor and Description
EdDSAPrivateKey(byte[] encoded) Constructs a new EdDSAPrivateKey from an encoded ASN.1 structure.
EdDSAPrivateKey(EdDSAPrivateKeySpec keySpec) Constructs a new EdDSAPrivateKey from an IAIK EdDSAPrivateKeySpec object.
EdDSAPrivateKey(EdParameterSpec params, byte[] seed) Constructs a new ECPrivateKey from a set of curve parameters and a private key seed.
EdDSAPrivateKey(EdParameterSpec params, byte[] seed, byte[] hash, BigInteger s, ECPoint w) Constructs a new ECPrivateKey from a set of curve parameters and a private key seed and all derived values.

Method Summary

Modifier and Type	Method and Description
protected ECPoint	computeOrGetW() Check if public point is set and return it.
protected void	decode(byte[] privateKey) Decodes the DER encoded private key.
protected void	finalize()
String	getAlgorithm()

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

computeS, createEncodedPrivateKey, getKeyLength, getParams, getPublicKey, getSeed, toString

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

encode, equals, getS, hashCode

Methods inherited from class iaik.pkcs.pkcs8.PrivateKeyInfo

clone, createPrivateKeyInfo, decode, getAlgorithmID, getAttributes, getEncoded, getFormat, getPrivateKey, getPrivateKey, getPrivateKey, getPrivateKey, getPrivateKey, getPrivateKey, getPubKey, setAttributes, setPubKey, toASN1Object, writeTo

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.security.Key

getEncoded, getFormat

Methods inherited from interface javax.security.auth.Destroyable

destroy, isDestroyed

Constructor Detail

EdDSAPrivateKey

public EdDSAPrivateKey(EdDSAPrivateKeySpec keySpec)

Constructs a new EdDSAPrivateKey from an IAIK EdDSAPrivateKeySpec object.

Parameters:

keySpec - the private key spec

EdDSAPrivateKey

public EdDSAPrivateKey(byte[] encoded)
                throws InvalidKeyException

Constructs a new EdDSAPrivateKey from an encoded ASN.1 structure.

Parameters:

encoded - the byte[] holding the ASN.1 structure

Throws:

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

EdDSAPrivateKey

public EdDSAPrivateKey(EdParameterSpec params,
                       byte[] seed)

Constructs a new ECPrivateKey from a set of curve parameters and a private key seed.

Parameters:

params - the curve parameters

seed - the private key

EdDSAPrivateKey

public EdDSAPrivateKey(EdParameterSpec params,
                       byte[] seed,
                       byte[] hash,
                       BigInteger s,
                       ECPoint w)

Constructs a new ECPrivateKey from a set of curve parameters and a private key seed and all derived values.

Parameters:

params - the curve parameters

seed - the private key

hash - hash expanded from the seed

s - secret scalar extracted from hash

w - public key

Method Detail

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class EdPrivateKey

Throws:

Throwable

decode

protected void decode(byte[] privateKey)
               throws InvalidKeyException

Decodes the DER encoded private key.

Overrides:

decode in class EdPrivateKey

Parameters:

privateKey - the DER byte array.

Throws:

InvalidKeyException - if the provided key data is invalid.

See Also:

AbstractECPrivateKey.encode()

getAlgorithm

public String getAlgorithm()

Specified by:

getAlgorithm in interface Key

Overrides:

getAlgorithm in class EdPrivateKey

computeOrGetW

protected ECPoint computeOrGetW()

Description copied from class: EdPrivateKey

Check if public point is set and return it. If not, re-compute it.

Overrides:

computeOrGetW in class EdPrivateKey

Returns:

the public point