Microsoft Exchange

Required Exchange Permissions

Feature

On-Premise

Online

crawling all inboxes

Permissions required:

Mailbox Search
ApplicationImpersonation

Note: The username configured with this permissions needs to be added to the username field in the source settings file and that users password added in the password field.

Permissions required:

Mailbox Search

Note: The username configured with this permissions needs to be added to the username field in the source settings file.

crawling public folders

Permissions required:

Public Folders

Note: The username configured with this permissions needs to be added to the public-folder-access-email field in the source settings file.

Permissions required:

Public Folders

Note: The username configured with this permissions needs to be added to the public-folder-access-email field in the source settings file.

We strongly recommend creating a new role group in Exchange for managing Shinydocs software with the recommended permissions.

Source Settings for Exchange On-Premise

Example source setting file for crawling Exchange On-Premise:

CODE

{
	"comments": [
		"Please don't forget to encrypt your sensitive fields with the cognitive toolkit",
		"Set auth-type to 'up' for username and password ",
		"Set auth-type to 'app' for azure application authentication"
	],
	"sourceType": "Exchange",
	"sourceConnectionSettings": {
		"auth-type": "up",
		"username": "username with the required permission of Mailbox Search and ApplicationImpersonation enabled",
		"password": "my-password",
		"exchange-url": "https://<exchange-server>/ews/exchange.asmx",
		"app-id": "",
		"secret-key": "",
		"tenant-id": "",
		"public-folder-access-email": "username with the required permission of Public Folders enabled"
	}
}

Source Settings for Exchange Online

Example source setting file for crawling Exchange Online:

CODE

{
	"comments": [
		"Please don't forget to encrypt your sensitive fields with the cognitive toolkit",
		"Set auth-type to 'up' for username and password ",
		"Set auth-type to 'app' for azure application authentication"
	],
	"sourceType": "Exchange",
	"sourceConnectionSettings": {
		"auth-type": "app",
		"username": "username with the required permission of Mailbox Search enabled",
		"exchange-url": "https://outlook.office365.com/ews/exchange.asmx",
		"app-id": "my-app",
		"secret-key": "my-secret",
		"tenant-id": "my-tenant",
		"public-folder-access-email": "username with the required permission of Public Folders enabled"
	}
}

Download

Download the Microsoft Exchange Settings pdf:

Microsoft Exchange Settings.pdf