Using SMTP Credentials and using TLS connection to SMTP Server with MFT Platform Server for Unix

Using SMTP Credentials and using TLS connection to SMTP Server with MFT Platform Server for Unix

book

Article ID: KB0071378

calendar_today

Updated On:

Products Versions
TIBCO Managed File Transfer Platform Server for UNIX 8.1.1 HF-006

Description

This article describes how to send email notifications in a secure authenticated mode.

Issue/Introduction

Using SMTP Credentials and using TLS connection to SMTP Server with MFT Platform Server for Unix

Environment

All supported environments

Resolution

The ability to send email notifications in a secure authenticated mode was added in Platform Server for Unix HF-006. The following parameters must be added to the config.txt file COMMON section:
 
         SMTPTLS:                  No                 { Yes, No, StartTLS }
    SMTPTrustTLSCertificates: No                 { Yes, No }
    SMTPUserCredentials:      No                 { No, $$SMTPUSER }
 
SMTPTLS:
Yes - use implicit TLS connection to SMTP Server;
No - use plain tcp connection to SMTP Server;
StartTls - connect to SMTP Server via plain tcp.  Switch to TLS mode using the StartTls command after the TCP connection to SMTP server is established.
 
SMTPTrustTLSCertificates:
Yes - trust the SMTP TLS Certificate without verifying that the SMTP Server TLS certificate is in the "TrustedAuthorityFileName" file.
No - verify SMTP Server TLS certificate. SMTP Server TLS certificate must be added to the "TrustedAuthorityFileName" file.
 
SMTPUserCredentials:
No - do not authenticate mail requests to SMTP Server. ( typically for plain tcp connections. However plain tcp can require auth as well. TLS connections might not require auth )
$$SMTPUSER - use SMTP uid and pwd from cfprofile.cfg file.
 
Use this cfprofile command to define the SMTP credentials by adding a user profile for user $$SMTPUSER and node $$SMTP.
Sample Command:
cfprofile n:'$$SMTP' lu:'$$SMTPUSER' u:smtpuser p:smtppassword
 
The following TLS config.txt parameters are utilized as well:
 
TrustedAuthorityFileName
Defines the trusted authority file used to validate certificates when  SMTPTrustTLSCertificates is set to "No".
 
Ciphers
Defined the ciphers used when establishing TLS connections.