Botan::PK_KEM_Decryptor Class Reference

#include <pubkey.h>

Public Member Functions
secure_vector< uint8_t >	decrypt (const uint8_t encap_key[], size_t encap_key_len, size_t desired_shared_key_len)
secure_vector< uint8_t >	decrypt (const uint8_t encap_key[], size_t encap_key_len, size_t desired_shared_key_len, const uint8_t salt[], size_t salt_len)
secure_vector< uint8_t >	decrypt (std::span< const uint8_t > encap_key, size_t desired_shared_key_len, std::span< const uint8_t > salt)
PK_KEM_Decryptor &	operator= (const PK_KEM_Decryptor &)=delete
PK_KEM_Decryptor &	operator= (PK_KEM_Decryptor &&)=delete
	PK_KEM_Decryptor (const PK_KEM_Decryptor &)=delete
	PK_KEM_Decryptor (const Private_Key &key, RandomNumberGenerator &rng, std::string_view kem_param="", std::string_view provider="")
	PK_KEM_Decryptor (PK_KEM_Decryptor &&)=delete
size_t	shared_key_length (size_t desired_shared_key_len) const
	~PK_KEM_Decryptor ()

Detailed Description

Public Key Key Encapsulation Mechanism Decryption.

Definition at line 727 of file pubkey.h.

Constructor & Destructor Documentation

PK_KEM_Decryptor() [1/3]

Botan::PK_KEM_Decryptor::PK_KEM_Decryptor	(	const Private_Key &	key,
		RandomNumberGenerator &	rng,
		std::string_view	kem_param = "",
		std::string_view	provider = ""
	)

Construct an instance.

Parameters

key	the key to use inside the decryptor
rng	the RNG to use
kem_param	additional KEM parameters
provider	the provider to use

Definition at line 188 of file pubkey.cpp.

   {
   m_op = key.create_kem_decryption_op(rng, param, provider);
   if(!m_op)
      {
      throw Invalid_Argument(fmt("Key type {} does not support KEM decryption", key.algo_name()));
      }
   }

References Botan::Asymmetric_Key::algo_name(), Botan::Private_Key::create_kem_decryption_op(), and Botan::fmt().

~PK_KEM_Decryptor()

Botan::PK_KEM_Decryptor::~PK_KEM_Decryptor ( )

default

PK_KEM_Decryptor() [2/3]

Botan::PK_KEM_Decryptor::PK_KEM_Decryptor ( const PK_KEM_Decryptor &  )

delete

PK_KEM_Decryptor() [3/3]

Botan::PK_KEM_Decryptor::PK_KEM_Decryptor ( PK_KEM_Decryptor &&  )

delete

Member Function Documentation

decrypt() [1/3]

secure_vector< uint8_t > Botan::PK_KEM_Decryptor::decrypt ( const uint8_t  encap_key[], size_t  encap_key_len, size_t  desired_shared_key_len  )

inline

Decrypts the shared key for data encryption.

Parameters

encap_key	the encapsulated key
encap_key_len	size of the encapsulated key in bytes
desired_shared_key_len	desired size of the shared key in bytes

Returns

the shared data encryption key

Definition at line 786 of file pubkey.h.

         {
         return this->decrypt(encap_key, encap_key_len,
                              desired_shared_key_len,
                              nullptr, 0);
         }

decrypt() [2/3]

secure_vector< uint8_t > Botan::PK_KEM_Decryptor::decrypt	(	const uint8_t	encap_key[],
		size_t	encap_key_len,
		size_t	desired_shared_key_len,
		const uint8_t	salt[],
		size_t	salt_len
	)

Decrypts the shared key for data encryption.

Parameters

encap_key	the encapsulated key
encap_key_len	size of the encapsulated key in bytes
desired_shared_key_len	desired size of the shared key in bytes
salt	a salt value used in the KDF
salt_len	size of the salt value in bytes

Returns

the shared data encryption key

Definition at line 202 of file pubkey.cpp.

   {
   return m_op->kem_decrypt(encap_key, encap_key_len,
                            desired_shared_key_len,
                            salt, salt_len);
   }

decrypt() [3/3]

secure_vector< uint8_t > Botan::PK_KEM_Decryptor::decrypt ( std::span< const uint8_t >  encap_key, size_t  desired_shared_key_len, std::span< const uint8_t >  salt  )

inline

Decrypts the shared key for data encryption.

Parameters

encap_key	the encapsulated key
desired_shared_key_len	desired size of the shared key in bytes
salt	a salt value used in the KDF

Returns

the shared data encryption key

Definition at line 802 of file pubkey.h.

         {
         return this->decrypt(encap_key.data(), encap_key.size(),
                              desired_shared_key_len,
                              salt.data(), salt.size());
         }

operator=() [1/2]

PK_KEM_Decryptor & Botan::PK_KEM_Decryptor::operator= ( const PK_KEM_Decryptor &  )

delete

operator=() [2/2]

PK_KEM_Decryptor & Botan::PK_KEM_Decryptor::operator= ( PK_KEM_Decryptor &&  )

delete

shared_key_length()

size_t Botan::PK_KEM_Decryptor::shared_key_length

(

size_t

desired_shared_key_len

)

const

Return the length of the shared key returned by this KEM

If this KEM was used with a KDF, then it will always return exactly the desired key length, because the output of the KEM will be hashed by the KDF.

However if the KEM was used with "Raw" kdf, to request the algorithmic output of the KEM directly, then the desired key length will be ignored and a bytestring that depends on the algorithm is returned

Parameters

desired_shared_key_len

is the requested length.

Definition at line 183 of file pubkey.cpp.

   {
   return m_op->shared_key_length(desired_shared_key_len);
   }

---

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

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