iaik.security.ec.common

Class ECKeyFactory

java.lang.Object

java.security.KeyFactorySpi

iaik.security.ec.common.ECKeyFactory

public final class ECKeyFactory
extends KeyFactorySpi

Implementation of the key factory service provider interface for ECC. The following transformations are implemented:

  ECPublicKey  <--> ECPublicKeySpec, X509EncodedKeySpec, java.security.spec.ECPublicKeySpec
  ECPrivateKey <--> ECPrivateKeySpec, PKCS8EncodedKeySpec, java.security.spec.ECPrivateKeySpec
 

Author:

Christian Hanser

See Also:

ECKey, ECPrivateKey, ECPrivateKeySpec, ECPublicKey, ECPublicKeySpec

Constructor Summary

Constructors

Constructor and Description
ECKeyFactory() Default constructor.

Method Summary

Modifier and Type	Method and Description
protected PrivateKey	engineGeneratePrivate(KeySpec keySpec) Generates a private key from the given key spec.
protected PublicKey	engineGeneratePublic(KeySpec keySpec) Generates a public key from the given key spec.
protected <T extends KeySpec> T	engineGetKeySpec(Key key, Class<T> keySpec) Implementation of the engine method.
protected Key	engineTranslateKey(Key key) Translates the given key object of some unknown or untrusted provider into a key object supported by this EC key factory.
static ECKey	translateKey(Key key) Translates a key to an ECKey.

Methods inherited from class java.lang.Object

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

Constructor Detail

ECKeyFactory

public ECKeyFactory()

Default constructor.

Method Detail

engineGeneratePublic

protected PublicKey engineGeneratePublic(KeySpec keySpec)
                                  throws InvalidKeySpecException

Generates a public key from the given key spec.

Specified by:

engineGeneratePublic in class KeyFactorySpi

Parameters:

keySpec - the key spec may be a X509EncodedKeySpec or a ECPublicKeySpec.

Returns:

the public key generated from the key spec.

Throws:

InvalidKeySpecException - if the key spec can is not supported or erroneous.

engineGeneratePrivate

protected PrivateKey engineGeneratePrivate(KeySpec keySpec)
                                    throws InvalidKeySpecException

Generates a private key from the given key spec.

Specified by:

engineGeneratePrivate in class KeyFactorySpi

Parameters:

keySpec - the key material; it may either be ECPrivateKeySpec or PKCS8EncodedKeySpec

Throws:

InvalidKeySpecException - if the key spec is not supported or erroneous

engineGetKeySpec

protected <T extends KeySpec> T engineGetKeySpec(Key key,
                                                 Class<T> keySpec)
                                          throws InvalidKeySpecException

Implementation of the engine method. Converts a key into its spec.

Specified by:

engineGetKeySpec in class KeyFactorySpi

Parameters:

key - the key to be converted (either ECPublicKey or ECPrivateKey)

keySpec - the key specification type. If the given key is of type ECPublicKey the keySpec may be ECPublicKeySpec or X509EncodedKeySpec. Otherwise (key is of type ECPrivateKey) the keySpec may be ECPrivateKeySpec or PKCS8EncodedKeySpec

Returns:

the corresponding key spec

Throws:

InvalidKeySpecException - if the key cannot be transformed into the provided keySpec.

engineTranslateKey

protected Key engineTranslateKey(Key key)
                          throws InvalidKeyException

Translates the given key object of some unknown or untrusted provider into a key object supported by this EC key factory. This method can only translate keys of type ECPublicKey or ECPrivateKey.

Specified by:

engineTranslateKey in class KeyFactorySpi

Parameters:

key - the key to be translated

Returns:

the translated key

Throws:

InvalidKeyException - if the given key cannot be translated

translateKey

public static ECKey translateKey(Key key)
                          throws InvalidKeyException

Translates a key to an ECKey.

Parameters:

key - the key object

Returns:

an EC key object

Throws:

InvalidKeyException - if the given key cannot be translated to an ECKey