Botan::DLIES_Encryptor Class Reference

#include <dlies.h>

Inheritance diagram for Botan::DLIES_Encryptor:

Public Member Functions
	DLIES_Encryptor (const DH_PrivateKey &own_priv_key, RandomNumberGenerator &rng, std::unique_ptr< KDF > kdf, std::unique_ptr< Cipher_Mode > cipher, size_t cipher_key_len, std::unique_ptr< MessageAuthenticationCode > mac, size_t mac_key_len=20)
	DLIES_Encryptor (const DH_PrivateKey &own_priv_key, RandomNumberGenerator &rng, std::unique_ptr< KDF > kdf, std::unique_ptr< MessageAuthenticationCode > mac, size_t mac_key_len=20)
std::vector< uint8_t >	encrypt (const uint8_t in[], size_t length, RandomNumberGenerator &rng) const
std::vector< uint8_t >	encrypt (std::span< const uint8_t > in, RandomNumberGenerator &rng) const
void	set_initialization_vector (const InitializationVector &iv)
	Set the initialization vector for the data encryption method.
void	set_other_key (const std::vector< uint8_t > &other_pub_key)

Detailed Description

DLIES Encryption

Definition at line 23 of file dlies.h.

Constructor & Destructor Documentation

DLIES_Encryptor() [1/2]

Botan::DLIES_Encryptor::DLIES_Encryptor	(	const DH_PrivateKey &	own_priv_key,
		RandomNumberGenerator &	rng,
		std::unique_ptr< KDF >	kdf,
		std::unique_ptr< MessageAuthenticationCode >	mac,
		size_t	mac_key_len = 20
	)

Stream mode: use KDF to provide a stream of bytes to xor with the message

Parameters

own_priv_key	own (ephemeral) DH private key
rng	the RNG to use
kdf	the KDF that should be used
mac	the MAC function that should be used
mac_key_len	key length of the MAC function. Default = 20 bytes

output = (ephemeral) public key + ciphertext + tag

Definition at line 14 of file dlies.cpp.

                                                        :
   DLIES_Encryptor(own_priv_key, rng, std::move(kdf), nullptr, 0, std::move(mac), mac_key_length)
   {
   }

DLIES_Encryptor() [2/2]

Botan::DLIES_Encryptor::DLIES_Encryptor	(	const DH_PrivateKey &	own_priv_key,
		RandomNumberGenerator &	rng,
		std::unique_ptr< KDF >	kdf,
		std::unique_ptr< Cipher_Mode >	cipher,
		size_t	cipher_key_len,
		std::unique_ptr< MessageAuthenticationCode >	mac,
		size_t	mac_key_len = 20
	)

Block cipher mode

Parameters

own_priv_key	own (ephemeral) DH private key
rng	the RNG to use
kdf	the KDF that should be used
cipher	the block cipher that should be used
cipher_key_len	the key length of the block cipher
mac	the MAC function that should be used
mac_key_len	key length of the MAC function. Default = 20 bytes

output = (ephemeral) public key + ciphertext + tag

Definition at line 23 of file dlies.cpp.

                                                        :
   m_other_pub_key(),
   m_own_pub_key(own_priv_key.public_value()),
   m_ka(own_priv_key, rng, "Raw"),
   m_kdf(std::move(kdf)),
   m_cipher(std::move(cipher)),
   m_cipher_key_len(cipher_key_len),
   m_mac(std::move(mac)),
   m_mac_keylen(mac_key_length),
   m_iv()
   {
   BOTAN_ASSERT_NONNULL(m_kdf);
   BOTAN_ASSERT_NONNULL(m_mac);
   }

References BOTAN_ASSERT_NONNULL.

Member Function Documentation

encrypt() [1/2]

std::vector< uint8_t > Botan::PK_Encryptor::encrypt ( const uint8_t  in[], size_t  length, RandomNumberGenerator &  rng  ) const

inlineinherited

Encrypt a message.

Parameters

in	the message as a byte array
length	the length of the above byte array
rng	the random number source to use

Returns

encrypted message

Definition at line 38 of file pubkey.h.

         {
         return enc(in, length, rng);
         }

Referenced by Botan::KeyPair::encryption_consistency_check().

encrypt() [2/2]

std::vector< uint8_t > Botan::PK_Encryptor::encrypt ( std::span< const uint8_t >  in, RandomNumberGenerator &  rng  ) const

inlineinherited

Encrypt a message.

Parameters

in	the message
rng	the random number source to use

Returns

encrypted message

Definition at line 50 of file pubkey.h.

         {
         return enc(in.data(), in.size(), rng);
         }

set_initialization_vector()

void Botan::DLIES_Encryptor::set_initialization_vector ( const InitializationVector &  iv )

inline

Set the initialization vector for the data encryption method.

Definition at line 71 of file dlies.h.

         {
         m_iv = iv;
         }

set_other_key()

void Botan::DLIES_Encryptor::set_other_key ( const std::vector< uint8_t > &  other_pub_key )

inline

Definition at line 65 of file dlies.h.

         {
         m_other_pub_key = other_pub_key;
         }

---

The documentation for this class was generated from the following files:

• src/lib/pubkey/dlies/dlies.h
• src/lib/pubkey/dlies/dlies.cpp