Page History
...
- Required arguments include the
mail.store.protocol
which specifies whetherimap
orpop3
should be used. - All other arguments are optional provided that a Job Resource is used which specifies the connection details to the mail server, see below. Otherwise individual settings such as the IMAP/POP3 host, IMAP/POP3 port etc. have to be specified from arguments.
- When using a secure SSL connection consider that:
- for to use of TLS the , the
mail.imap.starttls.enable
argument has to be used specified with the valuetrue
, for to use with SSL SSL, themail.imap.ssl.enable
argument has to be used specified with the valuetrue
. - different ports might be in use: for unencrypted connections and for TLS connections port 143 is frequently used, for SSL connections port 993 is frequently used.
- optionally use the
mail.imap.ssl.protocols
argument with a value such asTLSv1.2
orTLSv1.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 thejava.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 to use of TLS the , the
- Select the check box provided with each argument if you want this argument to be added to the arguments of the MailInboxJob.
...
- The variable names specified should match arguments available with the JITL
MailInboxJob
template. - Consider use of variable names that start with
mail.store.
,mail.imap.
,mail.pop3
, etc.- Names of variables correspond to Java properties available with the JavaMail API. Any of the JavaMail properties can be specified.
- You will find a full list of available
- general mail settings from https://javaee.github.io/javamail/docs/api/javax/mail/package-summary.html
mail.imap.
properties from https://javaee.github.io/javamail/docs/api/com/sun/mail/imap/package-summary.htmlmail.pop3.
properties from https://javaee.github.io/javamail/docs/api/com/sun/mail/pop3/package-summary.html
- Required properties include (but are not limited to):
mail.store.protocol
mail.imap.host
mail.imap.port
mail.imap.user
mail.imap.password
- Optional properties include (but are not limited to):
- For authentication the following settings are used:
- the
mail.imap.user
setting is assigned the IMAP user account. - the
mail.imap.password
setting is assigned the password.
- the
- When using OAuth2 authentication then the following settings are used:
- the
mail.imap.auth
setting is assigned the valuetrue
. - the
mail.imap.auth.mechanisms
setting is assigned the valueXOAUTH2
. - the
mail.imap.user
setting is assigned the OAuth2 user account. - the
mail.imap.password
setting is assigned the OAuth2 access token. - Some mail servers such as smtp.office365.com might require the older SASL mechanism to be used:
- the
mail.imap.sasl.mechanisms.oauth2.oauthToken
setting is assigned the OAuth2 access token. - the
mail.imap.password
setting is not specified.
- the
- the
- For authentication the following settings are used:
Assigning a Job Resource for Mail Settings
...
The MailInboxJob can be used with a credential store to hold sensitive arguments. For use of the credential_store_*
arguments see JS7 - Use of Credential Store with JITL Jobs.
Further Resources
Links
...
Overview
Content Tools