Microsoft 365¶
Category: Productivity | Version: 1.0.0 | Requires: Tevyra Proxy
What is this module for?¶
The Microsoft 365 module connects to your M365 tenant via the Microsoft Graph API. It synchronizes your users, groups, and licenses. You can also enable/disable accounts and manage licenses directly from Tevyra.
Proxy required
This module requires a Tevyra Proxy to access the Microsoft Graph API. See the proxy installation guide.
Before you start¶
To configure this module, you will need:
- An Azure AD / Entra ID tenant
- An Azure AD App Registration with the appropriate permissions (see guide below)
- The Client Secret generated for this application
Configuration¶
Parametres requis¶
| Parametre | Type | Description |
|---|---|---|
tenant_id | string | Tenant ID |
client_id | string | Client ID |
client_secret | secret | Client Secret |
Example configuration¶
{
"tenant_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"client_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"client_secret": "your-client-secret"
}
Configure the Azure AD App Registration¶
- Go to Azure Portal > Azure Active Directory > App registrations
- Click New registration
- Name the application:
Tevyra Integration - Account type: Single tenant
- Click Register
- Note the Application (client) ID and Directory (tenant) ID
- Go to Certificates & secrets > New client secret
- Go to API permissions > Add a permission > Microsoft Graph > Application permissions
- Add the following permissions:
| Permission | Usage |
|---|---|
User.Read.All | Synchronize users |
Group.Read.All | Synchronize groups |
Directory.Read.All | Read directory information |
User.ReadWrite.All | Enable/disable accounts (optional) |
- Click Grant admin consent
Minimum permissions
For synchronization only (without actions), *.Read.All permissions are sufficient. Add User.ReadWrite.All only if you want to enable/disable accounts or manage licenses from Tevyra.
Collected data¶
Once activated, the module automatically synchronizes the following data:
| Type d'asset | Description |
|---|---|
m365_user | Utilisateurs Azure AD / Microsoft 365 |
m365_group | Groupes Azure AD |
m365_license | Licences Microsoft 365 |
Default sync interval: 5 minutes
Available actions¶
From the Tevyra interface, you can perform the following actions:
| Action | Description |
|---|---|
microsoft-365.disable_user | Désactive un compte utilisateur |
microsoft-365.enable_user | Réactive un compte utilisateur |
microsoft-365.assign_license | Assigne une licence à un utilisateur |
microsoft-365.remove_license | Retire une licence d'un utilisateur |
Indicators¶
The dashboard displays the following indicators:
| Indicator | Description |
|---|---|
users_total | Total number of users |
users_enabled | Active users |
users_licensed | Users with a license |
groups_total | Total number of groups |
licenses_total | Total available licenses |
licenses_consumed | Licenses in use |