Security Scol plugin
|
Integer-based GroupParameters specialization. More...
#include <gfpcrypt.h>
Public Member Functions | |
void | Initialize (const DL_GroupParameters_IntegerBased ¶ms) |
Initialize a group parameters over integers. | |
void | Initialize (RandomNumberGenerator &rng, unsigned int pbits) |
Create a group parameters over integers. | |
void | Initialize (const Integer &p, const Integer &g) |
Initialize a group parameters over integers. | |
void | Initialize (const Integer &p, const Integer &q, const Integer &g) |
Initialize a group parameters over integers. | |
void | BERDecode (BufferedTransformation &bt) |
Decode this object from a BufferedTransformation. | |
void | DEREncode (BufferedTransformation &bt) const |
Encode this object into a BufferedTransformation. | |
void | GenerateRandom (RandomNumberGenerator &rng, const NameValuePairs &alg) |
Generate a random key. | |
bool | GetVoidValue (const char *name, const std::type_info &valueType, void *pValue) const |
Get a named value. | |
void | AssignFrom (const NameValuePairs &source) |
Initialize or reinitialize this key. | |
const Integer & | GetSubgroupOrder () const |
Retrieves the subgroup order. | |
Integer | GetGroupOrder () const |
Retrieves the order of the group. | |
bool | ValidateGroup (RandomNumberGenerator &rng, unsigned int level) const |
Check the group for errors. | |
bool | ValidateElement (unsigned int level, const Integer &element, const DL_FixedBasePrecomputation< Integer > *precomp) const |
Check the element for errors. | |
bool | FastSubgroupCheckAvailable () const |
Determine if subgroup membership check is fast. | |
void | EncodeElement (bool reversible, const Element &element, byte *encoded) const |
Encodes the element. | |
unsigned int | GetEncodedElementSize (bool reversible) const |
Retrieve the encoded element's size. | |
Integer | DecodeElement (const byte *encoded, bool checkForGroupMembership) const |
Decodes the element. | |
Integer | ConvertElementToInteger (const Element &element) const |
Converts an element to an Integer. | |
Integer | GetMaxExponent () const |
Retrieve the maximum exponent for the group. | |
OID | GetAlgorithmID () const |
Retrieve the OID of the algorithm. | |
virtual const Integer & | GetModulus () const =0 |
Retrieve the modulus for the group. | |
virtual void | SetModulusAndSubgroupGenerator (const Integer &p, const Integer &g)=0 |
Set group parameters. | |
void | SetSubgroupOrder (const Integer &q) |
Set subgroup order. | |
Public Member Functions inherited from ASN1CryptoMaterial< DL_GroupParameters< Integer > > | |
void | Save (BufferedTransformation &bt) const |
DER encode ASN.1 object. | |
void | Load (BufferedTransformation &bt) |
BER decode ASN.1 object. | |
Public Member Functions inherited from ASN1Object | |
virtual void | BEREncode (BufferedTransformation &bt) const |
Encode this object into a BufferedTransformation. | |
Public Member Functions inherited from DL_GroupParameters< Integer > | |
bool | Validate (RandomNumberGenerator &rng, unsigned int level) const |
Check this object for errors. | |
bool | SupportsPrecomputation () const |
Determines whether the object supports precomputation. | |
void | Precompute (unsigned int precomputationStorage=16) |
Perform precomputation. | |
void | LoadPrecomputation (BufferedTransformation &storedPrecomputation) |
Retrieve previously saved precomputation. | |
void | SavePrecomputation (BufferedTransformation &storedPrecomputation) const |
Save precomputation for later use. | |
virtual const Element & | GetSubgroupGenerator () const |
Retrieves the subgroup generator. | |
virtual void | SetSubgroupGenerator (const Element &base) |
Sets the subgroup generator. | |
virtual Element | ExponentiateBase (const Integer &exponent) const |
Exponentiates the base. | |
virtual Element | ExponentiateElement (const Element &base, const Integer &exponent) const |
Exponentiates an element. | |
virtual const DL_GroupPrecomputation< Element > & | GetGroupPrecomputation () const=0 |
Retrieves the group precomputation. | |
virtual const DL_FixedBasePrecomputation< Element > & | GetBasePrecomputation () const=0 |
Retrieves the group precomputation. | |
virtual DL_FixedBasePrecomputation< Element > & | AccessBasePrecomputation ()=0 |
Retrieves the group precomputation. | |
virtual Integer | GetCofactor () const |
Retrieves the cofactor. | |
virtual bool | IsIdentity (const Element &element) const=0 |
Determines if an element is an identity. | |
virtual void | SimultaneousExponentiate (Element *results, const Element &base, const Integer *exponents, unsigned int exponentsCount) const=0 |
Exponentiates a base to multiple exponents. | |
Public Member Functions inherited from GeneratableCryptoMaterial | |
void | GenerateRandomWithKeySize (RandomNumberGenerator &rng, unsigned int keySize) |
Generate a random key or crypto parameters. | |
Public Member Functions inherited from CryptoMaterial | |
virtual void | ThrowIfInvalid (RandomNumberGenerator &rng, unsigned int level) const |
Check this object for errors. | |
void | DoQuickSanityCheck () const |
Perform a quick sanity check. | |
Public Member Functions inherited from NameValuePairs | |
template<class T > | |
bool | GetThisObject (T &object) const |
Get a copy of this object or subobject. | |
template<class T > | |
bool | GetThisPointer (T *&ptr) const |
Get a pointer to this object. | |
template<class T > | |
bool | GetValue (const char *name, T &value) const |
Get a named value. | |
template<class T > | |
T | GetValueWithDefault (const char *name, T defaultValue) const |
Get a named value. | |
CRYPTOPP_DLL std::string | GetValueNames () const |
Get a list of value names that can be retrieved. | |
CRYPTOPP_DLL bool | GetIntValue (const char *name, int &value) const |
Get a named value with type int. | |
CRYPTOPP_DLL int | GetIntValueWithDefault (const char *name, int defaultValue) const |
Get a named value with type int, with default. | |
CRYPTOPP_DLL bool | GetWord64Value (const char *name, word64 &value) const |
Get a named value with type word64. | |
CRYPTOPP_DLL word64 | GetWord64ValueWithDefault (const char *name, word64 defaultValue) const |
Get a named value with type word64, with default. | |
template<class T > | |
void | GetRequiredParameter (const char *className, const char *name, T &value) const |
Retrieves a required name/value pair. | |
CRYPTOPP_DLL void | GetRequiredIntParameter (const char *className, const char *name, int &value) const |
Retrieves a required name/value pair. | |
Static Public Member Functions | |
static std::string CRYPTOPP_API | StaticAlgorithmNamePrefix () |
Static Public Member Functions inherited from NameValuePairs | |
static CRYPTOPP_DLL void CRYPTOPP_API | ThrowIfTypeMismatch (const char *name, const std::type_info &stored, const std::type_info &retrieving) |
Ensures an expected name and type is present. | |
Protected Member Functions | |
Integer | ComputeGroupOrder (const Integer &modulus) const |
virtual int | GetFieldType () const =0 |
virtual unsigned int | GetDefaultSubgroupOrderSize (unsigned int modulusSize) const |
Protected Member Functions inherited from DL_GroupParameters< Integer > | |
void | ParametersChanged () |
Additional Inherited Members | |
Public Types inherited from DL_GroupParameters< Integer > | |
typedef Integer | Element |
Integer-based GroupParameters specialization.
Definition at line 34 of file gfpcrypt.h.
|
inlinevirtual |
Definition at line 39 of file gfpcrypt.h.
|
virtual |
Initialize or reinitialize this key.
source | NameValuePairs to assign |
Implements CryptoMaterial.
Definition at line 292 of file gfpcrypt.cpp.
|
virtual |
Decode this object from a BufferedTransformation.
bt | BufferedTransformation object |
Uses Basic Encoding Rules (BER)
Implements ASN1Object.
Definition at line 258 of file gfpcrypt.cpp.
|
inlineprotected |
Definition at line 167 of file gfpcrypt.h.
|
inlinevirtual |
Converts an element to an Integer.
element | the element to convert to an Integer |
ConvertElementToInteger() must be implemented in a derived class.
Implements DL_GroupParameters< Integer >.
Definition at line 139 of file gfpcrypt.h.
|
virtual |
Decodes the element.
encoded | byte array with the encoded element |
checkForGroupMembership | flag indicating if the element should be validated |
DecodeElement() must be implemented in a derived class.
COUNTOF(encoded) == GetEncodedElementSize()
Implements DL_GroupParameters< Integer >.
Definition at line 249 of file gfpcrypt.cpp.
|
virtual |
Encode this object into a BufferedTransformation.
bt | BufferedTransformation object |
Uses Distinguished Encoding Rules (DER)
Implements ASN1Object.
Definition at line 277 of file gfpcrypt.cpp.
|
virtual |
Encodes the element.
reversible | flag indicating the encoding format |
element | reference to the element to encode |
encoded | destination byte array for the encoded element |
EncodeElement() must be implemented in a derived class.
COUNTOF(encoded) == GetEncodedElementSize()
Implements DL_GroupParameters< Integer >.
Definition at line 237 of file gfpcrypt.cpp.
|
inlinevirtual |
Determine if subgroup membership check is fast.
Implements DL_GroupParameters< Integer >.
Definition at line 105 of file gfpcrypt.h.
|
virtual |
Generate a random key.
rng | a RandomNumberGenerator to produce keying material |
alg | additional initialization parameters |
Recognised NameValuePairs are ModulusSize and SubgroupOrderSize (optional)
KeyingErr | if a key can't be generated or algorithm parameters are invalid |
Reimplemented from GeneratableCryptoMaterial.
Definition at line 209 of file gfpcrypt.cpp.
OID DL_GroupParameters_IntegerBased::GetAlgorithmID | ( | ) | const |
Retrieve the OID of the algorithm.
Definition at line 300 of file gfpcrypt.cpp.
|
protectedvirtual |
Definition at line 327 of file gfpcrypt.cpp.
|
virtual |
Retrieve the encoded element's size.
reversible | flag indicating the encoding format |
The format of the encoded element varies by the underlying type of the element and the reversible flag.
Implements DL_GroupParameters< Integer >.
Definition at line 243 of file gfpcrypt.cpp.
|
inlinevirtual |
Retrieves the order of the group.
Either GetGroupOrder() or GetCofactor() must be overridden in a derived class.
Reimplemented from DL_GroupParameters< Integer >.
Definition at line 99 of file gfpcrypt.h.
|
virtual |
Retrieve the maximum exponent for the group.
Implements DL_GroupParameters< Integer >.
Definition at line 322 of file gfpcrypt.cpp.
|
pure virtual |
Retrieve the modulus for the group.
|
inlinevirtual |
Retrieves the subgroup order.
Implements DL_GroupParameters< Integer >.
Definition at line 98 of file gfpcrypt.h.
|
virtual |
Get a named value.
name | the name of the object or value to retrieve |
valueType | reference to a variable that receives the value |
pValue | void pointer to a variable that receives the value |
GetVoidValue() retrieves the value of name if it exists.
Reimplemented from DL_GroupParameters< Integer >.
Definition at line 286 of file gfpcrypt.cpp.
|
inline |
Initialize a group parameters over integers.
params | the group parameters |
Definition at line 43 of file gfpcrypt.h.
Initialize a group parameters over integers.
p | the modulus |
g | the generator |
Definition at line 58 of file gfpcrypt.h.
|
inline |
Initialize a group parameters over integers.
p | the modulus |
q | the subgroup order |
g | the generator |
Definition at line 65 of file gfpcrypt.h.
|
inline |
Create a group parameters over integers.
rng | a RandomNumberGenerator derived class |
pbits | the size of p, in bits |
This function overload of Initialize() creates a new private key because it takes a RandomNumberGenerator() as a parameter. If you have an existing keypair, then use one of the other Initialize() overloads.
Definition at line 52 of file gfpcrypt.h.
|
pure virtual |
Set group parameters.
p | the prime modulus |
g | the group generator |
|
inline |
|
inlinestatic |
Definition at line 164 of file gfpcrypt.h.
|
virtual |
Check the element for errors.
level | level of thoroughness |
element | element to check |
precomp | optional pointer to DL_FixedBasePrecomputation |
There are four levels of thoroughness:
Level 0 performs group membership checks. Level 1 may not check for weak keys and such. Levels 2 and 3 are recommended.
ValidateElement() must be implemented in a derived class.
Implements DL_GroupParameters< Integer >.
Definition at line 162 of file gfpcrypt.cpp.
|
virtual |
Check the group for errors.
rng | RandomNumberGenerator for objects which use randomized testing |
level | level of thoroughness |
There are four levels of thoroughness:
Level 0 does not require a RandomNumberGenerator. A NullRNG() can be used for level 0. Level 1 may not check for weak keys and such. Levels 2 and 3 are recommended.
ValidateGroup() must be implemented in a derived class.
Implements DL_GroupParameters< Integer >.
Definition at line 133 of file gfpcrypt.cpp.