3️⃣Importing Old Email
Importing the old mail into the archive via the Mailbox Reader service.
What is Mailbox Reader?
Mailbox reader allows you to import old mail directly from your mail server directly into the archive. The Mailbox Reader is configured in two parts. Firstly, by creating a connection to a mail server system and then by adding user mailboxes to read from that connection.
Configuring a Mailbox Reader Connection
Go to Mailbox Reader > Connection Settings
The Connection Settings section allows Administrators to configure the settings to setup a Mailbox Reader Connection. You need to create a connection before importing user accounts.
The protocol you wish to use for accessing and reading from the mailboxes will depend on the mail server. Recommendations for protocol:
For Exchange 2007 onwards, use EWS (Exchange Web Services). This is a powerful facility and is becoming more efficient and effective with later Exchange releases.
For most other mail sources, use IMAP (Exchange 2003 / Gmail / Hotmail / etc.)
Use POP3 as a last resort.
MSGraph
Then you will need to discover the server from which to access the mailboxes. For Exchange, the CAS server is usually preferred – as this offers the IMAP (if enabled) and EWS web services. For EWS you MUST enter the correct server host name – it must match the services’ certificate and standard URL. Please note: If this is not correct, EWS will not authorise the connection and errors.
For IMAP/POP3, you will generally use the service names that are well documented by the various mail vendors
EWS is the recommended method for mail extraction from an on-premises Exchange system.
MSGraph is the recommended method for mail extraction from Microsoft Exchange Online(Office365).
Some Mailbox Reader settings are only visible when a particular protocol is selected and these are noted in the description for that setting.
Configuring a Mailbox Reader Connection with MSGraph Protocol
Prerequisite: OAuth Connection details. To create an OAuth Connection, please see the documentation here.
Within your OAuth connection, the following fields should be set.
Protocol field should be
MSGraph
Server field should be
outlook.office365.com
OAuth connection field should default to Microsoft Office 365
Tenant ID
is global identifier for office 365 account
To create a Mailbox reader with MSGraph Protocol, please follow the below guide.
Navigate to Mailbox Reader > Connection Settings.
Click the Create Connection button.
Enter / Select the required values in the fields. Refer to the table below for field names and descriptions.
Click the Save Connection button.
The mailbox reader connection settings will be configured successfully.
Note: Hover your mouse on the field names for additional information and / or example values.
Please see the table of below values and explanation of each field.
Last updated