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

SMIME Control

Properties   Methods   Events   Configuration Settings   Errors  

The SMIME component implements the S/MIME standard for encryption and decryption with public key cryptography and X.509 digital certificates.

Syntax

SMIME

Remarks

The SMIME control implements the S/MIME V3 standard for encryption and decryption using Public Key Cryptography Standards (PKCS). In addition the control can be used to both generate and verify RSA digital signatures. Using this control for decrypting or signing requires a valid digital certificate with a private key.

To sign the current data included in Message with a certificate, the Certificate property must be set to a valid Certificate object for the signing certificate. The IncludeCertificate and DetachedSignature properties allow you to specify additional details about the signing process. By setting IncludeCertificate to true, digital certificates can be encoded and included in message signature when signing the document. Including a certificate is the preferred method of building signed messages. In addition the SMIME control can also generate PKCS #7 formatted detached digital signatures and envelopes by specifying DetachedSignature.

To encrypt a message with the control in a PCKS envelope, you must first specify the Certificate for each recipient in the RecipientCerts properties to encrypt the message with. You can easily add these with the AddRecipientCert method. Once you have done this you can call the Encrypt method to encrypt the message with the recipient certificates.

In addition, the control allows you to sign and encrypt simultaneously with the SignAndEncrypt method. You must set all of the properties needed for both Sign and Encrypt

The result of the encrypted or signed data will be replaced in the Message property and the MessageHeaders property will be filled with the appropriate mime headers if applicable.

In addition the SMIME control can be used to verify signatures included in signed messages or documents. The Message property is used to specify the signed message envelope. VerifySignature can then be used to verify the signature. If the message does not have a certificate attached more then likely an exception will be thrown and the control will not be able to verify the signature. If VerifySignature is successful, the SignerCert and SignerCertChain properties will be filled with the certificate information of the message signer. This information can be used to verify the signing certificates.

Decrypting PKCS envelopes is handled with the Decrypt method. When this method is called, the control will attempt to find an appropriate certificate in the Certificate property that matches the encrypting certificate. If it cannot find an appropriate certificate an exception will be thrown and the message will not be decrypted.

Similar to SignAndEncrypt, DecryptAndVerifySignature can be used to both decrypt and verify the message in Message.

Property List


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

CertEncodedThe certificate (PEM/base64 encoded).
CertStoreThe name of the certificate store for the client certificate.
CertStorePasswordIf the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.
CertStoreTypeThe type of certificate store for this certificate.
CertSubjectThe subject of the certificate used for client authentication.
DetachedSignatureSpecifies whether to include a detached signature when signing a message.
EncryptingAlgorithmTextual description of the encrypting algorithm.
IncludeCertificateSpecifies whether to include the signer's certificate with the signed message.
IncludeChainSpecifies whether to include the signer's certificate chain with the signed message.
InternalHeadersThe headers of the MIME entity inside the encrypted or signed message.
MessageThe fully encoded or decoded S/MIME message.
MessageEncryptedWhether or not the current message is encrypted.
MessageHeaderCountThe number of records in the MessageHeader arrays.
MessageHeaderFieldThis property contains the name of the HTTP header (same case as it is delivered).
MessageHeaderValueThis property contains the header contents.
MessageHeadersStringString version of headers from the SMIME message.
MessageSignedWhether or not the current message is signed.
RecipientCertCountThe number of records in the RecipientCert arrays.
RecipientCertEncodedThe certificate (PEM/base64 encoded).
SignerCertEncodedThe certificate (PEM/base64 encoded).
SignerCertIssuerThe issuer of the certificate.
SignerCertSerialNumberThe serial number of the certificate encoded as a string.
SignerCertSubjectThe subject of the certificate used for client authentication.
SignerCertChainCountThe number of records in the SignerCertChain arrays.
SignerCertChainEncodedThe certificate (PEM/base64 encoded).
SigningAlgorithmTextual description of the signature hash algorithm.

Method List


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

AddRecipientCertUsed to add recipient certificates used to encrypt messages.
ConfigSets or retrieves a configuration setting .
DecryptDecrypts the current Message .
DecryptAndVerifySignatureDecrypts and verifies the signature of the current Message .
DecryptFileDecrypts the contents of a file.
EncryptEncrypts the current Message .
EncryptFileEncrypts the contents of a file.
GetRecipientInfoGets the recipient infos for an encrypted message.
ResetResets the component properties.
SignSigns the current Message .
SignAndEncryptSigns and encrypts the current Message .
VerifySignatureVerifies the signature of the current Message .

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.

ErrorInformation about errors during data delivery.
RecipientInfoFired for each recipient certificate of the encrypted message.
SignerCertInfoFired during verification of the signed message.

Configuration Settings


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

ApplyB64EncodingInstructs the component to base64 encode the message when signing or encrypting.
CSPThe Cryptographic Service Provider.
GenerateSignatureTimestampWhether to generate timestamps in signatures.
IncludeHeadersTells the component whether to include the headers when encoding the message.
IncludeInternalHeadersTells the component whether or not to include the internal headers when encoding the message.
ParseInternalHeadersTells the component whether or not to parse the message part headers when decrypting a message.
RecipientCertUsed to specify the public certificate when using a PEM key to decrypt.
RecipientCertFileUsed to specify the public certificate file when using a PEM key to decrypt.
UseCryptoAPIWhether to use the Microsoft Crypto API for cryptographic message generation.
CodePageThe system code page used for Unicode to Multibyte translations.

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