pk_ops_impl.h

Go to the documentation of this file.

 
/*
* (C) 2015 Jack Lloyd
*
* Botan is released under the Simplified BSD License (see license.txt)
*/
 
#ifndef BOTAN_PK_OPERATION_IMPL_H_
#define BOTAN_PK_OPERATION_IMPL_H_
 
#include <botan/pk_ops.h>
 
namespace Botan {
 
class HashFunction;
class KDF;
class EncryptionPaddingScheme;
 
}  // namespace Botan
 
namespace Botan::PK_Ops {
 
// NOLINTBEGIN(*-special-member-functions)
 
class Encryption_with_Padding : public Encryption {
   public:
      ~Encryption_with_Padding() override;
 
      size_t max_input_bits() const override;
 
      std::vector<uint8_t> encrypt(std::span<const uint8_t> ptext, RandomNumberGenerator& rng) override;
 
   protected:
      explicit Encryption_with_Padding(std::string_view padding);
 
   private:
      virtual size_t max_ptext_input_bits() const = 0;
 
      virtual std::vector<uint8_t> raw_encrypt(std::span<const uint8_t> msg, RandomNumberGenerator& rng) = 0;
      std::unique_ptr<EncryptionPaddingScheme> m_padding;
};
 
class Decryption_with_Padding : public Decryption {
   public:
      ~Decryption_with_Padding() override;
 
      secure_vector<uint8_t> decrypt(uint8_t& valid_mask, std::span<const uint8_t> ctext) override;
 
   protected:
      explicit Decryption_with_Padding(std::string_view padding);
 
   private:
      virtual secure_vector<uint8_t> raw_decrypt(std::span<const uint8_t> ctext) = 0;
      std::unique_ptr<EncryptionPaddingScheme> m_padding;
};
 
class Verification_with_Hash : public Verification {
   public:
      ~Verification_with_Hash() override;
 
      void update(std::span<const uint8_t> input) override;
      bool is_valid_signature(std::span<const uint8_t> sig) override;
 
      std::string hash_function() const final;
 
   protected:
      explicit Verification_with_Hash(std::string_view hash);
 
      explicit Verification_with_Hash(const AlgorithmIdentifier& alg_id,
                                      std::string_view pk_algo,
                                      bool allow_null_parameters = false);
 
      /**
      * Perform a signature check operation
      * @param msg the message
      * @param sig the signature
      * @returns if sig is a valid signature for msg
      */
      virtual bool verify(std::span<const uint8_t> msg, std::span<const uint8_t> sig) = 0;
 
   private:
      std::unique_ptr<HashFunction> m_hash;
};
 
class Signature_with_Hash : public Signature {
   public:
      void update(std::span<const uint8_t> input) override;
 
      std::vector<uint8_t> sign(RandomNumberGenerator& rng) override;
 
      ~Signature_with_Hash() override;
 
   protected:
      explicit Signature_with_Hash(std::string_view hash);
 
      std::string hash_function() const final;
 
#if defined(BOTAN_HAS_RFC6979_GENERATOR)
      std::string rfc6979_hash_function() const;
#endif
 
   private:
      virtual std::vector<uint8_t> raw_sign(std::span<const uint8_t> input, RandomNumberGenerator& rng) = 0;
 
      std::unique_ptr<HashFunction> m_hash;
};
 
class Key_Agreement_with_KDF : public Key_Agreement {
   public:
      secure_vector<uint8_t> agree(size_t key_len,
                                   std::span<const uint8_t> other_key,
                                   std::span<const uint8_t> salt) override;
 
      ~Key_Agreement_with_KDF() override;
 
   protected:
      explicit Key_Agreement_with_KDF(std::string_view kdf);
 
   private:
      virtual secure_vector<uint8_t> raw_agree(const uint8_t w[], size_t w_len) = 0;
      std::unique_ptr<KDF> m_kdf;
};
 
class KEM_Encryption_with_KDF : public KEM_Encryption {
   public:
      void kem_encrypt(std::span<uint8_t> out_encapsulated_key,
                       std::span<uint8_t> out_shared_key,
                       RandomNumberGenerator& rng,
                       size_t desired_shared_key_len,
                       std::span<const uint8_t> salt) final;
 
      size_t shared_key_length(size_t desired_shared_key_len) const final;
 
      ~KEM_Encryption_with_KDF() override;
 
   protected:
      virtual void raw_kem_encrypt(std::span<uint8_t> out_encapsulated_key,
                                   std::span<uint8_t> out_raw_shared_key,
                                   RandomNumberGenerator& rng) = 0;
 
      virtual size_t raw_kem_shared_key_length() const = 0;
 
      explicit KEM_Encryption_with_KDF(std::string_view kdf);
 
   private:
      std::unique_ptr<KDF> m_kdf;
};
 
class KEM_Decryption_with_KDF : public KEM_Decryption {
   public:
      void kem_decrypt(std::span<uint8_t> out_shared_key,
                       std::span<const uint8_t> encapsulated_key,
                       size_t desired_shared_key_len,
                       std::span<const uint8_t> salt) final;
 
      size_t shared_key_length(size_t desired_shared_key_len) const final;
 
      ~KEM_Decryption_with_KDF() override;
 
   protected:
      virtual void raw_kem_decrypt(std::span<uint8_t> out_raw_shared_key,
                                   std::span<const uint8_t> encapsulated_key) = 0;
 
      virtual size_t raw_kem_shared_key_length() const = 0;
 
      explicit KEM_Decryption_with_KDF(std::string_view kdf);
 
   private:
      std::unique_ptr<KDF> m_kdf;
};
 
// NOLINTEND(*-special-member-functions)
 
}  // namespace Botan::PK_Ops
 
#endif