Configure the Mail Transport Connector

jhmase: Sender config needs upgrade - default mail sender

The mail transport connector makes it possible to use IFS Applications using SMTP and POP3 protocol. 
With an ordinary email client, a user can create an email message in any format and send it to the IFS Connect configured mailbox. 
The Mail Sender makes it possible to send mail in different formats using SMTP protocol.

Contents

• Setting up the Mail sender
• Starting up the Mail reader
• How to create new instances of the Mail connector
   

Setting up the Mail sender

1. Setup the mail sender parameters
   Setup the configuration parameters for the MAIL_SENDER1.
   
   For explanation and help about the parameters, see the quick help which is displayed as a tool tip for every parameter.
   
   
          
2. SMTP authentication
   If your SMTP server requires authentication, check PERFORM_SMTP_AUTH and specify user name and password.
   
   
3. Mail Server and SSL
   If the SMTP connection is secured by SSL, check USE_SSL check box and specify user name and password.
   Certificates:
   If any third party mail servers that requires ssl is being used you probably do not need to care about the cerificate, but in case the certificate is not trusted, the mail reader will not be able to establish a connection to the mail server. To mark a certificate as trusted you need to get hold of the actual certificate and import it to the keystore using the keytool command.
   Trust a certificate:
   This guide assumes you already have obtained a copy of the certificate from a safe source. There are ways to obtain the certificate by other means but this is not recommended and beyond the scope of this guide.
   1. To trust a certificate you need to use the keytool command supplied with the JDK. You will need to locate the JDK used during runtime by your application server.
      You can choose to create a new truststore or use the cacerts that comes with the java installation.
      Example:
      <java_home>/bin/keytool -import -alias <certificate-alias> -file <certificate.cer> -keystore <truststore> -storepass <thePassword>
      Where:
      -alias: Is the alias of the mail certificate (can be whatever you wish but use a descriptive name)
      -file: The certificate file
      -keystore: The keystore you want to put it in. If you choose to use a new truststore you do not need to give the -storepass argument. If you do, however, this will be the password for the new truststore. If you rather use cacerts storepass it is located in <java_home>/jre/lib/security.
      -storePass: Is the password to the truststore. (The default password for cacerts is 'changeit' or 'changeme' depending on the platform.)
   2. The keytool command will print out the certificate information including the fingerprint and ask you to verify it. You should verify this fingerprint by comparing it with the original certificate before adding it to the truststore. You can check the fingerprint of a certificate using the -printcert command.
      Example:
      keytool -printcert -file <certificate>
      If the fingerprint is OK, add it and you should see a confirmation that the certificate has been added successfully.
   
   

Starting up the Mail reader

1. Configure the Transport Connector Server to run the Mail Connector reader
   Add the MAIL_READER1 instance name in the CONNECT_SERVER1 configuration.
   
   
    
2. Setup the mail reader parameters
   Setup the configuration parameters for MAIL_READER1.
   The RESPONSE parameter controls if a mail response should be sent with the result of the execution.
   The PARSE_BODY parameter enables the reader to read messages that is sent in the body. Normally a message is sent as an attachment.
   
   For explanation and help about the other parameters, see the quick help which is displayed as a tool tip for every parameter.
    

   WARNING: You should not use your own mail account for the mail reader. You will  get errors that result in a large number of replies to many people who may have sent you mail. It is recommended that you set up a separate mail account to be used only for the mail reader connector. 

   
   
   
   
   

3. Restart the CONNECT_SERVER1.
    

How to create new instances of the Mail Connector

It's possible to create new instances of the Mail Reader Transport Connector provided that they should poll distinct mailboxes (Only one Mail Reader can poll a mailbox).

Instructions for how to create a new connector instance.