Botan
1.11.15
|
#include <if_algo.h>
Public Member Functions | |
virtual std::string | algo_name () const =0 |
AlgorithmIdentifier | algorithm_identifier () const |
bool | check_key (RandomNumberGenerator &rng, bool) const |
size_t | estimated_strength () const override |
const BigInt & | get_c () const |
const BigInt & | get_d () const |
const BigInt & | get_d1 () const |
const BigInt & | get_d2 () const |
const BigInt & | get_e () const |
const BigInt & | get_n () const |
virtual OID | get_oid () const |
const BigInt & | get_p () const |
const BigInt & | get_q () const |
IF_Scheme_PrivateKey (RandomNumberGenerator &rng, const BigInt &prime1, const BigInt &prime2, const BigInt &exp, const BigInt &d_exp, const BigInt &mod) | |
IF_Scheme_PrivateKey (RandomNumberGenerator &rng, const AlgorithmIdentifier &alg_id, const secure_vector< byte > &key_bits) | |
size_t | max_input_bits () const |
virtual size_t | message_part_size () const |
virtual size_t | message_parts () const |
virtual AlgorithmIdentifier | pkcs8_algorithm_identifier () const |
secure_vector< byte > | pkcs8_private_key () const |
std::vector< byte > | x509_subject_public_key () const |
Protected Member Functions | |
void | gen_check (RandomNumberGenerator &rng) const |
IF_Scheme_PrivateKey () | |
virtual void | load_check (RandomNumberGenerator &rng) const |
void | load_check (RandomNumberGenerator &rng) const |
Protected Attributes | |
BigInt | c |
BigInt | d |
BigInt | d1 |
BigInt | d2 |
BigInt | e |
BigInt | n |
BigInt | p |
BigInt | q |
This class represents public keys of integer factorization based (IF) public key schemes.
Botan::IF_Scheme_PrivateKey::IF_Scheme_PrivateKey | ( | RandomNumberGenerator & | rng, |
const BigInt & | prime1, | ||
const BigInt & | prime2, | ||
const BigInt & | exp, | ||
const BigInt & | d_exp, | ||
const BigInt & | mod | ||
) |
Definition at line 95 of file if_algo.cpp.
References c, d, d1, d2, Botan::IF_Scheme_PublicKey::e, Botan::inverse_mod(), Botan::BigInt::is_even(), Botan::BigInt::is_nonzero(), Botan::lcm(), Botan::Private_Key::load_check(), Botan::IF_Scheme_PublicKey::n, p, and q.
Botan::IF_Scheme_PrivateKey::IF_Scheme_PrivateKey | ( | RandomNumberGenerator & | rng, |
const AlgorithmIdentifier & | alg_id, | ||
const secure_vector< byte > & | key_bits | ||
) |
Definition at line 75 of file if_algo.cpp.
References c, d, d1, d2, Botan::BER::decode(), Botan::BER_Decoder::decode_and_check(), Botan::IF_Scheme_PublicKey::e, Botan::Private_Key::load_check(), Botan::IF_Scheme_PublicKey::n, p, q, Botan::SEQUENCE, and Botan::BER_Decoder::start_cons().
Botan::IF_Scheme_PrivateKey::IF_Scheme_PrivateKey | ( | ) | [inline, protected] |
virtual std::string Botan::Public_Key::algo_name | ( | ) | const [pure virtual, inherited] |
Get the name of the underlying public key scheme.
Implemented in Botan::GOST_3410_PublicKey, Botan::ECDH_PublicKey, Botan::ECDSA_PublicKey, Botan::McEliece_PublicKey, Botan::RSA_PublicKey, Botan::DH_PublicKey, Botan::DSA_PublicKey, Botan::ElGamal_PublicKey, Botan::NR_PublicKey, Botan::RW_PublicKey, and Botan::Curve25519_PublicKey.
Referenced by Botan::PKCS8::BER_encode(), Botan::EAC_Signed_Object::check_signature(), Botan::X509_Object::check_signature(), Botan::TLS::Handshake_State::choose_sig_format(), Botan::choose_sig_format(), Botan::TLS::Client_Key_Exchange::Client_Key_Exchange(), Botan::find_constraints(), Botan::Private_Key::gen_check(), Botan::Public_Key::get_oid(), Botan::Public_Key::load_check(), Botan::Private_Key::load_check(), Botan::PK_Encryptor_EME::PK_Encryptor_EME(), Botan::PK_Key_Agreement::PK_Key_Agreement(), Botan::PK_Signer::PK_Signer(), Botan::PK_Verifier::PK_Verifier(), and Botan::TLS::Handshake_State::understand_sig_format().
AlgorithmIdentifier Botan::IF_Scheme_PublicKey::algorithm_identifier | ( | ) | const [virtual, inherited] |
Implements Botan::Public_Key.
Definition at line 21 of file if_algo.cpp.
References Botan::Public_Key::get_oid(), and Botan::AlgorithmIdentifier::USE_NULL_PARAM.
{ return AlgorithmIdentifier(get_oid(), AlgorithmIdentifier::USE_NULL_PARAM); }
bool Botan::IF_Scheme_PrivateKey::check_key | ( | RandomNumberGenerator & | rng, |
bool | strong | ||
) | const [virtual] |
Test the key values for consistency.
rng | rng to use |
strong | whether to perform strong and lengthy version of the test |
Reimplemented from Botan::IF_Scheme_PublicKey.
Reimplemented in Botan::RW_PrivateKey, and Botan::RSA_PrivateKey.
Definition at line 127 of file if_algo.cpp.
References c, d, d1, d2, Botan::IF_Scheme_PublicKey::e, Botan::inverse_mod(), Botan::BigInt::is_even(), Botan::is_prime(), Botan::IF_Scheme_PublicKey::n, p, and q.
Referenced by Botan::RSA_PrivateKey::check_key(), and Botan::RW_PrivateKey::check_key().
size_t Botan::IF_Scheme_PublicKey::estimated_strength | ( | ) | const [override, virtual, inherited] |
Return the estimated strength of the underlying key against the best currently known attack. Note that this ignores anything but pure attacks against the key itself and do not take into account padding schemes, usage mistakes, etc which might reduce the strength. However it does suffice to provide an upper bound.
Implements Botan::Public_Key.
Definition at line 16 of file if_algo.cpp.
References Botan::BigInt::bits(), Botan::dl_work_factor(), and Botan::IF_Scheme_PublicKey::n.
{ return dl_work_factor(n.bits()); }
void Botan::Private_Key::gen_check | ( | RandomNumberGenerator & | rng | ) | const [protected, inherited] |
Self-test after generating a key
rng | a random number generator |
Definition at line 49 of file pk_keys.cpp.
References Botan::Public_Key::algo_name(), and Botan::Public_Key::check_key().
Referenced by Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), Botan::NR_PrivateKey::NR_PrivateKey(), Botan::RSA_PrivateKey::RSA_PrivateKey(), and Botan::RW_PrivateKey::RW_PrivateKey().
const BigInt& Botan::IF_Scheme_PrivateKey::get_c | ( | ) | const [inline] |
const BigInt& Botan::IF_Scheme_PrivateKey::get_d | ( | ) | const [inline] |
const BigInt& Botan::IF_Scheme_PrivateKey::get_d1 | ( | ) | const [inline] |
const BigInt& Botan::IF_Scheme_PrivateKey::get_d2 | ( | ) | const [inline] |
const BigInt& Botan::IF_Scheme_PublicKey::get_e | ( | ) | const [inline, inherited] |
const BigInt& Botan::IF_Scheme_PublicKey::get_n | ( | ) | const [inline, inherited] |
OID Botan::Public_Key::get_oid | ( | ) | const [virtual, inherited] |
Get the OID of the underlying public key scheme.
Definition at line 17 of file pk_keys.cpp.
References Botan::Public_Key::algo_name(), and Botan::OIDS::lookup().
Referenced by Botan::DL_Scheme_PublicKey::algorithm_identifier(), Botan::Curve25519_PublicKey::algorithm_identifier(), Botan::IF_Scheme_PublicKey::algorithm_identifier(), Botan::GOST_3410_PublicKey::algorithm_identifier(), Botan::EC_PublicKey::algorithm_identifier(), and Botan::McEliece_PublicKey::algorithm_identifier().
{ try { return OIDS::lookup(algo_name()); } catch(Lookup_Error) { throw Lookup_Error("PK algo " + algo_name() + " has no defined OIDs"); } }
const BigInt& Botan::IF_Scheme_PrivateKey::get_p | ( | ) | const [inline] |
const BigInt& Botan::IF_Scheme_PrivateKey::get_q | ( | ) | const [inline] |
void Botan::Public_Key::load_check | ( | RandomNumberGenerator & | rng | ) | const [protected, virtual, inherited] |
Self-test after loading a key
rng | a random number generator |
Reimplemented in Botan::Private_Key.
Definition at line 31 of file pk_keys.cpp.
References Botan::Public_Key::algo_name(), and Botan::Public_Key::check_key().
{ if(!check_key(rng, BOTAN_PUBLIC_KEY_STRONG_CHECKS_ON_LOAD)) throw Invalid_Argument(algo_name() + ": Invalid public key"); }
void Botan::Private_Key::load_check | ( | RandomNumberGenerator & | rng | ) | const [protected, virtual, inherited] |
Self-test after loading a key
rng | a random number generator |
Reimplemented from Botan::Public_Key.
Definition at line 40 of file pk_keys.cpp.
References Botan::Public_Key::algo_name(), and Botan::Public_Key::check_key().
Referenced by Botan::Curve25519_PrivateKey::Curve25519_PrivateKey(), Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), IF_Scheme_PrivateKey(), and Botan::NR_PrivateKey::NR_PrivateKey().
{ if(!check_key(rng, BOTAN_PRIVATE_KEY_STRONG_CHECKS_ON_LOAD)) throw Invalid_Argument(algo_name() + ": Invalid private key"); }
size_t Botan::IF_Scheme_PublicKey::max_input_bits | ( | ) | const [inline, virtual, inherited] |
virtual size_t Botan::Public_Key::message_part_size | ( | ) | const [inline, virtual, inherited] |
Find out the message part size supported by this scheme/key.
Reimplemented in Botan::GOST_3410_PublicKey, Botan::ECDSA_PublicKey, Botan::NR_PublicKey, and Botan::DSA_PublicKey.
Definition at line 67 of file pk_keys.h.
{ return 0; }
virtual size_t Botan::Public_Key::message_parts | ( | ) | const [inline, virtual, inherited] |
Find out the number of message parts supported by this scheme.
Reimplemented in Botan::GOST_3410_PublicKey, Botan::ECDSA_PublicKey, Botan::NR_PublicKey, and Botan::DSA_PublicKey.
Definition at line 61 of file pk_keys.h.
Referenced by Botan::EAC_Signed_Object::check_signature(), Botan::X509_Object::check_signature(), and Botan::choose_sig_format().
{ return 1; }
virtual AlgorithmIdentifier Botan::Private_Key::pkcs8_algorithm_identifier | ( | ) | const [inline, virtual, inherited] |
Reimplemented in Botan::GOST_3410_PrivateKey.
Definition at line 109 of file pk_keys.h.
Referenced by Botan::PKCS8::BER_encode().
{ return algorithm_identifier(); }
secure_vector< byte > Botan::IF_Scheme_PrivateKey::pkcs8_private_key | ( | ) | const [virtual] |
Implements Botan::Private_Key.
Definition at line 58 of file if_algo.cpp.
References c, d, d1, d2, Botan::IF_Scheme_PublicKey::e, Botan::DER_Encoder::encode(), Botan::DER_Encoder::end_cons(), Botan::DER_Encoder::get_contents(), Botan::IF_Scheme_PublicKey::n, p, q, Botan::SEQUENCE, and Botan::DER_Encoder::start_cons().
std::vector< byte > Botan::IF_Scheme_PublicKey::x509_subject_public_key | ( | ) | const [virtual, inherited] |
Implements Botan::Public_Key.
Definition at line 27 of file if_algo.cpp.
References Botan::IF_Scheme_PublicKey::e, Botan::DER_Encoder::encode(), Botan::DER_Encoder::end_cons(), Botan::DER_Encoder::get_contents_unlocked(), Botan::IF_Scheme_PublicKey::n, Botan::SEQUENCE, and Botan::DER_Encoder::start_cons().
BigInt Botan::IF_Scheme_PrivateKey::c [protected] |
Definition at line 103 of file if_algo.h.
Referenced by check_key(), IF_Scheme_PrivateKey(), pkcs8_private_key(), Botan::RSA_PrivateKey::RSA_PrivateKey(), and Botan::RW_PrivateKey::RW_PrivateKey().
BigInt Botan::IF_Scheme_PrivateKey::d [protected] |
Definition at line 103 of file if_algo.h.
Referenced by Botan::RSA_PrivateKey::check_key(), Botan::RW_PrivateKey::check_key(), check_key(), IF_Scheme_PrivateKey(), pkcs8_private_key(), Botan::RSA_PrivateKey::RSA_PrivateKey(), and Botan::RW_PrivateKey::RW_PrivateKey().
BigInt Botan::IF_Scheme_PrivateKey::d1 [protected] |
Definition at line 103 of file if_algo.h.
Referenced by check_key(), IF_Scheme_PrivateKey(), pkcs8_private_key(), Botan::RSA_PrivateKey::RSA_PrivateKey(), and Botan::RW_PrivateKey::RW_PrivateKey().
BigInt Botan::IF_Scheme_PrivateKey::d2 [protected] |
Definition at line 103 of file if_algo.h.
Referenced by check_key(), IF_Scheme_PrivateKey(), pkcs8_private_key(), Botan::RSA_PrivateKey::RSA_PrivateKey(), and Botan::RW_PrivateKey::RW_PrivateKey().
BigInt Botan::IF_Scheme_PublicKey::e [protected, inherited] |
Definition at line 53 of file if_algo.h.
Referenced by Botan::IF_Scheme_PublicKey::check_key(), Botan::RSA_PrivateKey::check_key(), Botan::RW_PrivateKey::check_key(), check_key(), IF_Scheme_PrivateKey(), Botan::IF_Scheme_PublicKey::IF_Scheme_PublicKey(), pkcs8_private_key(), Botan::RSA_PrivateKey::RSA_PrivateKey(), Botan::RW_PrivateKey::RW_PrivateKey(), and Botan::IF_Scheme_PublicKey::x509_subject_public_key().
BigInt Botan::IF_Scheme_PublicKey::n [protected, inherited] |
Definition at line 53 of file if_algo.h.
Referenced by Botan::IF_Scheme_PublicKey::check_key(), check_key(), Botan::IF_Scheme_PublicKey::estimated_strength(), IF_Scheme_PrivateKey(), Botan::IF_Scheme_PublicKey::IF_Scheme_PublicKey(), pkcs8_private_key(), Botan::RSA_PrivateKey::RSA_PrivateKey(), Botan::RW_PrivateKey::RW_PrivateKey(), and Botan::IF_Scheme_PublicKey::x509_subject_public_key().
BigInt Botan::IF_Scheme_PrivateKey::p [protected] |
Definition at line 103 of file if_algo.h.
Referenced by Botan::RSA_PrivateKey::check_key(), Botan::RW_PrivateKey::check_key(), check_key(), IF_Scheme_PrivateKey(), pkcs8_private_key(), Botan::RSA_PrivateKey::RSA_PrivateKey(), and Botan::RW_PrivateKey::RW_PrivateKey().
BigInt Botan::IF_Scheme_PrivateKey::q [protected] |
Definition at line 103 of file if_algo.h.
Referenced by Botan::RSA_PrivateKey::check_key(), Botan::RW_PrivateKey::check_key(), check_key(), IF_Scheme_PrivateKey(), pkcs8_private_key(), Botan::RSA_PrivateKey::RSA_PrivateKey(), and Botan::RW_PrivateKey::RW_PrivateKey().