Crypto++
8.3
Free C++ class library of cryptographic schemes
|
Integer-based GroupParameters specialization. More...
Public Member Functions | |
void | Initialize (const DL_GroupParameters_IntegerBased ¶ms) |
Initialize a group parameters over integers. More... | |
void | Initialize (RandomNumberGenerator &rng, unsigned int pbits) |
Create a group parameters over integers. More... | |
void | Initialize (const Integer &p, const Integer &g) |
Initialize a group parameters over integers. More... | |
void | Initialize (const Integer &p, const Integer &q, const Integer &g) |
Initialize a group parameters over integers. More... | |
void | BERDecode (BufferedTransformation &bt) |
Decode this object from a BufferedTransformation. More... | |
void | DEREncode (BufferedTransformation &bt) const |
Encode this object into a BufferedTransformation. More... | |
void | GenerateRandom (RandomNumberGenerator &rng, const NameValuePairs &alg) |
Generate a random key. More... | |
bool | GetVoidValue (const char *name, const std::type_info &valueType, void *pValue) const |
Get a named value. More... | |
void | AssignFrom (const NameValuePairs &source) |
Initialize or reinitialize this key. More... | |
const Integer & | GetSubgroupOrder () const |
Integer | GetGroupOrder () const |
bool | ValidateGroup (RandomNumberGenerator &rng, unsigned int level) const |
Check the group for errors. More... | |
bool | ValidateElement (unsigned int level, const Integer &element, const DL_FixedBasePrecomputation< Integer > *precomp) const |
Check the element for errors. More... | |
bool | FastSubgroupCheckAvailable () const |
Determine if subgroup membership check is fast. More... | |
void | EncodeElement (bool reversible, const Element &element, byte *encoded) const |
Encodes the element. More... | |
unsigned int | GetEncodedElementSize (bool reversible) const |
Retrieve the encoded element's size. More... | |
Integer | DecodeElement (const byte *encoded, bool checkForGroupMembership) const |
Decodes the element. More... | |
Integer | ConvertElementToInteger (const Element &element) const |
Converts an element to an Integer. More... | |
Integer | GetMaxExponent () const |
Retrieve the maximum exponent for the group. More... | |
OID | GetAlgorithmID () const |
Retrieve the OID of the algorithm. More... | |
virtual const Integer & | GetModulus () const =0 |
Retrieve the modulus for the group. More... | |
virtual void | SetModulusAndSubgroupGenerator (const Integer &p, const Integer &g)=0 |
Set group parameters. More... | |
void | SetSubgroupOrder (const Integer &q) |
Set subgroup order. More... | |
![]() | |
void | Save (BufferedTransformation &bt) const |
DER encode ASN.1 object. More... | |
void | Load (BufferedTransformation &bt) |
BER decode ASN.1 object. More... | |
![]() | |
virtual void | BEREncode (BufferedTransformation &bt) const |
Encode this object into a BufferedTransformation. More... | |
![]() | |
bool | Validate (RandomNumberGenerator &rng, unsigned int level) const |
Check this object for errors. More... | |
bool | GetVoidValue (const char *name, const std::type_info &valueType, void *pValue) const |
Get a named value. More... | |
bool | SupportsPrecomputation () const |
Determines whether the object supports precomputation. More... | |
void | Precompute (unsigned int precomputationStorage=16) |
Perform precomputation. More... | |
void | LoadPrecomputation (BufferedTransformation &storedPrecomputation) |
Retrieve previously saved precomputation. More... | |
void | SavePrecomputation (BufferedTransformation &storedPrecomputation) const |
Save precomputation for later use. More... | |
virtual const Element & | GetSubgroupGenerator () const |
Retrieves the subgroup generator. More... | |
virtual void | SetSubgroupGenerator (const Element &base) |
Sets the subgroup generator. More... | |
virtual Element | ExponentiateBase (const Integer &exponent) const |
Exponentiates the base. More... | |
virtual Element | ExponentiateElement (const Element &base, const Integer &exponent) const |
Exponentiates an element. More... | |
virtual const DL_GroupPrecomputation< Element > & | GetGroupPrecomputation () const=0 |
Retrieves the group precomputation. More... | |
virtual const DL_FixedBasePrecomputation< Element > & | GetBasePrecomputation () const=0 |
Retrieves the group precomputation. More... | |
virtual DL_FixedBasePrecomputation< Element > & | AccessBasePrecomputation ()=0 |
Retrieves the group precomputation. More... | |
virtual const Integer & | GetSubgroupOrder () const=0 |
Retrieves the subgroup order. More... | |
virtual Integer | GetMaxExponent () const=0 |
Retrieves the maximum exponent for the group. More... | |
virtual Integer | GetGroupOrder () const |
Retrieves the order of the group. More... | |
virtual Integer | GetCofactor () const |
Retrieves the cofactor. More... | |
virtual void | EncodeElement (bool reversible, const Element &element, byte *encoded) const=0 |
Encodes the element. More... | |
virtual bool | FastSubgroupCheckAvailable () const=0 |
virtual bool | IsIdentity (const Element &element) const=0 |
Determines if an element is an identity. More... | |
virtual void | SimultaneousExponentiate (Element *results, const Element &base, const Integer *exponents, unsigned int exponentsCount) const=0 |
Exponentiates a base to multiple exponents. More... | |
![]() | |
void | GenerateRandomWithKeySize (RandomNumberGenerator &rng, unsigned int keySize) |
Generate a random key or crypto parameters. More... | |
![]() | |
virtual void | ThrowIfInvalid (RandomNumberGenerator &rng, unsigned int level) const |
Check this object for errors. More... | |
virtual bool | SupportsPrecomputation () const |
Determines whether the object supports precomputation. More... | |
void | DoQuickSanityCheck () const |
Perform a quick sanity check. More... | |
![]() | |
template<class T > | |
bool | GetThisObject (T &object) const |
Get a copy of this object or subobject. More... | |
template<class T > | |
bool | GetThisPointer (T *&ptr) const |
Get a pointer to this object. More... | |
template<class T > | |
bool | GetValue (const char *name, T &value) const |
Get a named value. More... | |
template<class T > | |
T | GetValueWithDefault (const char *name, T defaultValue) const |
Get a named value. More... | |
CRYPTOPP_DLL std::string | GetValueNames () const |
Get a list of value names that can be retrieved. More... | |
CRYPTOPP_DLL bool | GetIntValue (const char *name, int &value) const |
Get a named value with type int. More... | |
CRYPTOPP_DLL int | GetIntValueWithDefault (const char *name, int defaultValue) const |
Get a named value with type int, with default. More... | |
CRYPTOPP_DLL bool | GetWord64Value (const char *name, word64 &value) const |
Get a named value with type word64. More... | |
CRYPTOPP_DLL word64 | GetWord64ValueWithDefault (const char *name, word64 defaultValue) const |
Get a named value with type word64, with default. More... | |
template<class T > | |
void | GetRequiredParameter (const char *className, const char *name, T &value) const |
Retrieves a required name/value pair. More... | |
CRYPTOPP_DLL void | GetRequiredIntParameter (const char *className, const char *name, int &value) const |
Retrieves a required name/value pair. More... | |
Static Public Member Functions | |
static std::string CRYPTOPP_API | StaticAlgorithmNamePrefix () |
![]() | |
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. More... | |
Additional Inherited Members | |
![]() | |
typedef Integer | Element |
Integer-based GroupParameters specialization.
Definition at line 34 of file gfpcrypt.h.
|
inline |
Initialize a group parameters over integers.
params | the group parameters |
Definition at line 43 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.
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.
|
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.
|
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 |
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.
Reimplemented in DL_GroupParameters_DSA.
Definition at line 209 of file gfpcrypt.cpp.
|
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 |
Implements NameValuePairs.
Reimplemented in DL_GroupParameters_LUC, DL_GroupParameters_GFP, DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >, DL_GroupParameters_IntegerBasedImpl< DL_GroupPrecomputation_LUC, DL_BasePrecomputation_LUC >, and DL_GroupParameters_IntegerBasedImpl< ModExpPrecomputation >.
Definition at line 286 of file gfpcrypt.cpp.
|
virtual |
Initialize or reinitialize this key.
source | NameValuePairs to assign |
Implements CryptoMaterial.
Reimplemented in DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >, DL_GroupParameters_IntegerBasedImpl< DL_GroupPrecomputation_LUC, DL_BasePrecomputation_LUC >, and DL_GroupParameters_IntegerBasedImpl< ModExpPrecomputation >.
Definition at line 292 of file gfpcrypt.cpp.
|
virtual |
Check the group for errors.
rng | RandomNumberGenerator for objects which use randomized testing |
level | level of thoroughness |
Implements DL_GroupParameters< Integer >.
Reimplemented in DL_GroupParameters_DSA.
Definition at line 133 of file gfpcrypt.cpp.
|
virtual |
Check the element for errors.
level | level of thoroughness |
element | element to check |
precomp | optional pointer to DL_FixedBasePrecomputation |
Implements DL_GroupParameters< Integer >.
Definition at line 162 of file gfpcrypt.cpp.
|
inline |
Determine if subgroup membership check is fast.
Definition at line 105 of file gfpcrypt.h.
void DL_GroupParameters_IntegerBased::EncodeElement | ( | bool | reversible, |
const Element & | element, | ||
byte * | encoded | ||
) | const |
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()
Definition at line 237 of file gfpcrypt.cpp.
|
virtual |
Retrieve the encoded element's size.
reversible | flag indicating the encoding format |
Implements DL_GroupParameters< Integer >.
Definition at line 243 of file gfpcrypt.cpp.
|
virtual |
Decodes the element.
encoded | byte array with the encoded element |
checkForGroupMembership | flag indicating if the element should be validated |
COUNTOF(encoded) == GetEncodedElementSize()
Implements DL_GroupParameters< Integer >.
Definition at line 249 of file gfpcrypt.cpp.
|
inlinevirtual |
Converts an element to an Integer.
element | the element to convert to an Integer |
Implements DL_GroupParameters< Integer >.
Definition at line 139 of file gfpcrypt.h.
Integer DL_GroupParameters_IntegerBased::GetMaxExponent | ( | ) | const |
Retrieve the maximum exponent for the group.
Definition at line 322 of file gfpcrypt.cpp.
OID DL_GroupParameters_IntegerBased::GetAlgorithmID | ( | ) | const |
Retrieve the OID of the algorithm.
Definition at line 300 of file gfpcrypt.cpp.
|
pure virtual |
Retrieve the modulus for the group.
Implemented in DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >.
|
pure virtual |
Set group parameters.
p | the prime modulus |
g | the group generator |
Implemented in DL_GroupParameters_IntegerBasedImpl< GROUP_PRECOMP, BASE_PRECOMP >, DL_GroupParameters_IntegerBasedImpl< DL_GroupPrecomputation_LUC, DL_BasePrecomputation_LUC >, and DL_GroupParameters_IntegerBasedImpl< ModExpPrecomputation >.
|
inline |