Mail Palette

The Mail Palette is used to receive incoming emails or send outgoing emails.

TIBCO® Cloud Integration supports the following mail protocols:
  • POP
  • SMTP
TIBCO® Cloud Integration supports the following ports for each protocol:
Protocol Supported Encryption Type
  • Non-Encrypted (use port 25)
  • STARTTLS (use port 587)
  • SSL (use port 465)
  • Non-Encrypted (use port 110)
  • SSL (use port 995)
Refer to the "Open Network Ports for TIBCO® Cloud Integration Apps" topic under the section, Getting Started for a list of ports that are open.

Creating Shared Resources

You must create the following shared resources before using the Mail Palette activities:

Create shared resources from the General tab of the SendMail activity by clicking () icon in your project in TIBCO Business Studio™ and clicking on the Create Shared Resource in the resulting dialog.
  • SMTP shared resource: In addition to configuring the Machine Name, Username, and Password, be sure to change the port number according to the type of connection you want to use. If you want to use TLS, make sure to check the Enable STARTTLS checkbox. To use SSL, check the Confidentiality check box under Security.
  • SSL Client shared resource: Provide specific SSL configurations in the shared resource.
  • Keystore shared resource: Select SUN in the Provider drop-down menu. Provide the location of the JKS truststore. You can enter the relative path within the project for the truststore. Provide the Password and select JKS for the Type.

An Example with Using the Gmail Server

The following example explains the configurations that you must do before you use the Gmail server with the Mail palette:
  • Generate a JKS truststore that contains the Gmail server certificates on your local machine and import the truststore into your project. This is required in order for the Gmail server to authenticate the client (your project). To do so, follow these steps:
    1. Obtain the following Gmail server certificates and copy it into a temporary location on your local machine:
      • Google Internet Authority G2.cert
      • GeoTrust Global CA.cert
      • smtp_gmail_com.cert
      • Trusted Certificate.cert
    2. Using a keystore generating software such as keytool, generate a JKS truststore. Refer to the documentation for the software for details on how to do this.
    3. Import the Gmail server certificates one at a time into the newly created JKS truststore using the same keystore generating software that you used in the previous step.
    4. Import the JKS truststore into your project. See the "Configuring SSL Certificates" topic under Application Development.
  • In your Gmail account, make sure you have the POP and IMAP access enabled. You can do this from the POP/IMAP Download page which is accessed from the Gmail Settings page.
  • In your Gmail account, go to My Account > Sign-in & security > Connected apps & sites and scroll down to the bottom of the page. Turn on the Allow less secure apps option by sliding the button to the ON position.
  • Create all three shared resources listed in Creating Shared Resources above.