Overview
The Office 365 integration uses the Office 365 Management Activity API to ingest the unified audit log:
Audit.Exchange— mailbox access, send-as, transport rule changesAudit.SharePoint— file access, sharing, and permission changesAudit.AzureActiveDirectory— sign-ins and directory changesAudit.General— Teams, Power BI, Forms, and other workloadsDLP.All— data loss prevention rule matches
Prerequisites
- A Microsoft 365 tenant with unified audit logging enabled (it is on by default for newer tenants; otherwise enable it from the Microsoft Purview compliance portal).
- Global Administrator rights to register an Azure AD app and grant admin consent.
Step 1: Register an app in Azure AD
- Sign in to the Azure portal and open Microsoft Entra ID → App registrations → New registration.
- Name it
atatus-o365-siem, choose Accounts in this organizational directory only, and click Register. - Copy the Application (client) ID and Directory (tenant) ID from the Overview page.
- Open Certificates & secrets → New client secret and copy the secret Value.
Step 2: Grant Office 365 Management API permissions
- In the same app, open API permissions → Add a permission → Office 365 Management APIs → Application permissions.
- Add:
ActivityFeed.ReadActivityFeed.ReadDlpServiceHealth.Read
- Click Grant admin consent for
.
Step 3: Enable subscription content types
The first time you connect, Atatus calls /subscriptions/start for each content type listed above. If you prefer to enable them manually beforehand, run the API calls described in Microsoft's Management API documentation.
Step 4: Connect Office 365 in Atatus
- In Atatus, go to Security → Cloud SIEM → Integrations.
- Locate the Office 365 card and click Connect.
- Fill in the form:
| Field | Description | Example |
|---|---|---|
| Tenant ID | Directory (tenant) ID. | 00000000-0000-0000-0000-000000000000 |
| Client ID | Application (client) ID. | 11111111-1111-1111-1111-111111111111 |
| Client Secret | The client secret value from Step 1. | •••••••• |
| Poll Interval (minutes) | How often to fetch new events. | 5 |
| Enabled | Turn collection on. | true |
- Click Connect.
Verification
- The Office 365 card shows Configured.
- Audit events appear in Security → Cloud SIEM → Audit Logs → Events with source
office365.
+1-415-800-4104