com.ibm.crypto.fips.provider
Class AESKeyGenerator

java.lang.Object
  |
  +--javax.crypto.KeyGeneratorSpi
        |
        +--com.ibm.crypto.fips.provider.AESKeyGenerator
All Implemented Interfaces:
AlgorithmStatus

public final class AESKeyGenerator
extends javax.crypto.KeyGeneratorSpi
implements AlgorithmStatus

This class generates a secret key for use with the AES algorithm.

Version:
1.0, 11/26/01
Author:
Paschalis Kaltsatis

Constructor Summary
AESKeyGenerator()
          Verify the JCE framework in the constructor.
 
Method Summary
protected  javax.crypto.SecretKey engineGenerateKey()
          Generates a AES key.
protected  void engineInit(java.security.spec.AlgorithmParameterSpec params, java.security.SecureRandom random)
          Initializes this key generator with the specified parameter set and a user-provided source of randomness.
protected  void engineInit(int keysize, java.security.SecureRandom random)
          Initializes this key generator for a certain keysize, using the given source of randomness.
protected  void engineInit(java.security.SecureRandom random)
          Initializes this key generator.
protected  javax.crypto.SecretKey internalGenerateKey()
          Generates a AES key.
protected  void internalInit(java.security.spec.AlgorithmParameterSpec params, java.security.SecureRandom random)
          Initializes this key generator with the specified parameter set and a user-provided source of randomness.
protected  void internalInit(int keysize, java.security.SecureRandom random)
          Initializes this key generator for a certain keysize, using the given source of randomness.
protected  void internalInit(java.security.SecureRandom random)
          Initializes this key generator.
 boolean isFipsApproved()
          Module identifies if the cryptographic operation (algorithm) is FIPS certified
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AESKeyGenerator

public AESKeyGenerator()
Verify the JCE framework in the constructor.
Throws:
java.lang.SecurityException - if fails to verify the JCE framework.
Method Detail

isFipsApproved

public boolean isFipsApproved()
Description copied from interface: AlgorithmStatus
Module identifies if the cryptographic operation (algorithm) is FIPS certified
Specified by:
isFipsApproved in interface AlgorithmStatus
See Also:
AlgorithmStatus.isFipsApproved()

engineInit

protected void engineInit(java.security.SecureRandom random)
Initializes this key generator.
Overrides:
engineInit in class javax.crypto.KeyGeneratorSpi
Parameters:
random - the source of randomness for this generator
Throws:
FIPSRuntimeException - if SelfTest.isFipsRunnable returns false.

internalInit

protected void internalInit(java.security.SecureRandom random)
Initializes this key generator.
Parameters:
random - the source of randomness for this generator

engineInit

protected void engineInit(java.security.spec.AlgorithmParameterSpec params,
                          java.security.SecureRandom random)
                   throws java.security.InvalidAlgorithmParameterException
Initializes this key generator with the specified parameter set and a user-provided source of randomness.
Overrides:
engineInit in class javax.crypto.KeyGeneratorSpi
Parameters:
params - the key generation parameters
random - the source of randomness for this key generator
Throws:
java.security.InvalidAlgorithmParameterException - if params is inappropriate for this key generator
FIPSRuntimeException - if SelfTest.isFipsRunnable returns false.

internalInit

protected void internalInit(java.security.spec.AlgorithmParameterSpec params,
                            java.security.SecureRandom random)
                     throws java.security.InvalidAlgorithmParameterException
Initializes this key generator with the specified parameter set and a user-provided source of randomness.
Parameters:
params - the key generation parameters
random - the source of randomness for this key generator
Throws:
java.security.InvalidAlgorithmParameterException - if params is inappropriate for this key generator

engineInit

protected void engineInit(int keysize,
                          java.security.SecureRandom random)
Initializes this key generator for a certain keysize, using the given source of randomness.
Overrides:
engineInit in class javax.crypto.KeyGeneratorSpi
Parameters:
keysize - the keysize. This is an algorithm-specific metric specified in number of bits.
random - the source of randomness for this key generator
Throws:
FIPSRuntimeException - if SelfTest.isFipsRunnable returns false.

internalInit

protected void internalInit(int keysize,
                            java.security.SecureRandom random)
Initializes this key generator for a certain keysize, using the given source of randomness.
Parameters:
keysize - the keysize. This is an algorithm-specific metric specified in number of bits.
random - the source of randomness for this key generator

engineGenerateKey

protected javax.crypto.SecretKey engineGenerateKey()
Generates a AES key.
Overrides:
engineGenerateKey in class javax.crypto.KeyGeneratorSpi
Returns:
the new AES key
Throws:
FIPSRuntimeException - if SelfTest.isFipsRunnable returns false.

internalGenerateKey

protected javax.crypto.SecretKey internalGenerateKey()
Generates a AES key.
Returns:
the new AES key