M365 Unified Audit Logs
Cado has the capability to acquire, process and analyze M365 Unified Audit Logs (UAL). This can aid in the investigation of Business Email Compromise and insider threats.
Setting up the View-only Audit logs role
To acquire the M365 Unified Audit Log (UAL), the ‘View-only Audit Logs’ role you need to grant the ‘View-only Audit Logs’ to the Microsoft account of the user who is performing the acquisition.
You will need to grant this role in both the Exchange Admin Centre and Microsoft Purview.
Exchange Admin Centre
- Navigate to the Exchange Admin Centre and login.
- In the left side panel under ‘Roles’, click on ‘Admin roles’.
- You will be presented with a list of roles and their descriptions. At the top of the page click on ‘Add role group’.
- Give your role a name and description, then click next.
- On the permissions page, search for ‘View-Only Audit Logs’ and tick the box, then click next.
- On the ‘Admins’ page, add the users who require this role, then click next. On the next page, review your role group and finish the setup.
Microsoft Purview
- Navigate to Microsoft Purview and login.
- In the left side panel under ‘Roles & scopes’, click on ‘Permissions’.
- On the ‘Permissions’ page under ‘Microsoft Purview Solutions’, click on ‘Roles’.
- On the Role Groups page click on ‘Create Role Group’.
- Give your role a name and description, then click next.
- On the roles page, click on ‘Choose Roles’ and search for ‘View-Only Audit Logs’. Tick the box for this role, click select then next.
- On the ‘Members’ page, add the users who require this role. You can do this by selecting individual users or a group, click select then next.
- On the ‘Review and finish’ page, review your role group, then click ‘Create’ to finish the setup.
UAL acquisition
The feature is currently in Beta. To enable, navigate to Settings - Experiments and enable the ‘SaaS Imports’ button.
Once you have granted the role to the user’s Microsoft account, you can acquire the the UAL through the Cado platform
To do this, click the Import button from within an investigation. Select ‘SaaS’ > ‘Microsoft 365 Logs’ > ‘Unified Audit Log’.
At step 3 in the import process, you can refine the acquisition by timeframe, user, IP, or workload. For example:
- From date to date
- Specific to the ‘Exchange’ workload
- Specific to the user ‘user1@cadosecurity.com’
On the last page of the import wizard, you will see instructions to navigate to the pipelines page, where you can authenticate to M365 using your Microsoft account using the access code provided.
Finally, when the acquisition and processing is completed, the logs will be available to view and search in the main timeline page. To help users with their search and analysis, Cado maps the following UAL fields.
Mapped fields
UAL Field | Cado Field | CADO Facet Name |
---|---|---|
ClientIP | source_hostname | Source Hostname |
UserID | user | Users |
Workload | sourcetype | Datatype |
For example, the user is able to filter the dataset by the ‘AzureActiveDirectory’ workload by selecting this value in the ‘Datatype’ facet.
Video Tutorial
For a video tutorial on how to import Microsoft 365 Unified Audit Logs, please see this video