Page History

...

• The variable names specified are selected to match those used with the JITL MailJob template.
• Note the use of variable names that start with mail.smtp.
  • These variable names correspond to Java properties available with the JavaMail API. Any of the JavaMail properties can be specified.
  • You will find a full list of the available mail.smtp. properties from https://javaee.github.io/javamail/docs/api/com/sun/mail/smtp/package-summary.html
  • Required properties include (but are not limited to):
    • mail.smtp.host
    • mail.smtp.port
  • When using a secure SSL connection note that:
    • to use TLS, the mail.smtp.starttls.enable argument has to be used with the value true, to use SSL, the mail.smtp.ssl.enable argument has to be used with the value true.
    • different ports might be in use: for unencrypted connections port 25 is frequently used, for TLS connections port 465 or 587 is frequently used, for SSL connections port 587 is frequently used.
    • optionally use the mail.smtp.ssl.protocols argument with a value such as TLSv1.2 or TLSv1.1,TLSv1.2 to specify one or more protocol versions that limit handshake with the mail server to the protocol versions specified. Depending on the Java version in use and possible modifications of the java.security file a number of protocols could be enabled that might not match the mail server's capabilities. Typically SSL handshaking starts from the highest protocol version accepted by both parties. However, it is not guaranteed that protocol negotiation will work perfectly. In such a situation it is recommended that the protocol version is specified using this argument.
  • For authentication the following settings are used:
    • the mail.smtp.user setting is assigned the SMTP user account.
    • the mail.smtp.password setting is assigned the password.
  • When using OAuth2 authentication then the following settings are used:
    • the mail.smtp.auth setting is assigned the value true.
    • the mail.smtp.auth.mechanisms setting is assigned the value XOAUTH2.
    • the mail.smtp.user setting is assigned the OAuth2 user account.
    • the mail.smtp.password setting is assigned the OAuth2 access token.
    • Some mail servers such as smtp.office365.com might force require the older SASL mechanism to be used:
      • the mail.smtp.sasl.mechanisms.oauth2.oauthToken setting is assigned the OAuth2 access token.
      • the mail.smtp.password setting is not specified.

...