Skip to content

Azure Permissions Reference

This page is a lookup reference for all Microsoft Graph permissions required by the collector. For the step-by-step setup guide, see Azure Permissions.

PermissionTypeRequiredPurpose
CallRecords.Read.AllApplicationYesRetrieve Teams call records, stream details, PSTN, and Direct Routing data
Reports.Read.AllApplicationYesAccess Microsoft Teams activity reports (user activity, usage)
ServiceHealth.Read.AllApplicationYesAccess Microsoft 365 service health announcements and incidents

The following permissions are required only if Auto Attendant or Call Queue collection is enabled (autoattendant_collection / callqueue_collection feature flags):

PermissionTypeRequired ForPurpose
(VAAC-specific permissions)ApplicationAuto Attendant, Call QueueVoice application analytics

Contact your vendor for the exact VAAC permissions required for your environment.

AttributeValue
Permission typeApplication (not Delegated)
Admin consentRequired
Token typeClient credentials flow
MethodDescription
Client secretStandard client secret generated in Azure App Registration
Certificate (PEM)RSA certificate — private + public key in a single PEM file
  • Apply the principle of least privilege — only grant the permissions listed above.
  • Use certificate-based authentication in preference to client secrets for production deployments.
  • Rotate client secrets regularly and update the collector configuration before expiry.
  • Restrict the Azure app registration to accounts in your organisational directory only.
  • Monitor app registration activity in Microsoft Entra ID audit logs.