Applies to: version 2.9.1 and earlier.
This article describes the requirements and steps required to configure a the Mimecast Synchronization service account for Office 365 environments.
For Office 365 the user that is selected to run the Mimecast Synchronization Engine service needs to be mailbox enabled and have permissions to access the mailboxes hosted in Office 365. This is configured by,
- Create / select a user to run the Mimecast Synchronization Engine service in Office 365.
- Apply the Full Access mailbox permission for the service account user in order to be able to access the Office 365 mailboxes.
- On a workstation or server of your choice, start Windows PowerShell
- Set your Office 365 admin credentials using this command:
$cred = Get-Credential
- Import the Office 365 cmdlets using this command:
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid -Credential $cred -Authentication Basic -AllowRedirection
- Finally import these cmdlets in to your local session using this command:
- Once connected you can configure the mailbox permissions for mailbox that you created / selected in step 1 using this command:
Get-Mailbox -ResultSize unlimited | Add-MailboxPermission -User email@example.com -AccessRights fullaccess -InheritanceType all
Where firstname.lastname@example.org is the primary SMTP address of the user that you created / selected in step 1.
- Microsoft best practice recommends to disconnect a PowerShell session from Office 365 once you have completed your tasks. This is done using this command:
Remove-PSSession $SessionWhere $Session is the name of the variable used to create the session.
Observations: Mimecast has noticed the following Exchange / Office 365 behaviors when configuring these permissions:
- The PowerShell Script Execution Policy should be set to unrestricted on the workstation being used to configure these permissions.
- Once applied the permissions can take up to 6 hours to propagate through Office 365.
- When new users are added to Office 365 these steps will need to repeated to ensure that the Mimecast Synchronization Engine can access the newly added mailboxes.
Setting the Service Account
Once the Mimecast Synchronization Engine is installed the service account should be set using the Site Configure utility. To do this follow these steps:
- Open the Site Configure Utility from Start | Programs | Mimecast Synchronization Engine
- Navigate to the Accounts Tab.
- Use the button to the left of the User Name text box to launch a Windows account picker dialog box.
- Type the name of the user account to set as the service account and click OK. This can be a local machine or Active Directory domain user.
- Type the password for the user account.
- In the Microsoft Mailbox section type the primary SMTP address of the user created / selected in step 1 of the Exchange Permissions section above.
- Type the password of the Microsoft Mailbox.
- Change the Directory | Type to the Microsoft Office 365 Directory and click Apply.
With the service account configured you are now ready to bind your Mimecast Synchronization Engine site to Mimecast. To learn more about this please see [LEGACY] Binding the Mimecast Synchronization Engine.