iaik.security.cipher

Class GeneralKeyFactory

java.lang.Object

javax.crypto.SecretKeyFactorySpi

iaik.security.cipher.GeneralKeyFactory

public class GeneralKeyFactory
extends javax.crypto.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 17

Constructor Summary

Constructors

Constructor and Description
GeneralKeyFactory() Constructor used by getInstance().

Method Summary

Methods

Modifier and Type	Method and Description
protected javax.crypto.SecretKey	engineGenerateSecret(java.security.spec.KeySpec keySpec) Converts the given key specification (key material) into a SecretKey object.
protected java.security.spec.KeySpec	engineGetKeySpec(javax.crypto.SecretKey secretKey, java.lang.Class classSpec) Converts the given secret key into the requested key specification (key material).
protected javax.crypto.SecretKey	engineTranslateKey(javax.crypto.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 javax.crypto.SecretKey engineGenerateSecret(java.security.spec.KeySpec keySpec)
                                               throws java.security.spec.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.

Specified by:

engineGenerateSecret in class javax.crypto.SecretKeyFactorySpi

Parameters:

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

Returns:

the SecretKey object

Throws:

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

engineGetKeySpec

protected java.security.spec.KeySpec engineGetKeySpec(javax.crypto.SecretKey secretKey,
                                          java.lang.Class classSpec)
                                               throws java.security.spec.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.

Specified by:

engineGetKeySpec in class javax.crypto.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:

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

engineTranslateKey

protected javax.crypto.SecretKey engineTranslateKey(javax.crypto.SecretKey secretKey)
                                             throws java.security.InvalidKeyException

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

Specified by:

engineTranslateKey in class javax.crypto.SecretKeyFactorySpi

Parameters:

secretKey - the key of some unknown or untrusted provider

Returns:

the translated key

Throws:

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