/* * Diffie-Hellman * (C) 1999-2007 Jack Lloyd * * Botan is released under the Simplified BSD License (see license.txt) */ #ifndef BOTAN_DIFFIE_HELLMAN_H__ #define BOTAN_DIFFIE_HELLMAN_H__ #include namespace Botan { /** * This class represents Diffie-Hellman public keys. */ class BOTAN_DLL DH_PublicKey : public virtual DL_Scheme_PublicKey { public: std::string algo_name() const override { return "DH"; } std::vector public_value() const; size_t max_input_bits() const override { return group_p().bits(); } DL_Group::Format group_format() const override { return DL_Group::ANSI_X9_42; } /** * Create a public key. * @param alg_id the X.509 algorithm identifier * @param key_bits X.509 subject public key info structure */ DH_PublicKey(const AlgorithmIdentifier& alg_id, const secure_vector& key_bits) : DL_Scheme_PublicKey(alg_id, key_bits, DL_Group::ANSI_X9_42) {} /** * Construct a public key with the specified parameters. * @param grp the DL group to use in the key * @param y the public value y */ DH_PublicKey(const DL_Group& grp, const BigInt& y); protected: DH_PublicKey() {} }; /** * This class represents Diffie-Hellman private keys. */ class BOTAN_DLL DH_PrivateKey : public DH_PublicKey, public PK_Key_Agreement_Key, public virtual DL_Scheme_PrivateKey { public: std::vector public_value() const override; /** * Load a private key. * @param alg_id the X.509 algorithm identifier * @param key_bits PKCS #8 structure * @param rng a random number generator */ DH_PrivateKey(const AlgorithmIdentifier& alg_id, const secure_vector& key_bits, RandomNumberGenerator& rng); /** * Create a private key. * @param rng random number generator to use * @param grp the group to be used in the key * @param x the key's secret value (or if zero, generate a new key) */ DH_PrivateKey(RandomNumberGenerator& rng, const DL_Group& grp, const BigInt& x = 0); std::unique_ptr create_key_agreement_op(RandomNumberGenerator& rng, const std::string& params, const std::string& provider) const override; }; } #endif