iaik.security.ec.common

Class EdKeyFactory

java.lang.Object

java.security.KeyFactorySpi

iaik.security.ec.common.EdKeyFactory

Direct Known Subclasses:

EdDSAKeyFactory

public class EdKeyFactory
extends KeyFactorySpi

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

  EdPublicKey  <--> EdPublicKeySpec, X509EncodedKeySpec
  EdPrivateKey <--> EdPrivateKeySpec, PKCS8EncodedKeySpec
 

Author:

Sebastian Ramacher

See Also:

EdKey, EdPrivateKey, EdPrivateKeySpec, EdPublicKey, EdPublicKeySpec

Constructor Summary

Constructors

Constructor and Description
EdKeyFactory() 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 EdPublicKey	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 EdKey	translateKey(Key key) Translates a key to an EdKey.
protected static EdPublicKey	translatePublicKey(PublicKey key) Translation routine for public keys.

Methods inherited from class java.lang.Object

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

Constructor Detail

EdKeyFactory

public EdKeyFactory()

Default constructor.

Method Detail

engineGeneratePublic

protected EdPublicKey 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 EdPublicKeySpec.

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 EdPrivateKeySpec 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 EdPublicKey or EdPrivateKey)

keySpec - the key specification type. If the given key is of type EdPublicKey the keySpec may be EdPublicKeySpec or X509EncodedKeySpec. Otherwise (key is of type EdPrivateKey) the keySpec may be EdPrivateKeySpec 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 EdPublicKey or EdPrivateKey.

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

translatePublicKey

protected static EdPublicKey translatePublicKey(PublicKey key)
                                         throws InvalidKeyException

Translation routine for public keys.

Parameters:

key - the public key to be translated

Returns:

the public key in its internal representation or null if it could not be converted

Throws:

InvalidKeyException - if the key could not be translated

translateKey

public static EdKey translateKey(Key key)
                          throws InvalidKeyException

Translates a key to an EdKey.

Parameters:

key - the key object

Returns:

an EC key object

Throws:

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