Active Roles 7.4.1 - Synchronization Service Administration Guide

Working with Microsoft Office 365

Connections to external data systems > External data systems supported out of the box > Working with Microsoft Office 365

To create a connection to Microsoft Office 365, you need to use Synchronization Service in conjunction with a special connector called Microsoft Office 365 Connector. This connector is included in the Synchronization Service package.

The Microsoft Office 365 Connector supports the following features:

Table 72: Supported features
Feature	Supported
Bidirectional synchronization Allows you to read and write data in the connected data system.	Yes
Delta processing mode Allows you to process only the data that has changed in the connected data system since the last synchronization operation, thereby reducing the overall synchronization operation time.	No
Password synchronization Allows you to synchronize user passwords from an Active Directory domain to the connected data system.	Yes
Secure Sockets Layer (SSL) data encryption Uses SSL to encrypt data that is transmitted between Synchronization Service and connected data system. The Microsoft Office 365 Connector uses cmdlets supplied with Microsoft Azure Active Directory Module for Windows PowerShell to access Microsoft Office 365. For this reason, all traffic between Synchronization Service and Microsoft Office 365 is encrypted using the SSL certificate configured on the Microsoft Office 365 side.	Yes

In this section:

Creating a Microsoft Office 365 connection

Connections to external data systems > External data systems supported out of the box > Working with Microsoft Office 365 > Creating a Microsoft Office 365 connection

To create a new connection

Make sure that the software specified in the System Requirements section of the Active Roles Release Notes is installed on the computer on which you plan to use the Microsoft Office 365 Connector.
In the Synchronization Service Administration Console, open the Connections tab.
Click Add connection, and then use the following options:
- Connection name. Type a descriptive name for the connection.
- Use the specified connector. Select Microsoft Office 365 Connector.
Click Next.
On the Specify connection settings page, use the following options:
- Microsoft Online Services ID. Type the Microsoft Online Services ID with which you want to access Office 365. The Office 365 user account whose ID you specify must have the Global Administrator role and Exchange Online license assigned in your Office 365 organization.
- Password. Type the password for the specified Microsoft Online Services ID.
- SharePoint Online. Select this check box to work with object types and attributes specific to SharePoint Online. For detailed information about these object types, see Objects and attributes specific to Microsoft Office 365 services.
  If you select this check box, use the Administration Center URL text box to enter the SharePoint Online administration center URL.
  
  To use this option, you must install SharePoint Online Management Shell on your computer. For details, see the System Requirements section in the Release Notes.
- Exchange Online. Select this check box to work with object types and attributes specific to Exchange Online. For detailed information about these object types and attributes, see Objects and attributes specific to Microsoft Office 365 services.
- Skype for Business Online. Select this check box to work with object types and attributes specific to Skype for Business Online. For detailed information about these object types, see Objects and attributes specific to Microsoft Office 365 services.
  To use this option, you must install Windows PowerShell Module for Skype for Business Online on your computer. For details, see the System Requirements section in the Release Notes.
- Test Connection. Click this button to verify the specified connection settings.
Click Finish to create a connection to Microsoft Office 365.

Modifying a Microsoft Office 365 connection

Connections to external data systems > External data systems supported out of the box > Working with Microsoft Office 365 > Modifying a Microsoft Office 365 connection

To modify connection settings

In the Synchronization Service Administration Console, open the Connections tab.
Click Connection settings below the existing Microsoft Office 365 connection you want to modify.
On the Connection Settings tab, click the Specify connection settings item to expand it and use the following options:
- Microsoft Online Services ID. Type the Microsoft Online Services ID with which you want to access Office 365. The Office 365 user account whose ID you specify must have the Global Administrator role and Exchange Online license assigned in your Office 365 organization.
- Password. Type the password for the specified Microsoft Online Services ID.
- Proxy server. Specify whether you want to use a proxy server for the connection. You can select one of the following options:
- Use Internet Explorer settings. Causes the connector to automatically detect and use the proxy server settings specified in Microsoft Internet Explorer installed on the Synchronization ServiceSynchronization Service computer.
- Use WinHTTP settings. Causes the connector to use the proxy server settings configured for Windows HTTP Services (WinHTTP).
- Automatically detect. Automatically detects and uses proxy server settings.
- Do not use proxy settings. Specifies to not use proxy server for the connection.
SharePoint Online. Select this check box to work with object types and attributes specific to SharePoint Online. For detailed information about these object types, see Objects and attributes specific to Microsoft Office 365 services.
If you select this check box, use the Administration Center URL text box to enter the SharePoint Online administration center URL.

To use this option, you must install SharePoint Online Management Shell on your computer. For details, see the System Requirements section in the Release Notes.

Exchange Online. Select this check box to work with object types and attributes specific to Exchange Online. For detailed information about these object types and attributes, see Objects and attributes specific to Microsoft Office 365 services.
Skype for Business Online. Select this check box to work with object types and attributes specific to Skype for Business Online. For detailed information about these object types, see Objects and attributes specific to Microsoft Office 365 services.
To use this option, you must install Windows PowerShell Module for Skype for Business Online on your computer. For details, see the System Requirements section in the Release Notes.

Test Connection. Click this button to verify the specified connection settings.
When you are finished, click Save.

Microsoft Office 365 data supported out of the box

Connections to external data systems > External data systems supported out of the box > Working with Microsoft Office 365 > Microsoft Office 365 data supported out of the box

The next table lists the Microsoft Office 365 object types supported by the Microsoft Office 365 Connector out of the box and provides information about the operations you can perform on these objects by using the Microsoft Office 365 Connector.

Table 73: Supported objects and operations
Object	Read	Create	Delete	Update
ClientPolicy Allows you to work with client policies in Skype for Business Online. You can use client policies to determine the features of Skype for Business Online that are available to users. For more information on what data you can read and write, see ClientPolicy object attributes.	Yes	No	No	No
ConferencingPolicy Allows you to work with conferencing policies in Skype for Business Online. You can use conferencing policies to determine the features available to the users participating in a conference. For more information on what data you can read and write, see ConferencingPolicy object attributes.	Yes	No	No	No
Contact Allows you to work with external contact properties in Office 365. For more information on what data you can read and write, see Contact object attributes.	Yes	Yes	Yes	Yes
DistributionGroup Allows you to work with distribution group properties in Office 365. For more information on what data you can read and write, see DistributionGroup object attributes.	Yes	Yes	Yes	Yes
Domain Allows you to retrieve information about domains in Office 365. For more information on what data you can retrieve, see Domain object attributes.	Yes	No	No	No
DynamicDistributionGroup Allows you to work with dynamic distribution group properties in Office 365. For more information on what data you can read and write, see DynamicDistributionGroup object attributes.	Yes	Yes	Yes	Yes
ExternalAccessPolicy Allows you to work with external access policies in Skype for Business Online. For more information on what data you can read and write, see ExternalAccessPolicy object attributes.	Yes	No	No	No
HostedVoicemailPolicy Allows you to work with voice mail policies in Skype for Business Online. For more information on what data you can read and write, see HostedVoicemailPolicy object attributes.	Yes	No	No	No
LicensePlanService Allows you to retrieve information related to the license plans and services that are currently in use in Office 365. For more information on what data you can read and write, see LicensePlanService object attributes.	Yes	No	No	No
Mailbox Allows you to work with Exchange Online mailboxes in Office 365. For more information on what data you can read and write, see Mailbox object attributes.	Yes	Yes	Yes	Yes
MailUser Allows you to work with mail user properties in Office 365. For more information on what data you can read and write, see MailUser object attributes.	Yes	Yes	Yes	Yes
PresencePolicy Allows you to work with presence policies in Skype for Business Online. For more information on what data you can read and write, see PresencePolicy object attributes.	Yes	No	No	No
SecurityGroup Allows you to work with security group properties in Office 365. For more information on what data you can read and write, see SecurityGroup object attributes.	Yes	Yes	Yes	Yes
SPOSite Allows you to work with the properties of site collections in SharePoint Online. For more information on what data you can read and write, see SPOSite object attributes.	Yes	Yes	Yes	Yes
SPOSiteGroup Allows you to work with groups inside site collections in SharePoint Online. For more information on what data you can read and write, see SPOSiteGroup object attributes.	Yes	Yes	Yes	Yes
SPOWebTemplate Allows you to work with Web templates in SharePoint Online. For more information on what data you can read and write, see SPOWebTemplate object attributes.	Yes	No	No	No
SPOTenant Allows you to work with SharePoint Online organization. For more information on what data you can read and write, see SPOTenant object attributes.	Yes	No	No	Yes
User Allows you to read and write user properties in Office 365. For more information on what data you can read and write, see User object attributes.	Yes	Yes	Yes	Yes
VoicePolicy Allows you to read or write data related to voice policies in Skype for Business Online. For more information on what data you can read and write, see VoicePolicy object attributes.	Yes	No	No	No

This section describes the attributes provided by the Microsoft Office 365 Connector. By using these attributes, you can read and/or write data related to a particular object in Microsoft Office 365.

In this section:

ClientPolicy object attributes

ConferencingPolicy object attributes

Contact object attributes

DistributionGroup object attributes

Domain object attributes

DynamicDistributionGroup object attributes

ExternalAccessPolicy object attributes

HostedVoicemailPolicy object attributes

LicensePlanService object attributes

Mailbox object attributes

MailUser object attributes