Skip to content

Microsoft 365

Identity & SaaS audit logs. Exchange, SharePoint, and Teams activity from the Microsoft 365 Unified Audit Log.

Status: available now - you connect this yourself

This source is live in the console. Create the read-only credential below, connect it on its card in Integrate -> Sources, and your dedicated instance starts collecting.

Sign-ins are a separate source

This source covers Exchange, SharePoint/OneDrive, and Teams activity. Entra ID sign-ins and directory audits are a different source, see Microsoft Entra ID.

What SheerSight reads

SheerSight reads the Microsoft 365 Unified Audit Log through the Office 365 Management Activity API, across Exchange, SharePoint/OneDrive, and Teams:

  • mailbox forwarding rules and delegation changes,
  • anonymous sharing links,
  • external members added to Teams,
  • mass file download and mass file delete.

That feed powers detections for exactly those behaviors. It is read-only.

What you'll need

  • A Microsoft 365 / Entra administrator who can register an app, grant admin consent, and enable the Unified Audit Log.
  • Your dedicated instance enrolled.

Create the read-only credential

First make sure auditing is on, then register an app with one read-only permission.

  1. Enable the Unified Audit Log (if it is not already on): in the Microsoft Purview portal, go to Audit and, if prompted, select Start recording user and admin activity. Without this, the API returns an empty feed.
  2. In the Microsoft Entra admin center, go to Identity -> Applications -> App registrations -> New registration. Name it sheersight-m365 and register (single-tenant is fine).
  3. Open API permissions -> Add a permission -> Office 365 Management APIs -> Application permissions, and add ActivityFeed.Read.
  4. Click Grant admin consent for .
  5. Go to Certificates & secrets -> New client secret, add one, and copy the secret value immediately (shown only once).
  6. From the app's Overview, copy the Directory (tenant) ID and the Application (client) ID.

Auditing can take time to populate

If you just enabled the Unified Audit Log, it can take a little while before activity is available through the API. New events flow through within the hour in most tenants.

Connect it in SheerSight

In the console, open Integrate -> Sources -> Microsoft 365 and fill in:

Field Value
Tenant ID The Directory (tenant) ID from step 6.
Client ID The Application (client) ID from step 6.
Client secret The secret value from step 5.

Press Connect. Your instance starts the audit subscription itself on the first poll.

Verify

  1. The relayed credentials entry moves from pending to applied.
  2. The Microsoft 365 source badge moves from not connected to live.
  3. Exchange, SharePoint, and Teams audit events begin appearing, and matching detections start firing.

Troubleshooting

  • No data at all. The most common cause is the Unified Audit Log not being enabled in Purview. Turn it on, then allow time for events to populate.
  • Missing sign-in events. Sign-ins are not part of this source. Connect Microsoft Entra ID for identity sign-in and directory-audit coverage.

What SheerSight can and cannot do

The permission is read-only access to the audit activity feed. SheerSight cannot read message or file contents, change mailbox or sharing settings, or take any action in Microsoft 365. It only reads audit events.