com.entrust.toolkit.security.provider

Class ECDSAKeyFactory

java.lang.Object

java.security.KeyFactorySpi

com.entrust.toolkit.security.provider.ECDSAKeyFactory

Deprecated.

since 7.2 SP2; use EcKeyFactory instead

public final class ECDSAKeyFactory
extends java.security.KeyFactorySpi

The ECDSAKeyFactory class converts ECDSA keys (opaque representation) to their KeySpecs (transparent representation) and vice versa.

• ECDSAPublicKey <--> ECDSAPublicKeySpec or X509EncodedKeySpec
• ECDSAPrivateKey <--> ECDSAPrivateKeySpec or PKCS8EncodedKeySpec

For example, to convert DER encoded PKCS#8 private key material (such as pkcs8_key_spec instantiated from PKCS8EncodedKeySpec) into an ECDSAPrivateKey representation, use this KeyFactory for DSA keys:

 
 KeyFactory ecdsa_key_fac = KeyFactory.getInstance("ECDSA");
 DSAPrivateKey ecdsa_priv_key = (ECDSAPrivateKey) ecdsa_key_fac.generatePrivate(pkcs8_key_spec);
 
 

See Also:

ECDSAPrivateKey, ECDSAPublicKey

Constructor Summary

Constructors

Constructor and Description
ECDSAKeyFactory() Deprecated. Default constructor for creating a DSAKeyFactory.

Method Summary

Methods

Modifier and Type	Method and Description
protected java.security.PrivateKey	engineGeneratePrivate(java.security.spec.KeySpec keySpec) Deprecated. Converts the given key specification to a PrivateKey.
protected java.security.PublicKey	engineGeneratePublic(java.security.spec.KeySpec keySpec) Deprecated. Converts the given key specification to a PublicKey.
protected java.security.spec.KeySpec	engineGetKeySpec(java.security.Key key, java.lang.Class classSpec) Deprecated. Converts the given key into the requested key specification (key material).
protected java.security.Key	engineTranslateKey(java.security.Key key) Deprecated. Translates the key argument of an unknown or untrusted provider into a Key object supported by this ECDSA key factory.

Methods inherited from class java.lang.Object

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

Constructor Detail

ECDSAKeyFactory

public ECDSAKeyFactory()

Deprecated.

Default constructor for creating a DSAKeyFactory.

Applications must use KeyFactory.getInstance("ECDSA"); for instantiating a DSAKeyFactory.

Method Detail

engineGeneratePrivate

protected java.security.PrivateKey engineGeneratePrivate(java.security.spec.KeySpec keySpec)
                                                  throws java.security.spec.InvalidKeySpecException

Deprecated.

Converts the given key specification to a PrivateKey.

The given key material can be either an ECDSAPrivateKeySpec object or a PKCS8EncodedKeySpec object.

Specified by:

engineGeneratePrivate in class java.security.KeyFactorySpi

Parameters:

keySpec - the key specification as ECDSAPrivateKeySpec or as PKCS8EncodedKeySpec

Returns:

the resulting PrivateKey

Throws:

java.security.spec.InvalidKeySpecException - if the given key material is not an ECDSAPrivateKeySpec obect or a PKCS8EncodedKeySpec object

engineGeneratePublic

protected java.security.PublicKey engineGeneratePublic(java.security.spec.KeySpec keySpec)
                                                throws java.security.spec.InvalidKeySpecException

Deprecated.

Converts the given key specification to a PublicKey.

The given key material can be either an ECDSAPublicKeySpec object or an X509EncodedKeySpec object.

Specified by:

engineGeneratePublic in class java.security.KeyFactorySpi

Parameters:

keySpec - the key specification as ECDSAPublicKeySpec or as X509EncodedKeySpec

Returns:

the resulting PublicKey

Throws:

java.security.spec.InvalidKeySpecException - if the given key material is neither an ECDSAPublicKeySpec object nor an X509EncodedKeySpec object

engineGetKeySpec

protected java.security.spec.KeySpec engineGetKeySpec(java.security.Key key,
                                          java.lang.Class classSpec)
                                               throws java.security.spec.InvalidKeySpecException

Deprecated.

Converts the given key into the requested key specification (key material).

The key argument can be either an ECDSAPublicKey object or an ECDSAPrivateKey object.

If the key argument is a ECDSAPublicKey, this method can create only one of the following key specifications:

• ECDSAPublicKeySpec
• X509EncodedKeySpec

If the key argument is an ECDSAPrivateKey, this method can create either of the following key specifications (depending on which of the two specifications is requested in the classSpec argument):

• ECDSAPrivateKeySpec
• PKCS8EncodedKeySpec

Every attempt to retrieve key material of a type not matching a given ECDSA key will throw an exception.

Specified by:

engineGetKeySpec in class java.security.KeyFactorySpi

Parameters:

key - the key to be converted — either an ECDSAPublicKey or an ECDSAPrivateKey

classSpec - the key specification type into which the key is to be converted. If the key argument is a ECDSAPublicKey, classSpec can be either of the following:

• ECDSAPublicKeySpec
• X509EncodedKeySpec

If the key argument is a ECDSAPrivateKey, classSpec can be either of the following:

• ECDSAPrivateKeySpec
• PKCS8EncodedKeySpec

Returns:

the key specification (key material) derived from the given key

Throws:

java.security.spec.InvalidKeySpecException - if the given key cannot be converted into the requested key specification object. Always thrown (method is not supported).

engineTranslateKey

protected java.security.Key engineTranslateKey(java.security.Key key)
                                        throws java.security.InvalidKeyException

Deprecated.

Translates the key argument of an unknown or untrusted provider into a Key object supported by this ECDSA key factory.

This method can translate only those keys of type ECDSAPublicKey and >ECDSAPrivateKey.

Specified by:

engineTranslateKey in class java.security.KeyFactorySpi

Parameters:

key - the key of an unknown or untrusted provider

Returns:

the translated key

Throws:

java.security.InvalidKeyException - if the given key cannot be translated by this key factory. Always thrown (method is not supported)