iaik.security.ec.common

Class AbstractECPrivateKey

java.lang.Object

iaik.pkcs.pkcs8.PrivateKeyInfo

iaik.security.ec.common.AbstractECPrivateKey

All Implemented Interfaces:

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

Direct Known Subclasses:

ECPrivateKey, EdPrivateKey

public abstract class AbstractECPrivateKey
extends iaik.pkcs.pkcs8.PrivateKeyInfo
implements ECPrivateKey, ECKey

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

PKCS#8 [1] defines a syntax for encapsulating private key information:

 PrivateKeyInfo ::= SEQUENCE {
   version Version,
   privateKeyAlgorithm PrivateKeyAlgorithmIdentifier,
   privateKey PrivateKey
   attributes [0] IMPLICIT Attributes OPTIONAL }
 

This class implements some common methods and defines interfaces for all EC private keys.

References:

[1] An RSA Laboratories Technical Note. 1993. PKCS #8: Private-Key Information Syntax Standard v2.1

Author:

Sebastian Ramacher, Christian Hanser

See Also:

AbstractECPublicKey, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected iaik.asn1.ASN1	encodedPrivateKey_ ASN.1 encoding of the private key.
protected ECParameterSpec	params_
protected BigInteger	s_
protected ECPoint	w_

Fields inherited from class iaik.pkcs.pkcs8.PrivateKeyInfo

private_key_algorithm

Fields inherited from interface java.security.interfaces.ECPrivateKey

serialVersionUID

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractECPrivateKey() Creates a new instance; only for internal use
	AbstractECPrivateKey(byte[] encoded) Constructs a new private key from an encoded ASN.1 structure.
	AbstractECPrivateKey(ECParameterSpec params, BigInteger s) Constructs a new private key from a set of curve parameters and a secret integer s.
	AbstractECPrivateKey(ECParameterSpec params, BigInteger s, ECPoint publicKey) Creates a new private key with the specified parameters.

Method Summary

Modifier and Type	Method and Description
protected abstract void	createEncodedPrivateKey() Creates the ASN.1 private key structure.
protected byte[]	encode()
boolean	equals(Object obj)
protected void	finalize()
ECParameterSpec	getParams() Returns the domain parameters of the associated elliptic curve.
abstract AbstractECPublicKey	getPublicKey() Returns the corresponding AbstractECPublicKey.
BigInteger	getS()
int	hashCode()

Methods inherited from class iaik.pkcs.pkcs8.PrivateKeyInfo

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

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.security.Key

getAlgorithm, getEncoded, getFormat

Methods inherited from interface javax.security.auth.Destroyable

destroy, isDestroyed

Methods inherited from interface iaik.security.ec.common.ECKey

getKeyLength

Field Detail

encodedPrivateKey_

protected transient iaik.asn1.ASN1 encodedPrivateKey_

ASN.1 encoding of the private key.

s_

protected transient BigInteger s_

params_

protected transient ECParameterSpec params_

w_

protected transient ECPoint w_

Constructor Detail

AbstractECPrivateKey

public AbstractECPrivateKey(byte[] encoded)
                     throws InvalidKeyException

Constructs a new private key 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

AbstractECPrivateKey

public AbstractECPrivateKey(ECParameterSpec params,
                            BigInteger s)

Constructs a new private key from a set of curve parameters and a secret integer s.

Parameters:

params - the curve parameters

s - the private key

AbstractECPrivateKey

public AbstractECPrivateKey(ECParameterSpec params,
                            BigInteger s,
                            ECPoint publicKey)

Creates a new private key with the specified parameters.

Parameters:

params - the domain parameters

s - the private key

publicKey - the corresponding public key (may be null)

AbstractECPrivateKey

protected AbstractECPrivateKey()

Creates a new instance; only for internal use

Method Detail

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

encode

protected byte[] encode()

Specified by:

encode in class iaik.pkcs.pkcs8.PrivateKeyInfo

createEncodedPrivateKey

protected abstract void createEncodedPrivateKey()

Creates the ASN.1 private key structure.

getParams

public ECParameterSpec getParams()

Description copied from interface: ECKey

Returns the domain parameters of the associated elliptic curve.

Specified by:

getParams in interface ECKey

Returns:

the curve domain parameters

getS

public BigInteger getS()

Specified by:

getS in interface ECPrivateKey

hashCode

public int hashCode()

Overrides:

hashCode in class iaik.pkcs.pkcs8.PrivateKeyInfo

equals

public boolean equals(Object obj)

Overrides:

equals in class iaik.pkcs.pkcs8.PrivateKeyInfo

getPublicKey

public abstract AbstractECPublicKey getPublicKey()

Returns the corresponding AbstractECPublicKey.

Returns:

the corresponding AbstractECPublicKey