Introduction
The Office365 (O365) connector is a cloud-to-cloud integration that allows WXP Collaboration to retrieve calendar scheduling data from collaboration rooms and combine it with endpoint data. This enables comprehensive visibility and detailed analysis across your meeting spaces.
This article explains how to set up the O365 connector.
Prerequisite
Global Administrator Access is required. The authorizing user must have Global Administrator access within the Microsoft Office 365 tenant to authorize WXP Collaboration data collection.
Required Scopes
Microsoft is deprecating the Legacy Exchange Web Services (EWS) connection and has introduced an alternative using the Graph API.
The Graph API enables WXP Collaboration to access your O365 tenant using specific permissions called scopes, via an Azure Enterprise Application. After a global admin consents, an application named Office365 GraphAPI Collector is created.
Below are the scopes requested by WXP Collaboration during authorization.
| Scope | Permission | Microsoft Reference |
|---|---|---|
| Calendars.Read | Allows WXP Collaboration to read calendar events. | Link |
| Directory.Read.All | Allows WXP Collaboration to read data in your organization's directory, such as users, groups, and apps. | |
| Place.Read.All | Allows WXP Collaboration to read company places (conference rooms and room lists) for calendar events. | Link |
| User.Read | Allows WXP Collaboration to sign-in to the app, and allows the app to read the profile of the signed-in users. It also allows the app to read basic company information of sign-in users. | Link |
| User.Read.All | Allows WXP Collaboration to read users profiles. | Link |
Optional: Room Distribution List in O365
WXP Collaboration Workspace Insights uses a room distribution list to identify which room resources are queried for scheduled meeting data. Typically, these include only rooms with managed endpoints.
For instructions on creating a room distribution list, see:
How To: Create a Room Distribution List for Workspace Insights with O365
Distribution Lists or O365 Groups are not supported and will not work.
O365 Integration Setup
To begin collecting O365 data, you must add the O365 Collector to your existing data collector.
-
Log in to your WXP Collaboration account. (Admin privileges required.)
-
From the Product Selection menu, go to the Admin Portal.
-
On the Admin Portal page, select Infrastructure > New Infrastructure.
From the list of infrastructure options, click Microsoft Office 365.
Your list may differ depending on your configuration. -
Select the appropriate Calendar option and complete the required fields under Office365 Host Details.
Add the Room Distribution List Details
If you plan to use a Room Distribution List to sync rooms to Workspace Insights, complete the following fields:
- User Agent: This is a legacy Microsoft requirement. Enter any valid email address (e.g., WXPCollab-svc@customer.com).
- Room (Distribution) List Address: Enter the email address of the room distribution list created earlier.
Multiple addresses must be comma-separated.
O365 Authorization
When adding an Office365 system requiring OAuth authorization, follow these steps:
-
On the New Infrastructure page, scroll to O365 Authorization and expand the section.
-
Click CLICK TO AUTHORIZE.
-
When the Microsoft login is prompted, sign in with the credentials of a user with the Global Admin role.
-
After signing in, a confirmation box is displayed.
If the confirmation box does not appear, the selected user does not have the Global Admin role.
- Once authorization is successful, validate the connection.
Validation may take up to two hours due to Microsoft replication delays.
Click Save to apply your changes.
Optional: Limit Mailboxes Accessible by WXP Collaboration
WXP Collaboration limits its data collection to Room Mailboxes by default. However, for stricter access control, you can configure Microsoft to limit access to specific Exchange Online Mailboxes.
For more information, see:
Limiting application permissions to specific Exchange Online mailboxes
What WXP Collaboration Collects from Mailboxes
WXP Collaboration collects the following data from mailboxes:
- Meeting subject (only if meeting is not marked as Private)
- Meeting start time and end time
To revoke WXP Collaboration’s access to this data, see:
How to disable viewing access of your data to WXP Collaboration Support
Contact Us
For any assistance, create a support case or email support@wxp.hp.com.