Configuring an External SMTP Host

Oracle Transportation and Global Trade Management service supports customers configuring OTM to send email via their own SMTP server. Doing so alleviates the need to configure SPF/DKIM and the need to create an Approved Sender since the email. The disadvantage of this approach is that there is a greater change of instability because the email traffic is routed over the Public Internet. Transportation and Global Trade Management does not have an automatic retry capability with this approach, so intermittent connectivity issues with the external SMTP server will result in emails failing to deliver. Since this traffic traverses the Public Internet, only authenticated SMTP transport with TLS is supported on Port 587.

In order to use this approach, you will first need to open a Service Request to request the outbound IP Address that will be the source of the mail traffic from the Transportation and Global Trade Management instance. You will need to whitelist the source IP address on your SMTP Server.

Once the whitelisting is complete, add the following properties to the CUSTOM Property Set.
  • glog.mail.smtp.external.host
  • glog.mail.smtp.external.port

For the "host" property, the value must use the following format:

[<user>][/{w<key>][@]<host> 
where:
  • <user> is the mail server user for authentication.
  • <key> is a password wallet key that is used to store the mail server user's password in a wallet.
  • <host> is the SMTP host name.
To set this property in the CUSTOM Property Set:
  1. Choose a name for the password wallet key, i.e. "smtp.external".
  2. Edit the CUSTOM Property Set and add a new property for the SMTP host using the password wallet key, i.e. "glog.mail.smtp.external.host=myuser/{wsmtp.external@host.<YOUR DOMAIN>.com".
  3. Add a new property for the SMTP port, i.e. "glog.mail.smtp.external.port=587".
  4. Save the property set.
  5. Edit the CUSTOM Property Set again and add a new property where the key is your password wallet key and the value is your password, i.e. "smtp.external=PASSWORD".
  6. Save the property set.

On the second save, the password will be properly stored in a wallet, and you should be able to start sending mail.

Note: It is very important that you follow the steps provided exactly. Make sure that you add the "glog.mail.smtp.external.host" property and save the property set before adding the "smtp.external" property. If you added both properties at the same time, it will not work correctly. If needed, delete these two properties and try again.