Skip to content

Connect Microsoft 365

Trimtab scans a client's Microsoft 365 tenant with a read-only app. A Global Administrator of the tenant approves it once.

Connect the tenant

  1. In the Bridge, open Clients and find the client.
  2. Under Microsoft 365, select Connect Microsoft 365.
  3. Pick or sign in as a Global Administrator of the client's tenant. Use an account that belongs to that tenant, not a guest account, because Trimtab connects the tenant you sign in to.
  4. Microsoft then shows Trimtab's permissions. Review them and select Accept. (The first time, Microsoft may also ask you to accept a basic sign-in permission before this.)
  5. You return to the Bridge and see Tenant connected. The first scan runs within a couple of minutes. Select View tenant.

Unverified publisher

Microsoft may label the app as unverified until Trimtab completes Microsoft's publisher verification. The permissions it asks for are all read-only, listed below.

Enable Exchange Online checks

Exchange settings need one extra step: assigning a read-only directory role to the Trimtab app.

  1. In the client's Microsoft Entra admin center, go to Identity → Roles & admins → Roles & admins.
  2. Search for and open Global Reader.
  3. Select Add assignments, then search for Trimtab M365 Scanner, select it, and assign it.
  4. Back in the Bridge, open the tenant and select Scan now. Role changes can take up to an hour to reach Exchange Online.

Until the role is assigned, the Exchange checks show as not evaluated. The SPF and DMARC checks still run because they only use public DNS.

What Trimtab can access

Permission Type Used for
Policy.Read.All Microsoft Graph, application Security defaults, Conditional Access (including authentication strengths, session controls, and authentication flows), authentication methods, consent and admin consent requests, guest, tenant creation, and idle session timeout settings
Directory.Read.All Microsoft Graph, application Users, guests, groups and their members, domains, password protection settings, and which admin accounts sync from on-premises
RoleManagement.Read.Directory Microsoft Graph, application Admin role members and Privileged Identity Management (eligible and permanent assignments)
AuditLog.Read.All Microsoft Graph, application MFA registration and sign-in activity for users and guests
SecurityEvents.Read.All Microsoft Graph, application Microsoft Secure Score
SharePointTenantSettings.Read.All Microsoft Graph, application SharePoint and OneDrive sharing, legacy authentication, and sync settings
Organization.Read.All Microsoft Graph, application Organization name and verified domains
DeviceManagementManagedDevices.Read.All Microsoft Graph, application Intune devices: platform, compliance, encryption, and last check-in
DeviceManagementConfiguration.Read.All Microsoft Graph, application Intune compliance policies and compliance settings
DeviceManagementApps.Read.All Microsoft Graph, application Intune app protection policies for iOS and Android
Exchange.ManageAsApp Exchange Online, application Read-only Exchange settings: auditing, forwarding, mail flow rules, anti-spam, anti-malware, Safe Links and Safe Attachments, shared mailboxes, and Outlook add-ins (requires the Global Reader role)

Trimtab doesn't read email, files, chats, or calendars, and it can't change anything in Intune or wipe devices.

Keep Trimtab read-only

The Graph permissions above can only read. Exchange.ManageAsApp is different: it lets the app connect to Exchange Online, and the directory role you assign decides what it can do there. Assign Global Reader only. Never give Trimtab M365 Scanner Global Administrator, Exchange Administrator, or any other role that can make changes.

Every scan checks this for you (Trimtab's own access is read-only, M365-026). It fails if Trimtab's app in the tenant has:

  • an Entra role that can make changes, assigned directly or through a group, or one it's eligible for in Privileged Identity Management
  • an API permission Trimtab doesn't ask for
  • a delegated permission that lets it act as a signed-in user, beyond signing you in
  • ownership of another app or service principal (an owner can add credentials to it)
  • any Azure role, on a subscription or management group (Trimtab needs no Azure access)
  • an Exchange role other than a view-only one
  • a secret or certificate added to it in your tenant (Trimtab's credential lives on its own app registration and never in your tenant)

It warns, rather than passes, if it can't read one of these. Usually that's Exchange, when Global Reader isn't assigned yet.

Trimtab also watches its own side. Once a day the Bridge checks the Trimtab M365 Scanner app registration in Trimtab's tenant: no certificates or client secrets, only one federated credential that trusts the Trimtab server's own Azure managed identity, and only the read-only permissions listed above. If anything else appears, Trimtab's team is told at once.

Attackers who get into a vendor's app often add exactly these to keep their access, so treat a failure you didn't cause as an incident: remove what was added, then check the Entra audit log for who added it.

Licensing notes

  • Microsoft Entra ID P1 is needed for the MFA registration, inactive account, stale guest, managed device, phishing-resistant admin MFA, device code, admin session, and custom banned password checks. Without it, those show as not evaluated and don't affect the score.
  • Microsoft Entra ID P2 (included in Microsoft 365 E5) is needed for the risky sign-in and risky user check and the just-in-time Global Administrator check.
  • Microsoft Defender for Office 365 (included in Microsoft 365 Business Premium) is needed for the Safe Links and Safe Attachments check.
  • Microsoft Intune Plan 1 (included in Microsoft 365 Business Premium, E3, and E5) is needed for the Intune checks. Basic Mobility and Security, included with Business Basic and Standard, isn't enough.
  • Tenants without Exchange Online show the Exchange checks as not evaluated.

Scans

Tenants are scanned once a day. To scan now, open the tenant in the Bridge and select Scan now, or select Rescan tenants on the Fleet page to scan every tenant.

Disconnect a tenant

  1. Open the tenant in the Bridge and select Disconnect. Trimtab stops scanning it.
  2. To remove access completely, delete Trimtab M365 Scanner from the tenant's Entra admin center → Enterprise applications.

The Intune checks (October 2026) added three read-only Intune permissions. Until a tenant is reconnected and the new permissions are approved, the Intune checks show as not evaluated with a reminder to reconnect.

Reconnect

When a Trimtab release needs a permission a tenant hasn't approved, Owners and Admins see a banner at the top of the Bridge, and the tenant shows Needs new permissions on the Clients page with a Reconnect to approve new permissions button. Trimtab knows from each daily scan which permissions the tenant has granted.

If permissions change in a future release, select Connect Microsoft 365 again for the same client and approve. The tenant keeps its history.