- Configuration and Testing
- Functional Demonstration
- Use Case Scenario
- Useful Tips
SMTP Bridge component allows you to connect to a remote email/news server and send emails/news articles.
SMTP is capable of handling:
- Simple text e-mails/news articles
- HTML e-mails/news articles
- E-mails/news articles with attachments
- Sign, encrypt mail and MDN
SMTP Bridge uses SMTP protocol for transmission of emails, NNTP protocol for transmission of news articles and AS1 protocol for signing, encrypting mail and MDN request. It uses the SMTP implementation from the JavaMail API and for NNTP, GNU a service provider for NNTP protocol to JavaMail API.
Configuration and Testing
Managed Connection Factory Panel
Figure 1: Managed Connection Factory
The IP address or name of the SMTP mail server/NNTP news server.
The port on which the SMTP server is running on the host specified by the property MailServer IP/Name. Default port for NNTP is 119 and SMTP is 25
The component uses a session (javax.mail.Session) to represent a mail session. A session collects together properties and defaults used by the mail APIs.
- If this option is set to Yes, the default session object (javax.mail.Session) is used to connect to the mail server. If a default is not setup, a new Session object is created and installed as default.
- If this option is set to No, then the default session object is not used and a new session object is created for every connection attempt.
- Authentication required
Specifies whether the connection has to be authenticated by the SMTP/NNTP server. The properties Login Name and Password for authentication are relevant only if Authentication is required. In case of NNTP, new server authenticates users against their preset account ids and passwords. You needs to provide authentication information in order to post news articles to the news server.
- Login Name
The Login Name with which the connection to SMTP/NNTP server is made. The login name specified must be valid with respect to the server whose URL is specified by property MailServer/NewsServer IP/Name.
- Password for authentication
Password for the user as specified by the property Login Name.
- Connection Timeout for mail server
Socket connection timeout value in milliseconds. This is the time duration (in milliseconds) for which the component waits while trying to establish connection with the server. If the component fails to get a valid connection in the specified connection timeout interval, then the retry behavior depends on the configuration specified in Error Configuration Panel. Default value -1 indicates infinite timeout.
- Timeout for sending MIME message
Socket I/O timeout value in milliseconds while sending MIME message. If sending a MIME message requires more time, the current connection will be lost. For example, if attaching a file takes more than the specified timeout period then connection will be timed out by the component. Default value -1 indicates infinite timeout.
- Enable AS1: Select this option to enable AS1 and provide signing, encryption and MDN configuration by clicking the ellipsis button of AS1 SSL Configuration property.
Figure 2: Signature configuration details
- Sign Mail: Select to sign mail and provide algorithm and key store details to be used for signing.
Alias: Host private key alias should be configured.
Figure 3: MDN configuration details
- Request Receipt: Choose whether MDN should be signed or unsigned.
Figure 4: Encryption configuration details
- Encrypt Mail: When this option is selected, mail will be encrypted with the provided algorithm and Keystore details.
Interaction Configurations Panel
Figure 5: Interaction Configurations
Display Name of the Sender
Name of the Sender to be displayed in the mail that is sent using the component.
If the input message has <From> element, its value overrides the display name specified by this property.
Email ID of the Sender
The sender's e-mail ID. This ID must be valid with respect to the server details provided in the Managed Connection Factory Panel.
SMTP component takes the input in XML format as shown below when SMTP protocol is selected.
Figure 11: Input in XML format when SMTP protocol is selected
SMTP component takes the input in XML format as shown below when NNTP protocol is selected.
Figure 12: Input in XML formatwhen NNTP protocol is selected
Descriptions of the elements involved are as below:
- To: Applicable only for SMTP protocol, E-mail ID of the primary recipient(s). For multiple recipients, the e-mail IDs should be separated by comma.
- Newsgroup: Applicable only for NNTP protocol Newsgroup ID/Name of the primary recipient(s). For multiple recipients, the Newsgroup IDs should be separated by comma.
- From: E-mail ID of the sender. The E-mail ID provided here will override the value provided for property Email ID of the Sender in the CPS. This element is optional.
- CC: Applicable only for SMTP protocol, E-mail ID of the CC (carbon copy) recipient(s) to be copied in the e-mail. For multiple recipients, the e-mail IDs should be separated by comma. This element is optional.
- BCC: Applicable only for SMTP protocol, E-mail ID of the BCC (blind carbon copy) recipient(s) to be copied in the mail. For multiple recipients, the e-mail IDs should be separated by comma. This element is optional.
- ReplyTo: Applicable only for SMTP protocol, ReplyTo header field. Comma separated e-mail IDs can be used here.
The ReplyTo field is used by some e-mail programs when the Reply address is different than the From address.
While replying to an e-mail using Reply function, if ReplyTo header was set on the message, then the e-mail client shows the Reply-To field instead of the From field in the To address. This element is optional.
- DispositionNotificationTo: E-mail ID to which a receipt/acknowledgement mail is to be sent back to (from recipients of this mail).
ReturnReceipt: Boolean indicating whether the mail is a normal one or a receipt/acknowledgement mail. If set to 'true', a multi-part report will be generated and sent as acknowledgement mail.
- Subject: Subject of the e-mail. This element is optional.
Headers: The headers provided (name value pairs) are added as Headers in the message. This element is optional.
Attachments: This option is used to send attachments in the e-mail. This element is optional.
The attachment name is the value of the name attribute in the Attachment element.
- Body: Used to specify the e-mail message body. This element is optional.
- TextBody: Sets the given string as the body content with a MIME type of text/plain.
- HTMLBody: Sets the given value as the body content with MIME type text/html.
If the e-mail is sent successfully, then the component sends an XML output with a single element Result.
Figure 6: Sample response
Sending HTML mails with attachment.
Configure the SMTP Bridge as described in Configuration and Testing section and use Feeder and Display component to send sample input and check the response respectively.
Figure 7: Demonstrating Scenario 1 with sample input and output
Figure 8: Mail sent by SMTP Bridge in the Inbox
Use Case Scenario
In an order entry scenario e-mails can be sent to concerned party when a PO is accepted or rejected.
Figure 9: Event Process demonstrating
The Event Process demonstrating this scenario is bundled with the installer.
Documentation of the scenario and instructions to run the flow can be found in the Help tab of the Event Process in Fiorano Studio.
- SMTP component can be used as ESB Alerter when configured with ExceptionListener component to listen for exceptions from all flows.
- If the component is used to connect to a mail server that is SSL enabled, set the value of property 'mail.smtp.ssl.enable' to 'true' in Additional Properties in Connection Configuration.
- If the component is used to connect to a mail server that is SSL enabled and the component is running in-memory, enable SSL in component configuration and provide the truststore location and password. In general, this truststore is %JAVA_HOME%\jre\lib\security\cacerts.