Permissions Explained

365TUNE collects data from Microsoft 365 exclusively through the Microsoft Graph API, which provides secure and streamlined access to a wide range ...

Permissions Explained

365TUNE collects data from Microsoft 365 exclusively through the Microsoft Graph API, which provides secure and streamlined access to a wide range of Microsoft 365 services.

1. Application Registration and Permissions

  • During the initial setup, a Global Administrator grants read-only permissions to 365TUNE, including User.Read.All, Reports.Read.All and others. These permissions allow the tool to retrieve user profile data and usage reports without the ability to modify or delete any data.
  • 365TUNE is registered as an application within Microsoft Entra ID (formerly Azure Active Directory), enabling it to securely access Microsoft 365 data.
  • 365TUNE does not store Global Admin credentials. It uses secure authentication through OAuth 2.0 to access the necessary data.

Below are the detailed breakdown of permissions requested during the onboarding/app registration process.

Microsoft Graph Permissions:

Application Permissions (Read-Only)

PermissionDescriptionWhat 365tune Uses It For
DelegatedAdminRelationship.Read.AllRead Delegated Admin relationships with customersAutomatically discovers which tenants you manage via GDAP and syncs user access based on existing security group mappings.
Directory.Read.AllRead directory dataAccesses user accounts, groups, organizational units, and directory structure to inventory users across managed tenants.
User.Read.AllRead all users' full profilesRetrieves user properties including department, job title, manager, office location, and license assignments for reporting and optimization.
AuditLog.Read.AllRead all audit log dataAccesses audit logs for sign-ins, file access, mailbox activity, and admin actions to track activity and detect inactive users.
Reports.Read.AllRead all usage reportsRetrieves Microsoft 365 usage statistics, application usage data, and adoption metrics for usage analysis.
MailboxSettings.ReadRead all user mailbox settingsReads mailbox settings such as forwarding rules, automatic replies, and time zone settings. Can't read emails.
SharePointTenantSettings.Read.AllRead SharePoint and OneDrive tenant settingsAccesses tenant-level SharePoint/OneDrive settings including sharing policies, storage limits, and site creation permissions.
Application.Read.AllRead all applicationsLists registered applications and their permissions for security auditing and identifying apps with excessive permissions.
ReportSettings.Read.AllRead all admin report settingsAccesses tenant report settings including privacy settings and report customization options.

2. Using Microsoft Graph API

  • After the initial setup and permission approval, 365TUNE interacts solely with the Microsoft Graph API, which is the gateway to Microsoft 365 data. The Graph API enables access to a variety of data, including:
    • User data: Information on users, their assigned licenses, and roles.
    • Usage data: Activity and usage reports from services like Exchange, Teams, and OneDrive.
  • 365TUNE makes API calls to Microsoft Graph endpoints to collect this data in real-time.

3. Secure Data Access

  • 365TUNE uses OAuth 2.0 tokens to authenticate API requests. These tokens are obtained once the Global Administrator grants consent and will be used for subsequent requests to Microsoft Graph.
  • This method ensures that 365TUNE accesses the data securely and does not require storing any sensitive credentials. It operates with the granted read-only permissions, ensuring that it can only view and analyze data without the ability to make changes.
  • 365TUNE sends requests to Microsoft Graph API to retrieve specific datasets such as:
    • User profiles: Data about users, their licenses, and assigned roles.
    • Reports: License usage, activity metrics, and other compliance reports.
  • The data collected is then analyzed and compiled into reports, which help administrators monitor license consumption and user activity across the organization.

Conclusion

365TUNE relies entirely on Microsoft Graph API for collecting and analyzing data from Microsoft 365. By using secure OAuth 2.0 authentication and read-only permissions, 365TUNE ensures that it can gather important insights without compromising data integrity or requiring continuous admin access. The tool’s ability to operate solely via the Microsoft Graph API makes it both secure and efficient for reporting and compliance monitoring.

Want to learn more about Entra ID App Registration & Permissions? Head to this article from Microsoft.


Did this page help you?