Skip to content

Microsoft M365 importer

Versio.io can import, historize and process identity data from Microsoft M365.

Configuration

You can find the configuration option in Versio.io at Environment settings > OneImporter > Configurations > Microsoft 365.

Here you can edit all existing configurations, create new configurations or delete existing configurations. To add a new configuration enter a Name for your importer and an Entity suffix (default: -microsoft-365) to clearly identify your M365 entities.
Note that the Entity suffix is fixed and cannot be changed afterwards.

Click Add to proceed to the configuration.

To edit an existing configurations click the arrow on the left of your importer name to expand the configuration options.

Following configuration options are available:

Field Description Advice
Name Meaningful name Add the word "M365" to identify importer when viewing the logs
Active Option to activate and deactivate the configuration. Data is only imported if the configuration is activated.
Tenant ID Go to Azure Entra ID > Overview and copy the Tenant ID
Application ID (Credential) Go to Azure Entra ID > App Registartions > [Click relevant application] > Overview and copy the Application (client) ID
Application Secret (Credential) Go to Azure Entra ID > App Registartions > [Click relevant application] > Certificates & secrets > Client secrets > New client secret > [Configure and Click save] and copy and store the secret.
There is no possibility to retrieve the secret after leaving this page.
Entities Select all required entities
Executing OneImporter Select a Versio.io OneImporter to import the data based on the importer configuration. Requires installed OneImporter: Installation instruction
Schedule time (cron format) Determine the frequency of imports in CRON format Learn more about CRON format: https://en.wikipedia.org/wiki/Cron

Table: M365 configuration parameters

M365 Application API permissions

The application set up in M365 should have API permissions for the Microsoft Graph API using Application permissions. Here, the read permissions for M365 resources (Directory.Read.All, Organization.Read.All) are required.

Reference