eax.h
#ifndef CRYPTOPP_EAX_H
#define CRYPTOPP_EAX_H
#include "authenc.h"
#include "modes.h"
#include "cmac.h"
NAMESPACE_BEGIN(CryptoPP)
//! .
class CRYPTOPP_NO_VTABLE EAX_Base : public AuthenticatedSymmetricCipherBase
{
public:
// AuthenticatedSymmetricCipher
std::string AlgorithmName() const
{return GetMAC().GetCipher().AlgorithmName() + std::string("/EAX");}
size_t MinKeyLength() const
{return GetMAC().MinKeyLength();}
size_t MaxKeyLength() const
{return GetMAC().MaxKeyLength();}
size_t DefaultKeyLength() const
{return GetMAC().DefaultKeyLength();}
size_t GetValidKeyLength(size_t n) const
{return GetMAC().GetValidKeyLength(n);}
bool IsValidKeyLength(size_t n) const
{return GetMAC().IsValidKeyLength(n);}
unsigned int OptimalDataAlignment() const
{return GetMAC().OptimalDataAlignment();}
IV_Requirement IVRequirement() const
{return UNIQUE_IV;}
unsigned int IVSize() const
{return GetMAC().TagSize();}
unsigned int MinIVLength() const
{return 0;}
unsigned int MaxIVLength() const
{return UINT_MAX;}
unsigned int DigestSize() const
{return GetMAC().TagSize();}
lword MaxHeaderLength() const
{return LWORD_MAX;}
lword MaxMessageLength() const
{return LWORD_MAX;}
protected:
// AuthenticatedSymmetricCipherBase
bool AuthenticationIsOnPlaintext() const
{return false;}
unsigned int AuthenticationBlockSize() const
{return 1;}
void SetKeyWithoutResync(const byte *userKey, size_t keylength, const NameValuePairs &params);
void Resync(const byte *iv, size_t len);
size_t AuthenticateBlocks(const byte *data, size_t len);
void AuthenticateLastHeaderBlock();
void AuthenticateLastFooterBlock(byte *mac, size_t macSize);
SymmetricCipher & AccessSymmetricCipher() {return m_ctr;}
const CMAC_Base & GetMAC() const {return const_cast<EAX_Base *>(this)->AccessMAC();}
virtual CMAC_Base & AccessMAC() =0;
CTR_Mode_ExternalCipher::Encryption m_ctr;
};
//! .
template <class T_BlockCipher, bool T_IsEncryption>
class EAX_Final : public EAX_Base
{
public:
static std::string StaticAlgorithmName()
{return T_BlockCipher::StaticAlgorithmName() + std::string("/EAX");}
bool IsForwardTransformation() const
{return T_IsEncryption;}
private:
CMAC_Base & AccessMAC() {return m_cmac;}
CMAC<T_BlockCipher> m_cmac;
};
#ifdef EAX // EAX is defined to 11 on GCC 3.4.3, OpenSolaris 8.11
#undef EAX
#endif
/// <a href="http://www.cryptolounge.org/wiki/EAX">EAX</a>
template <class T_BlockCipher>
struct EAX : public AuthenticatedSymmetricCipherDocumentation
{
typedef EAX_Final<T_BlockCipher, true> Encryption;
typedef EAX_Final<T_BlockCipher, false> Decryption;
};
NAMESPACE_END
#endif
CipherModeFinalTemplate_ExternalCipher< ConcretePolicyHolder< Empty, AdditiveCipherTemplate< AbstractPolicyHolder< AdditiveCipherAbstractPolicy, CTR_ModePolicy > > > >
EAX_Base::MinKeyLength
size_t MinKeyLength() const
returns smallest valid key length in bytes */
Definition: eax.h:17
EAX_Base::DigestSize
unsigned int DigestSize() const
size of the hash/digest/MAC returned by Final()
Definition: eax.h:37
modes.h
AuthenticatedSymmetricCipherDocumentation
Each class derived from this one defines two types, Encryption and Decryption, both of which implemen...
Definition: seckey.h:211
EAX_Base
Definition: eax.h:11
EAX_Base::MaxKeyLength
size_t MaxKeyLength() const
returns largest valid key length in bytes */
Definition: eax.h:19
CMAC< T_BlockCipher >
EAX_Base::GetValidKeyLength
size_t GetValidKeyLength(size_t n) const
returns the smallest valid key length in bytes that is >= min(n, GetMaxKeyLength()) ...
Definition: eax.h:23
EAX_Final
Definition: eax.h:64
SymmetricCipher
interface for one direction (encryption or decryption) of a stream cipher or cipher mode ...
Definition: cryptlib.h:610
EAX_Base::MaxMessageLength
lword MaxMessageLength() const
the maximum length of encrypted data
Definition: eax.h:41
AuthenticatedSymmetricCipherBase
Definition: authenc.h:10
EAX_Base::OptimalDataAlignment
unsigned int OptimalDataAlignment() const
returns how input should be aligned for optimal performance
Definition: eax.h:27
EAX_Base::IVRequirement
IV_Requirement IVRequirement() const
returns the minimal requirement for secure IVs
Definition: eax.h:29
EAX_Base::MaxHeaderLength
lword MaxHeaderLength() const
the maximum length of AAD that can be input before the encrypted data
Definition: eax.h:39
EAX_Base::DefaultKeyLength
size_t DefaultKeyLength() const
returns default (recommended) key length in bytes */
Definition: eax.h:21
CMAC_Base
_
Definition: cmac.h:10
EAX_Base::MinIVLength
unsigned int MinIVLength() const
returns minimal length of IVs accepted by this object
Definition: eax.h:33
EAX_Base::MaxIVLength
unsigned int MaxIVLength() const
returns maximal length of IVs accepted by this object
Definition: eax.h:35
EAX_Base::AlgorithmName
std::string AlgorithmName() const
returns name of this algorithm, not universally implemented yet
Definition: eax.h:15
EAX_Final::IsForwardTransformation
bool IsForwardTransformation() const
returns whether this is an encryption object
Definition: eax.h:69
EAX
EAX
Definition: eax.h:83
EAX_Base::IsValidKeyLength
bool IsValidKeyLength(size_t n) const
returns whether n is a valid key length
Definition: eax.h:25
NameValuePairs
interface for retrieving values given their names
Definition: cryptlib.h:224