What's Provided

Exchange is a common email interface used by many organizations. We get email, contacts and calendar meetings from Exchange.

Connecting

There are multiple options for connecting your Exchange services to SigParser. They depend on how you're using SigParser.

If you have an entire team of people using SigParser, you'll likely want to setup a single Exchange connection for the entire team which doesn't expire credentials. There are two options in this case. Either Impersonation account or a Delegated access account.

Individual MailBox for Individual Users

If you're just going to connect your Exchange account to SigParser to get all your data in SigParser, the easiest way is to go to Settings -> Data Sources -> Outlook/Exchange. Enter your credentials.

Unfortunately if your Exchange account credentials are changed every 90 days or on some other schedule like many organizations require, you will need to login to SigParser and fix this. SigParser will email you each time we are unable to connect to your Exchange server.

Exchange Delegated Access

Delegated access grants a user account access to another user or multiple user's email accounts. This is good when you don't want to setup your entire organization in SigParser.

Unfortunately this means each time you want to add another user mailbox to be monitored by SigParser, you have to touch both Exchange and SigParser.

  1. In Exchange create a new user for “SigParser”
  2. In Exchange go each each of the mailboxes SigParser will need to be able to access and send emails through.
    1. If in Office 365 go to the “Mailbox Delegation” section
    2. Add the special “SigParser” user to the “Full Access” permission.
  3. Login to SigParser -> Settings -> Data Sources -> Outlook/Exchange -> Enter new delegated user
  4. Go back to the Data Sources page and click the "Advanced Settings" for the Exchange connection and change the mode to "Delegated".
  5. Add each of the inboxes SigParser will check. This should be the full email address. Set the Accessible By permission to the users who should have access to the mailbox contents.

Online tutorials for different versions:

Office 365

Youtube: Configure Mailbox Delegation in Exchange 2010

Exchange Impersonation

Exchange Impersonation approach you can configure one Exchange account to access all mailboxes for an entire organization. This is nice if you know you want to monitor every employee and makes adding new mailboxes as simple as just adding them mailbox to the list in SigParser instead of having to touch both Exchange and SigParser for each new mailbox monitored.

To use impersonation

  1. In Exchange create a new "Admin" role
  2. In Exchange, assign to the new role the “ApplicationImpersonation” management role.
  3. In Exchange, create a new user for SigParser and assign that user the new role you just created which allows impersonation.
  4. Login to SigParser -> Settings -> Data Sources -> Outlook/Exchange -> Enter new impersonation user
  5. Go back to the Data Sources page and click the "Advanced Settings" for the Exchange connection and change the mode to "Impersonation".
  6. Add each of the inboxes SigParser will check. This should be the full email address. Set the Accessible By permission to the users who should have access to the mailbox contents.

Data Update Frequency

SigParser uses two mechanisms to get data from Exchange. Once per day it will connect to each Exchange mailbox and pull down the latest emails, contacts and meetings.

If using Exchange Server 2010 or higher, SigParser will also setup an Exchange webhook subscription so that as soon as an email arrives or a meeting is updated, SigParser will receive that update. Typically the delay is 2 - 5 seconds for the meeting or email to show up in SigParser.

Security Considerations

The users listed under "Accessible By" for an Exchange Mailbox will have access to any contacts, emails, calendar meetings or attachments which are in that mailbox. So it is important to only grant access to this mailbox to the owner and whoever needs to

Email Sending Permissions

The email addresses a user can send as come from the Exchange mailboxes they are listed on as "Accessible By".