esign.h
Go to the documentation of this file.
#ifndef CRYPTOPP_ESIGN_H
#define CRYPTOPP_ESIGN_H
/** \file
This file contains classes that implement the
ESIGN signature schemes as defined in IEEE P1363a.
*/
#include "pubkey.h"
#include "integer.h"
#include "asn.h"
NAMESPACE_BEGIN(CryptoPP)
//! _
class ESIGNFunction : public TrapdoorFunction, public ASN1CryptoMaterial<PublicKey>
{
typedef ESIGNFunction ThisClass;
public:
void Initialize(const Integer &n, const Integer &e)
{m_n = n; m_e = e;}
// PublicKey
void BERDecode(BufferedTransformation &bt);
void DEREncode(BufferedTransformation &bt) const;
// CryptoMaterial
bool Validate(RandomNumberGenerator &rng, unsigned int level) const;
bool GetVoidValue(const char *name, const std::type_info &valueType, void *pValue) const;
void AssignFrom(const NameValuePairs &source);
// TrapdoorFunction
Integer ApplyFunction(const Integer &x) const;
Integer PreimageBound() const {return m_n;}
Integer ImageBound() const {return Integer::Power2(GetK());}
// non-derived
const Integer & GetModulus() const {return m_n;}
const Integer & GetPublicExponent() const {return m_e;}
void SetModulus(const Integer &n) {m_n = n;}
void SetPublicExponent(const Integer &e) {m_e = e;}
protected:
unsigned int GetK() const {return m_n.BitCount()/3-1;}
Integer m_n, m_e;
};
//! _
class InvertibleESIGNFunction : public ESIGNFunction, public RandomizedTrapdoorFunctionInverse, public PrivateKey
{
typedef InvertibleESIGNFunction ThisClass;
public:
void Initialize(const Integer &n, const Integer &e, const Integer &p, const Integer &q)
{m_n = n; m_e = e; m_p = p; m_q = q;}
// generate a random private key
void Initialize(RandomNumberGenerator &rng, unsigned int modulusBits)
{GenerateRandomWithKeySize(rng, modulusBits);}
void BERDecode(BufferedTransformation &bt);
void DEREncode(BufferedTransformation &bt) const;
Integer CalculateRandomizedInverse(RandomNumberGenerator &rng, const Integer &x) const;
// GeneratibleCryptoMaterial
bool Validate(RandomNumberGenerator &rng, unsigned int level) const;
bool GetVoidValue(const char *name, const std::type_info &valueType, void *pValue) const;
void AssignFrom(const NameValuePairs &source);
/*! parameters: (ModulusSize) */
void GenerateRandom(RandomNumberGenerator &rng, const NameValuePairs &alg);
const Integer& GetPrime1() const {return m_p;}
const Integer& GetPrime2() const {return m_q;}
void SetPrime1(const Integer &p) {m_p = p;}
void SetPrime2(const Integer &q) {m_q = q;}
protected:
Integer m_p, m_q;
};
//! _
template <class T>
class EMSA5Pad : public PK_DeterministicSignatureMessageEncodingMethod
{
public:
static const char *StaticAlgorithmName() {return "EMSA5";}
void ComputeMessageRepresentative(RandomNumberGenerator &rng,
const byte *recoverableMessage, size_t recoverableMessageLength,
HashTransformation &hash, HashIdentifier hashIdentifier, bool messageEmpty,
byte *representative, size_t representativeBitLength) const
{
SecByteBlock digest(hash.DigestSize());
hash.Final(digest);
size_t representativeByteLength = BitsToBytes(representativeBitLength);
T mgf;
mgf.GenerateAndMask(hash, representative, representativeByteLength, digest, digest.size(), false);
if (representativeBitLength % 8 != 0)
representative[0] = (byte)Crop(representative[0], representativeBitLength % 8);
}
};
//! EMSA5, for use with ESIGN
struct P1363_EMSA5 : public SignatureStandard
{
typedef EMSA5Pad<P1363_MGF1> SignatureMessageEncodingMethod;
};
struct ESIGN_Keys
{
static std::string StaticAlgorithmName() {return "ESIGN";}
typedef ESIGNFunction PublicKey;
typedef InvertibleESIGNFunction PrivateKey;
};
//! ESIGN, as defined in IEEE P1363a
template <class H, class STANDARD = P1363_EMSA5>
struct ESIGN : public TF_SS<STANDARD, H, ESIGN_Keys>
{
};
NAMESPACE_END
#endif
pubkey.h
This file contains helper classes/functions for implementing public key algorithms.
ESIGN
ESIGN, as defined in IEEE P1363a.
Definition: esign.h:122
SecBlock< byte >
InvertibleESIGNFunction::DEREncode
void DEREncode(BufferedTransformation &bt) const
encode this object into a BufferedTransformation, using DER (Distinguished Encoding Rules) ...
RandomNumberGenerator
interface for random number generators
Definition: cryptlib.h:668
InvertibleESIGNFunction::Validate
bool Validate(RandomNumberGenerator &rng, unsigned int level) const
check this object for errors
BufferedTransformation
interface for buffered transformations
Definition: cryptlib.h:770
PrivateKey
interface for private keys
Definition: cryptlib.h:1121
SignatureStandard
Base class for public key signature standard classes. These classes are used to select from variants ...
Definition: pubkey.h:1600
Integer::BitCount
unsigned int BitCount() const
number of significant bits = floor(log2(abs(*this))) + 1
InvertibleESIGNFunction::BERDecode
void BERDecode(BufferedTransformation &bt)
decode this object from a BufferedTransformation, using BER (Basic Encoding Rules) ...
EMSA5Pad
_
Definition: esign.h:87
PK_DeterministicSignatureMessageEncodingMethod
Definition: pubkey.h:249
InvertibleESIGNFunction::AssignFrom
void AssignFrom(const NameValuePairs &source)
assign values from source to this object
InvertibleESIGNFunction
_
Definition: esign.h:52
Integer
multiple precision integer and basic arithmetics
Definition: integer.h:26
TrapdoorFunction
_
Definition: pubkey.h:68
P1363_EMSA5
EMSA5, for use with ESIGN.
Definition: esign.h:108
Integer::Power2
static Integer Power2(size_t e)
return the integer 2**e
InvertibleESIGNFunction::GetVoidValue
bool GetVoidValue(const char *name, const std::type_info &valueType, void *pValue) const
to be implemented by derived classes, users should use one of the above functions instead ...
HashTransformation::DigestSize
virtual unsigned int DigestSize() const =0
size of the hash/digest/MAC returned by Final()
ESIGN_Keys
Definition: esign.h:113
ESIGNFunction
_
Definition: esign.h:16
HashTransformation
interface for hash functions and data processing part of MACs
Definition: cryptlib.h:530
GeneratableCryptoMaterial::GenerateRandomWithKeySize
void GenerateRandomWithKeySize(RandomNumberGenerator &rng, unsigned int keySize)
calls the above function with a NameValuePairs object that just specifies "KeySize" ...
integer.h
PublicKey
interface for public keys
Definition: cryptlib.h:1115
RandomizedTrapdoorFunctionInverse
_
Definition: pubkey.h:79
InvertibleESIGNFunction::GenerateRandom
void GenerateRandom(RandomNumberGenerator &rng, const NameValuePairs &alg)
HashTransformation::Final
virtual void Final(byte *digest)
compute hash for current message, then restart for a new message
Definition: cryptlib.h:544
ASN1CryptoMaterial
_
Definition: asn.h:235
NameValuePairs
interface for retrieving values given their names
Definition: cryptlib.h:224
TF_SS
Trapdoor Function Based Signature Scheme.
Definition: pubkey.h:1625