Crypto++  5.6.3
Free C++ class library of cryptographic schemes
authenc.h
Go to the documentation of this file.
1 // authenc.h - written and placed in the public domain by Wei Dai
2 
3 //! \file
4 //! \headerfile authenc.h
5 //! \brief Base classes for working with authenticated encryption modes of encryption
6 
7 #ifndef CRYPTOPP_AUTHENC_H
8 #define CRYPTOPP_AUTHENC_H
9 
10 #include "cryptlib.h"
11 #include "secblock.h"
12 
13 NAMESPACE_BEGIN(CryptoPP)
14 
15 //! \class AuthenticatedSymmetricCipherBase
16 //! \brief
17 class CRYPTOPP_DLL CRYPTOPP_NO_VTABLE AuthenticatedSymmetricCipherBase : public AuthenticatedSymmetricCipher
18 {
19 public:
20  AuthenticatedSymmetricCipherBase() : m_state(State_Start), m_bufferedDataLength(0),
21  m_totalHeaderLength(0), m_totalMessageLength(0), m_totalFooterLength(0) {}
22 
23  bool IsRandomAccess() const {return false;}
24  bool IsSelfInverting() const {return true;}
25  void UncheckedSetKey(const byte *,unsigned int,const CryptoPP::NameValuePairs &) {assert(false);}
26 
27  void SetKey(const byte *userKey, size_t keylength, const NameValuePairs &params);
28  void Restart() {if (m_state > State_KeySet) m_state = State_KeySet;}
29  void Resynchronize(const byte *iv, int length=-1);
30  void Update(const byte *input, size_t length);
31  void ProcessData(byte *outString, const byte *inString, size_t length);
32  void TruncatedFinal(byte *mac, size_t macSize);
33 
34 protected:
35  void AuthenticateData(const byte *data, size_t len);
36  const SymmetricCipher & GetSymmetricCipher() const {return const_cast<AuthenticatedSymmetricCipherBase *>(this)->AccessSymmetricCipher();};
37 
38  virtual SymmetricCipher & AccessSymmetricCipher() =0;
39  virtual bool AuthenticationIsOnPlaintext() const =0;
40  virtual unsigned int AuthenticationBlockSize() const =0;
41  virtual void SetKeyWithoutResync(const byte *userKey, size_t keylength, const NameValuePairs &params) =0;
42  virtual void Resync(const byte *iv, size_t len) =0;
43  virtual size_t AuthenticateBlocks(const byte *data, size_t len) =0;
44  virtual void AuthenticateLastHeaderBlock() =0;
45  virtual void AuthenticateLastConfidentialBlock() {}
46  virtual void AuthenticateLastFooterBlock(byte *mac, size_t macSize) =0;
47 
48  enum State {State_Start, State_KeySet, State_IVSet, State_AuthUntransformed, State_AuthTransformed, State_AuthFooter};
49  State m_state;
50  unsigned int m_bufferedDataLength;
51  lword m_totalHeaderLength, m_totalMessageLength, m_totalFooterLength;
52  AlignedSecByteBlock m_buffer;
53 };
54 
55 NAMESPACE_END
56 
57 #endif
Interface for one direction (encryption or decryption) of a stream cipher or block cipher mode with a...
Definition: cryptlib.h:1107
Abstract base classes that provide a uniform interface to this library.
bool IsRandomAccess() const
Determines whether the cipher supports random access.
Definition: authenc.h:23
void Restart()
Restart the hash.
Definition: authenc.h:28
Classes and functions for secure memory allocations.
Interface for one direction (encryption or decryption) of a stream cipher or cipher mode...
Definition: cryptlib.h:1089
SecBlock using AllocatorWithCleanup typedef.
Definition: secblock.h:729
bool IsSelfInverting() const
Determines whether the cipher is self-inverting.
Definition: authenc.h:24
Crypto++ library namespace.
Interface for retrieving values given their names.
Definition: cryptlib.h:277