Crypto++ 8.7
Free C++ class library of cryptographic schemes
|
IETF XChaCha20Poly1305 cipher final implementation. More...
#include <chachapoly.h>
Additional Inherited Members | |
Public Types inherited from SimpleKeyingInterface | |
enum | IV_Requirement { UNIQUE_IV = 0 , RANDOM_IV , UNPREDICTABLE_RANDOM_IV , INTERNALLY_GENERATED_IV , NOT_RESYNCHRONIZABLE } |
Secure IVs requirements as enumerated values. More... | |
Public Member Functions inherited from XChaCha20Poly1305_Base | |
std::string | AlgorithmName () const |
Provides the name of this algorithm. More... | |
std::string | AlgorithmProvider () const |
Retrieve the provider of this algorithm. More... | |
size_t | MinKeyLength () const |
Returns smallest valid key length. More... | |
size_t | MaxKeyLength () const |
Returns largest valid key length. More... | |
size_t | DefaultKeyLength () const |
Returns default key length. More... | |
size_t | GetValidKeyLength (size_t n) const |
Returns a valid key length for the algorithm. More... | |
bool | IsValidKeyLength (size_t n) const |
Returns whether keylength is a valid key length. More... | |
unsigned int | OptimalDataAlignment () const |
Provides input and output data alignment for optimal performance. More... | |
IV_Requirement | IVRequirement () const |
Minimal requirement for secure IVs. More... | |
unsigned int | IVSize () const |
Returns length of the IV accepted by this object. More... | |
unsigned int | MinIVLength () const |
Provides the minimum size of an IV. More... | |
unsigned int | MaxIVLength () const |
Provides the maximum size of an IV. More... | |
unsigned int | DigestSize () const |
Provides the digest size of the hash. More... | |
lword | MaxHeaderLength () const |
Provides the maximum length of AAD that can be input. More... | |
lword | MaxMessageLength () const |
Provides the maximum length of encrypted data. More... | |
lword | MaxFooterLength () const |
Provides the maximum length of AAD. More... | |
virtual void | EncryptAndAuthenticate (byte *ciphertext, byte *mac, size_t macSize, const byte *iv, int ivLength, const byte *aad, size_t aadLength, const byte *message, size_t messageLength) |
Encrypts and calculates a MAC in one call. More... | |
virtual bool | DecryptAndVerify (byte *message, const byte *mac, size_t macSize, const byte *iv, int ivLength, const byte *aad, size_t aadLength, const byte *ciphertext, size_t ciphertextLength) |
Decrypts and verifies a MAC in one call. More... | |
Public Member Functions inherited from AuthenticatedSymmetricCipherBase | |
bool | IsRandomAccess () const |
Determines whether the cipher supports random access. More... | |
bool | IsSelfInverting () const |
Determines whether the cipher is self-inverting. More... | |
void | SetKey (const byte *userKey, size_t keylength, const NameValuePairs ¶ms) |
Sets or reset the key of this object. More... | |
void | Restart () |
Restart the hash. More... | |
void | Resynchronize (const byte *iv, int length=-1) |
Resynchronize with an IV. More... | |
void | Update (const byte *input, size_t length) |
Updates a hash with additional input. More... | |
void | ProcessData (byte *outString, const byte *inString, size_t length) |
Encrypt or decrypt an array of bytes. More... | |
void | TruncatedFinal (byte *mac, size_t macSize) |
Computes the hash of the current message. More... | |
Public Member Functions inherited from AuthenticatedSymmetricCipher | |
virtual lword | MaxHeaderLength () const =0 |
Provides the maximum length of AAD that can be input. More... | |
virtual lword | MaxMessageLength () const =0 |
Provides the maximum length of encrypted data. More... | |
virtual lword | MaxFooterLength () const |
Provides the maximum length of AAD. More... | |
virtual bool | NeedsPrespecifiedDataLengths () const |
Determines if data lengths must be specified prior to inputting data. More... | |
void | SpecifyDataLengths (lword headerLength, lword messageLength, lword footerLength=0) |
Prescribes the data lengths. More... | |
virtual void | EncryptAndAuthenticate (byte *ciphertext, byte *mac, size_t macSize, const byte *iv, int ivLength, const byte *header, size_t headerLength, const byte *message, size_t messageLength) |
Encrypts and calculates a MAC in one call. More... | |
virtual bool | DecryptAndVerify (byte *message, const byte *mac, size_t macSize, const byte *iv, int ivLength, const byte *header, size_t headerLength, const byte *ciphertext, size_t ciphertextLength) |
Decrypts and verifies a MAC in one call. More... | |
virtual std::string | AlgorithmName () const |
Provides the name of this algorithm. More... | |
virtual std::string | AlgorithmProvider () const |
Retrieve the provider of this algorithm. More... | |
Public Member Functions inherited from SimpleKeyingInterface | |
virtual size_t | MinKeyLength () const =0 |
Returns smallest valid key length. More... | |
virtual size_t | MaxKeyLength () const =0 |
Returns largest valid key length. More... | |
virtual size_t | DefaultKeyLength () const =0 |
Returns default key length. More... | |
virtual size_t | GetValidKeyLength (size_t keylength) const =0 |
Returns a valid key length for the algorithm. More... | |
virtual bool | IsValidKeyLength (size_t keylength) const |
Returns whether keylength is a valid key length. More... | |
virtual void | SetKey (const byte *key, size_t length, const NameValuePairs ¶ms=g_nullNameValuePairs) |
Sets or reset the key of this object. More... | |
void | SetKeyWithRounds (const byte *key, size_t length, int rounds) |
Sets or reset the key of this object. More... | |
void | SetKeyWithIV (const byte *key, size_t length, const byte *iv, size_t ivLength) |
Sets or reset the key of this object. More... | |
void | SetKeyWithIV (const byte *key, size_t length, const byte *iv) |
Sets or reset the key of this object. More... | |
virtual IV_Requirement | IVRequirement () const =0 |
Minimal requirement for secure IVs. More... | |
bool | IsResynchronizable () const |
Determines if the object can be resynchronized. More... | |
bool | CanUseRandomIVs () const |
Determines if the object can use random IVs. More... | |
bool | CanUsePredictableIVs () const |
Determines if the object can use random but possibly predictable IVs. More... | |
bool | CanUseStructuredIVs () const |
Determines if the object can use structured IVs. More... | |
virtual unsigned int | IVSize () const |
Returns length of the IV accepted by this object. More... | |
unsigned int | DefaultIVLength () const |
Provides the default size of an IV. More... | |
virtual unsigned int | MinIVLength () const |
Provides the minimum size of an IV. More... | |
virtual unsigned int | MaxIVLength () const |
Provides the maximum size of an IV. More... | |
virtual void | Resynchronize (const byte *iv, int ivLength=-1) |
Resynchronize with an IV. More... | |
virtual void | GetNextIV (RandomNumberGenerator &rng, byte *iv) |
Retrieves a secure IV for the next message. More... | |
Public Member Functions inherited from HashTransformation | |
HashTransformation & | Ref () |
Provides a reference to this object. More... | |
virtual void | Update (const byte *input, size_t length)=0 |
Updates a hash with additional input. More... | |
virtual byte * | CreateUpdateSpace (size_t &size) |
Request space which can be written into by the caller. More... | |
virtual void | Final (byte *digest) |
Computes the hash of the current message. More... | |
virtual void | Restart () |
Restart the hash. More... | |
virtual unsigned int | DigestSize () const =0 |
Provides the digest size of the hash. More... | |
unsigned int | TagSize () const |
Provides the tag size of the hash. More... | |
virtual unsigned int | BlockSize () const |
Provides the block size of the compression function. More... | |
virtual unsigned int | OptimalBlockSize () const |
Provides the input block size most efficient for this hash. More... | |
virtual unsigned int | OptimalDataAlignment () const |
Provides input and output data alignment for optimal performance. More... | |
virtual void | CalculateDigest (byte *digest, const byte *input, size_t length) |
Updates the hash with additional input and computes the hash of the current message. More... | |
virtual bool | Verify (const byte *digest) |
Verifies the hash of the current message. More... | |
virtual bool | VerifyDigest (const byte *digest, const byte *input, size_t length) |
Updates the hash with additional input and verifies the hash of the current message. More... | |
virtual void | TruncatedFinal (byte *digest, size_t digestSize)=0 |
Computes the hash of the current message. More... | |
virtual void | CalculateTruncatedDigest (byte *digest, size_t digestSize, const byte *input, size_t length) |
Updates the hash with additional input and computes the hash of the current message. More... | |
virtual bool | TruncatedVerify (const byte *digest, size_t digestLength) |
Verifies the hash of the current message. More... | |
virtual bool | VerifyTruncatedDigest (const byte *digest, size_t digestLength, const byte *input, size_t length) |
Updates the hash with additional input and verifies the hash of the current message. More... | |
Public Member Functions inherited from Algorithm | |
Algorithm (bool checkSelfTestStatus=true) | |
Interface for all crypto algorithms. More... | |
virtual std::string | AlgorithmName () const |
Provides the name of this algorithm. More... | |
virtual std::string | AlgorithmProvider () const |
Retrieve the provider of this algorithm. More... | |
Public Member Functions inherited from Clonable | |
virtual Clonable * | Clone () const |
Copies this object. More... | |
Public Member Functions inherited from StreamTransformation | |
StreamTransformation & | Ref () |
Provides a reference to this object. More... | |
virtual unsigned int | MandatoryBlockSize () const |
Provides the mandatory block size of the cipher. More... | |
virtual unsigned int | OptimalBlockSize () const |
Provides the input block size most efficient for this cipher. More... | |
virtual unsigned int | GetOptimalBlockSizeUsed () const |
Provides the number of bytes used in the current block when processing at optimal block size. More... | |
virtual unsigned int | OptimalDataAlignment () const |
Provides input and output data alignment for optimal performance. More... | |
virtual void | ProcessData (byte *outString, const byte *inString, size_t length)=0 |
Encrypt or decrypt an array of bytes. More... | |
virtual size_t | ProcessLastBlock (byte *outString, size_t outLength, const byte *inString, size_t inLength) |
Encrypt or decrypt the last block of data. More... | |
virtual unsigned int | MinLastBlockSize () const |
Provides the size of the last block. More... | |
virtual bool | IsLastBlockSpecial () const |
Determines if the last block receives special processing. More... | |
void | ProcessString (byte *inoutString, size_t length) |
Encrypt or decrypt a string of bytes. More... | |
void | ProcessString (byte *outString, const byte *inString, size_t length) |
Encrypt or decrypt a string of bytes. More... | |
byte | ProcessByte (byte input) |
Encrypt or decrypt a byte. More... | |
virtual bool | IsRandomAccess () const =0 |
Determines whether the cipher supports random access. More... | |
virtual void | Seek (lword pos) |
Seek to an absolute position. More... | |
virtual bool | IsSelfInverting () const =0 |
Determines whether the cipher is self-inverting. More... | |
virtual bool | IsForwardTransformation () const =0 |
Determines if the cipher is being operated in its forward direction. More... | |
Static Public Member Functions inherited from XChaCha20Poly1305_Base | |
static const char * | StaticAlgorithmName () |
IETF XChaCha20Poly1305 cipher final implementation.
T_IsEncryption | flag indicating cipher direction |
XChaCha20Poly1305 is an authenticated encryption scheme that combines XChaCha20 and Poly1305-TLS. The scheme is defined in RFC 8439, section 2.8, AEAD_CHACHA20_POLY1305 construction, and uses the IETF versions of ChaCha20 and Poly1305.
Definition at line 281 of file chachapoly.h.
|
inlinevirtual |
Definition at line 284 of file chachapoly.h.