Dsa

If set to a file path, this property logs the LastErrorText of each Chilkat method or property call to the specified file. This logging helps identify the context and history of Chilkat calls leading up to any crash or hang, aiding in debugging.

Enabling the VerboseLogging property provides more detailed information. This property is mainly used for debugging rare instances where a Chilkat method call causes a hang or crash, which should generally not happen.

Possible causes of hangs include:

• A timeout property set to 0, indicating an infinite timeout.
• A hang occurring within an event callback in the application code.
• An internal bug in the Chilkat code causing the hang.

Specifies the size, in bits, of the DSA subgroup parameter Q used by the legacy GenKey method. The default is 160. This also determines the natural size of the DSA signature components r and s.

Applications should normally leave this property at its default. When an explicit standards-era (L, N) parameter pair is required, use GenKey2, where L is the bit length of P and N is the bit length of Q.

Contains the message digest to be signed by SignHash or checked by Verify. Set this property before calling either method. The same value can also be supplied in encoded form with SetEncodedHash.

The Dsa class does not hash the original message. The application must compute the exact digest required by the protocol or file format and provide the resulting bytes here.

Returns the DSA domain parameter G, the generator of the subgroup of order Q modulo P.

The returned text is a hexadecimal encoding of Chilkat's SSH1-format bignum representation, which includes a two-byte bit-length prefix followed by the unsigned integer bytes.

Returns the DSA domain parameter P, the large prime modulus.

The returned text is a hexadecimal encoding of Chilkat's SSH1-format bignum representation, which includes a two-byte bit-length prefix followed by the unsigned integer bytes.

Returns the DSA domain parameter Q, a prime divisor of P - 1. The bit length of Q is commonly written as N and determines the range of the private value X and signature components r and s.

The returned text is a hexadecimal encoding of Chilkat's SSH1-format bignum representation, which includes a two-byte bit-length prefix followed by the unsigned integer bytes.

Returns the DSA private value X. It is present only when the object contains a private key and satisfies 0 < X < Q.

The returned text is a hexadecimal encoding of Chilkat's SSH1-format bignum representation, which includes a two-byte bit-length prefix followed by the unsigned integer bytes.

Returns the DSA public value Y, where Y = GX mod P. It is available when either a public or private DSA key is loaded.

The returned text is a hexadecimal encoding of Chilkat's SSH1-format bignum representation, which includes a two-byte bit-length prefix followed by the unsigned integer bytes.

Provides HTML-formatted information about the last called method or property. If a method call fails or behaves unexpectedly, check this property for details. Note that information is available regardless of the method call's success.

Provides plain text information about the last called method or property. If a method call fails or behaves unexpectedly, check this property for details. Note that information is available regardless of the method call's success.

Provides XML-formatted information about the last called method or property. If a method call fails or behaves unexpectedly, check this property for details. Note that information is available regardless of the method call's success.

Indicates the success or failure of the most recent method call: true means success, false means failure. This property remains unchanged by property setters or getters. This method is present to address challenges in checking for null or Nothing returns in certain programming languages. Note: This property does not apply to methods that return integer values or to boolean-returning methods where the boolean does not indicate success or failure.

Contains the DSA signature produced by SignHash. Before calling Verify, set this property to the signature being checked, or use SetEncodedSignature or SetEncodedSignatureRS.

Chilkat represents the signature as an ASN.1 DER SEQUENCE containing the two DSA integers r and s. Use GetEncodedSignature to obtain a hexadecimal or Base64 representation.

Reserved for uncommon or compatibility-specific options. The default is the empty string, and applications should normally leave this property unchanged unless Chilkat documentation or support identifies a specific keyword required for the target system.

If set to true, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. The default value is false. Verbose logging should only be used for debugging. The potentially large quantity of logged information may adversely affect peformance.

Version of the component/library, such as "10.1.0"

Loads a DSA private key from the DER-encoded bytes in derData. On success, the object contains both the private and public key components and can sign or verify digests.

Returns true for success, false for failure.

Loads a DSA private key from the DER bytes contained in the BinData object passed in bd. Returns true on successful decoding.

Returns true for success, false for failure.

Loads a DSA private key from the DER-encoded file specified by path. Returns true when the file is read and decoded successfully; otherwise returns false.

Returns true for success, false for failure.

Loads a DSA private key from the PEM text in pemData. password supplies the password when the PEM is encrypted. If the PEM is unencrypted, the password is ignored and the key is loaded normally.

Returns true on success and false if the PEM cannot be decoded, the password is incorrect, or the contained key is not a supported DSA private key.

Returns true for success, false for failure.

Loads an unencrypted DSA private key from the PEM text in pemData. On success, the object contains the private key and its corresponding public components.

Returns true for success, false for failure.

Loads a DSA public key from the DER-encoded bytes in derData. A public key can be used with Verify and can be exported, but it cannot be used by SignHash.

Returns true for success, false for failure.

Loads a DSA public key from the DER bytes contained in the BinData object passed in bd. The resulting key can verify signatures but cannot sign.

Returns true for success, false for failure.

Loads a DSA public key from the DER-encoded file specified by path. Returns true when the file is read and decoded successfully; otherwise returns false.

Returns true for success, false for failure.

Loads a DSA public key from the PEM text in pemData. Returns true when the PEM contains a supported DSA public key and is decoded successfully.

Returns true for success, false for failure.

Loads a DSA public or private key from the XML text in xmlKey. The XML content determines whether the resulting object contains public components only or also includes the private value X.

Returns true for success, false for failure.

Generates a new DSA key pair with a P size of numBits bits. numBits must be at least 1024 and a multiple of 64. This legacy method uses the subgroup size selected by GroupSize, whose default is 160 bits.

For explicit standard parameter pairs such as (2048, 224) or (3072, 256), use GenKey2.

Returns true for success, false for failure.

Generates a new DSA key pair using an explicit (L, N) parameter-size combination. keyLenBits is L, the bit length of the prime modulus P. modLenBits is N, the bit length of the subgroup prime Q.

Returns true for success, false for failure.

Generates a new DSA key pair from OpenSSL-style DSA parameters supplied as DER-encoded bytes in derBytes.

The supplied data contains DSA domain parameters P, Q, and G, not an existing private key. Chilkat validates or imports those parameters and generates a fresh private value X and corresponding public value Y.

Returns true for success, false for failure.

Generates a new DSA key pair from OpenSSL-style DSA parameters stored as DER bytes in the BinData object passed in bd.

The supplied data contains DSA domain parameters P, Q, and G, not an existing private key. Chilkat validates or imports those parameters and generates a fresh private value X and corresponding public value Y.

Returns true for success, false for failure.

Generates a new DSA key pair from the OpenSSL-style DER DSA-parameters file specified by path.

The supplied data contains DSA domain parameters P, Q, and G, not an existing private key. Chilkat validates or imports those parameters and generates a fresh private value X and corresponding public value Y.

Returns true when the parameters are loaded and a key pair is generated successfully.

Returns true for success, false for failure.

Generates a new DSA key pair from OpenSSL-style DSA parameters supplied as PEM text in pem.

The supplied data contains DSA domain parameters P, Q, and G, not an existing private key. Chilkat validates or imports those parameters and generates a fresh private value X and corresponding public value Y.

Returns true for success, false for failure.

Generates a new DSA key pair from the OpenSSL-style PEM DSA-parameters file specified by path.

The supplied data contains DSA domain parameters P, Q, and G, not an existing private key. Chilkat validates or imports those parameters and generates a fresh private value X and corresponding public value Y.

A typical parameter file is PEM-armored with a BEGIN DSA PARAMETERS header. The newly generated private key can be exported with the applicable To* methods.

Returns true for success, false for failure.

Generates a new DSA private/public key pair using the preselected domain parameters P, Q, and G supplied in pHex, qHex, and gHex.

Each argument is hexadecimal text in Chilkat's SSH1-format bignum representation. Chilkat generates a fresh private value X and derives Y; the supplied values are domain parameters, not an existing key pair.

Returns true for success, false for failure.

Returns the current Hash bytes encoded according to encoding. Use hex or base64.

This method does not compute a hash; it only converts the bytes already stored in the Hash property to text.

Returns null on failure

Returns the current Signature bytes encoded according to encoding. Use hex or base64.

After a successful SignHash call, the returned bytes are the ASN.1 DER-encoded DSA signature containing the integers r and s.

Returns null on failure

Loads the entire file specified by path and returns its contents as text using the legacy ANSI character encoding.

Returns null on failure

Writes strToSave to the file specified by path using the legacy ANSI character encoding. Returns true on success.

Returns true for success, false for failure.

Decodes encodedHash using the encoding named by encoding and stores the resulting bytes in the Hash property. Use hex or base64.

The decoded value must be the already-computed message digest that will be signed by SignHash or checked by Verify.

Returns true for success, false for failure.

Decodes the signature text in encodedSig using the encoding named by encoding and stores the resulting bytes in the Signature property. Use hex or base64.

The decoded bytes are expected to contain the ASN.1 DER-encoded DSA signature. Set the corresponding Hash and public key before calling Verify.

Returns true for success, false for failure.

Builds the DSA signature from separately encoded r and s integer values. encoding identifies the encoding used by both encodedR and encodedS; use hex or base64.

On success, Signature contains the ASN.1 DER SEQUENCE of the two integers and is ready for use with Verify.

Returns true for success, false for failure.

Loads a DSA private key from explicitly supplied components. groupSizeInBytes is the size of Q in bytes. pHex, qHex, gHex, and xHex provide P, Q, G, and the private value X, respectively.

The corresponding public value Y = GX mod P is derived from the private key.

Returns true for success, false for failure.

Loads a DSA public key from explicitly supplied components. groupSizeInBytes is the size of Q in bytes. pHex, qHex, gHex, and yHex provide P, Q, G, and the public value Y, respectively.

The resulting object can verify DSA signatures but cannot create them.

Returns true for success, false for failure.

Creates a DSA signature over the digest currently stored in Hash. A DSA private key must be loaded, and the digest must be set directly or with SetEncodedHash before this method is called.

On success, Signature contains an ASN.1 DER-encoded sequence of the DSA values r and s. Retrieve it with GetEncodedSignature or read the Signature property.

Returns true for success, false for failure.

Returns the loaded DSA private key as DER-encoded bytes. A private key must be present; a public-only key cannot be exported by this method.

Returns null on failure

Writes the DER-encoded DSA private key to the BinData object passed in bd. Returns true on success.

Returns true for success, false for failure.

Writes the loaded DSA private key to the DER file specified by path. Returns true on success.

Returns true for success, false for failure.

Returns the loaded DSA private key as password-encrypted PEM text using password as the password.

Returns null on failure

Returns the loaded DSA private key as unencrypted PEM text.

Returns null on failure

Returns the public portion of the loaded DSA key as DER-encoded bytes. This works whether the object contains a public key or a private key with a corresponding public value.

Returns null on failure

Writes the DER-encoded public portion of the loaded DSA key to the BinData object passed in bd. Returns true on success.

Returns true for success, false for failure.

Writes the public portion of the loaded DSA key to the DER file specified by path. Returns true on success.

Returns true for success, false for failure.

Returns the public portion of the loaded DSA key as PEM text. Public-key PEM may be distributed to parties that need to verify signatures; it does not contain the private value X.

Returns null on failure

Returns the loaded DSA key as XML. Set bPublicOnly to true to export public components only. Set it to false to include the private component when a private key is loaded.

Returns null on failure

Verifies the DSA signature currently stored in Signature against the digest stored in Hash, using the loaded public key. Both values must be set before calling this method.

Returns true only when the signature is valid. A false result can indicate an invalid signature, malformed input, an incompatible key, or another operational error; inspect LastErrorText when the reason matters.

Returns true for success, false for failure.

Checks the mathematical validity and internal consistency of the DSA public or private key currently loaded in the object. Returns true when the key parameters and available key components pass validation.

This does not establish who owns the key, whether the key came from a trusted source, or whether it is suitable for a particular protocol.