Skip to main content

Configure the Microsoft 365 connector

The Snow Integration Connector for Microsoft 365 is configured in the Snow Integration Manager. For more information, refer to Snow Integration Manager.

Set up the Snow License Manager Configuration

The Microsoft 365 connector uses an API connection.

In Snow Integration Manager, add the Microsoft 365 connector, and configure the settings:

  1. In the API Endpoint, enter the URL to the Snow License Manager (SLM) Web API.

  2. Enter the Port of the SLM Web API.

  3. In the User Name and Password, enter credentials for a user account with access to the SLM Web API.

  4. If you need to use a proxy server to connect to the SLM Web API, select Proxy. Proxies can be configured in the Proxy profiles tab in the Snow Integration Manager main interface.

  5. Select Get customer. The Customer is populated with the current SLM customer.

  6. To prevent out-of-memory issues to the SLM API, enter the Batch size. The default value is 5000, and it applies to all data that is being batched.

Set up the Office 365 Configuration

  1. In the Graph API section, enter the Application Id, Application Secret, and Directory ID found in the Graph API app in the Azure portal. See Configure Graph API in Microsoft Azure.

  2. To include information on the country and department of Microsoft 365 users, select the Include country and department.

  3. To include information on last logon time for Skype for BusinessExchange Online, OneDrive, SharePoint, Yammer, and Teams, select the Include last activity.

  4. To exclude disabled M365 users when using the connector, select Exclude disabled users.

  5. Select the M365 Cloud environment that you want to connect to:

    1. Select PublicCloud to connect to global public cloud environment (this is the default option).

    2. Select UsGovCloud to connect to Microsoft Cloud for US Government.

  6. Optional: Enable domain filtering according to Domain filtering.

  7. If you need to use a proxy server to connect to Microsoft 365, select Proxy. Proxies can be configured in the Proxy profiles tab in Snow Integration Manager main interface.

  8. To verify the connection, select Test connection.

  9. Select OK.

Domain filtering

Domain filtering is a feature in the Microsoft 365 connector that makes it possible to filter which Microsoft 365 users to import based on the domain name. A list of verified domains is fetched for the Microsoft 365 tenant, and the domains for which to import the data from can be selected. Users with a matching domain in their UserPrincipalName are imported.

Even though the user list will be filtered, the number of subscriptions cannot be filtered by the domain name. The subscription information sent to Snow License Manager will represent the state for the whole Microsoft 365 estate.

To use domain filtering:

  1. Select Domain filtering. The Filter by domains window opens.

  2. Select Enable domain filtering.

  3. Select the domains that you want to import data from. Select All selects all of the domains in the list.

    Select None clears the checkboxes.

  4. Select OK.

  5. Continue to manually aggregate the connector or schedule an aggregation.

Scheduling

To configure a schedule for the Microsoft 365 connector:

  1. In Snow Integration Manager Properties, select Connector options.

  2. In the Active connectors list, select the Microsoft 365 connector.

  3. Select Schedule. The Schedule for Microsoft 365 connector window appears.

  4. Select Schedule aggregation at every, and then set an aggregation interval.

  5. To save the schedule and close the window, select OK.

Note

The connector should be scheduled outside of the time span when the Data Update Job (DUJ) is active/running. Otherwise, performance of both the connector and the DUJ might be affected negatively.