Office 365 Reports¶
The Office 365 Reporting web service integration allows for ingestion of tracking and analysis of a variety of metrics and analytics from your Office 365 environment. The integration currently, supports MessageTrace reports which provide a summary of information about the processing of email messages that have passed through the Office 365 system for the organization.
Office 365 Reporting Web Service
Azure App Prerequisite
For this integration, an Azure App must be created. More information can be found about how to do that in the documentation here.
Data Types¶
- OFFICE_365_MESSAGETRACE
Requirements¶
In the Cyderes Azure App, select API permissions from the sidebar. Then click the Add a permission button. Click APIs my organization uses and search for 'Office 365 Exchange Online' and then select it. Click the Application permissions and click the check box next to the following permissions.
ReportingWebService.Read.All
Attention
Once the permissions have been added, click the Grant admin consent for Cyderes button at the bottom of the page. At the top of the page it will ask for confirmation to finalize the permissions set. Important: Workspace Admin permissions are required to complete this step.
In the Office 365 portal Admin application, navigate to the Azure AD Admin Center. Navigate to Roles and Administrators. Search for the "Global Reader" role. Click Add assignments. Select the application with the name matching the Azure AD App Registration created previously. Save the role addition.
Gather Information¶
Provide the following information to Cyderes to complete implementation:
- Identity (Azure Active Directory App)
- Application (client) ID
- Directory (tenant) ID
- Secret ID
- Secret Value