SMTP Server Properties

Location: Available from the Messaging Setup Window

An SMTP server is a server used to send e-mail messages. Your mail server may be internal to your organization or it may be hosted elsewhere (such as a Gmail server).

Description

Enter a name or brief description for this server, such as "Primary mail server" or "Corporate mail server."

Enabled

Clear this box to disable the server. adTempus will not send messages through this server while it is disabled.

Server Name or Address

Enter the DNS name or IP address of the server. If the mail server runs on the same computer as adTempus, use 127.0.0.1 as the address.

Port

Enter the port that the SMTP server is listening on. Most servers use the default port, which is 25. Leave this box empty to use the default, or specify a value if you server uses a different port.

If you are using a mail server such as Gmail that requires a secure connection, you must specify port 465 (SSL) or 587 (for TLS).

Return Address for Messages

Specify the return address to use on e-mail messages sent to the server. The address must be specified, and must be a valid address. Your mail server will reject messages that do not have a valid return address.

Sender Display Name

The display name to use in the return address. By default messages will use "adTempus on servername" (where servername is the name and instance name of the adTempus server) as the name of the sender. If you want to use a different name, specify it here. If you include the token %servername%, adTempus will replace that with the name of the adTempus server (and the instance name, if other than the default).

You can specify different return addresses for different jobs in any of the following ways:

Set the E-Mail Sender options in a Notification Task or Notification Action.
Set the NotificationFromName and/or NotificationFromAddress Job Variables for a job, group, queue, step, etc. You can do this either through the properties window for the job, group, etc., or by running a script within the job.

Maximum Size for Messages

Set the maximum message size allowed by the mail server. If a notification message exceeds this size due to the length of the message text, adTempus will truncate the message text. If message attachments cause the message to exceed this length, adTempus will selectively exclude attachments from the message to keep it within the size limits (a notice will be appended to the message indicating which attachment(s) have been dropped).

If you are sending notification messages that include attachments, it is important to set this value correctly to ensure that notification messages are not rejected by your mail server for being too large.

Authentication

Most SMTP servers will require authentication. If you are unsure, check with your mail system administrator if you are unsure regarding these settings.

Select the type of authentication required by your mail server.

None. Choose this option if the mail server does not require authentication, which is unlikely. Note that if your mail server ordinarily authenticates you automatically based on your Windows login identity, this will not work with adTempus, because the connection to the mail server will not be made under your identity. You will need to specify credentials.
User ID and Password. Choose this option to authenticate using a user ID and password. Generally the User ID will be your complete e-mail address (e.g., "[email protected]").
OAuth2. Choose this option to authenticate using OAuth2, if supported for your email provider. See below for more information.

Authentication using OAuth2

Version Compatibility: Server version 4.9 or later Console version 4.9 or later.

For some mail providers adTempus supports authentication using the OAuth2 protocol. When you authorize using OAuth2, your login credentials are not stored (or entered) in adTempus. Instead, you authorize adTempus to access your account, and adTempus stores an access token. You can revoke access at any time through your mail account.

To use OAuth2, select your mail provider from the list and click the Authorize button. adTempus will launch your Web browser and take you to the login or authorization page for your mail provider. Here you must authorize adTempus to access your email account.

OAuth2 is supported for the following providers:

Microsoft (Microsoft 365, Office 365, Outlook.com, Exchange Online, etc.)

Support for Google (G Suite and Gmail) will be added soon. Please contact us if you need support for other mail providers.

Test...

Click the Test... button to send a test message using the settings you have provided. If adTempus is unable to send the test message it will display an error message with the reason.