CertMgr Configuration
The control accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the control, access to these internal properties is provided through the Config method.CertMgr Configuration Settings
CertComment: A comment to include in a saved certificate.This settings specified the comment to use when calling SaveCertificate. This can only be used when CertificateOutputFormat is set to a value other than the default value. When CertificateOutputFormat is set to "SSH2PublicKey" the value of this setting should be the full header. For instance: "Comment: My Comment". | |||||||||||||||
CertCustomExtensionCount: The number of records in the CertCustomExtension arrays.This property controls the size of the following arrays:
The array indices start at 0 and end at CertExtensionCount-1. | |||||||||||||||
CertCustomExtensionCritical[i]: Whether or not the extension is defined as critical.Whether or not the certificate extension at index 'i' is defined as critical.
Valid array indices are from 0 to CertCustomExtensionCount - 1. | |||||||||||||||
CertCustomExtensionOID[i]: The ASN of the extension at index 'i'.The ASN.1 Object-Identifier (OID) that defines the certificate extension at index 'i'.
Valid array indices are from 0 to CertCustomExtensionCount - 1. | |||||||||||||||
CertCustomExtensionValue[i]: The raw value of the extension at index 'i'.The raw value of this certificate extension (as a byte string). This value is encoded
according to the extension's ASN.1 specification.
Valid array indices are from 0 to CertCustomExtensionCount - 1. | |||||||||||||||
CertificateOutputFormat: The format of the certificate to save.By default when SaveCertificate is called the certificate will be written in a PEM format. You may change the format by setting this setting to "SSH2PublicKey" or "OpenSSHPublicKey". Set this to the value "PEM" to specify the default behavior. | |||||||||||||||
CertKeyLength: The public key length for created certificates and keys.When CreateCertificate creates a new certificate and associated key, or when CreateKey creates a key, this setting determines the length of the new public key (in bits). The default value is 1024. | |||||||||||||||
CertKeyType: The types of keys created for new certificates.When CreateCertificate creates a new certificate and associated key, or when CreateKey creates a key, this setting determines the type of key generated: 1 for key exchange (encryption) keys, and 2 for digital signature keys. The default value is 1. | |||||||||||||||
CertSignatureAlgorithm: The signature algorithm used when creating certificates.When CreateCertificate or IssueCertificate creates a new certificate,
the signature algorithm used is specified by this setting. Possible values are:
| |||||||||||||||
CertValidityTime: The validity period for the certificate.When CreateCertificate creates a new certificate, the certificate is valid the moment it is created. CertValidityTime determines the number of days until expiration. The default value is 365 days. | |||||||||||||||
CSP: The Cryptographic Service Provider.The name of the Cryptographic Service Provider used to provide access to certificate signing operations. | |||||||||||||||
ImportCertAction: Specified the action to take if a matching certificate or a link to a matching certificate already exists.When calling ImportCertificate if a matching certificate or a link to a matching certificate already exists
in the Windows certificate store this setting governs what action will be taken. Possible values are:
| |||||||||||||||
KeyFormat: How the public and private key are formatted.This setting controls the format of CertPublicKey and CertPrivateKey. By default
these properties hold PEM formatted public and private key data. When set to 1 (XML) the keys
are stored in a XML format. This only affects the values returned by the control; the actual keys remain
the same regardless of this setting. Possible values are:
| |||||||||||||||
ReplaceKey: Whether or not to replace an existing key when creating a new key.If this is false (default), the component will throw an error if a duplicate key exists while generating a new keyset using CreateKey. If set to true, the component will replace a key if it already exists when generating new keys. |
Base Configuration Settings
CodePage: The system code page used for Unicode to Multibyte translations.
The default code page is the Active Code Page (0).
The following is a list of valid code page identifiers:
|