cryptix.provider.cipher

Class IDEA

Implemented Interfaces:
Parameterized, SymmetricCipher

public final class IDEA
extends Cipher
implements SymmetricCipher

IDEA is a block cipher with a key length of 16 bytes and a block length of 8 bytes. It is highly popular, being the original cipher in PGP, and has received a lot of cryptanalytic attention.

IDEA was written by Dr. X. Lai and Prof. J. Massey.

References:

  1. See the IDEA page for more details.

  2. The algorithm is subject to patent claims by Ascom Systec Ltd (applied for May 1991), and is licensable.

Copyright © 1995-1997 Systemics Ltd on behalf of the Cryptix Development Team.
All rights reserved.

$Revision: 1.4 $

Authors:
Systemics Ltd
David Hopwood
Raif S. Naffah
Since:
Cryptix 2.2.2

Field Summary

Fields inherited from class xjava.security.Cipher

DECRYPT, ENCRYPT, UNINITIALIZED

Fields inherited from class xjava.security.IJCE_Traceable

tracing

Constructor Summary

IDEA()
Constructs an IDEA cipher object, in the UNINITIALIZED state.

Method Summary

Object
clone()
Always throws a CloneNotSupportedException (cloning of ciphers is not supported for security reasons).
protected int
engineBlockSize()
SPI: Returns the length of an input block, in bytes.
protected void
engineInitDecrypt(Key key)
SPI: Initializes this cipher for decryption, using the specified key.
protected void
engineInitEncrypt(Key key)
SPI: Initializes this cipher for encryption, using the specified key.
protected int
engineUpdate(byte[] in, int inOffset, int inLen, byte[] out, int outOffset)
SPI: This is the main engine method for updating data.
protected void
finalize()
Cleans up resources used by this instance, if necessary.
static LinkStatus
getLinkStatus()
Gets an object representing the native linking status of this class.
static void
main(argv[] )
Entry point for very basic self_test.
static void
self_test()
Do some basic tests.

Methods inherited from class xjava.security.Cipher

blockSize, clone, crypt, crypt, crypt, doFinal, doFinal, doFinal, doFinal, engineBlockSize, engineCiphertextBlockSize, engineCrypt, engineGetParameter, engineInBufferSize, engineInitDecrypt, engineInitEncrypt, engineOutBufferSize, enginePlaintextBlockSize, engineSetPaddingScheme, engineSetParameter, engineUpdate, getAlgorithm, getAlgorithms, getAlgorithms, getCiphertextBlockSize, getInputBlockSize, getInstance, getInstance, getInstance, getMode, getOutputBlockSize, getPadding, getPaddingScheme, getParameter, getPlaintextBlockSize, getProvider, getState, inBufferSize, inBufferSizeFinal, initDecrypt, initEncrypt, isPaddingBlockCipher, outBufferSize, outBufferSizeFinal, setParameter, toString, update, update, update, update

Methods inherited from class xjava.security.IJCE_Traceable

disableTracing, enableTracing, traceMethod, traceResult, traceResult, traceVoidMethod

Constructor Details

IDEA

public IDEA()
Constructs an IDEA cipher object, in the UNINITIALIZED state. This calls the Cipher constructor with implBuffering false, implPadding false and the provider set to "Cryptix".

Method Details

clone

public final Object clone()
            throws CloneNotSupportedException
Always throws a CloneNotSupportedException (cloning of ciphers is not supported for security reasons).
Overrides:
clone in interface Cipher

engineBlockSize

protected int engineBlockSize()
SPI: Returns the length of an input block, in bytes.
Overrides:
engineBlockSize in interface Cipher
Returns:
the length in bytes of an input block for this cipher.

engineInitDecrypt

protected void engineInitDecrypt(Key key)
            throws InvalidKeyException,
                   CryptixException
SPI: Initializes this cipher for decryption, using the specified key.
Overrides:
engineInitDecrypt in interface Cipher
Parameters:
key - the key to use for encryption.

engineInitEncrypt

protected void engineInitEncrypt(Key key)
            throws InvalidKeyException,
                   CryptixException
SPI: Initializes this cipher for encryption, using the specified key.
Overrides:
engineInitEncrypt in interface Cipher
Parameters:
key - the key to use for encryption.

engineUpdate

protected int engineUpdate(byte[] in,
                           int inOffset,
                           int inLen,
                           byte[] out,
                           int outOffset)
SPI: This is the main engine method for updating data.

in and out may be the same array, and the input and output regions may overlap.

Overrides:
engineUpdate in interface Cipher
Parameters:
in - the input data.
inOffset - the offset into in specifying where the data starts.
inLen - the length of the subarray.
out - the output array.
outOffset - the offset indicating where to start writing into the out array.
Returns:
the number of bytes written.

finalize

protected final void finalize()
Cleans up resources used by this instance, if necessary.

getLinkStatus

public static LinkStatus getLinkStatus()
Gets an object representing the native linking status of this class.

main

public static void main(argv[] )
Entry point for very basic self_test.

self_test

public static void self_test()
            throws Throwable
Do some basic tests. Three of the certification data are included only, no output, success or exception. If you want more, write a test program!
See Also:
cryptix.examples.IDEA