#include <dsa.h>

Inheritance diagram for Botan::DSA_PrivateKey:

Public Member Functions
std::string	algo_name () const
AlgorithmIdentifier	algorithm_identifier () const
bool	check_key (RandomNumberGenerator &rng, bool strong) const
	DSA_PrivateKey (const AlgorithmIdentifier &alg_id, const MemoryRegion< byte > &key_bits, RandomNumberGenerator &rng)
	DSA_PrivateKey (RandomNumberGenerator &rng, const DL_Group &group, const BigInt &private_key=0)
const DL_Group &	get_domain () const
virtual OID	get_oid () const
const BigInt &	get_x () const
const BigInt &	get_y () const
DL_Group::Format	group_format () const
const BigInt &	group_g () const
const BigInt &	group_p () const
const BigInt &	group_q () const
size_t	max_input_bits () const
size_t	message_part_size () const
size_t	message_parts () const
virtual AlgorithmIdentifier	pkcs8_algorithm_identifier () const
MemoryVector< byte >	pkcs8_private_key () const
MemoryVector< byte >	x509_subject_public_key () const

Protected Member Functions
void	gen_check (RandomNumberGenerator &rng) const
void	load_check (RandomNumberGenerator &rng) const
virtual void	load_check (RandomNumberGenerator &rng) const

Protected Attributes
DL_Group	group
BigInt	x
BigInt	y

Detailed Description

DSA Private Key

Definition at line 45 of file dsa.h.

Constructor & Destructor Documentation

◆ DSA_PrivateKey() [1/2]

Botan::DSA_PrivateKey::DSA_PrivateKey	(	const AlgorithmIdentifier &	alg_id,
		const MemoryRegion< byte > &	key_bits,
		RandomNumberGenerator &	rng )

Definition at line 44 of file dsa.cpp.

                                                           :
   DL_Scheme_PrivateKey(alg_id, key_bits, DL_Group::ANSI_X9_57)
   {
   y = power_mod(group_g(), x, group_p());
 
   load_check(rng);
   }

References Botan::DL_Scheme_PrivateKey::DL_Scheme_PrivateKey(), Botan::DL_Scheme_PublicKey::group_g(), Botan::DL_Scheme_PublicKey::group_p(), Botan::Private_Key::load_check(), Botan::power_mod(), Botan::DL_Scheme_PrivateKey::x, and Botan::DL_Scheme_PublicKey::y.

Referenced by Botan::make_private_key().

◆ DSA_PrivateKey() [2/2]

Botan::DSA_PrivateKey::DSA_PrivateKey	(	RandomNumberGenerator &	rng,
		const DL_Group &	group,
		const BigInt &	private_key = 0 )

Definition at line 26 of file dsa.cpp.

   {
   group = grp;
   x = x_arg;
 
   if(x == 0)
      x = BigInt::random_integer(rng, 2, group_q() - 1);
 
   y = power_mod(group_g(), x, group_p());
 
   if(x_arg == 0)
      gen_check(rng);
   else
      load_check(rng);
   }

References Botan::Private_Key::gen_check(), Botan::DL_Scheme_PublicKey::group, Botan::DL_Scheme_PublicKey::group_g(), Botan::DL_Scheme_PublicKey::group_p(), Botan::DL_Scheme_PublicKey::group_q(), Botan::Private_Key::load_check(), Botan::power_mod(), Botan::BigInt::random_integer(), Botan::DL_Scheme_PrivateKey::x, and Botan::DL_Scheme_PublicKey::y.

Member Function Documentation

◆ algo_name()

std::string Botan::DSA_PublicKey::algo_name ( ) const

inlinevirtualinherited

Get the name of the underlying public key scheme.

Returns: name of the public key scheme

Implements Botan::Public_Key.

Definition at line 24 of file dsa.h.

24{ return "DSA"; }

◆ algorithm_identifier()

AlgorithmIdentifier Botan::DL_Scheme_PublicKey::algorithm_identifier ( ) const

virtualinherited

Returns: X.509 AlgorithmIdentifier for this key

Implements Botan::Public_Key.

Definition at line 15 of file dl_algo.cpp.

   {
   return AlgorithmIdentifier(get_oid(),
                              group.DER_encode(group_format()));
   }

References Botan::AlgorithmIdentifier::AlgorithmIdentifier(), Botan::DL_Group::DER_encode(), Botan::Public_Key::get_oid(), group, and group_format().

◆ check_key()

bool Botan::DSA_PrivateKey::check_key	(	RandomNumberGenerator &	rng,
		bool	strong ) const

virtual

Test the key values for consistency.

Parameters

rng	rng to use
strong	whether to perform strong and lengthy version of the test

Returns: true if the test is passed

Reimplemented from Botan::DL_Scheme_PublicKey.

Definition at line 57 of file dsa.cpp.

   {
   if(!DL_Scheme_PrivateKey::check_key(rng, strong) || x >= group_q())
      return false;
 
   if(!strong)
      return true;
 
   return KeyPair::signature_consistency_check(rng, *this, "EMSA1(SHA-1)");
   }

References Botan::DL_Scheme_PrivateKey::check_key(), Botan::DL_Scheme_PublicKey::group_q(), Botan::KeyPair::signature_consistency_check(), and Botan::DL_Scheme_PrivateKey::x.

◆ gen_check()

void Botan::Private_Key::gen_check ( RandomNumberGenerator & rng ) const

protectedinherited

Self-test after generating a key

Parameters

rng	a random number generator

Definition at line 49 of file pk_keys.cpp.

   {
   if(!check_key(rng, BOTAN_PRIVATE_KEY_STRONG_CHECKS_ON_GENERATE))
      throw Self_Test_Failure(algo_name() + " private key generation failed");
   }

References Botan::Public_Key::algo_name(), Botan::Public_Key::check_key(), and Botan::Self_Test_Failure::Self_Test_Failure().

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().

◆ get_domain()

const DL_Group & Botan::DL_Scheme_PublicKey::get_domain ( ) const

inlineinherited

Get the DL domain parameters of this key.

Returns: DL domain parameters of this key

Definition at line 33 of file dl_algo.h.

33{ return group; }

References group.

Referenced by Botan::Server_Key_Exchange::Server_Key_Exchange().

◆ get_oid()

OID Botan::Public_Key::get_oid ( ) const

virtualinherited

Get the OID of the underlying public key scheme.

Returns: OID of the public key scheme

Definition at line 17 of file pk_keys.cpp.

   {
   try {
      return OIDS::lookup(algo_name());
      }
   catch(Lookup_Error)
      {
      throw Lookup_Error("PK algo " + algo_name() + " has no defined OIDs");
      }
   }

References algo_name(), Botan::OIDS::lookup(), and Botan::Lookup_Error::Lookup_Error().

Referenced by algo_name(), Botan::DL_Scheme_PublicKey::algorithm_identifier(), Botan::EC_PublicKey::algorithm_identifier(), and Botan::IF_Scheme_PublicKey::algorithm_identifier().

◆ get_x()

const BigInt & Botan::DL_Scheme_PrivateKey::get_x ( ) const

inlineinherited

Get the secret key x.

Returns: secret key

Definition at line 95 of file dl_algo.h.

95{ return x; }

References x.

Referenced by Botan::ElGamal_Decryption_Operation::ElGamal_Decryption_Operation().

◆ get_y()

const BigInt & Botan::DL_Scheme_PublicKey::get_y ( ) const

inlineinherited

Get the public value y with y = g^x mod p where x is the secret key.

Definition at line 38 of file dl_algo.h.

38{ return y; }

References y.

Referenced by Botan::ElGamal_Encryption_Operation::ElGamal_Encryption_Operation().

◆ group_format()

DL_Group::Format Botan::DSA_PublicKey::group_format ( ) const

inlinevirtualinherited

Get the underlying groups encoding format.

Returns: encoding format

Implements Botan::DL_Scheme_PublicKey.

Definition at line 26 of file dsa.h.

26{ return DL_Group::ANSI_X9_57; }

References Botan::DL_Group::ANSI_X9_57.

◆ group_g()

const BigInt & Botan::DL_Scheme_PublicKey::group_g ( ) const

inlineinherited

Get the generator g of the underlying DL group.

Returns: generator g

Definition at line 56 of file dl_algo.h.

56{ return group.get_g(); }

Botan::DL_Group::get_g

const BigInt & get_g() const

Definition dl_group.cpp:185

References group.

Referenced by Botan::DL_Scheme_PrivateKey::check_key(), Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::DSA_Verification_Operation::DSA_Verification_Operation(), Botan::ElGamal_Encryption_Operation::ElGamal_Encryption_Operation(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), Botan::NR_PrivateKey::NR_PrivateKey(), Botan::NR_PrivateKey::NR_PrivateKey(), and Botan::NR_Verification_Operation::NR_Verification_Operation().

◆ group_p()

const BigInt & Botan::DL_Scheme_PublicKey::group_p ( ) const

inlineinherited

Get the prime p of the underlying DL group.

Returns: prime p

Definition at line 44 of file dl_algo.h.

44{ return group.get_p(); }

Botan::DL_Group::get_p

const BigInt & get_p() const

Definition dl_group.cpp:176

References group.

Referenced by Botan::DL_Scheme_PrivateKey::check_key(), check_key(), Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::DSA_Verification_Operation::DSA_Verification_Operation(), Botan::ElGamal_Decryption_Operation::ElGamal_Decryption_Operation(), Botan::ElGamal_Encryption_Operation::ElGamal_Encryption_Operation(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), Botan::DH_PublicKey::max_input_bits(), Botan::ElGamal_PublicKey::max_input_bits(), Botan::NR_PrivateKey::NR_PrivateKey(), Botan::NR_PrivateKey::NR_PrivateKey(), Botan::NR_Verification_Operation::NR_Verification_Operation(), and Botan::DH_PublicKey::public_value().

◆ group_q()

const BigInt & Botan::DL_Scheme_PublicKey::group_q ( ) const

inlineinherited

Get the prime q of the underlying DL group.

Returns: prime q

Definition at line 50 of file dl_algo.h.

50{ return group.get_q(); }

Botan::DL_Group::get_q

const BigInt & get_q() const

Definition dl_group.cpp:194

References group.

Referenced by Botan::DSA_PrivateKey::check_key(), Botan::NR_PrivateKey::check_key(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::DSA_Verification_Operation::DSA_Verification_Operation(), Botan::DSA_PublicKey::max_input_bits(), Botan::NR_PublicKey::max_input_bits(), Botan::DSA_PublicKey::message_part_size(), Botan::NR_PublicKey::message_part_size(), Botan::NR_PrivateKey::NR_PrivateKey(), and Botan::NR_Verification_Operation::NR_Verification_Operation().

◆ load_check() [1/2]

void Botan::Private_Key::load_check ( RandomNumberGenerator & rng ) const

protectedvirtualinherited

Self-test after loading a key

Parameters

rng	a random number generator

Reimplemented from Botan::Public_Key.

Definition at line 40 of file pk_keys.cpp.

   {
   if(!check_key(rng, BOTAN_PRIVATE_KEY_STRONG_CHECKS_ON_LOAD))
      throw Invalid_Argument(algo_name() + ": Invalid private key");
   }

References Botan::Public_Key::algo_name(), and Botan::Public_Key::check_key().

Referenced by Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), Botan::IF_Scheme_PrivateKey::IF_Scheme_PrivateKey(), Botan::IF_Scheme_PrivateKey::IF_Scheme_PrivateKey(), Botan::NR_PrivateKey::NR_PrivateKey(), and Botan::NR_PrivateKey::NR_PrivateKey().

◆ load_check() [2/2]

void Botan::Public_Key::load_check ( RandomNumberGenerator & rng ) const

protectedvirtualinherited

Self-test after loading a key

Parameters

rng	a random number generator

Reimplemented in Botan::Private_Key.

Definition at line 31 of file pk_keys.cpp.

   {
   if(!check_key(rng, BOTAN_PUBLIC_KEY_STRONG_CHECKS_ON_LOAD))
      throw Invalid_Argument(algo_name() + ": Invalid public key");
   }

References algo_name(), and check_key().

◆ max_input_bits()

size_t Botan::DSA_PublicKey::max_input_bits ( ) const

inlinevirtualinherited

Get the maximum message size in bits supported by this public key.

Returns: maximum message size in bits

Implements Botan::Public_Key.

Definition at line 29 of file dsa.h.

29{ return group_q().bits(); }

Botan::BigInt::bits

size_t bits() const

Definition bigint.cpp:254

References Botan::DL_Scheme_PublicKey::group_q().

◆ message_part_size()

size_t Botan::DSA_PublicKey::message_part_size ( ) const

inlinevirtualinherited

Find out the message part size supported by this scheme/key.

Returns: size of the message parts in bits

Reimplemented from Botan::Public_Key.

Definition at line 28 of file dsa.h.

28{ return group_q().bytes(); }

Botan::BigInt::bytes

size_t bytes() const

Definition bigint.cpp:246

References Botan::DL_Scheme_PublicKey::group_q().

◆ message_parts()

size_t Botan::DSA_PublicKey::message_parts ( ) const

inlinevirtualinherited

Find out the number of message parts supported by this scheme.

Returns: number of message parts

Reimplemented from Botan::Public_Key.

Definition at line 27 of file dsa.h.

27{ return 2; }

◆ pkcs8_algorithm_identifier()

virtual AlgorithmIdentifier Botan::Private_Key::pkcs8_algorithm_identifier ( ) const

inlinevirtualinherited

Returns: PKCS #8 AlgorithmIdentifier for this key Might be different from the X.509 identifier, but normally is not

Definition at line 98 of file pk_keys.h.

99 { return algorithm_identifier(); }

Botan::Public_Key::algorithm_identifier

virtual AlgorithmIdentifier algorithm_identifier() const =0

References Botan::Public_Key::algorithm_identifier().

Referenced by Botan::PKCS8::BER_encode().

◆ pkcs8_private_key()

MemoryVector< byte > Botan::DL_Scheme_PrivateKey::pkcs8_private_key ( ) const

virtualinherited

Returns: PKCS #8 private key encoding for this key object

Implements Botan::Private_Key.

Definition at line 36 of file dl_algo.cpp.

   {
   return DER_Encoder().encode(x).get_contents();
   }

References Botan::DER_Encoder::encode(), Botan::DER_Encoder::get_contents(), and x.

◆ x509_subject_public_key()

MemoryVector< byte > Botan::DL_Scheme_PublicKey::x509_subject_public_key ( ) const

virtualinherited

Returns: X.509 subject key encoding for this key object

Implements Botan::Public_Key.

Definition at line 21 of file dl_algo.cpp.

   {
   return DER_Encoder().encode(y).get_contents();
   }

References Botan::DER_Encoder::encode(), Botan::DER_Encoder::get_contents(), and y.

Member Data Documentation

◆ group

DL_Group Botan::DL_Scheme_PublicKey::group

protectedinherited

The DL group

Definition at line 79 of file dl_algo.h.

Referenced by algorithm_identifier(), Botan::DL_Scheme_PrivateKey::check_key(), check_key(), Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DH_PublicKey::DH_PublicKey(), Botan::DL_Scheme_PrivateKey::DL_Scheme_PrivateKey(), DL_Scheme_PublicKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::DSA_PublicKey::DSA_PublicKey(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), Botan::ElGamal_PublicKey::ElGamal_PublicKey(), get_domain(), group_g(), group_p(), group_q(), Botan::NR_PrivateKey::NR_PrivateKey(), and Botan::NR_PublicKey::NR_PublicKey().

◆ x

BigInt Botan::DL_Scheme_PrivateKey::x

protectedinherited

The DL private key

Definition at line 109 of file dl_algo.h.

Referenced by check_key(), Botan::DSA_PrivateKey::check_key(), Botan::NR_PrivateKey::check_key(), Botan::DH_PrivateKey::DH_PrivateKey(), Botan::DH_PrivateKey::DH_PrivateKey(), DL_Scheme_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::DSA_PrivateKey::DSA_PrivateKey(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), Botan::ElGamal_PrivateKey::ElGamal_PrivateKey(), get_x(), Botan::NR_PrivateKey::NR_PrivateKey(), Botan::NR_PrivateKey::NR_PrivateKey(), and pkcs8_private_key().

◆ y

BigInt Botan::DL_Scheme_PublicKey::y

protectedinherited

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

src/pubkey/dsa/dsa.h
src/pubkey/dsa/dsa.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ DSA_PrivateKey() [1/2]

◆ DSA_PrivateKey() [2/2]

Member Function Documentation

◆ algo_name()

◆ algorithm_identifier()

◆ check_key()

◆ gen_check()

◆ get_domain()

◆ get_oid()

◆ get_x()

◆ get_y()

◆ group_format()

◆ group_g()

◆ group_p()

◆ group_q()

◆ load_check() [1/2]

◆ load_check() [2/2]

◆ max_input_bits()

◆ message_part_size()

◆ message_parts()

◆ pkcs8_algorithm_identifier()

◆ pkcs8_private_key()

◆ x509_subject_public_key()

Member Data Documentation

◆ group

◆ x

◆ y