interface for domains of authenticated key agreement protocols More...
#include <cryptlib.h>
Public Member Functions | |
virtual unsigned int | AgreedValueLength () const =0 |
return length of agreed value produced | |
virtual unsigned int | StaticPrivateKeyLength () const =0 |
return length of static private keys in this domain | |
virtual unsigned int | StaticPublicKeyLength () const =0 |
return length of static public keys in this domain | |
virtual void | GenerateStaticPrivateKey (RandomNumberGenerator &rng, byte *privateKey) const =0 |
generate static private key | |
virtual void | GenerateStaticPublicKey (RandomNumberGenerator &rng, const byte *privateKey, byte *publicKey) const =0 |
generate static public key | |
virtual void | GenerateStaticKeyPair (RandomNumberGenerator &rng, byte *privateKey, byte *publicKey) const |
generate private/public key pair | |
virtual unsigned int | EphemeralPrivateKeyLength () const =0 |
return length of ephemeral private keys in this domain | |
virtual unsigned int | EphemeralPublicKeyLength () const =0 |
return length of ephemeral public keys in this domain | |
virtual void | GenerateEphemeralPrivateKey (RandomNumberGenerator &rng, byte *privateKey) const =0 |
generate ephemeral private key | |
virtual void | GenerateEphemeralPublicKey (RandomNumberGenerator &rng, const byte *privateKey, byte *publicKey) const =0 |
generate ephemeral public key | |
virtual void | GenerateEphemeralKeyPair (RandomNumberGenerator &rng, byte *privateKey, byte *publicKey) const |
generate private/public key pair | |
virtual bool | Agree (byte *agreedValue, const byte *staticPrivateKey, const byte *ephemeralPrivateKey, const byte *staticOtherPublicKey, const byte *ephemeralOtherPublicKey, bool validateStaticOtherPublicKey=true) const =0 |
derive agreed value from your private keys and couterparty's public keys, return false in case of failure | |
CryptoMaterial & | AccessMaterial () |
returns a reference to the crypto material used by this object | |
const CryptoMaterial & | GetMaterial () const |
returns a const reference to the crypto material used by this object | |
virtual CryptoParameters & | AccessCryptoParameters ()=0 |
virtual const CryptoParameters & | GetCryptoParameters () const |
void | BERDecode (BufferedTransformation &bt) |
for backwards compatibility, calls AccessMaterial().Load(bt) | |
void | DEREncode (BufferedTransformation &bt) const |
for backwards compatibility, calls GetMaterial().Save(bt) | |
virtual std::string | AlgorithmName () const |
returns name of this algorithm, not universally implemented yet | |
virtual Clonable * | Clone () const |
this is not implemented by most classes yet |
interface for domains of authenticated key agreement protocols
In an authenticated key agreement protocol, each party has two key pairs. The long-lived key pair is called the static key pair, and the short-lived key pair is called the ephemeral key pair.
Definition at line 1469 of file cryptlib.h.
virtual void AuthenticatedKeyAgreementDomain::GenerateStaticPrivateKey | ( | RandomNumberGenerator & | rng, | |
byte * | privateKey | |||
) | const [pure virtual] |
generate static private key
Implemented in DH2, and MQV_Domain< GROUP_PARAMETERS, COFACTOR_OPTION >.
Referenced by GenerateStaticKeyPair().
virtual void AuthenticatedKeyAgreementDomain::GenerateStaticPublicKey | ( | RandomNumberGenerator & | rng, | |
const byte * | privateKey, | |||
byte * | publicKey | |||
) | const [pure virtual] |
generate static public key
Implemented in DH2, and MQV_Domain< GROUP_PARAMETERS, COFACTOR_OPTION >.
Referenced by GenerateStaticKeyPair().
void AuthenticatedKeyAgreementDomain::GenerateStaticKeyPair | ( | RandomNumberGenerator & | rng, | |
byte * | privateKey, | |||
byte * | publicKey | |||
) | const [virtual] |
generate private/public key pair
Reimplemented in DH2.
Definition at line 814 of file cryptlib.cpp.
References GenerateStaticPrivateKey(), and GenerateStaticPublicKey().
virtual void AuthenticatedKeyAgreementDomain::GenerateEphemeralPrivateKey | ( | RandomNumberGenerator & | rng, | |
byte * | privateKey | |||
) | const [pure virtual] |
generate ephemeral private key
Implemented in DH2, and MQV_Domain< GROUP_PARAMETERS, COFACTOR_OPTION >.
Referenced by GenerateEphemeralKeyPair().
virtual void AuthenticatedKeyAgreementDomain::GenerateEphemeralPublicKey | ( | RandomNumberGenerator & | rng, | |
const byte * | privateKey, | |||
byte * | publicKey | |||
) | const [pure virtual] |
generate ephemeral public key
Implemented in DH2, and MQV_Domain< GROUP_PARAMETERS, COFACTOR_OPTION >.
Referenced by GenerateEphemeralKeyPair().
void AuthenticatedKeyAgreementDomain::GenerateEphemeralKeyPair | ( | RandomNumberGenerator & | rng, | |
byte * | privateKey, | |||
byte * | publicKey | |||
) | const [virtual] |
generate private/public key pair
Reimplemented in DH2.
Definition at line 820 of file cryptlib.cpp.
References GenerateEphemeralPrivateKey(), and GenerateEphemeralPublicKey().
virtual bool AuthenticatedKeyAgreementDomain::Agree | ( | byte * | agreedValue, | |
const byte * | staticPrivateKey, | |||
const byte * | ephemeralPrivateKey, | |||
const byte * | staticOtherPublicKey, | |||
const byte * | ephemeralOtherPublicKey, | |||
bool | validateStaticOtherPublicKey = true | |||
) | const [pure virtual] |
derive agreed value from your private keys and couterparty's public keys, return false in case of failure
Implemented in DH2, and MQV_Domain< GROUP_PARAMETERS, COFACTOR_OPTION >.