Microsoft 365 plugin

For more information about what this plugin does and the data streams it retrieves, see:

Microsoft 365

Analyze and report on your Microsoft 365 usage.

To add a data source click on the + next to Data Sources on the left-hand menu in SquaredUp. Search for the data source and click on it to open the Configure data source page.

Before you start

Authentication types

When configuring the data source, the plugin's connection to Microsoft 365 can be authenticated by either manually entering the client credentials of your Microsoft account or by via Microsoft Entra ID and logging in with your Microsoft account.

While authentication via Microsoft Entra ID is encouraged, if you must authenticate using client credentials, first follow the steps in Configuring App Registration for the Microsoft 365 Plugin.

Configuring the data source

  1. Display Name:
    Enter a name for your data source. This helps you to identify this data source in the list of your data sources.

  2. Add Intune Support:
    Select to enable the Microsoft Intune extension for this plugin, allowing you to monitor device compliance managed by Intune.
    If you select this option, you can optionally select the Import User Objects check box to import additional user data.
  3. Authentication Type:
    Select how the plugin authenticates with Microsoft 365. Choose from:
    • Microsoft Entra ID: Click the Sign in with Microsoft button that appears. You are redirected to the Microsoft authentication client. After signing in with your Microsoft account you are redirected back to the plugin configuration page in SquaredUp.
    • Client Credentials: Manually specify your client credentials. You must complete the following fields using the credentials you noted when Configuring App Registration for the Microsoft 365 Plugin:
      • Directory (Tenant) ID
      • Application (Client) ID
      • Client Secret

  4. Restrict access to this data source:
    You can enable this option if you only want certain users or groups to have access to the data source, or the permission to link it to new workspaces. See data source access control for more information.

  5. Install Sample Dashboards:
    Select whether you would like to install sample dashboards with the data source. By default, this is set to on.

    Currently all the available sample dashboards require Microsoft Intune support to function. Installing sample dashboards without adding Intune support installs these dashboards, however they will not display any data.

  6. Click Test and add to validate the data source configuration. SquaredUp will now attempt to connect to SquaredUp using the provided authentication method. If this process fails, see Testing and troubleshooting for assistance with the corresponding errors.

Next Steps

Once you have successfully connected to data source, you can start exploring your imported objects and using your data streams to create data tiles on your dashboards.

If you chose to install sample dashboards when configuring the data source, now is a great time to take a look at those and how you can visualize your data.

Sample dashboards

Currently all the available sample dashboards require Microsoft Intune support to function. Installing sample dashboards without adding Intune support installs these dashboards, however they will not display any data.

The following sample dashboards can be installed with this plugin:

  • Managed device compliance overview

The following perspectives are also installed:

  • Compliance Policy Status
  • Configuration Policy Status
  • Device Compliance and Configuration Status

Graph imported objects

Microsoft Intune imported objects

The following objects are imported if you have selected to Add Intune Support during plugin configuration.

Object
Description
Compliance Policies
Contains data about each of the compliance policies returned from the connected MS Intune instance.
Configuration Policies
Contains data about each of the configuration policies returned from the connected MS Intune instance.
Managed Devices
Contains data about each of the devices managed by the connected MS Intune instance.

Data streams

Microsoft Intune data streams

The following data streams are installed if you have selected to Add Intune Support during plugin configuration.

Data stream
Description
Compliance Policy Device Status
Scopes to a Compliance Policy and returns device status records pertinent to that policy.
Compliance Policy Overview
Scopes to a Compliance Policy and returns summary counts of devices in various states.
Compliance Policy Status by Device
Scopes to a Device and returns device status records for compliance policies pertinent to that device.
Compliance Policy Summary
Returns a summary of non-compliant devices.
Configuration Policy Device Status
Scopes to a Configuration Policy and returns device status records pertinent to that policy.
Configuration Policy Overview
Scopes to a Configuration Policy and returns summary counts of devices in various states.
Configuration Policy Status by Device
Scopes to a Device and returns device status records for configuration policies pertinent to that device.
Configuration Policy Summary
Returns a summary configuration policy failures.
Managed Device Properties
Scopes to a Device and returns current property values for the selected Managed Device object(s).
Managed Devices by Compliance State
Returns managed devices in the required compliance state(s).

Was this article helpful?

Have more questions or facing an issue?
Submit a ticket