ccm.h
#ifndef CRYPTOPP_CCM_H
#define CRYPTOPP_CCM_H
#include "authenc.h"
#include "modes.h"
NAMESPACE_BEGIN(CryptoPP)
//! .
class CRYPTOPP_DLL CRYPTOPP_NO_VTABLE CCM_Base : public AuthenticatedSymmetricCipherBase
{
public:
CCM_Base()
: m_digestSize(0), m_L(0) {}
// AuthenticatedSymmetricCipher
std::string AlgorithmName() const
{return GetBlockCipher().AlgorithmName() + std::string("/CCM");}
size_t MinKeyLength() const
{return GetBlockCipher().MinKeyLength();}
size_t MaxKeyLength() const
{return GetBlockCipher().MaxKeyLength();}
size_t DefaultKeyLength() const
{return GetBlockCipher().DefaultKeyLength();}
size_t GetValidKeyLength(size_t n) const
{return GetBlockCipher().GetValidKeyLength(n);}
bool IsValidKeyLength(size_t n) const
{return GetBlockCipher().IsValidKeyLength(n);}
unsigned int OptimalDataAlignment() const
{return GetBlockCipher().OptimalDataAlignment();}
IV_Requirement IVRequirement() const
{return UNIQUE_IV;}
unsigned int IVSize() const
{return 8;}
unsigned int MinIVLength() const
{return 7;}
unsigned int MaxIVLength() const
{return 13;}
unsigned int DigestSize() const
{return m_digestSize;}
lword MaxHeaderLength() const
{return W64LIT(0)-1;}
lword MaxMessageLength() const
{return m_L<8 ? (W64LIT(1)<<(8*m_L))-1 : W64LIT(0)-1;}
bool NeedsPrespecifiedDataLengths() const
{return true;}
void UncheckedSpecifyDataLengths(lword headerLength, lword messageLength, lword footerLength);
protected:
// AuthenticatedSymmetricCipherBase
bool AuthenticationIsOnPlaintext() const
{return true;}
unsigned int AuthenticationBlockSize() const
{return GetBlockCipher().BlockSize();}
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 AuthenticateLastConfidentialBlock();
void AuthenticateLastFooterBlock(byte *mac, size_t macSize);
SymmetricCipher & AccessSymmetricCipher() {return m_ctr;}
virtual BlockCipher & AccessBlockCipher() =0;
virtual int DefaultDigestSize() const =0;
const BlockCipher & GetBlockCipher() const {return const_cast<CCM_Base *>(this)->AccessBlockCipher();};
byte *CBC_Buffer() {return m_buffer+REQUIRED_BLOCKSIZE;}
enum {REQUIRED_BLOCKSIZE = 16};
int m_digestSize, m_L;
word64 m_messageLength, m_aadLength;
CTR_Mode_ExternalCipher::Encryption m_ctr;
};
//! .
template <class T_BlockCipher, int T_DefaultDigestSize, bool T_IsEncryption>
class CCM_Final : public CCM_Base
{
public:
static std::string StaticAlgorithmName()
{return T_BlockCipher::StaticAlgorithmName() + std::string("/CCM");}
bool IsForwardTransformation() const
{return T_IsEncryption;}
private:
BlockCipher & AccessBlockCipher() {return m_cipher;}
int DefaultDigestSize() const {return T_DefaultDigestSize;}
typename T_BlockCipher::Encryption m_cipher;
};
/// <a href="http://www.cryptolounge.org/wiki/CCM">CCM</a>
template <class T_BlockCipher, int T_DefaultDigestSize = 16>
struct CCM : public AuthenticatedSymmetricCipherDocumentation
{
typedef CCM_Final<T_BlockCipher, T_DefaultDigestSize, true> Encryption;
typedef CCM_Final<T_BlockCipher, T_DefaultDigestSize, false> Decryption;
};
NAMESPACE_END
#endif
CCM_Base::AlgorithmName
std::string AlgorithmName() const
returns name of this algorithm, not universally implemented yet
Definition: ccm.h:17
CipherModeFinalTemplate_ExternalCipher< ConcretePolicyHolder< Empty, AdditiveCipherTemplate< AbstractPolicyHolder< AdditiveCipherAbstractPolicy, CTR_ModePolicy > > > >
CCM_Base::GetValidKeyLength
size_t GetValidKeyLength(size_t n) const
returns the smallest valid key length in bytes that is >= min(n, GetMaxKeyLength()) ...
Definition: ccm.h:25
CCM_Base::MinIVLength
unsigned int MinIVLength() const
returns minimal length of IVs accepted by this object
Definition: ccm.h:35
modes.h
CCM_Base::MaxIVLength
unsigned int MaxIVLength() const
returns maximal length of IVs accepted by this object
Definition: ccm.h:37
CCM_Base::IsValidKeyLength
bool IsValidKeyLength(size_t n) const
returns whether n is a valid key length
Definition: ccm.h:27
CCM
CCM
Definition: ccm.h:93
AuthenticatedSymmetricCipherDocumentation
Each class derived from this one defines two types, Encryption and Decryption, both of which implemen...
Definition: seckey.h:211
BlockCipher
interface for one direction (encryption or decryption) of a block cipher
Definition: cryptlib.h:603
CCM_Base::DefaultKeyLength
size_t DefaultKeyLength() const
returns default (recommended) key length in bytes */
Definition: ccm.h:23
CCM_Base::NeedsPrespecifiedDataLengths
bool NeedsPrespecifiedDataLengths() const
if this function returns true, SpecifyDataLengths() must be called before attempting to input data ...
Definition: ccm.h:45
SymmetricCipher
interface for one direction (encryption or decryption) of a stream cipher or cipher mode ...
Definition: cryptlib.h:610
AuthenticatedSymmetricCipherBase
Definition: authenc.h:10
CCM_Base::MinKeyLength
size_t MinKeyLength() const
returns smallest valid key length in bytes */
Definition: ccm.h:19
CCM_Base::MaxKeyLength
size_t MaxKeyLength() const
returns largest valid key length in bytes */
Definition: ccm.h:21
CCM_Base
Definition: ccm.h:10
CCM_Base::IVRequirement
IV_Requirement IVRequirement() const
returns the minimal requirement for secure IVs
Definition: ccm.h:31
CCM_Base::MaxHeaderLength
lword MaxHeaderLength() const
the maximum length of AAD that can be input before the encrypted data
Definition: ccm.h:41
CCM_Base::MaxMessageLength
lword MaxMessageLength() const
the maximum length of encrypted data
Definition: ccm.h:43
CCM_Base::OptimalDataAlignment
unsigned int OptimalDataAlignment() const
returns how input should be aligned for optimal performance
Definition: ccm.h:29
CCM_Base::DigestSize
unsigned int DigestSize() const
size of the hash/digest/MAC returned by Final()
Definition: ccm.h:39
CCM_Final
Definition: ccm.h:77
CCM_Final::IsForwardTransformation
bool IsForwardTransformation() const
returns whether this is an encryption object
Definition: ccm.h:82
NameValuePairs
interface for retrieving values given their names
Definition: cryptlib.h:224