org.ejbca.cvc

Class PublicKeyEC

java.lang.Object

org.ejbca.cvc.CVCObject

org.ejbca.cvc.AbstractSequence

org.ejbca.cvc.CVCPublicKey

org.ejbca.cvc.PublicKeyEC

All Implemented Interfaces:

Serializable, ECKey, ECPublicKey, Key, PublicKey

public class PublicKeyEC
extends CVCPublicKey
implements ECPublicKey

Implements handling of a public key of Elliptic Curve type.

Version:

$Id$

Author:

Keijo Kurkinen, Swedish National Police Board

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static byte	UNCOMPRESSED_POINT_TAG Byte value indicating the start of an uncompressed Point data array

Fields inherited from class org.ejbca.cvc.CVCObject

CVC_VERSION, NEWLINE

Constructor Summary

Constructors

Constructor and Description
PublicKeyEC(GenericPublicKeyField genericKey) Creates an instance from a GenericPublicKeyField
PublicKeyEC(OIDField oid, ECPublicKey pubKeyEC, AuthorizationRole authRole) Creates an instance from an OIDField and a java.security.interfaces.ECPublicKey
PublicKeyEC(OIDField oid, ECPublicKey pubKeyEC, AuthorizationRoleEnum authRole) Creates an instance from an OIDField and a java.security.interfaces.ECPublicKey.

Method Summary

Modifier and Type	Method and Description
static ECPoint	decodePoint(byte[] data) Decodes an uncompressed ECPoint.
static byte[]	encodePoint(ECPoint ecPoint, EllipticCurve curve) Uncompressed encoding of a ECPoint according to BSI-TR-03111 chapter 3.1.1: 0x04 || enc(X) || enc(Y)
String	getAlgorithm()
protected CVCTagEnum[]	getAllowedFields() Returns tags for all allowed subfields, in the same order as they appear when DER-encoded
protected List<CVCObject>	getEncodableFields() Overridden method that enables us to control exactly which fields that are included when DER-encoding.
String	getFormat()
ECParameterSpec	getParams()
ECPoint	getW()

Methods inherited from class org.ejbca.cvc.CVCPublicKey

getEncoded, getObjectIdentifier, setObjectIdentifier

Methods inherited from class org.ejbca.cvc.AbstractSequence

encode, getAsText, getAsText, getDEREncoded, getOrderedSubfields, getSubfields

Methods inherited from class org.ejbca.cvc.CVCObject

decodeLength, encodeLength, getAsText, getAsText, getParent, getTag, setParent, toByteArray, toByteArray, trimByteArray

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.security.Key

getEncoded

Field Detail

UNCOMPRESSED_POINT_TAG

public static final byte UNCOMPRESSED_POINT_TAG

Byte value indicating the start of an uncompressed Point data array

See Also:

Constant Field Values

Constructor Detail

PublicKeyEC

public PublicKeyEC(GenericPublicKeyField genericKey)
            throws ConstructionException,
                   NoSuchFieldException

Creates an instance from a GenericPublicKeyField

Parameters:

genericKey -

Throws:

NoSuchFieldException

ConstructionException

PublicKeyEC

public PublicKeyEC(OIDField oid,
                   ECPublicKey pubKeyEC,
                   AuthorizationRole authRole)
            throws ConstructionException

Creates an instance from an OIDField and a java.security.interfaces.ECPublicKey

Parameters:

oid -

pubKeyEC -

authRole - role of certificate holder. If null or 'CVCA' all subfields are added, otherwise only the required ones.

Throws:

ConstructionException

PublicKeyEC

public PublicKeyEC(OIDField oid,
                   ECPublicKey pubKeyEC,
                   AuthorizationRoleEnum authRole)
            throws ConstructionException

Creates an instance from an OIDField and a java.security.interfaces.ECPublicKey. This seemingly redundant overloaded constructor is for binary (.class file) backwards compatibility. It is NOT deprecated to use these argument types.

Throws:

ConstructionException

Method Detail

getAllowedFields

protected CVCTagEnum[] getAllowedFields()

Description copied from class: AbstractSequence

Returns tags for all allowed subfields, in the same order as they appear when DER-encoded

Specified by:

getAllowedFields in class AbstractSequence

Returns:

getEncodableFields

protected List<CVCObject> getEncodableFields()

Overridden method that enables us to control exactly which fields that are included when DER-encoding. According to EAC Spec 1.11: CVCRequest must contain all fields, CVCA-certificate may have all, others must only have the required fields.

Overrides:

getEncodableFields in class AbstractSequence

Returns:

getAlgorithm

public String getAlgorithm()

Specified by:

getAlgorithm in interface Key

getFormat

public String getFormat()

Specified by:

getFormat in interface Key

getParams

public ECParameterSpec getParams()

Specified by:

getParams in interface ECKey

getW

public ECPoint getW()

Specified by:

getW in interface ECPublicKey

encodePoint

public static byte[] encodePoint(ECPoint ecPoint,
                                 EllipticCurve curve)

Uncompressed encoding of a ECPoint according to BSI-TR-03111 chapter 3.1.1: 0x04 || enc(X) || enc(Y)

Parameters:

ecPoint - the point to encode

curve - the curve used to get the field size, or null. If curve is given we can accurately decide the field size. If null is given we take the field size to be the largest of affineX.length and affineY.length, which will work in the majority of cases but might randomly produce the wrong result (a chance of 1 over 2^16).

Returns:

decodePoint

public static ECPoint decodePoint(byte[] data)

Decodes an uncompressed ECPoint. First byte must be 0x04, otherwise IllegalArgumentException is thrown.

Parameters:

data -

Returns: