Microsoft 365 Integration Installation Instructions

Minimum Version

This DEX Pack requires SysTrack version 10.1 or higher.

Notes

After this DEX Pack is installed, it may take up to 24 hours for data to appear.
If anonymization is enabled on the tenant, the data will not display in the dashboard.

Import Kit

To use this DEX Pack, the corresponding Kit must be imported to SysTrack.

If you have already imported the DEX Pack directly from the Kits page, the Import Kit step is complete. You may move on to the next step.

If you are viewing this DEX Pack in the Customer Gateway, follow these steps to import this DEX Pack Kit:

On the DEX Pack page, download the DEX Pack ZIP file.
In SysTrack, open Kits.
Under Local, click Select Kit File.
Select the DEX Pack ZIP File.

Integrate Microsoft 365

SysTrack Configure provides additional configuration settings for interaction external third-party services including Office 365. Integration of Microsoft 365 monitoring is necessary to retrieve data.

On the home page, under Settings, click on Configure.
Click Integrations.
Click Other Integrations and then check the box to edit for Office 365.

Dashboard Data for Office 365 Monitoring

SysTrack dashboards have a wide range of data sources. These dashboards are a result of custom collection of the Office 365 Graph API.

Go to URL: https://portal.azure.com/#home.
Select Azure Active Directory and click through the following three app registration menus.
Name the application Office365 and then click Register.
Locate and click into the newly created Office 365 App Registration.
Make a note of the Application (client) ID and Directory (tenant) ID, which will be used later.
Select Certificates and secrets and add a New client secret.

NOTE: In the next step, be sure to write down the secret or copy it to where you can find it later. This is the only time the secret is visible.
Make a note of the secret VALUE.
Select API permissions and then select Add a permission.
On the Microsoft APIs tab, select Microsoft Graph.
Select Application Permissions.
Expand Reports and select Reports.Read.All, expand User and select and User.ReadBasic.All, then click Add Permissions.

NOTE: You need to give permissions for Reports.Read.All because we use the Microsoft Graph API reports to pull the data and permissions for User.ReadBasic.Allto cleanup data since reports could still have data from people who no longer work at your company and no longer exist in O365 as users.
Log into SysTrack Configure with a user that has TAS rights to modify settings in SysTrack Configure.
Select SysTrack Settings > Integrations.
Click the Lock icon in the upper right to allow for editing.
On the Other Integrations tab, click the Edit icon next to Office 365 and enter the following information:
- Tenant ID (previously called Directory (tenant) ID)
- Client ID Field (previously called Application (client) ID)
- Client Secret (as recorded in prior step)
It is recommended that you leave the default retention periods and enable all collection intervals by selecting Collect Daily, Collect Weekly, etc.

NOTE: You can find the Tenant ID and Client ID information on the app Overview page.
Click OK, then click Save Changes.
Click the open Lock icon to end your editing session. The integration for Office 365 data collection has now been successfully configured.

Set User Information to Display

To ensure that names for users, groups, and sites are shown in the data SysTrack collects from this integration, you must follow these steps to edit a setting in Microsoft 365 admin center:

Open the Microsoft 365 admin center.
Go to the Services page at Settings > Org Settings > Services page.
Select Reports.
Uncheck the check box for Display concealed user, group, and site names in all reports.
Select Save.

TIP: For more information on this setting, see Microsoft's documentation.