Microsoft 365 Private Status Ingestion
StatusGator Enterprise plan supports ingestion of your specific tenant status from major services such as Microsoft Office 365. There are 3 values we need in order to connect to the Office 365 status API as part of your account:
- Tenant Name: This is a domain name such as “yourcompany.com” or “yourcompany.onmicrosoft.com” and uniquely identifies your Office 365 tenant.
- Client ID: Identifier for a new OAuth2 application you will register inside your Microsoft admin center.
- Client Secret: The corresponding secret value for the Client ID you will create.
Follow these steps to register a new application:
- Sign into Microsoft Entra admin center
- Click on Applications on the left menu
- Click on Enterprise applications on the expand menu
- Click on New application at the top
- Click on Create your own application at the top
- Under What’s the name of your app?
Enter “StatusGator” (or a name of your choosing) - Under What are you looking to do with your application?
Choose Register an application to integrate with Microsoft Entra ID (App you're developing) - Under Who can use this application or access this API?
Choose Accounts in this organizational directory only - Leave Redirect URI blank
- Click Register at the bottom
- Under Applications on the left click App Registrations
- Click the All applications tab
- Click the app you just created
- If the application doesn’t appear right away, wait a few moments an refresh.
- Click API permissions on the left
- Click Add a permission
- Click Microsoft Graph at the top
- Click Application permissions on the right
- Type ServiceHealth in the search box
- Expand the ServiceHealth bar by clicking > and check off ServiceHealth.Read.All
- Type ServiceMessage in the search box
- Expand the ServiceMessage bar by clicking > and check off ServiceMessage.Read.All
- Click Add permissions at the bottom
- Click Grant admin consent for [organization] at the top of the table
- Click Yes to confirm
- Click on Certificates & secrets on the left
- Click on the Client secrets tab
- Click on New client secret
- Enter a description such as “StatusGator”
- Choose an expiration. You will need to generate a new secret and update in the StatusGator UI before the expiration of your secret.
- Copy the string in the Value column. This is your Client Secret.
- Click on the Overview item on the left
- Copy the string listed under Application (client) ID. This is your Client ID.
- Click the user profile menu in the upper right corner.
- The value after the @ sign in your email address is your Tenant ID.