iaik.pkcs.pkcs12

Class MacKeyGenerator

java.lang.Object

javax.crypto.KeyGeneratorSpi

iaik.pkcs.pkcs12.MacKeyGenerator

public class MacKeyGenerator
extends javax.crypto.KeyGeneratorSpi

KeyMaterialGenerator for deriving a PKCS#12 MAC-Key from a password, a salt and an iteration count, using SHA-1 as hash function. The generated MAC-SecretKey is used for the PKCS#12 MAC operations.

Version:

File Revision 10

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MacKeyGenerator.MacKeyGeneratorSha224 KeyMaterialGenerator for deriving a PKCS#12 MAC-Key from a password, a salt and an iteration count, using SHA-224 as hash function.
static class	MacKeyGenerator.MacKeyGeneratorSha256 KeyMaterialGenerator for deriving a PKCS#12 MAC-Key from a password, a salt and an iteration count, using SHA-256 as hash function.
static class	MacKeyGenerator.MacKeyGeneratorSha384 KeyMaterialGenerator for deriving a PKCS#12 MAC-Key from a password, a salt and an iteration count, using SHA-384 as hash function.
static class	MacKeyGenerator.MacKeyGeneratorSha512 KeyMaterialGenerator for deriving a PKCS#12 MAC-Key from a password, a salt and an iteration count, using SHA-512 as hash function.
static class	MacKeyGenerator.MacKeyGeneratorSha512_224 KeyMaterialGenerator for deriving a PKCS#12 MAC-Key from a password, a salt and an iteration count, using SHA-512/224 as hash function.
static class	MacKeyGenerator.MacKeyGeneratorSha512_256 KeyMaterialGenerator for deriving a PKCS#12 MAC-Key from a password, a salt and an iteration count, using SHA-512/256 as hash function.

Constructor Summary

Constructors

Constructor and Description
MacKeyGenerator() Default Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected javax.crypto.SecretKey	engineGenerateKey() Generates the desired key material and returns it as a SecretKey.
protected void	engineInit(java.security.spec.AlgorithmParameterSpec params, java.security.SecureRandom random) Inits this KeyMaterialGenerator.
protected void	engineInit(int keylen, java.security.SecureRandom random) Sets the length of the key to generate.
protected void	engineInit(java.security.SecureRandom random) Not implemented.

Methods inherited from class java.lang.Object

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

Constructor Detail

MacKeyGenerator

public MacKeyGenerator()

Default Constructor. Initializes the KeyMaterialGenerator for generating a MAC-SecretKey. SHA-1 is used as hash function.

Method Detail

engineInit

protected void engineInit(java.security.spec.AlgorithmParameterSpec params,
              java.security.SecureRandom random)
                   throws java.security.InvalidAlgorithmParameterException

Inits this KeyMaterialGenerator.

Specified by:

engineInit in class javax.crypto.KeyGeneratorSpi

Parameters:

params - the required parameters as PBEKeyAndParameterSpec

random - not needed by this key generator

Throws:

java.security.InvalidAlgorithmParameterException

engineInit

protected void engineInit(int keylen,
              java.security.SecureRandom random)

Sets the length of the key to generate.

Specified by:

engineInit in class javax.crypto.KeyGeneratorSpi

engineInit

protected void engineInit(java.security.SecureRandom random)

Not implemented.

Specified by:

engineInit in class javax.crypto.KeyGeneratorSpi

engineGenerateKey

protected javax.crypto.SecretKey engineGenerateKey()

Generates the desired key material and returns it as a SecretKey. Note that this method also returns IVs as SecretKey objects since there is no method for returning an IvParameterSpec. The algorithm name of the returned key is set to "RAW" and may be later changed by the calling application, if required:

 String algorithm = ...;
 KeyGenerator keyGen = KeyGenerator.getInstance("PKCS#12", "IAIK");
 ...
 iaik.security.cipher.SecretKey secretKey = (iaik.security.cipher.SecretKey)keyGen.generateKey();
 secretKey.setAlgorithm(algorithm);
 

Specified by:

engineGenerateKey in class javax.crypto.KeyGeneratorSpi