Incoming E-Mail Provider Properties

Location: Available from the Messaging Setup Window

An Incoming E-Mail Provider allows adTempus to connect to e-mail inboxes for E-Mail Triggers and E-Mail Processing Tasks. Each Provider represents a connection to a POP3 or IMAP server, using a particular set of login credentials.

If you need to monitor more than one mailbox (i.e., log on using more than one user account), you must create a separate Provider for each account.

Property Pages

Provider

Provider Name

Enter a unique, descriptive name for this provider. For example, "Automation Trigger IMAP account."

Server Name or Address

Enter the name or IP address for the mail server.

If you change the name or address for an existing provider definition that uses IMAP, adTempus will ask you whether to reset the seen-message tracking information for e-mail triggers and e-mail processing tasks that use this provider. adTempus uses this information to avoid processing messages more than once. This information is specific to each IMAP server, so using the tracking information from one server when connecting to a different server may cause adTempus to miss new messages or to reprocess old messages.

  • If this the name or address has changed but it is still the same e-mail server, choose No to keep the existing tracking information.
  • If you are changing the provider to point to a different IMAP server, choose Yes to reset the tracking information so that adTempus will select the correct messages going forward. For example, if you have changed your e-mail from one service provider to another, or migrated from on on-premises server to an off-premises server, you would select Yes to reset the tracking information.

Server Port

Enter the port number, or leave blank to use the default port for the server type.

If you are using a mail server such as Gmail that requires a secure connection, you must specify the correct port number:

  • Secure POP3 (SSL-POP): 995
  • Secure IMAP (IMAP4-SSL): 585
  • IMAP4 over SSL (IMAPS): 993

Server Type

Select the type of server: POP3 or IMAP.

Authentication

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]").
  • OAuth. Choose this option to authenticate using OAuth, if supported by your email provider. See below for more information.
Authentication using OAuth

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

For some mail providers adTempus supports authentication using the OAuth protocol. When you authorize using OAuth, 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 OAuth:

  1. Select OAuth for the Authentication Type.
  2. Click the OAuth Configuration button6.0Server version 6.0 or later
    Console version 6.0 or later     to open the OAuth Configuration window. Here you select your mail provider and, if needed, specify your own application registration. (If you click Authorize without selecting a provider, this window is displayed first.)
  3. If you selected Other provider using OAuth, enter the mailbox login (usually the email address) in the User (Account) Name field. For other providers the account name is filled in automatically when you authorize.
  4. 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. When you have finished, return to adTempus.

OAuth is supported for the following providers:

  • Microsoft (Microsoft 365, Office 365, Outlook.com, Exchange Online, etc.)
  • Google (Google Workspace and Gmail)6.0Server version 6.0 or later
    Console version 6.0 or later
  • Other mail providers that support OAuth6.0Server version 6.0 or later
    Console version 6.0 or later

Test

Click the Test... button to verify that adTempus can connect to the server using the settings you have provided. If adTempus is unable to connect it will display an error message with the reason.

Security

The Security page contains a standard Security Editor that allows authorized users to manage the security for this Provider. Permission to create new providers is controlled through the Notification Recipient Security options.

Related Topics

Messaging Setup Window