Security Scol plugin
|
Discrete Log (DL) private key base implementation. More...
#include <pubkey.h>
Public Types | |
typedef GP::Element | Element |
Public Types inherited from DL_PrivateKey< GP::Element > | |
typedef GP::Element | Element |
Public Types inherited from DL_KeyImpl< PKCS8PrivateKey, GP > | |
typedef GP | GroupParameters |
Public Member Functions | |
bool | Validate (RandomNumberGenerator &rng, unsigned int level) const |
Check this object for errors. | |
bool | GetVoidValue (const char *name, const std::type_info &valueType, void *pValue) const |
Get a named value. | |
void | AssignFrom (const NameValuePairs &source) |
Assign values to this object. | |
void | GenerateRandom (RandomNumberGenerator &rng, const NameValuePairs ¶ms) |
Generate a random key or crypto parameters. | |
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. | |
const DL_GroupParameters< Element > & | GetAbstractGroupParameters () const |
Retrieves abstract group parameters. | |
DL_GroupParameters< Element > & | AccessAbstractGroupParameters () |
Retrieves abstract group parameters. | |
const Integer & | GetPrivateExponent () const |
Retrieves the private exponent. | |
void | SetPrivateExponent (const Integer &x) |
Sets the private exponent. | |
void | BERDecodePrivateKey (BufferedTransformation &bt, bool, size_t) |
Decode privateKey part of privateKeyInfo. | |
void | DEREncodePrivateKey (BufferedTransformation &bt) const |
Encode privateKey part of privateKeyInfo. | |
Public Member Functions inherited from DL_PrivateKey< GP::Element > | |
void | MakePublicKey (DL_PublicKey< GP::Element > &pub) const |
Initializes a public key from this 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. | |
Public Member Functions inherited from DL_KeyImpl< PKCS8PrivateKey, GP > | |
OID | GetAlgorithmID () const |
bool | BERDecodeAlgorithmParameters (BufferedTransformation &bt) |
bool | DEREncodeAlgorithmParameters (BufferedTransformation &bt) const |
const GP & | GetGroupParameters () const |
GP & | AccessGroupParameters () |
Public Member Functions inherited from PKCS8PrivateKey | |
void | BERDecode (BufferedTransformation &bt) |
Decode this object from a BufferedTransformation. | |
void | DEREncode (BufferedTransformation &bt) const |
Encode this object into a BufferedTransformation. | |
virtual void | BERDecodeOptionalAttributes (BufferedTransformation &bt) |
Decode optional attributes. | |
virtual void | DEREncodeOptionalAttributes (BufferedTransformation &bt) const |
Encode optional attributes. | |
Public Member Functions inherited from ASN1CryptoMaterial< PrivateKey > | |
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 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. | |
Additional Inherited Members | |
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 Attributes inherited from PKCS8PrivateKey | |
ByteQueue | m_optionalAttributes |
Discrete Log (DL) private key base implementation.
GP | GroupParameters class |
typedef GP::Element DL_PrivateKeyImpl< GP >::Element |
|
inlinevirtual |
|
inlinevirtual |
Retrieves abstract group parameters.
Implements DL_Key< T >.
|
inlinevirtual |
Assign values to this object.
This function can be used to create a public key from a private key.
Implements CryptoMaterial.
|
inlinevirtual |
Decode privateKey part of privateKeyInfo.
bt | BufferedTransformation object |
parametersPresent | flag indicating if algorithm parameters are present |
size | number of octets to read for the parameters, in bytes |
BERDecodePrivateKey() the decodes privateKey part of privateKeyInfo, without the OCTET STRING header.
When parametersPresent = true
then BERDecodePrivateKey() calls BERDecodeAlgorithmParameters() to parse algorithm parameters.
Implements PKCS8PrivateKey.
|
inlinevirtual |
Encode privateKey part of privateKeyInfo.
bt | BufferedTransformation object |
DEREncodePrivateKey() encodes the privateKey part of privateKeyInfo, without the OCTET STRING header.
Implements PKCS8PrivateKey.
|
inlinevirtual |
Generate a random key or crypto parameters.
rng | a RandomNumberGenerator to produce keying material |
params | additional initialization parameters |
KeyingErr | if a key can't be generated or algorithm parameters are invalid |
If a derived class does not override GenerateRandom(), then the base class throws NotImplemented.
Reimplemented from GeneratableCryptoMaterial.
|
inlinevirtual |
Retrieves abstract group parameters.
Implements DL_Key< T >.
|
inlinevirtual |
Retrieves the private exponent.
Must be overridden in derived classes.
Implements DL_PrivateKey< GP::Element >.
|
inlinevirtual |
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.
Implements NameValuePairs.
|
inlinevirtual |
Retrieve previously saved precomputation.
storedPrecomputation | BufferedTransformation with the saved precomputation |
NotImplemented |
Reimplemented from CryptoMaterial.
|
inlinevirtual |
Perform precomputation.
precomputationStorage | the suggested number of objects for the precompute table |
NotImplemented |
The exact semantics of Precompute() varies, but it typically means calculate a table of n objects that can be used later to speed up computation.
If a derived class does not override Precompute(), then the base class throws NotImplemented.
Reimplemented from CryptoMaterial.
|
inlinevirtual |
Save precomputation for later use.
storedPrecomputation | BufferedTransformation to write the precomputation |
NotImplemented |
Reimplemented from CryptoMaterial.
|
inlinevirtual |
Sets the private exponent.
x | the private exponent |
Must be overridden in derived classes.
Implements DL_PrivateKey< GP::Element >.
|
inlinevirtual |
Determines whether the object supports precomputation.
Reimplemented from CryptoMaterial.
|
inlinevirtual |
Check this object for errors.
rng | a RandomNumberGenerator for objects which use randomized testing |
level | the 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.
Implements CryptoMaterial.