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 16 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 37 of file pubkey.h.

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

Referenced by Botan::TLS::Client_Key_Exchange::Client_Key_Exchange(), and 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 47 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 67 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 64 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