iaik.security.cipher
Class GeneralKeyFactory

java.lang.Object
  |
  +--javax.crypto.SecretKeyFactorySpi
        |
        +--iaik.security.cipher.GeneralKeyFactory

public class GeneralKeyFactory

extends SecretKeyFactorySpi

This class is the SecretKeyFactory for all symmetric ciphers supported by the IAIK. It supports SecretKeySpec, DESKeySpec, and DESedeKeySpec. The keys generated by engineGenerateSecret() will be of a length valid for the particular algorithm possibly truncating the key or filling it up with zeros.

Version:

File Revision 15

Constructor Summary

GeneralKeyFactory()
Constructor used by getInstance().

Method Summary

protected SecretKey	engineGenerateSecret(KeySpec keySpec) Converts the given key specification (key material) into a SecretKey object.
protected KeySpec	engineGetKeySpec(SecretKey secretKey, Class classSpec) Converts the given secret key into the requested key specification (key material).
protected SecretKey	engineTranslateKey(SecretKey secretKey) Translates a key object of some unknown or untrusted provider into a secret key object of this key factory.

Methods inherited from class java.lang.Object

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

Constructor Detail

GeneralKeyFactory

public GeneralKeyFactory()

Constructor used by getInstance().

Method Detail

engineGenerateSecret

protected SecretKey engineGenerateSecret(KeySpec keySpec)
                                  throws InvalidKeySpecException

Converts the given key specification (key material) into a SecretKey object.

The supplied keySpec may be an instance of javax.crypto.spec.SecretKeySpec, javax.crypto.spec.DESKeySpec or javax.crypto.spec.DESedeKeySpec.

Overrides:

engineGenerateSecret in class SecretKeyFactorySpi

Parameters:

keySpec - the specification (key material) to be converted into SecretKey representation.

Returns:

the SecretKey object

Throws:

InvalidKeySpecException - if the given key material cannot be converted into a SecretKey object by this key factory

engineGetKeySpec

protected KeySpec engineGetKeySpec(SecretKey secretKey,
                                   Class classSpec)
                            throws InvalidKeySpecException

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

This method may be used for getting a javax.crypto.spec.SecretKeySpec, javax.crypto.spec.DESKeySpec, or javax.crypto.spec.DESedeKeySpec from the given secret key.

Overrides:

engineGetKeySpec in class SecretKeyFactorySpi

Parameters:

secretKey - the secret key to be converted

classSpec - the class implementing the requested secret key spec

Returns:

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

Throws:

InvalidKeySpecException - if the given secret key cannot be converted into the requested key specification object by this key factory

engineTranslateKey

protected SecretKey engineTranslateKey(SecretKey secretKey)
                                throws InvalidKeyException

Translates a key object of some unknown or untrusted provider into a secret key object of this key factory.

Overrides:

engineTranslateKey in class SecretKeyFactorySpi

Parameters:

secretKey - the key of some unknown or untrusted provider

Returns:

the translated key

Throws:

InvalidKeyException - if the given key cannot be translated by this key factory