org.jasypt.salt

Interface IVGenerator

All Known Implementing Classes:

NoOpIVGenerator, RandomIVGenerator, StringFixedIVGenerator

public interface IVGenerator

Common interface for all IV generators which can be applied in digest or encryption operations.

Every implementation of this interface must be thread-safe.

Since:

1.9.3

Author:

Alex Scal

Method Summary

Modifier and Type	Method and Description
byte[]	generateIV(int length) This method will be called for requesting the generation of a new IV of the specified length.
boolean	includePlainIVInEncryptionResults() Determines if the digests and encrypted messages created with a specific IV generator will include (prepended) the unencrypted IV itself, so that it can be used for matching and decryption operations.

Method Detail

generateIV

byte[] generateIV(int length)

This method will be called for requesting the generation of a new IV of the specified length.

Parameters:

length - the requested length for the IV.

Returns:

the generated IV.

includePlainIVInEncryptionResults

boolean includePlainIVInEncryptionResults()

Determines if the digests and encrypted messages created with a specific IV generator will include (prepended) the unencrypted IV itself, so that it can be used for matching and decryption operations.

Generally, including the IV unencrypted in encryption results will be mandatory for randomly generated IVs, or for those generated in a non-predictable manner. Otherwise, digest matching and decryption operations will always fail.

Returns:

whether the plain (unencrypted) IV has to be included in encryption results or not.