📄 class_authenticated_key_agreement_domain.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"><title>Crypto++: AuthenticatedKeyAgreementDomain class Reference</title><link href="doxygen.css" rel="stylesheet" type="text/css"></head><body><!-- Generated by Doxygen 1.3.2 --><div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="namespaces.html">Namespace List</a> | <a class="qindex" href="hierarchy.html">Class Hierarchy</a> | <a class="qindex" href="classes.html">Alphabetical List</a> | <a class="qindex" href="annotated.html">Compound List</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="namespacemembers.html">Namespace Members</a> | <a class="qindex" href="functions.html">Compound Members</a> | <a class="qindex" href="globals.html">File Members</a></div><h1>AuthenticatedKeyAgreementDomain Class Reference</h1><code>#include <<a class="el" href="cryptlib_8h-source.html">cryptlib.h</a>></code><p><p>Inheritance diagram for AuthenticatedKeyAgreementDomain:<p><center><img src="class_authenticated_key_agreement_domain.png" usemap="#AuthenticatedKeyAgreementDomain_map" border="0" alt=""></center><map name="AuthenticatedKeyAgreementDomain_map"><area href="class_key_agreement_algorithm.html" alt="KeyAgreementAlgorithm" shape="rect" coords="196,168,578,192"><area href="class_asymmetric_algorithm.html" alt="AsymmetricAlgorithm" shape="rect" coords="196,112,578,136"><area href="class_algorithm.html" alt="Algorithm" shape="rect" coords="196,56,578,80"><area href="class_clonable.html" alt="Clonable" shape="rect" coords="196,0,578,24"><area href="class_d_h2.html" alt="DH2" shape="rect" coords="0,280,382,304"><area href="class_m_q_v___domain.html" alt="MQV_Domain< GROUP_PARAMETERS, COFACTOR_OPTION >" shape="rect" coords="392,280,774,304"></map><a href="class_authenticated_key_agreement_domain-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>interface for domains of authenticated key agreement protocols <p>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. <p><p>Definition at line <a class="el" href="cryptlib_8h-source.html#l01407">1407</a> of file <a class="el" href="cryptlib_8h-source.html">cryptlib.h</a>.<table border=0 cellpadding=0 cellspacing=0><tr><td></td></tr><tr><td colspan=2><br><h2>Public Member Functions</h2></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_authenticated_key_agreement_domaina0" doxytag="AuthenticatedKeyAgreementDomain::AgreedValueLength"></a>virtual unsigned int </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina0">AgreedValueLength</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">return length of agreed value produced <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_authenticated_key_agreement_domaina1" doxytag="AuthenticatedKeyAgreementDomain::StaticPrivateKeyLength"></a>virtual unsigned int </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina1">StaticPrivateKeyLength</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">return length of static private keys in this domain <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_authenticated_key_agreement_domaina2" doxytag="AuthenticatedKeyAgreementDomain::StaticPublicKeyLength"></a>virtual unsigned int </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina2">StaticPublicKeyLength</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">return length of static public keys in this domain <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top>virtual void </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina3">GenerateStaticPrivateKey</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, byte *privateKey) const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">generate static private key </em> <a href="#_authenticated_key_agreement_domaina3"></a><em><br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top>virtual void </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina4">GenerateStaticPublicKey</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, const byte *privateKey, byte *publicKey) const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">generate static public key </em> <a href="#_authenticated_key_agreement_domaina4"></a><em><br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top>virtual void </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_m_q_v___domaina19">GenerateStaticKeyPair</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, byte *privateKey, byte *publicKey) const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">generate private/public key pair </em> <a href="#_m_q_v___domaina19"></a><em><br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_authenticated_key_agreement_domaina6" doxytag="AuthenticatedKeyAgreementDomain::EphemeralPrivateKeyLength"></a>virtual unsigned int </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina6">EphemeralPrivateKeyLength</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">return length of ephemeral private keys in this domain <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_authenticated_key_agreement_domaina7" doxytag="AuthenticatedKeyAgreementDomain::EphemeralPublicKeyLength"></a>virtual unsigned int </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina7">EphemeralPublicKeyLength</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">return length of ephemeral public keys in this domain <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top>virtual void </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina8">GenerateEphemeralPrivateKey</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, byte *privateKey) const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">generate ephemeral private key </em> <a href="#_authenticated_key_agreement_domaina8"></a><em><br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top>virtual void </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina9">GenerateEphemeralPublicKey</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, const byte *privateKey, byte *publicKey) const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">generate ephemeral public key </em> <a href="#_authenticated_key_agreement_domaina9"></a><em><br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top>virtual void </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_m_q_v___domaina20">GenerateEphemeralKeyPair</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, byte *privateKey, byte *publicKey) const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">generate private/public key pair </em> <a href="#_m_q_v___domaina20"></a><em><br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top>virtual bool </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_authenticated_key_agreement_domaina11">Agree</a> (byte *agreedValue, const byte *staticPrivateKey, const byte *ephemeralPrivateKey, const byte *staticOtherPublicKey, const byte *ephemeralOtherPublicKey, bool validateStaticOtherPublicKey=true) const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">derive agreed value from your private keys and couterparty's public keys, return false in case of failure </em> <a href="#_authenticated_key_agreement_domaina11"></a><em><br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_x_t_r___d_ha21" doxytag="AuthenticatedKeyAgreementDomain::AccessMaterial"></a><a class="el" href="class_crypto_material.html">CryptoMaterial</a> & </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_x_t_r___d_ha21">AccessMaterial</a> ()</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">returns a reference to the crypto material used by this object <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_x_t_r___d_ha22" doxytag="AuthenticatedKeyAgreementDomain::GetMaterial"></a>const <a class="el" href="class_crypto_material.html">CryptoMaterial</a> & </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_x_t_r___d_ha22">GetMaterial</a> () const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">returns a const reference to the crypto material used by this object <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_simple_key_agreement_domaina9" doxytag="AuthenticatedKeyAgreementDomain::AccessCryptoParameters"></a>virtual <a class="el" href="class_crypto_parameters.html">CryptoParameters</a> & </td><td class="memItemRight" valign=bottom><b>AccessCryptoParameters</b> ()=0</td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_x_t_r___d_ha23" doxytag="AuthenticatedKeyAgreementDomain::GetCryptoParameters"></a>virtual const <a class="el" href="class_crypto_parameters.html">CryptoParameters</a> & </td><td class="memItemRight" valign=bottom><b>GetCryptoParameters</b> () const</td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_x_t_r___d_ha24" doxytag="AuthenticatedKeyAgreementDomain::BERDecode"></a>void </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_x_t_r___d_ha24">BERDecode</a> (<a class="el" href="class_buffered_transformation.html">BufferedTransformation</a> &bt)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">for backwards compatibility, calls <a class="el" href="class_asymmetric_algorithm.html#_asymmetric_algorithma0">AccessMaterial()</a>.Load(bt) <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_verifier_with_recovery_templatea23" doxytag="AuthenticatedKeyAgreementDomain::DEREncode"></a>void </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_verifier_with_recovery_templatea23">DEREncode</a> (<a class="el" href="class_buffered_transformation.html">BufferedTransformation</a> &bt) const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">for backwards compatibility, calls <a class="el" href="class_asymmetric_algorithm.html#_asymmetric_algorithma1">GetMaterial()</a>.Save(bt) <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_zlib_decompressora17" doxytag="AuthenticatedKeyAgreementDomain::AlgorithmName"></a>virtual std::string </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_zlib_decompressora17">AlgorithmName</a> () const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">returns name of this algorithm, not universally implemented yet <br><br></td></tr><tr><td class="memItemLeft" nowrap align=right valign=top><a name="_zlib_decompressora18" doxytag="AuthenticatedKeyAgreementDomain::Clone"></a>virtual <a class="el" href="class_clonable.html">Clonable</a> * </td><td class="memItemRight" valign=bottom><a class="el" href="class_authenticated_key_agreement_domain.html#_zlib_decompressora18">Clone</a> () const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">this is not implemented by most classes yet <br><br></td></tr></table><hr><h2>Member Function Documentation</h2><a name="_authenticated_key_agreement_domaina3" doxytag="AuthenticatedKeyAgreementDomain::GenerateStaticPrivateKey"></a><p><table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> virtual void AuthenticatedKeyAgreementDomain::GenerateStaticPrivateKey </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> & </td> <td class="mdname" nowrap> <em>rng</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>byte * </td> <td class="mdname" nowrap> <em>privateKey</em></td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"> const<code> [pure virtual]</code></td> </tr> </table> </td> </tr></table><table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td><p>generate static private key <p><dl compact><dt><b>Precondition:</b></dt><dd>size of privateKey == PrivateStaticKeyLength() </dd></dl><p>Implemented in <a class="el" href="class_d_h2.html#_d_h2a5">DH2</a>, and <a class="el" href="class_m_q_v___domain.html#_m_q_v___domaina12">MQV_Domain< GROUP_PARAMETERS, COFACTOR_OPTION ></a>.<p>Referenced by <a class="el" href="cryptlib_8cpp-source.html#l00651">GenerateStaticKeyPair()</a>. </td> </tr></table><a name="_authenticated_key_agreement_domaina4" doxytag="AuthenticatedKeyAgreementDomain::GenerateStaticPublicKey"></a><p><table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> virtual void AuthenticatedKeyAgreementDomain::GenerateStaticPublicKey </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> & </td> <td class="mdname" nowrap> <em>rng</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const byte * </td> <td class="mdname" nowrap> <em>privateKey</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>byte * </td> <td class="mdname" nowrap> <em>publicKey</em></td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"> const<code> [pure virtual]</code></td> </tr> </table> </td> </tr></table><table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td><p>generate static public key <p><dl compact><dt><b>Precondition:</b></dt><dd>size of publicKey == PublicStaticKeyLength() </dd></dl><p>Implemented in <a class="el" href="class_d_h2.html#_d_h2a6">DH2</a>, and <a class="el" href="class_m_q_v___domain.html#_m_q_v___domaina13">MQV_Domain< GROUP_PARAMETERS, COFACTOR_OPTION ></a>.<p>Referenced by <a class="el" href="cryptlib_8cpp-source.html#l00651">GenerateStaticKeyPair()</a>. </td> </tr></table><a name="_m_q_v___domaina19" doxytag="AuthenticatedKeyAgreementDomain::GenerateStaticKeyPair"></a><p><table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void AuthenticatedKeyAgreementDomain::GenerateStaticKeyPair </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> & </td> <td class="mdname" nowrap> <em>rng</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>byte * </td> <td class="mdname" nowrap> <em>privateKey</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>byte * </td> <td class="mdname" nowrap> <em>publicKey</em></td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"> const<code> [virtual]</code></td> </tr> </table> </td> </tr></table><table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td><p>generate private/public key pair <p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -