de.cscc.crypto.provider
Class DESede3KeyCipherEngine

java.lang.Object
  javax.crypto.CipherSpi
      de.cscc.crypto.provider.DESBaseCipherEngine
          de.cscc.crypto.provider.DESede3KeyCipherEngine

public final class DESede3KeyCipherEngine

extends de.cscc.crypto.provider.DESBaseCipherEngine

This is the concret DESede3Key algorithm class, it subclasses DESBaseCipherEngine, because in JCE is no possiblity to set a cipher.

Constructor Summary

DESede3KeyCipherEngine()
Creates a new DESede3KeyCipherEngine object.

Method Summary

protected byte[]	engineDoFinal(byte[] input, int inputOffset, int inputLen) Encrypts or decrypts data in a single-part operation, or finishes a multiple-part operation.
protected int	engineDoFinal(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) Encrypts or decrypts data in a single-part operation, or finishes a multiple-part operation.
protected int	engineGetBlockSize() Returns the block size (in bytes).
protected byte[]	engineGetIV() Returns the initialization vector (IV) in a new buffer.
protected int	engineGetKeySize(Key key) Returns the key size of the given key object.
protected int	engineGetOutputSize(int inputLen) Returns the length in bytes that an output buffer would need to be in order to hold the result of the next update or doFinal operation, given the input length inputLen (in bytes).
protected AlgorithmParameters	engineGetParameters() Returns the parameters used with this cipher.
protected void	engineInit(int opmode, Key key, AlgorithmParameterSpec params, SecureRandom random) Initializes this cipher with a key, a set of algorithm parameters, and a source of randomness.
protected void	engineInit(int opmode, Key key, AlgorithmParameters params, SecureRandom random) Initializes this cipher with a key, a set of algorithm parameters, and a source of randomness.
protected void	engineInit(int opmode, Key key, SecureRandom random) Initializes this cipher with a key and a source of randomness.
protected void	engineSetMode(String mode) Sets the mode of this cipher.
protected void	engineSetPadding(String padding) Sets the padding mechanism of this cipher.
protected Key	engineUnwrap(byte[] wrappedKey, String wrappedKeyAlgorithm, int wrappedKeyType) Unwrap a previously wrapped key.
protected byte[]	engineUpdate(byte[] input, int inputOffset, int inputLen) Continues a multiple-part encryption or decryption operation (depending on how this cipher was initialized), processing another data part.
protected int	engineUpdate(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) Continues a multiple-part encryption or decryption operation (depending on how this cipher was initialized), processing another data part.
protected byte[]	engineWrap(Key key) Wrap a key.
String	toString() Returns a string representation of the object.

Methods inherited from class java.lang.Object

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

Constructor Detail

DESede3KeyCipherEngine

public DESede3KeyCipherEngine()

Creates a new DESede3KeyCipherEngine object.

Method Detail

toString

public String toString()

Returns a string representation of the object.

Returns:

a string representation of the object.

engineSetMode

protected void engineSetMode(String mode)
                      throws NoSuchAlgorithmException

Sets the mode of this cipher.

Parameters:

mode - the cipher mode.

Throws:

NoSuchAlgorithmException - if the requested cipher mode does not exist.

engineSetPadding

protected void engineSetPadding(String padding)
                         throws NoSuchPaddingException

Sets the padding mechanism of this cipher.

Parameters:

padding - the padding mechanism.

Throws:

NoSuchPaddingException - if the requested padding mechanism does not exist.

engineInit

protected void engineInit(int opmode,
                          Key key,
                          SecureRandom random)
                   throws InvalidKeyException

Initializes this cipher with a key and a source of randomness.

Parameters:

opmode - the operation mode of this cipher. This is one of the following: javax.crypto.Cipher.ENCRYPT_MODE javax.crypto.Cipher.DECRYPT_MODE javax.crypto.Cipher.WRAP_MODE javax.crypto.Cipher.UNWRAP_MODE

key - the key to encrypt or to decrypt.

random - the source of randomness.

Throws:

InvalidKeyException - if the given key is inappropriate for initializing this cipher, or if this cipher is being initialized for decryption and requires algorithm parameters that cannot be determinated from the given key.

engineInit

protected void engineInit(int opmode,
                          Key key,
                          AlgorithmParameters params,
                          SecureRandom random)
                   throws InvalidKeyException,
                          InvalidAlgorithmParameterException

Initializes this cipher with a key, a set of algorithm parameters, and a source of randomness.

Parameters:

opmode - the operation mode of this cipher. This is one of the following: javax.crypto.Cipher.ENCRYPT_MODE javax.crypto.Cipher.DECRYPT_MODE javax.crypto.Cipher.WRAP_MODE javax.crypto.Cipher.UNWRAP_MODE

key - the key to encrypt or to decrypt.

params - the algorithm paramter.

random - the source of randomness.

Throws:

InvalidKeyException - if the given key is inappropriate for initializing this cipher.

InvalidAlgorithmParameterException - if the given algorithm parameters are inappropriate for this cipher, or if this cipher is being initialized for decryption and requires algorithm parameters and params is null.

engineInit

protected void engineInit(int opmode,
                          Key key,
                          AlgorithmParameterSpec params,
                          SecureRandom random)
                   throws InvalidKeyException,
                          InvalidAlgorithmParameterException

Initializes this cipher with a key, a set of algorithm parameters, and a source of randomness.

Parameters:

opmode - the operation mode of this cipher. This is one of the following: javax.crypto.Cipher.ENCRYPT_MODE javax.crypto.Cipher.DECRYPT_MODE javax.crypto.Cipher.WRAP_MODE javax.crypto.Cipher.UNWRAP_MODE

key - the key to encrypt or to decrypt.

params - the algorithm paramter.

random - the source of randomness.

Throws:

InvalidKeyException - if the given key is inappropriate for initializing this cipher.

InvalidAlgorithmParameterException - if the given algorithm parameters are inappropriate for this cipher, or if this cipher is being initialized for decryption and requires algorithm parameters and params is null.

engineUpdate

protected byte[] engineUpdate(byte[] input,
                              int inputOffset,
                              int inputLen)

Continues a multiple-part encryption or decryption operation (depending on how this cipher was initialized), processing another data part.

Parameters:

input - the input buffer.

inputOffset - the offset in input where the input starts.

inputLen - the input length.

Returns:

the new buffer with the result, or null if the underlying cipher is a block cipher and the input data is too short to result in a new block.

engineUpdate

protected int engineUpdate(byte[] input,
                           int inputOffset,
                           int inputLen,
                           byte[] output,
                           int outputOffset)
                    throws ShortBufferException

Continues a multiple-part encryption or decryption operation (depending on how this cipher was initialized), processing another data part.

Parameters:

input - the input buffer.

inputOffset - the offset in input where the input starts.

inputLen - the input length.

output - the buffer for the result.

outputOffset - the offset in output where the result is stored.

Returns:

the number of bytes stored in output

Throws:

ShortBufferException - if the given output buffer is too small to hold the result.

engineDoFinal

protected byte[] engineDoFinal(byte[] input,
                               int inputOffset,
                               int inputLen)
                        throws IllegalBlockSizeException,
                               BadPaddingException

Encrypts or decrypts data in a single-part operation, or finishes a multiple-part operation.

Parameters:

input - the input buffer.

inputOffset - the offset in input where the input starts.

inputLen - the input length.

Returns:

the new buffer with the finally result.

Throws:

IllegalBlockSizeException - if this cipher is a block cipher, no padding has been requested (only in encryption mode), and the total input length of the data processed by this cipher is not a multiple of block size.

BadPaddingException - if this cipher is in decryption mode, and (un)padding has been requested, but the decrypted data is not bounded by the appropriate padding bytes.

engineDoFinal

protected int engineDoFinal(byte[] input,
                            int inputOffset,
                            int inputLen,
                            byte[] output,
                            int outputOffset)
                     throws ShortBufferException,
                            IllegalBlockSizeException,
                            BadPaddingException

Encrypts or decrypts data in a single-part operation, or finishes a multiple-part operation.

Parameters:

input - the input buffer.

inputOffset - the offset in input where the input starts.

inputLen - the input length.

output - the buffer for the finally result.

outputOffset - the offset in output where the result is stored.

Returns:

the number of bytes stored in output.

Throws:

ShortBufferException - if the given output buffer is too small to hold the result.

IllegalBlockSizeException - if this cipher is a block cipher, no padding has been requested (only in encryption mode), and the total input length of the data processed by this cipher is not a multiple of block size.

BadPaddingException - if this cipher is in decryption mode, and (un)padding has been requested, but the decrypted data is not bounded by the appropriate padding bytes.

engineGetOutputSize

protected int engineGetOutputSize(int inputLen)

Returns the length in bytes that an output buffer would need to be in order to hold the result of the next update or doFinal operation, given the input length inputLen (in bytes).

Parameters:

inputLen - the input length in bytes.

Returns:

the reqired output buffer size in bytes.

engineGetParameters

protected AlgorithmParameters engineGetParameters()

Returns the parameters used with this cipher.

Returns:

the parameters used with this cipher, or null if this cipher does not use any parameters.

engineGetIV

protected byte[] engineGetIV()

Returns the initialization vector (IV) in a new buffer.

Returns:

the initialization vector in a new buffer, or null if the underlying algorithm does not use an IV, or if the IV has not yet been set.

engineGetBlockSize

protected int engineGetBlockSize()

Returns the block size (in bytes).

Returns:

the block size (in bytes), or 0 if the underlying algorithm is not a block cipher

engineGetKeySize

protected int engineGetKeySize(Key key)
                        throws InvalidKeyException

Returns the key size of the given key object.

Parameters:

key - the key object.

Returns:

the key size of the given key object.

Throws:

InvalidKeyException - if key is invalid.

engineUnwrap

protected Key engineUnwrap(byte[] wrappedKey,
                           String wrappedKeyAlgorithm,
                           int wrappedKeyType)
                    throws InvalidKeyException,
                           NoSuchAlgorithmException

Unwrap a previously wrapped key.

Parameters:

wrappedKey - the wrapped key to unwrap.

wrappedKeyAlgorithm - the algorithm associated with the key wrapped key.

wrappedKeyType - the type of the wrapped key. This is one of javax.crypto.Cipher.SECRET_KEY, javax.crypto.Cipher.PRIVATE_KEY, javax.crypto.Cipher.PUBLIC_KEY.

Returns:

the unwrapped key.

Throws:

InvalidKeyException - if wrappedKey does not represent a wrapped key, or if the algorithm associated with the wrapped key is different from wrappedKeyAlgorithm and/or its key type is different from wrappedKeyType.

NoSuchAlgorithmException - if no installed providers can create keys for the wrappedKeyAlgorithm.

engineWrap

protected byte[] engineWrap(Key key)
                     throws IllegalBlockSizeException,
                            InvalidKeyException

Wrap a key.

Parameters:

key - the key to be wrapped.

Returns:

the wrapped key.

Throws:

IllegalBlockSizeException - if this cipher is a block cipher, no padding has been requested, and the length of the encoding of the key to be wrapped is not a multiple of the block size.

InvalidKeyException - if it is impossible or unsafe to wrap the key with this cipher (e.g., a hardware public key is being passed to a software-only cipher).