📄 class_p_k___signer.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"><title>Crypto++: PK_Signer Class Reference</title><link href="doxygen.css" rel="stylesheet" type="text/css"><link href="tabs.css" rel="stylesheet" type="text/css"></head><body><!-- Generated by Doxygen 1.5.2 --><div class="tabs"> <ul> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li class="current"><a href="classes.html"><span>Classes</span></a></li> <li><a href="files.html"><span>Files</span></a></li> </ul></div><div class="tabs"> <ul> <li><a href="classes.html"><span>Alphabetical List</span></a></li> <li><a href="annotated.html"><span>Class List</span></a></li> <li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul></div><h1>PK_Signer Class Reference</h1><!-- doxytag: class="PK_Signer" --><!-- doxytag: inherits="PK_SignatureScheme,PrivateKeyAlgorithm" --><code>#include <<a class="el" href="cryptlib_8h-source.html">cryptlib.h</a>></code><p><p>Inheritance diagram for PK_Signer:<p><center><img src="class_p_k___signer.png" usemap="#PK_Signer_map" border="0" alt=""></center><map name="PK_Signer_map"><area href="class_p_k___signature_scheme.html" alt="PK_SignatureScheme" shape="rect" coords="390,168,1161,192"><area href="class_private_key_algorithm.html" alt="PrivateKeyAlgorithm" shape="rect" coords="1171,168,1942,192"><area href="class_asymmetric_algorithm.html" alt="AsymmetricAlgorithm" shape="rect" coords="1171,112,1942,136"><area href="class_algorithm.html" alt="Algorithm" shape="rect" coords="1171,56,1942,80"><area href="class_clonable.html" alt="Clonable" shape="rect" coords="1171,0,1942,24"><area href="class_d_l___signature_scheme_base.html" alt="DL_SignatureSchemeBase< PK_Signer, DL_PrivateKey< SCHEME_OPTIONS::Element > >" shape="rect" coords="0,280,771,304"><area href="class_d_l___signature_scheme_base.html" alt="DL_SignatureSchemeBase< PK_Signer, DL_PrivateKey< T > >" shape="rect" coords="781,280,1552,304"><area href="class_t_f___signature_scheme_base.html" alt="TF_SignatureSchemeBase< PK_Signer, TF_Base< RandomizedTrapdoorFunctionInverse, PK_SignatureMessageEncodingMethod > >" shape="rect" coords="1562,280,2333,304"><area href="class_d_l___signer_base.html" alt="DL_SignerBase< SCHEME_OPTIONS::Element >" shape="rect" coords="0,336,771,360"><area href="class_d_l___signer_base.html" alt="DL_SignerBase< T >" shape="rect" coords="781,336,1552,360"><area href="class_t_f___signer_base.html" alt="TF_SignerBase" shape="rect" coords="1562,336,2333,360"><area href="class_algorithm_impl.html" alt="AlgorithmImpl< DL_SignerBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS::AlgorithmInfo >" shape="rect" coords="0,392,771,416"><area href="class_algorithm_impl.html" alt="AlgorithmImpl< TF_SignerBase, SCHEME_OPTIONS::AlgorithmInfo >" shape="rect" coords="1562,392,2333,416"><area href="class_d_l___object_impl_base.html" alt="DL_ObjectImplBase< DL_SignerBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey >" shape="rect" coords="0,448,771,472"><area href="class_t_f___object_impl_base.html" alt="TF_ObjectImplBase< TF_SignerBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey >" shape="rect" coords="1562,448,2333,472"><area href="class_d_l___object_impl.html" alt="DL_ObjectImpl< DL_SignerBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey >" shape="rect" coords="0,504,771,528"><area href="class_t_f___object_impl.html" alt="TF_ObjectImpl< TF_SignerBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PrivateKey >" shape="rect" coords="1562,504,2333,528"><area href="class_d_l___signer_impl.html" alt="DL_SignerImpl< SCHEME_OPTIONS >" shape="rect" coords="0,560,771,584"><area href="class_t_f___signer_impl.html" alt="TF_SignerImpl< SCHEME_OPTIONS >" shape="rect" coords="1562,560,2333,584"></map><a href="class_p_k___signer-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>interface for public-key signers <p><p>Definition at line <a class="el" href="cryptlib_8h-source.html#l01300">1300</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 class="anchor" name="ff85d006e814ccc8ac943b145a0bfaf9"></a><!-- doxytag: member="PK_Signer::NewSignatureAccumulator" ref="ff85d006e814ccc8ac943b145a0bfaf9" args="(RandomNumberGenerator &rng) const =0" -->virtual <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#ff85d006e814ccc8ac943b145a0bfaf9">NewSignatureAccumulator</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng) const =0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">create a new <a class="el" href="class_hash_transformation.html" title="interface for hash functions and data processing part of MACs">HashTransformation</a> to accumulate the message to be signed <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="9051dec5ad6586063f83d131edf86217"></a><!-- doxytag: member="PK_Signer::InputRecoverableMessage" ref="9051dec5ad6586063f83d131edf86217" args="(PK_MessageAccumulator &messageAccumulator, const byte *recoverableMessage, size_t recoverableMessageLength) const =0" -->virtual void </td><td class="memItemRight" valign="bottom"><b>InputRecoverableMessage</b> (<a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator, const byte *recoverableMessage, size_t recoverableMessageLength) const =0</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#28de428238711210d765b6389062e6e2">Sign</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> *messageAccumulator, byte *signature) const </td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">sign and delete messageAccumulator (even in case of exception thrown) <a href="#28de428238711210d765b6389062e6e2"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#fbcf3f00d761f681839ae6264743dd34">SignAndRestart</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator, byte *signature, bool restart=true) const =0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">sign and restart messageAccumulator <a href="#fbcf3f00d761f681839ae6264743dd34"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#6781cdd4a4a750a9720e268c90a24387">SignMessage</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, const byte *message, size_t messageLen, byte *signature) const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">sign a message <a href="#6781cdd4a4a750a9720e268c90a24387"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signer.html#76eb862d0cb8d80e0bee7ad52a0da707">SignMessageWithRecovery</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, const byte *recoverableMessage, size_t recoverableMessageLength, const byte *nonrecoverableMessage, size_t nonrecoverableMessageLength, byte *signature) const </td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">sign a recoverable message <a href="#76eb862d0cb8d80e0bee7ad52a0da707"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6e7deb95f656d3b3998b86ad971773f0"></a><!-- doxytag: member="PK_Signer::SignatureLength" ref="6e7deb95f656d3b3998b86ad971773f0" args="() const=0" -->virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#6e7deb95f656d3b3998b86ad971773f0">SignatureLength</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">signature length if it only depends on the key, otherwise 0 <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="665909c10f27db81343a01c814488652"></a><!-- doxytag: member="PK_Signer::MaxSignatureLength" ref="665909c10f27db81343a01c814488652" args="(size_t recoverablePartLength=0) const" -->virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#665909c10f27db81343a01c814488652">MaxSignatureLength</a> (size_t recoverablePartLength=0) const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">maximum signature length produced for a given length of recoverable message part <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="f8f3fd3692c258b72be3dad6da3423ec"></a><!-- doxytag: member="PK_Signer::MaxRecoverableLength" ref="f8f3fd3692c258b72be3dad6da3423ec" args="() const=0" -->virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#f8f3fd3692c258b72be3dad6da3423ec">MaxRecoverableLength</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">length of longest message that can be recovered, or 0 if this signature scheme does not support message recovery <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="2f2a599ba385e63766d4a7f7ccf2a884"></a><!-- doxytag: member="PK_Signer::MaxRecoverableLengthFromSignatureLength" ref="2f2a599ba385e63766d4a7f7ccf2a884" args="(size_t signatureLength) const =0" -->virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#2f2a599ba385e63766d4a7f7ccf2a884">MaxRecoverableLengthFromSignatureLength</a> (size_t signatureLength) const =0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">length of longest message that can be recovered from a signature of given length, or 0 if this signature scheme does not support message recovery <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_p_k___signature_scheme.html#95da484b356e57bac7548b1ea51f64cd">IsProbabilistic</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">requires a random number generator to sign <a href="#95da484b356e57bac7548b1ea51f64cd"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="56dba79cab3f05ad3757d8c66e989eec"></a><!-- doxytag: member="PK_Signer::AllowNonrecoverablePart" ref="56dba79cab3f05ad3757d8c66e989eec" args="() const=0" -->virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#56dba79cab3f05ad3757d8c66e989eec">AllowNonrecoverablePart</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">whether or not a non-recoverable message part can be signed <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8f62890f0485b9ca58528047871f8894"></a><!-- doxytag: member="PK_Signer::SignatureUpfront" ref="8f62890f0485b9ca58528047871f8894" args="() const" -->virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#8f62890f0485b9ca58528047871f8894">SignatureUpfront</a> () const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">if this function returns true, during verification you must input the signature before the message, otherwise you can input it at anytime */ <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8c951b8936376dc05e5e231998b32d31"></a><!-- doxytag: member="PK_Signer::RecoverablePartFirst" ref="8c951b8936376dc05e5e231998b32d31" args="() const=0" -->virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___signature_scheme.html#8c951b8936376dc05e5e231998b32d31">RecoverablePartFirst</a> () const=0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">whether you must input the recoverable part before the non-recoverable part during signing <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="48cf4528f16263f2200d5b908a0b8ffb"></a><!-- doxytag: member="PK_Signer::AccessMaterial" ref="48cf4528f16263f2200d5b908a0b8ffb" args="()" --><a class="el" href="class_crypto_material.html">CryptoMaterial</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_private_key_algorithm.html#48cf4528f16263f2200d5b908a0b8ffb">AccessMaterial</a> ()</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">returns a reference to the crypto material used by this object <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="59f3867165685cc6ac6be3f53d5f371b"></a><!-- doxytag: member="PK_Signer::GetMaterial" ref="59f3867165685cc6ac6be3f53d5f371b" args="() const" -->const <a class="el" href="class_crypto_material.html">CryptoMaterial</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_private_key_algorithm.html#59f3867165685cc6ac6be3f53d5f371b">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></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e2085815947c2ae7b3f9f614612e0c17"></a><!-- doxytag: member="PK_Signer::AccessPrivateKey" ref="e2085815947c2ae7b3f9f614612e0c17" args="()=0" -->virtual <a class="el" href="class_private_key.html">PrivateKey</a> & </td><td class="memItemRight" valign="bottom"><b>AccessPrivateKey</b> ()=0</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b36fe7af04ef624d38c0c06da5b89bb4"></a><!-- doxytag: member="PK_Signer::GetPrivateKey" ref="b36fe7af04ef624d38c0c06da5b89bb4" args="() const" -->virtual const <a class="el" href="class_private_key.html">PrivateKey</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_private_key_algorithm.html#b36fe7af04ef624d38c0c06da5b89bb4">GetPrivateKey</a> () const</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="522dbfcd5c1a46bf1be301cec26d6534"></a><!-- doxytag: member="PK_Signer::BERDecode" ref="522dbfcd5c1a46bf1be301cec26d6534" args="(BufferedTransformation &bt)" -->void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_asymmetric_algorithm.html#522dbfcd5c1a46bf1be301cec26d6534">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#d99d55413166b69a0a12e10d111926c8" title="returns a reference to the crypto material used by this object">AccessMaterial()</a>.Load(bt) <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="2d704079890783422b0a44653480ab83"></a><!-- doxytag: member="PK_Signer::DEREncode" ref="2d704079890783422b0a44653480ab83" args="(BufferedTransformation &bt) const " -->void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_asymmetric_algorithm.html#2d704079890783422b0a44653480ab83">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#eafe2b12d8353b6c639be41b57ef25de" title="returns a const reference to the crypto material used by this object">GetMaterial()</a>.Save(bt) <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="4f31510a192d1121856efe8ad0a9b844"></a><!-- doxytag: member="PK_Signer::AlgorithmName" ref="4f31510a192d1121856efe8ad0a9b844" args="() const" -->virtual std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="class_algorithm.html#4f31510a192d1121856efe8ad0a9b844">AlgorithmName</a> () const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">returns name of this algorithm, not universally implemented yet <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="d0016ba2d505c23aa85aad49e6c19bb7"></a><!-- doxytag: member="PK_Signer::Clone" ref="d0016ba2d505c23aa85aad49e6c19bb7" args="() const" -->virtual <a class="el" href="class_clonable.html">Clonable</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_clonable.html#d0016ba2d505c23aa85aad49e6c19bb7">Clone</a> () const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">this is not implemented by most classes yet <br></td></tr></table><hr><h2>Member Function Documentation</h2><a class="anchor" name="28de428238711210d765b6389062e6e2"></a><!-- doxytag: member="PK_Signer::Sign" ref="28de428238711210d765b6389062e6e2" args="(RandomNumberGenerator &rng, PK_MessageAccumulator *messageAccumulator, byte *signature) const " --><div class="memitem"><div class="memproto"> <table class="memname"> <tr> <td class="memname">size_t PK_Signer::Sign </td> <td>(</td> <td class="paramtype"><a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> & </td> <td class="paramname"> <em>rng</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"><a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> * </td> <td class="paramname"> <em>messageAccumulator</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">byte * </td> <td class="paramname"> <em>signature</em></td><td> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td><td width="100%"> const<code> [virtual]</code></td> </tr> </table></div><div class="memdoc"><p>sign and delete messageAccumulator (even in case of exception thrown) <p><dl class="pre" compact><dt><b>Precondition:</b></dt><dd>size of signature == <a class="el" href="class_p_k___signature_scheme.html#665909c10f27db81343a01c814488652" title="maximum signature length produced for a given length of recoverable message part">MaxSignatureLength()</a> </dd></dl><dl class="return" compact><dt><b>Returns:</b></dt><dd>actual signature length </dd></dl><p>Definition at line <a class="el" href="cryptlib_8cpp-source.html#l00649">649</a> of file <a class="el" href="cryptlib_8cpp-source.html">cryptlib.cpp</a>.<p>References <a class="el" href="class_p_k___signer.html#fbcf3f00d761f681839ae6264743dd34">SignAndRestart()</a>.<p>Referenced by <a class="el" href="filters_8cpp-source.html#l00802">SignerFilter::Put2()</a>.</div></div><p><a class="anchor" name="fbcf3f00d761f681839ae6264743dd34"></a><!-- doxytag: member="PK_Signer::SignAndRestart" ref="fbcf3f00d761f681839ae6264743dd34" args="(RandomNumberGenerator &rng, PK_MessageAccumulator &messageAccumulator, byte *signature, bool restart=true) const =0" --><div class="memitem"><div class="memproto"> <table class="memname">⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -