#include <IceKey.H>
IceKey::IceKey (int level)
IceKey::~IceKey ();
void IceKey::set (const unsigned char *key);
unsigned char *IceKey::encrypt (const unsigned char *plaintext,
unsigned char *ciphertext) const;
unsigned char *IceKey::decrypt (const unsigned char *ciphertext,
unsigned char *plaintext) const;
int IceKey::keySize () const;
int IceKey::blockSize () const;
The IceKey class is used for encrypting and decrypting 64-bit blocks of data with the ICE (Information Concealment Engine) encryption algorithm.
The constructor creates a new IceKey object that can be used
to encrypt and decrypt data. The level of encryption determines
the size of the key, and hence its speed. Level 0 uses the Thin-ICE
variant, which is an 8-round cipher taking an 8-byte key. This is the
fastest option, and is generally considered to be at least as secure
as DES, although it is not yet certain whether it is as secure as its
key size.
For levels n greater than zero, a 16n-round cipher is used, taking 8n-byte keys. Although not as fast as level 0, these are very very secure.
Before an IceKey can be used to encrypt data, its key
schedule must be set with the set() member function. The
length of the key required is determined by the level, as described above.
The member functions encrypt() and decrypt()
encrypt and decrypt respectively data in blocks of eight chracters,
using the specified key. They return a pointer to the resulting
ciphertext/plaintext.
Two functions keySize() and blockSize()
are provided which return the key and block size
respectively, measured in bytes. The key size is determined by
the level, while the block size is always 8.
The destructor zeroes out and frees up all memory associated with the key.