IP*Works! Auth V9 - Online Help
IP*Works! Auth V9
Questions / Feedback?

CertMgr Control

Properties   Methods   Events   Configuration Settings   Errors  

The CertMgr component is used to manage the digital certificates installed on a system.

Syntax

CertMgr

Remarks

The control methods, such as ListCertificateStores or ListStoreCertificates, are used to list certificate stores and certificates. The corresponding lists are returned via the StoreList and CertList events. Encoded certificates are provided through the events.

You can load a certificate by setting the Cert property of the control, then you can get information about the certificate through the corresponding fields of the Cert property (described below).

The CertSubject, CertSerialNumber, and CertIssuer properties identify the certificate. The CertEffectiveDate and CertExpirationDate show the time boundaries of the certificate.

CertPublicKey, CertPublicKeyAlgorithm, CertPublicKeyLength, and CertVersion provide information about the certificate keys and the certificate format (version).

CertUsageFlags specifies the intended usage of the certificate. The CertUsage property provides a text description of these flags.

Property List


The following is the full list of the properties of the control with short descriptions. Click on the links for further details.

CertEffectiveDateThe date which this certificate becomes valid.
CertEncodedThe certificate (PEM/base64 encoded).
CertExpirationDateThe date the certificate expires.
CertExtendedKeyUsageA comma-delimited list of extended key usage identifiers.
CertFingerprintThe hex-encoded, 16-byte MD5 fingerprint of the certificate.
CertIssuerThe issuer of the certificate.
CertKeyPasswordThe password for the certificate's private key (if any).
CertPrivateKeyThe private key of the certificate (if available).
CertPrivateKeyAvailableShows whether a PrivateKey is available for the selected certificate.
CertPrivateKeyContainerThe name of the PrivateKey container for the certificate (if available).
CertPublicKeyThe public key of the certificate.
CertPublicKeyAlgorithmTextual description of the public key algorithm of the certificate.
CertPublicKeyLengthThe length of the certificate public key (in bits).
CertSerialNumberThe serial number of the certificate encoded as a string.
CertSignatureAlgorithmText description of the signature algorithm of the certificate.
CertSubjectThe subject of the certificate used for client authentication.
CertSubjectAltNamesA comma-separated lists of alternative subject names of the certificate.
CertThumbprintMD5MD5 hash of the certificate.
CertThumbprintSHA1SHA1 hash of the certificate.
CertUsageText description of UsageFlags .
CertUsageFlagsFlags that show intended use for the certificate.
CertVersionThe certificate's version number.
CertExtensionCountThe number of records in the CertExtension arrays.
CertExtensionCriticalWhether or not the extension is defined as critical.
CertExtensionOIDThe ASN.
CertExtensionValueThe raw value of this certificate extension.
CertStoreThe certificate store to search for certificates.
CertStorePasswordThe password for the certificate store (if any).
CertStoreTypeThe type of certificate store for CertStore .

Method List


The following is the full list of the methods of the control with short descriptions. Click on the links for further details.

ConfigSets or retrieves a configuration setting .
CreateCertificateCreates a new self-signed certificate in the current store.
CreateKeyCreates a new keyset associated with the provided name.
DeleteCertificateDeletes the currently selected certificate from the store.
DeleteKeyDeletes the keyset associated with the provided name.
ExportCertificateSaves the current certificate to a PFX file.
GenerateCSRGenerates a new CSR to be sent to a signing authority.
ImportCertificateImports a certificate from a PFX file into the current certificate store.
ImportSignedCSRImports a signed CSR.
IssueCertificateCreates a new certificate in the current store, signed by the selected certificate.
ListCertificateStoresLists certificate stores.
ListKeysList keysets in a CSP.
ListMachineStoresList machine certificate stores.
ListStoreCertificatesList certificates in a store.
ReadCertificateLoads a certificate from a file.
ResetResets all certificate properties to their default values.
SaveCertificateSaves the current certificate to a file.
ShowCertificateChainShow certificate chain.
SignCSRCreates a signed certificate from a CSR.

Event List


The following is the full list of the events fired by the control with short descriptions. Click on the links for further details.

CertChainShows the certificate chain for the certificate (see the ShowCertificateChain method).
CertListLists the certificates in a store (see the ListStoreCertificates method).
ErrorInformation about errors during data delivery.
KeyListLists the keysets in a CSP (see the ListKeys method).
StoreListLists the system certificate stores (see the ListCertificateStores and ListMachineStores methods).

Configuration Settings


The following is a list of configuration settings for the control with short descriptions. Click on the links for further details.

CertCommentA comment to include in a saved certificate.
CertCustomExtensionCountThe number of records in the CertCustomExtension arrays.
CertCustomExtensionCritical[i]Whether or not the extension is defined as critical.
CertCustomExtensionOID[i]The ASN of the extension at index 'i'.
CertCustomExtensionValue[i]The raw value of the extension at index 'i'.
CertificateOutputFormatThe format of the certificate to save.
CertKeyLengthThe public key length for created certificates and keys.
CertKeyTypeThe types of keys created for new certificates.
CertSignatureAlgorithmThe signature algorithm used when creating certificates.
CertValidityTimeThe validity period for the certificate.
CSPThe Cryptographic Service Provider.
ImportCertActionSpecified the action to take if a matching certificate or a link to a matching certificate already exists.
KeyFormatHow the public and private key are formatted.
ReplaceKeyWhether or not to replace an existing key when creating a new key.
CodePageThe system code page used for Unicode to Multibyte translations.

 
 
Copyright (c) 2017 /n software inc. - All rights reserved.
Build 9.0.6240.0