Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The JS7 can be configured to send JS7 - NotificationNotifications by mail in the event of either successful or failed execution of jobs and workflows. In addition, the JS7 - JITL Mail Jobs can be used to send mail. A number of errors can indicate that the mail server connection does not work:

...

Should the Root CA Certificate is not be available from the above location then it can be specified like this:

...

Should verification of the mail server certificate fail, for example in the case of selfPrivate CA-signed certificates, then users can:

...

SettingValue
mail.smtp.authtrue
mail.smtp.user<account@domain><account>@<domain>
mail.smtp.password<password>

...

OAuth2 Authentication E-Mail Settings

OAuth2 authentication with mail servers allows to use an access token instead of a password:

  • Display feature availability
    StartingFromRelease2.5.2
  • For earlier versions of JS7 see the section Workaround of the following change for instructions how to update to a newer version of JavaMail that allows OAuth2 authentication:
    Jira
    serverSOS JIRA
    columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
    columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
    serverId6dc67751-9d67-34cd-985b-194a8cdc9602
    keyJOC-1456

The following settings can be used:

SettingValueHint
mail.smtp.authtrue
mail.smtp.auth.mechanismsXOAUTH2
mail.smtp.user<account>@<domain>
mail.smtp.password<oauth2-access-token>
mail.smtp.sasl.mechanisms.oauth2.oauthToken<oauth2-access-token>

some mail servers such as smtp.office365.com might force the older SASL mechanism to be used

  • This setting is assigned the OAuth2 access token.
  • The mail.smtp.password setting is not specified.

Anchor
logging
logging
Logging

Error messages are raised by the JOC Cockpit JS7 - Monitor Service when sending mail. They can be found in the service-monitor.log fileError messages are raised by the JOC Cockpit JS7 - Monitor Service when sending mail. They can be found in the service-monitor.log file, see JS7 - Log Files and Locations.

...

AreaSettingValueComment
Connectionmail.smtp.host<mail server host or IP address>

mail.smtp.port25587

mail.smtp.starttls.enabletrueAllow SMTP over TLS

mail.smtp.ssl.enablefalseDeny SMTP over SSL
Protocol Versionmail.smtp.ssl.protocolsTLSv1.2Specify the agreed-on protocol version
Authenticationmail.smtp.authtrueUse if mail server requires authentication

mail.smtp.user<account@domain>

mail.smtp.password<password>

...