Microsoft 365 status integration

Introduction

The current status of an Microsoft 365 tenant as well as the incident message history is exposed by Microsoft via an OAuth-protected API. Exoprise can be set up to retrieve this information and make it available to you on the Exoprise dashboards via a couple of widgets: Microsoft 365 Status and Microsoft 365 Messages.

For general information about Microsoft Service Health, refer to the following links:

Configuring OAuth authorization

The OAuth protocol makes it possible for you to authorize Exoprise to access the API for your Microsoft 365 tenant without needing to share your tenant admin credentials. To authorize Exoprise, you must have administrative privileges to your Exoprise organization.

  1. In the left navigation menu, go to Admin > Settings.

  2. Click the OAuth tab.

  3. In the Add Authorization section, configure the following:

    1. Select Graph Service Communications API.

    2. Give it a label (typically the domain of your tenant).

  4. Click Add.

  5. You will be redirected to the Microsoft 365 authorization page, which requires tenant admin privileges. If you are not already logged in, you will first get to the login page. Log in with admin credentials to the tenant you wish Exoprise to be able to access.

  6. If you agree, click Accept on the authorization page.

  7. You will be redirected back to the Exoprise OAuth page, and the newly added authorization will now be listed in the Current Authorizations section.

After a successful authorization, Exoprise will begin retrieving relevant service health data in the background. You can proceed to add Microsoft 365 widgets to your dashboard. Refer to Configurable dashboards.

Microsoft 365 widgets

The Microsoft 365 Status widget will show the current health status of the various aspects of your account. The Microsoft 365 Messages widget will show a feed of recent incident messages and statuses. To add these widgets to your dashboard, follow these steps:

  1. Navigate to a dashboard page.

  2. Click Tabs > New to add a new tab.

  3. Add the Microsoft 365 Status and the Microsoft 365 Messages widgets, as well as any other sensor widgets that you want on the tab. The Microsoft 365 widgets will automatically use a configured OAuth tenancy.

Removing OAuth authorization

You can delete an OAuth authorization by clicking the trash icon for its entry in the Current Authorizations section. This will make Microsoft 365 health data unavailable on your dashboard. However, if other users have also added an authorization to the same tenant, Exoprise will continue retrieving health data for it. Service health data retrieval will stop only if all users delete the authorization for a given tenant.

If you want to completely revoke Exoprise's access to your tenant, your tenant admin will need to remove Exoprise CloudReady from the list of authorized applications on the Azure Active Directory management page, which can be accessed via the Azure AD navigation link in the Microsoft 365 Admin Center.