Welcome > Connection Tasks menu > Connection configuration window > Mailbox settings window

Mailbox settings window

Use this window to add or edit connections to an IMAP, POP3, EWS or MS Graph mailbox.

Display name

A descriptive and unique name for this mailbox.

Poll cycle in seconds

How often should Kofax Import Connector check for new documents on the mail server. The maximum value is 86400 seconds, that is, 24 hours.

Host

For POP3 or IMAP, the host name or IP address of the mail server, such as pop3.gmail.com.

For Exchange Web Services, the URL of the EWS endpoint in the following format:

https://host[:port]/ews/exchange.asmx

Protocol

The protocol for connecting to your mail server: IMAP, POP3, EWS or MS Graph.

Client ID

For MS Graph, the client/application ID which is generated after registering the application in Microsoft Azure Active Directory.

Poll mail box
For IMAP/EWS only, a mail box folder name to poll the mails from a folder.
Note The path delimiter in a mailbox folder path may vary with the protocol selected and the mail server in use. Use the path delimiter which is applicable to your environment, such as Inbox.Subfolder1.Subfolder2, Inbox/Subfolder1/Subfolder2.
Poll sub folders
If selected, polls all the subfolders under the selected mail box folder.
Note

  • To poll a public folder's sub folder for EWS, include at least one subfolder in the folder, such as Public Folders\xyz and All Public Folders/TestPublicFolder01. It is necessary to specify the applicable root public folder name, such as Public Folders\xyz and All Public Folders in the path.

  • MS Graph does not support polling of public folders on an Exchange Server. To poll public folders on an Exchange Server, use EWS.

  • For IMAP, polling of sub folders in a multi-instance mode is not supported.

Keep messages on server

If selected, does not delete the processed messages from the mail server, but moves them to another folder. For an existing subfolder, the processed messages can be moved to a subfolder as well.

Note This option is only available for IMAP and EWS.

Enable Impersonation

If selected, enables impersonation for EWS connections. Make sure that you provide appropriate User name.

Enable NTLM

If selected, enables authentication using NTLM. This option is only available for EWS connections.

Processed folder name

The name of the folder for processed messages. This option is only available for IMAP/EWS and if you select to keep messages on server.

Mode

For IMAP/EWS only, select whether the same inbox can be polled by multiple Message Connectors simultaneously.

  • Single Instance: Allows polling this mailbox with only one Message Connector. Using this value and running multiple connections in parallel may import the same message multiple times to Kofax Capture.

  • Multiple Instance: Allows multiple connections to a single mailbox, without risking duplicate imports.

    However, not all IMAP servers support this option. To verify whether this option is available for your IMAP server, use Test Mailbox.

    Note For IMAP, you can only poll the inbox in a multiple instance mode.
SSL

A security option, if the mail server supports it.

Port

The port number to use to connect to the mail server. The default port numbers include:

  • POP3 - 110

  • secure POP3 (SSL-POP) - 995

  • IMAP - 143

  • secure IMAP (IMAP4-SSL) - 585

  • IMAP4 over SSL (IMAPS) - 993

  • EWS - 80

  • secure EWS - 443

Note The email providers might use different ports.

User name

The name of the mailbox. For EWS connections, do one of the following:

  • To enable impersonation, configure the user credentials in one of the following formats:

    • domain\user\mailbox

    • \user@domain.com\mailbox@domain.com

    • domain\user@domain.com\mailbox@domain.com. In this case, the domain parameter is ignored as the domain information is retrieved from the user@domain.com parameter.

    Where, domain is the domain name, user is the user having impersonation rights, and mailbox is the name of the mailbox to access. The mailbox can be a user's mailbox or a service account's mailbox.

  • To access shared mailbox (except Microsoft Office 365), configure the user credentials in one of the following formats:

    • DOMAIN\user\SharedMailbox@domain.com

    • \user@domain.com\SharedMailbox@domain.com

    • DOMAIN\user@domain.com\SharedMailbox@domain.com. In this case, the DOMAIN parameter is ignored and domain.com is used.

    • DOMAIN\user\SharedMailbox. This is only applicable if DOMAIN = domain.com.

    Where, DOMAIN is the domain name, user is the user to provide shared mailbox access, and SharedMailbox is the name of the shared mailbox to access.

  • To access Microsoft Office 365 shared mailbox, configure the user credentials in one of the following formats:

    • DOMAIN\user@domain.com\SharedMailbox@domain.com

    • \user@domain.com\SharedMailbox@domain.com

    • user@domain.com

    Where, DOMAIN is the domain name, user is the user to provide shared mailbox access, and SharedMailbox is the name of the shared mailbox to access.

Password

The password for the mailbox.

Note

  • Do not use angular bracket (<, >) characters in your Exchange Server password as it will cause a connection failure with the mailbox.

  • By default, this field is always displayed as blank.

    When editing the mailbox settings, provide the password only if it is changed. Once you enter the new password and save the mailbox settings, password provided here will override the stored password.

Test Mailbox

Lets you verify that Kofax Import Connector can connect to the specified mailbox.