SMIMEEmail Adapter
Properties Configuration Settings
The SMIMEEmail Component adds S/MIME-protected email capability to the BizTalk Server.
Remarks
The SMIMEEmail Adapter adds support for sending and receiving S/MIME-protected emails to BizTalk Server. The adapter allows you to encrypt and sign emails before sending and decrypt and verify signatures on received emails.
SMIMEEmail Receiver Adapter
The SMIMEEmail Receiver adapter is the S/MIME enabled equivalent of the Email Receive adapter. In addition to standard IMAP and POP3 functions, the SMIMEEmail Receiver adapter can decrypt and/or verify message signatures. In order to use the SMIMEEmail Receiver adapter, you must first select a ServerType. You must also enter a MailServer and User. For servers that require authentication, you will also have to enter a Password. To activate SSL, you must also set the SSLAcceptServerCert and SSLStartMode. The adapter will attempt to determine the correct port to connect to based on the server type and SSL settings. However, you may override the default by directly setting the MailPort in the property pages.
Once you have your port set up, the adapter will connect to the server once every PollingInterval and download messages. To control how the messages are downloaded, or to prevent duplicate messages from being fetched from the mail server, you may set the DeleteMode to an appropriate value. For IMAP connections, you may also set a Filter.
The adapter will write as much information as it has regarding the emails to various properties in the message context that can be polled at runtime. These include MessageFrom, MessageTo, MessageSubject and MessageHeaders. The message headers may also be included with the message body by setting the IncludeHeaders property to True.
When it receives an email, the SMIMEEmail Reciever adapter will detect if the message is encrypted and attempt to decrypt it using the certificate in the Certificate property. If the message is signed, it will also attempt to verify the signature using the certificate in the SignerCert property.
SMIMEEmail Sender Adapter
The SMIMEEmail Sender Adapter is a complete SMTP client that can also encrypt and sign emails. To send emails from the adapter you must set at a minimum your SMTPServer, as well as your From and SendTo email addresses. Should you need to guarantee a secure transmission, you may set the SSLCert and SSLStartMode properties, as well as a specific SSLAcceptServerCert.
You may also add carbon copy and blind carbon copy recipients via the Cc and BCc properties. If you wish to receive delivery or read notifications, you can set the DeliveryReceipt and ReadReceipt properties. You may set the Subject of your message. The contents of the outbound message will be sent as the body of the email.
If you want to encrypt an email you are sending, set the RecipientCert property to the receiver's certificate, set the EncryptData property to true, and set EncryptingAlgorithm to the encryption algorithm you want to use. To sign an email, set the Certificate property to your certificate, set the SignData property to true, and set the SigningAlgorithm property to the hash algorithm you want to use for signing.
Receiver Property List
The following is the full list of the properties of the receiver adapter with short descriptions. Click on the links for further details.
AttachmentDirectory | Specifies the directory to which attachments are saved. |
AuthMode | The authentication mode to be used when connecting to the MailServer . |
Certificate | The Certificate used to sign (Encoder) and decrypt (Decoder) messages. |
DeleteMode | Controls if and when the email is deleted after download. |
ErrorThreshold | The maximum number of errors before the component shuts down. |
Filter | A filter to be applied to the inbox when selecting messages. |
Firewall | A set of properties related to firewall access. |
IncludeHeaders | Instructs the component to include or ignore message headers. |
MailFolder | Name of the mailbox selected on the server. |
MailPort | The port of the mail server (IMAP or POP3). |
MailServer | The name or address of the mail server (IMAP or POP3). |
MaxBatchSize | The maximum size, in MB, of the current batch (0 indicates no limit). |
MaxFileCount | The maximum number of files in the current batch (0 indicates no limit). |
MaxFileSize | The maximum size, in MB, of a file in the current batch (0 indicates no limit). |
MaxThreads | The maximum number of threads that the component may consume. |
MessageCc | A comma separated list of addresses for carbon copies. |
MessageDate | The date a message was sent. |
MessageFrom | The email address of the author of the message. |
MessageHeaders | Message headers associated with the current email message. |
MessageId | The id of the current message. |
MessageNetId | The globally unique identifier of the message. |
MessageSender | The email address of the sender. |
MessageSize | The size of the current message. |
MessageSubject | The subject of the mail message. |
MessageTo | A comma separated list of addresses for destinations. |
OAuthAuthorization | OAuth Authorization Information. |
Other | Defines a set of configuration settings to be used by the component. |
Password | A password for login. |
PersistentConnection | Instructs the component whether to keep the connection to the server open. |
PollingInterval | The amount of time, in seconds, between download attempts. |
RequeueEndpoints | Whether to requeue receive endpoints if the polling interval has not been reached. |
RequireEncryption | Whether an error should be thrown if a received message is not encrypted. |
RequireOAEP | Whether an error should be thrown if OAEP was not used to encrypt the incoming message. |
RequirePSS | Whether an error should be thrown if RSA-PSS was not used to encrypt the incoming message. |
RequireSignature | Whether an error should be thrown if a received message is not signed. |
RolloverCertificate | The rollover decryption certificate. |
RuntimeLicense | Specifies the component runtime license key. |
ServerType | The type of server for your email account. |
SignerCert | Contains the certificate of the message signer. |
SSLAcceptServerCert | Instructs the component to unconditionally accept the server certificate that matches the supplied certificate. |
SSLCert | The certificate to use for client authentication during the SSL handshake. |
SSLStartMode | Determines how the component starts the SSL negotiation. |
TempPath | The path to which temporary files are written at runtime. |
Timeout | A timeout for the component. |
TransportLog | Tells the component where and how to report information about its operations. |
URI | The Uniform Resource Identifier (URI) of the send port or receive location. |
User | A user id for login. |
Sender Property List
The following is the full list of the properties of the sender adapter with short descriptions. Click on the links for further details.
Attachments | Specifies which files the component should include as attachments in the outgoing message. |
AuthMode | The authentication mode to be used when connecting to the MailServer . |
BCc | A comma separated list of addresses for blind carbon copies (optional). |
Cc | A comma separated list of addresses for carbon copies (optional). |
Certificate | The Certificate used to sign (Encoder) and decrypt (Decoder) messages. |
ConnectionLifetime | Instructs the component whether or not to leave the connection to the server open. |
DeliveryReceipt | Whether or not a delivery receipt should be returned to the sender. |
EncryptData | Whether to encrypt the MIME data. |
EncryptingAlgorithm | The algorithm to use for encryption. |
Firewall | A set of properties related to firewall access. |
From | The email address of the sender (required). |
IncludeCertificate | Specifies whether to include the signer's certificate with the signed message. |
IncludeChain | Specifies whether to include the signer's certificate chain with the signed message. |
MaxPersistentConnections | The maximum number of simultaneous persistent connections when sending. |
MaxThreads | The maximum number of threads that the component may consume. |
MaxTransmissionBatchSize | The maximum number of messages that can be sent in a single batch. |
MessageHeaders | Message headers associated with the current email message. |
MessageHTML | The HTML text of the message. |
MessageText | The text of the mail message (optional). |
OAuthAuthorization | OAuth Authorization Information. |
Other | Defines a set of configuration settings to be used by the component. |
Password | A password for login. |
ReadReceipt | Whether or not a receipt should be sent when the email has been read. |
RecipientCert | The certificate used to encrypt the MIME data. |
ReplyTo | A mail address to reply to (optional). |
RuntimeLicense | Specifies the component runtime license key. |
SendTo | A comma separated list of addresses for destinations (required). |
SignData | Whether to sign the MIME data. |
SigningAlgorithm | Textual description of the signature hash algorithm. |
SMTPMessageId | The id of the mail message (optional). |
SMTPPort | The server port for SMTP (default 25). |
SMTPServer | The name or address of a mail server (mail relay). |
SSLAcceptServerCert | Instructs the component to unconditionally accept the server certificate that matches the supplied certificate. |
SSLCert | The certificate to use for client authentication during the SSL handshake. |
SSLStartMode | Determines how the component starts the SSL negotiation. |
Subject | The subject of the mail message (optional). |
TempPath | The path to which temporary files are written at runtime. |
Timeout | A timeout for the component. |
TransmitBatchMode | How the transmitter processes batches. |
TransportLog | Tells the component where and how to report information about its operations. |
URI | The Uniform Resource Identifier (URI) of the send port or receive location. |
UseOAEP | Whether to use OAEP when encrypting the MIME data. |
UsePSS | Whether to use RSA-PSS when signing. |
User | A user id for login. |
Configuration Settings
The following is a list of configuration settings for the adapter with short descriptions. Click on the links for further details.
AutoNormalizeLF | Whether to automatically determine how to normalize the MIC when verifying a signature. |
ContinueOnSMIMEError | Specifies whether further emails are processed after encountering an error. |
SMIMECapabilities | Specifies the algorithms to include in the sMIMECapabilities object in the signature. |
AddAttachmentsAsMessageParts | Includes attachments as additional parts on the message. |
AttachmentEncoding[index] | Content-Transfer-Encoding for attached file (at index). |
AttachmentName[index] | Filename for the attached file (at index). |
AttachmentNameSource | Specifies the source location in the MIME entity from which the filename is retrieved. |
AttachmentType[index] | Content-type for attached file (at index). |
AutoDecodeHeaders | Whether to decode headers. |
AutoDecodeMessageText | Whether to decode non-MIME message text. |
DeleteOnSuspend | Specifies whether files may be deleted from server when message is suspended. |
DuplicateAttachmentAction | Specifies what action to take when a duplicate filename is encountered. |
FoldHeaders | Whether incoming message headers should be folded. |
IncludeAttachments | Determines if additional message parts are added to the outgoing E-Mail as attachments. |
IncludeFilterInURI | Determines if the Filter is appended to the URI. |
MaskSensitive | Whether sensitive properties should be masked when logging. |
MaxParts | The maximum number of parts to be parsed from a mime message. |
MessageHTMLFile | Specifies a file that will be included as the email's HTML content. |
MessageTextEncoding | When set, the Text values will be encoded using the specified encoding. |
MoveTo | Specifies the IMAP folder on the server to which messages will be moved. |
ReturnOnlyPlainTextPart | Specifies if the component should return the first plain text part or the entire message. |
ReturnPath | Sets the Return-Path to be used for sending email. |
UIDMode | If True, permanent message identifiers will be used instead of temporary identifiers. |
ReuseSSLSession | Determines if the SSL session is reused. |
SSLCipherStrength | The minimum cipher strength used for bulk encryption. |
SSLEnabledCipherSuites | The cipher suite to be used in an SSL negotiation. |
SSLEnabledProtocols | Used to enable/disable the supported security protocols. |
SSLIncludeCertChain | Whether the entire certificate chain is included in the SSLServerAuthentication event. |
SSLSecurityFlags | Flags that control certificate verification. |
TLS12SignatureAlgorithms | Defines the allowed TLS 1.2 signature algorithms when UseInternalSecurityAPI is True. |
TLS12SupportedGroups | The supported groups for ECC. |
TLS13KeyShareGroups | The groups for which to pregenerate key shares. |
TLS13SignatureAlgorithms | The allowed certificate signature algorithms. |
TLS13SupportedGroups | The supported groups for (EC)DHE key exchange. |
AbsoluteTimeout | Determines whether timeouts are inactivity timeouts or absolute timeouts. |
LocalHost | The name of the local host or user-assigned IP interface through which connections are initiated or accepted. |
TcpNoDelay | Whether or not to delay when sending packets. |
UseInternalSecurityAPI | Tells the component whether or not to use the system security libraries or an internal implementation. |