org.owasp.esapi.crypto

Class CipherSpec

java.lang.Object

org.owasp.esapi.crypto.CipherSpec

All Implemented Interfaces:

Serializable

public final class CipherSpec
extends Object
implements Serializable

Specifies all the relevant configuration data needed in constructing and using a Cipher except for the encryption key.

The "setters" all return a reference to this so that they can be strung together.

Note: While this is a useful class in it's own right, it should primarily be regarded as an implementation class to use with ESAPI encryption, especially the reference implementation. It is not intended to be used directly by application developers, but rather only by those either extending ESAPI or in the ESAPI reference implementation. Use directly by application code is not recommended or supported.

Since:

2.0

Author:

[email protected]

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CipherSpec() Default CTOR.
CipherSpec(byte[] iv)
CipherSpec(Cipher cipher) CTOR that sets everything except for the cipher key size and possibly the IV.
CipherSpec(Cipher cipher, int keySize) CTOR that sets everything.
CipherSpec(String cipherXform, int keySize) CTOR that sets everything but block size and IV.
CipherSpec(String cipherXform, int keySize, byte[] iv) CTOR that sets everything except block size.
CipherSpec(String cipherXform, int keySize, int blockSize) CTOR that sets everything but IV.
CipherSpec(String cipherXform, int keySize, int blockSize, byte[] iv) CTOR that explicitly sets everything.

Method Summary

Modifier and Type	Method and Description
protected boolean	canEqual(Object other) Needed for correct definition of equals for general classes.
boolean	equals(Object other)
int	getBlockSize() Retrieve the block size, in bytes.
String	getCipherAlgorithm() Retrieve the cipher algorithm.
String	getCipherMode() Retrieve the cipher mode.
String	getCipherTransformation() Get the cipher transformation.
byte[]	getIV() Retrieve the initialization vector (IV).
int	getKeySize() Retrieve the key size, in bits.
String	getPaddingScheme() Retrieve the cipher padding scheme.
int	hashCode()
boolean	requiresIV() Return true if the cipher mode requires an IV.
CipherSpec	setBlockSize(int blockSize) Set the block size for this CipherSpec.
CipherSpec	setCipherTransformation(String cipherXform) Set the cipher transformation for this CipherSpec.
CipherSpec	setIV(byte[] iv) Set the initialization vector (IV).
CipherSpec	setKeySize(int keySize) Set the key size for this CipherSpec.
String	toString() Override Object.toString() to provide something more useful.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CipherSpec

public CipherSpec(String cipherXform,
                  int keySize,
                  int blockSize,
                  byte[] iv)

CTOR that explicitly sets everything.

Parameters:

cipherXform - The cipher transformation

keySize - The key size (in bits).

blockSize - The block size (in bytes).

iv - The initialization vector. Null if not applicable.

CipherSpec

public CipherSpec(String cipherXform,
                  int keySize,
                  int blockSize)

CTOR that sets everything but IV.

Parameters:

cipherXform - The cipher transformation

keySize - The key size (in bits).

blockSize - The block size (in bytes).

CipherSpec

public CipherSpec(String cipherXform,
                  int keySize)

CTOR that sets everything but block size and IV.

CipherSpec

public CipherSpec(String cipherXform,
                  int keySize,
                  byte[] iv)

CTOR that sets everything except block size.

CipherSpec

public CipherSpec(Cipher cipher)

CTOR that sets everything except for the cipher key size and possibly the IV. (IV may not be applicable--e.g., with ECB--or may not have been specified yet.

CipherSpec

public CipherSpec(Cipher cipher,
                  int keySize)

CTOR that sets everything.

CipherSpec

public CipherSpec(byte[] iv)

CipherSpec

public CipherSpec()

Default CTOR. Creates a cipher specification for 128-bit cipher transformation of "AES/CBC/PKCS5Padding" and a null IV.

Method Detail

setCipherTransformation

public CipherSpec setCipherTransformation(String cipherXform)

Set the cipher transformation for this CipherSpec.

Parameters:

cipherXform - The cipher transformation string; e.g., "DESede/CBC/PKCS5Padding".

Returns:

This current CipherSpec object.

getCipherTransformation

public String getCipherTransformation()

Get the cipher transformation.

Returns:

The cipher transformation String.

setKeySize

public CipherSpec setKeySize(int keySize)

Set the key size for this CipherSpec.

Parameters:

keySize - The key size, in bits. Must be positive integer.

Returns:

This current CipherSpec object.

getKeySize

public int getKeySize()

Retrieve the key size, in bits.

Returns:

The key size, in bits, is returned.

setBlockSize

public CipherSpec setBlockSize(int blockSize)

Set the block size for this CipherSpec.

Parameters:

blockSize - The block size, in bytes. Must be positive integer appropriate for the specified cipher algorithm.

Returns:

This current CipherSpec object.

getBlockSize

public int getBlockSize()

Retrieve the block size, in bytes.

Returns:

The block size, in bytes, is returned.

getCipherAlgorithm

public String getCipherAlgorithm()

Retrieve the cipher algorithm.

Returns:

The cipher algorithm.

getCipherMode

public String getCipherMode()

Retrieve the cipher mode.

Returns:

The cipher mode.

getPaddingScheme

public String getPaddingScheme()

Retrieve the cipher padding scheme.

Returns:

The padding scheme is returned.

getIV

public byte[] getIV()

Retrieve the initialization vector (IV).

Returns:

The IV as a byte array.

setIV

public CipherSpec setIV(byte[] iv)

Set the initialization vector (IV).

Parameters:

iv - The byte array to set as the IV. A copy of the IV is saved. This parameter is ignored if the cipher mode does not require an IV.

Returns:

This current CipherSpec object.

requiresIV

public boolean requiresIV()

Return true if the cipher mode requires an IV.

Returns:

True if the cipher mode requires an IV, otherwise false.

toString

public String toString()

Override Object.toString() to provide something more useful.

Overrides:

toString in class Object

Returns:

A meaningful string describing this object.

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

canEqual

protected boolean canEqual(Object other)

Needed for correct definition of equals for general classes. (Technically not needed for 'final' classes like this class though; this will just allow it to work in the future should we decide to allow sub-classing of this class.)

See How to write an Equality Method in Java for full explanation.