Security Scol plugin
|
Rabin-Williams trapdoor function using the private key. More...
#include <rw.h>
Public Member Functions | |
InvertibleRWFunction () | |
Construct an InvertibleRWFunction. | |
void | Initialize (const Integer &n, const Integer &p, const Integer &q, const Integer &u) |
Initialize a Rabin-Williams private key. | |
void | Initialize (RandomNumberGenerator &rng, unsigned int modulusBits) |
Create a Rabin-Williams private key. | |
void | BERDecode (BufferedTransformation &bt) |
void | DEREncode (BufferedTransformation &bt) const |
void | Save (BufferedTransformation &bt) const |
Saves a key to a BufferedTransformation. | |
void | Load (BufferedTransformation &bt) |
Loads a key from a BufferedTransformation. | |
Integer | CalculateInverse (RandomNumberGenerator &rng, const Integer &x) const |
Calculates the inverse of an element. | |
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 &alg) |
const Integer & | GetPrime1 () const |
const Integer & | GetPrime2 () const |
const Integer & | GetMultiplicativeInverseOfPrime2ModPrime1 () const |
void | SetPrime1 (const Integer &p) |
void | SetPrime2 (const Integer &q) |
void | SetMultiplicativeInverseOfPrime2ModPrime1 (const Integer &u) |
virtual bool | SupportsPrecomputation () const |
Determines whether the object supports precomputation. | |
virtual void | Precompute (unsigned int unused=0) |
Perform precomputation. | |
virtual void | Precompute (unsigned int unused=0) const |
virtual void | LoadPrecomputation (BufferedTransformation &storedPrecomputation) |
Retrieve previously saved precomputation. | |
virtual void | SavePrecomputation (BufferedTransformation &storedPrecomputation) const |
Save precomputation for later use. | |
Public Member Functions inherited from RWFunction | |
void | Initialize (const Integer &n) |
Initialize a Rabin-Williams public key. | |
void | BERDecode (BufferedTransformation &bt) |
void | DEREncode (BufferedTransformation &bt) const |
void | Save (BufferedTransformation &bt) const |
Saves a key to a BufferedTransformation. | |
void | Load (BufferedTransformation &bt) |
Loads a key from a BufferedTransformation. | |
Integer | ApplyFunction (const Integer &x) const |
Applies the trapdoor. | |
Integer | PreimageBound () const |
Returns the maximum size of a message before the trapdoor function is applied. | |
Integer | ImageBound () const |
Returns the maximum size of a representation after the trapdoor function is applied. | |
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. | |
const Integer & | GetModulus () const |
void | SetModulus (const Integer &n) |
Public Member Functions inherited from TrapdoorFunction | |
Integer | ApplyRandomizedFunction (RandomNumberGenerator &rng, const Integer &x) const |
Applies the trapdoor function. | |
bool | IsRandomized () const |
Determines if the encryption algorithm is randomized. | |
Public Member Functions inherited from TrapdoorFunctionBounds | |
virtual Integer | MaxPreimage () const |
Returns the maximum size of a message before the trapdoor function is applied bound to a public key. | |
virtual Integer | MaxImage () const |
Returns the maximum size of a representation after the trapdoor function is applied bound to a public key. | |
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. | |
Public Member Functions inherited from TrapdoorFunctionInverse | |
Integer | CalculateRandomizedInverse (RandomNumberGenerator &rng, const Integer &x) const |
Applies the inverse of the trapdoor function. | |
bool | IsRandomized () const |
Determines if the decryption algorithm is randomized. | |
Public Member Functions inherited from GeneratableCryptoMaterial | |
void | GenerateRandomWithKeySize (RandomNumberGenerator &rng, unsigned int keySize) |
Generate a random key or crypto parameters. | |
Protected Member Functions | |
void | PrecomputeTweakedRoots () const |
Protected Attributes | |
Integer | m_p |
Integer | m_q |
Integer | m_u |
Integer | m_pre_2_9p |
Integer | m_pre_2_3q |
Integer | m_pre_q_p |
bool | m_precompute |
Protected Attributes inherited from RWFunction | |
Integer | m_n |
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. | |
Rabin-Williams trapdoor function using the private key.
|
inline |
Construct an InvertibleRWFunction.
|
virtual |
Assign values to this object.
This function can be used to create a public key from a private key.
Implements CryptoMaterial.
void InvertibleRWFunction::BERDecode | ( | BufferedTransformation & | bt | ) |
|
virtual |
Calculates the inverse of an element.
rng | a RandomNumberGenerator derived class |
x | the element |
Implements TrapdoorFunctionInverse.
void InvertibleRWFunction::DEREncode | ( | BufferedTransformation & | bt | ) | const |
|
virtual |
parameters: (ModulusSize)
Reimplemented from GeneratableCryptoMaterial.
|
inline |
|
inline |
|
inline |
|
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.
Implements NameValuePairs.
void InvertibleRWFunction::Initialize | ( | const Integer & | n, |
const Integer & | p, | ||
const Integer & | q, | ||
const Integer & | u | ||
) |
Initialize a Rabin-Williams private key.
n | modulus |
p | first prime factor |
q | second prime factor |
u | q-1 mod p |
This Initialize() function overload initializes a private key from existing parameters.
|
inline |
Create a Rabin-Williams private key.
rng | a RandomNumberGenerator derived class |
modulusBits | the size of the modulus, 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.
|
inlinevirtual |
Loads a key from a BufferedTransformation.
bt | the source BufferedTransformation |
KeyingErr |
Load() attempts to read material from a BufferedTransformation. If the material is a key that was generated outside the library, then the following usually applies:
"key info" means the key should have an object identifier with an algorithm id, like a subjectPublicKeyInfo.
To read a "raw" key without the "key info", then call the key's BERDecode() method.
Reimplemented from CryptoMaterial.
|
virtual |
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 |
|
protected |
|
inlinevirtual |
Saves a key to a BufferedTransformation.
bt | the destination BufferedTransformation |
NotImplemented |
Save() writes the material to a BufferedTransformation.
If the material is a key, then the key is written with ASN.1 DER encoding. The key includes an object identifier with an algorithm id, like a subjectPublicKeyInfo.
A "raw" key without the "key info" can be saved using a key's DEREncode() method.
If a derived class does not override Save(), then the base class throws NotImplemented().
Reimplemented from CryptoMaterial.
|
virtual |
Save precomputation for later use.
storedPrecomputation | BufferedTransformation to write the precomputation |
NotImplemented |
Reimplemented from CryptoMaterial.
|
inline |
|
inline |
|
inline |
|
inlinevirtual |
Determines whether the object supports precomputation.
Reimplemented from CryptoMaterial.
|
virtual |
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.