📄 class_p_k___verifier.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_Verifier 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_Verifier Class Reference</h1><!-- doxytag: class="PK_Verifier" --><!-- doxytag: inherits="PK_SignatureScheme,PublicKeyAlgorithm" --><code>#include <<a class="el" href="cryptlib_8h-source.html">cryptlib.h</a>></code><p><p>Inheritance diagram for PK_Verifier:<p><center><img src="class_p_k___verifier.png" usemap="#PK_Verifier_map" border="0" alt=""></center><map name="PK_Verifier_map"><area href="class_p_k___signature_scheme.html" alt="PK_SignatureScheme" shape="rect" coords="375,168,1115,192"><area href="class_public_key_algorithm.html" alt="PublicKeyAlgorithm" shape="rect" coords="1125,168,1865,192"><area href="class_asymmetric_algorithm.html" alt="AsymmetricAlgorithm" shape="rect" coords="1125,112,1865,136"><area href="class_algorithm.html" alt="Algorithm" shape="rect" coords="1125,56,1865,80"><area href="class_clonable.html" alt="Clonable" shape="rect" coords="1125,0,1865,24"><area href="class_d_l___signature_scheme_base.html" alt="DL_SignatureSchemeBase< PK_Verifier, DL_PublicKey< SCHEME_OPTIONS::Element > >" shape="rect" coords="0,280,740,304"><area href="class_d_l___signature_scheme_base.html" alt="DL_SignatureSchemeBase< PK_Verifier, DL_PublicKey< T > >" shape="rect" coords="750,280,1490,304"><area href="class_t_f___signature_scheme_base.html" alt="TF_SignatureSchemeBase< PK_Verifier, TF_Base< TrapdoorFunction, PK_SignatureMessageEncodingMethod > >" shape="rect" coords="1500,280,2240,304"><area href="class_d_l___verifier_base.html" alt="DL_VerifierBase< SCHEME_OPTIONS::Element >" shape="rect" coords="0,336,740,360"><area href="class_d_l___verifier_base.html" alt="DL_VerifierBase< T >" shape="rect" coords="750,336,1490,360"><area href="class_t_f___verifier_base.html" alt="TF_VerifierBase" shape="rect" coords="1500,336,2240,360"><area href="class_algorithm_impl.html" alt="AlgorithmImpl< DL_VerifierBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS::AlgorithmInfo >" shape="rect" coords="0,392,740,416"><area href="class_algorithm_impl.html" alt="AlgorithmImpl< TF_VerifierBase, SCHEME_OPTIONS::AlgorithmInfo >" shape="rect" coords="1500,392,2240,416"><area href="class_d_l___object_impl_base.html" alt="DL_ObjectImplBase< DL_VerifierBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS, SCHEME_OPTIONS::PublicKey >" shape="rect" coords="0,448,740,472"><area href="class_t_f___object_impl_base.html" alt="TF_ObjectImplBase< TF_VerifierBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PublicKey >" shape="rect" coords="1500,448,2240,472"><area href="class_d_l___object_impl.html" alt="DL_ObjectImpl< DL_VerifierBase< SCHEME_OPTIONS::Element >, SCHEME_OPTIONS, SCHEME_OPTIONS::PublicKey >" shape="rect" coords="0,504,740,528"><area href="class_t_f___object_impl.html" alt="TF_ObjectImpl< TF_VerifierBase, SCHEME_OPTIONS, SCHEME_OPTIONS::PublicKey >" shape="rect" coords="1500,504,2240,528"><area href="class_d_l___verifier_impl.html" alt="DL_VerifierImpl< SCHEME_OPTIONS >" shape="rect" coords="0,560,740,584"><area href="class_t_f___verifier_impl.html" alt="TF_VerifierImpl< SCHEME_OPTIONS >" shape="rect" coords="1500,560,2240,584"></map><a href="class_p_k___verifier-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>interface for public-key signature verifiers <p>The Recover* functions throw <a class="el" href="class_not_implemented.html" title="exception thrown by a class if a non-implemented method is called">NotImplemented</a> if the signature scheme does not support message recovery. The Verify* functions throw <a class="el" href="class_invalid_data_format.html" title="exception thrown when input data is received that doesn't conform to expected format...">InvalidDataFormat</a> if the scheme does support message recovery and the signature contains a non-empty recoverable message part. The Recovery* functions should be used in that case. <p><p>Definition at line <a class="el" href="cryptlib_8h-source.html#l01341">1341</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="24203e25fdd33fa7cf3c4a2393444a78"></a><!-- doxytag: member="PK_Verifier::NewVerificationAccumulator" ref="24203e25fdd33fa7cf3c4a2393444a78" args="() 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___verifier.html#24203e25fdd33fa7cf3c4a2393444a78">NewVerificationAccumulator</a> () 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 verified <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="515aa448e7fc3a5c6e422e65500ab507"></a><!-- doxytag: member="PK_Verifier::InputSignature" ref="515aa448e7fc3a5c6e422e65500ab507" args="(PK_MessageAccumulator &messageAccumulator, const byte *signature, size_t signatureLength) const =0" -->virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#515aa448e7fc3a5c6e422e65500ab507">InputSignature</a> (<a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator, const byte *signature, size_t signatureLength) const =0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">input signature into a message accumulator <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="002461c71eaacb022a0d169975a6f752"></a><!-- doxytag: member="PK_Verifier::Verify" ref="002461c71eaacb022a0d169975a6f752" args="(PK_MessageAccumulator *messageAccumulator) const " -->virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#002461c71eaacb022a0d169975a6f752">Verify</a> (<a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> *messageAccumulator) const </td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">check whether messageAccumulator contains a valid signature and message, and delete messageAccumulator (even in case of exception thrown) <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="36e176dc8a0d3f924938cb2b07021f28"></a><!-- doxytag: member="PK_Verifier::VerifyAndRestart" ref="36e176dc8a0d3f924938cb2b07021f28" args="(PK_MessageAccumulator &messageAccumulator) const =0" -->virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#36e176dc8a0d3f924938cb2b07021f28">VerifyAndRestart</a> (<a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator) const =0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">check whether messageAccumulator contains a valid signature and message, and restart messageAccumulator <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="4640a967fd291f8be86c1b721dc73b2d"></a><!-- doxytag: member="PK_Verifier::VerifyMessage" ref="4640a967fd291f8be86c1b721dc73b2d" args="(const byte *message, size_t messageLen, const byte *signature, size_t signatureLength) const " -->virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#4640a967fd291f8be86c1b721dc73b2d">VerifyMessage</a> (const byte *message, size_t messageLen, const byte *signature, size_t signatureLength) const </td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">check whether input signature is a valid signature for input message <br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="struct_decoding_result.html">DecodingResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#25a928c76d7bc73e1a04d85266b46382">Recover</a> (byte *recoveredMessage, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> *messageAccumulator) const </td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">recover a message from its signature <a href="#25a928c76d7bc73e1a04d85266b46382"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="struct_decoding_result.html">DecodingResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#6612ff44a274594890419ae75d260cce">RecoverAndRestart</a> (byte *recoveredMessage, <a class="el" href="class_p_k___message_accumulator.html">PK_MessageAccumulator</a> &messageAccumulator) const =0</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">recover a message from its signature <a href="#6612ff44a274594890419ae75d260cce"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="struct_decoding_result.html">DecodingResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_p_k___verifier.html#05d969651d86a63d5002057113e0cab7">RecoverMessage</a> (byte *recoveredMessage, const byte *nonrecoverableMessage, size_t nonrecoverableMessageLength, const byte *signature, size_t signatureLength) const</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">recover a message from its signature <a href="#05d969651d86a63d5002057113e0cab7"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="6e7deb95f656d3b3998b86ad971773f0"></a><!-- doxytag: member="PK_Verifier::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_Verifier::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_Verifier::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_Verifier::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_Verifier::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_Verifier::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_Verifier::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="74b77db3086e07caf5506fda9ec204e7"></a><!-- doxytag: member="PK_Verifier::AccessMaterial" ref="74b77db3086e07caf5506fda9ec204e7" args="()" --><a class="el" href="class_crypto_material.html">CryptoMaterial</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_public_key_algorithm.html#74b77db3086e07caf5506fda9ec204e7">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="8c2bb02751348ff151ad9d4756cafd74"></a><!-- doxytag: member="PK_Verifier::GetMaterial" ref="8c2bb02751348ff151ad9d4756cafd74" args="() const" -->const <a class="el" href="class_crypto_material.html">CryptoMaterial</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_public_key_algorithm.html#8c2bb02751348ff151ad9d4756cafd74">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="47cd0fed475280962ab6337c6c57c882"></a><!-- doxytag: member="PK_Verifier::AccessPublicKey" ref="47cd0fed475280962ab6337c6c57c882" args="()=0" -->virtual <a class="el" href="class_public_key.html">PublicKey</a> & </td><td class="memItemRight" valign="bottom"><b>AccessPublicKey</b> ()=0</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="49b6c27bffc8cc588e0db37071fde9f5"></a><!-- doxytag: member="PK_Verifier::GetPublicKey" ref="49b6c27bffc8cc588e0db37071fde9f5" args="() const" -->virtual const <a class="el" href="class_public_key.html">PublicKey</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_public_key_algorithm.html#49b6c27bffc8cc588e0db37071fde9f5">GetPublicKey</a> () const</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="522dbfcd5c1a46bf1be301cec26d6534"></a><!-- doxytag: member="PK_Verifier::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_Verifier::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_Verifier::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_Verifier::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="25a928c76d7bc73e1a04d85266b46382"></a><!-- doxytag: member="PK_Verifier::Recover" ref="25a928c76d7bc73e1a04d85266b46382" args="(byte *recoveredMessage, PK_MessageAccumulator *messageAccumulator) const " --><div class="memitem"><div class="memproto"> <table class="memname">⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -