Overview
The Microsoft Entra Users Collector retrieves user and licence allocation information from Microsoft Entra using the Microsoft Graph API.
This collector provides visibility into user accounts and assigned licences, enabling organisations to validate subscriptions, allocate costs, and reconcile licence usage within Varibill.
The collector retrieves unrated allocation data, meaning no monetary values are supplied by the source system. Pricing and billing calculations are applied within Varibill based on configured contracts and pricing rules.
This is a discrete (snapshot) collector, meaning each execution retrieves the current state of users and licence assignments at the time of collection.
For general instructions on creating and running Source Collectors,
see:
Varibill
Cloud Source Collectors – Setup and Configuration Guide
Collector Summary
| Field | Value |
|---|---|
| Source Collector Name | Entra Users – Version 6.0 |
| Collection Behavior | Discrete |
| Data Rating Model | Unrated |
| Vendor Name | Microsoft |
| Product | Microsoft Entra (Azure Active Directory) |
| Purpose | Retrieves user licence allocation data from Microsoft Entra for billing and validation within Varibill |
Data Collected
The Microsoft Entra Users 6.0 collector retrieves unrated user licence allocation data from Microsoft Entra. This includes individual user allocation data registered to Entra licences per user.
Important: The Entra Users 6.0 collector reflects the state of Microsoft Entra at the time it runs. More frequent execution improves billing accuracy for environments with frequent licence changes.
Prerequisites
Before configuring this collector, you must:
- Create an Application Registration in Microsoft Entra
- Configure the required Microsoft Graph API permissions
- Grant Admin Consent for the configured permissions
- Create a Client Secret
- Capture the following values:
- Tenant ID
- Client ID (Application ID)
- Client Secret
Configuration Parameters
| Parameter | What it is | Where to find it |
|---|---|---|
| Entra Tenant ID | Identifies your Microsoft Entra tenant | Azure Portal → Entra ID → Overview → Tenant ID |
| Entra Application (Client) ID | Identifies the application registration used for authentication | Azure Portal → App registrations → Your app → Overview → Application (client) ID |
| Entra Client Secret Key | Credential used by Varibill to authenticate against Microsoft APIs | Azure Portal → App registrations → Your app → Certificates & secrets → Client secrets |
Important: The Entra Users 6.0 collector reflects the state of Microsoft Entra at the time it runs. More frequent execution improves billing accuracy for environments with frequent licence changes.
Tip: Client secrets are displayed only once when created. Record and store the value securely before leaving the Azure portal.
Microsoft Entra References
The following resources may assist with locating values or configuring your Microsoft Entra application registration.
Microsoft Documentation (External)
- Where to find your Microsoft Entra Tenant ID
- How to register an application in Microsoft Entra
- How to create a Client Secret
- How to grant Admin Consent
Note: Microsoft documentation is provided for reference. Steps and interface labels may vary depending on your Azure environment and permissions.
Configuration Steps
Step 1: Prepare Microsoft Entra
- Create an application registration in Microsoft Entra
- Configure the required API permissions
- Grant Admin Consent
- Create a Client Secret
- Copy the Tenant ID, Client ID, and Client Secret
Step 2: Configure the Collector in Varibill
In the Varibill User Interface, open the Source Collector configuration screen.
Enter the required field values.
- Hosting Provider: Select Varibill Cloud
- Source Collector Name: Select Microsoft – Entra Users – 6.0
- Entra Tenant ID: Value from Azure portal
- Entra Application (Client) ID: Value from Azure portal
- Entra Secret Key: Client Secret value from Azure portal
- Set Collector Processing Rules.
Example:
- Group Client Identifier By: Use Entra attributes
such as department
(see the Microsoft Entra Attributes List)
- Save the collector configuration.
Step 3: Run the Collector
Run or schedule the collector according to your standard Source Collector execution process.
For detailed instructions, see:
Varibill Cloud Source Collectors – Setup and Configuration Guide
Troubleshooting
If the collector fails to connect to Microsoft Entra, verify that:
- The Tenant ID is correct
- The Client ID is correct
- The Client Secret is valid and not expired
- Admin Consent has been granted
Related Documentation
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article