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.
- 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.
- In the Microsoft Entra admin center, go to Identity -> Applications -> App registrations
-> New registration. Name it
sheersight-m365and register (single-tenant is fine). - Open API permissions -> Add a permission -> Office 365 Management APIs -> Application
permissions, and add
ActivityFeed.Read. - Click Grant admin consent for
. - Go to Certificates & secrets -> New client secret, add one, and copy the secret value immediately (shown only once).
- 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¶
- The relayed credentials entry moves from pending to applied.
- The Microsoft 365 source badge moves from not connected to live.
- 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.