OBSOLETE_Configure Office 365 Management Activity

This section provides a summary of the procedures required to configure collection from O365.

Prerequisites

Before you start to configure the collection from O365, you must ensure you have the following:

O365 account with admin access.
Microsoft Entra account with admin access that is tied to the O365 account.
System Monitor Agent version 7.10 or greater (required for REST API config) - Pro or Collector license.

Enable Auditing in Your Environment

Enable Auditing for SharePoint, OneDrive, and Microsoft Entra

Go to the Office 365 portal (https://portal.office.com).
Log in with your O365 administrator account.
Click the Admin app.
On the left-side menu, click Admin centers, and then click Security.
The Security & Compliance Center appears.
On the left-side menu, click Search, and then click Audit log search.
The Audit log search page appears.
Under the Audit log search heading, click the Start recording user and admin activities link.
In the Start recording user and admin activities dialog box, click Turn On.

If you do not see the Start recording user and admin activities link, then auditing for SharePoint, OneDrive, and Microsoft Entra has already been enabled.

It may take up to 60 minutes for the change to take effect.

(Optional) Enable Auditing for Exchange

Starting in January 2019, Microsoft turned on mailbox audit logging by default for all organizations. This means that certain actions performed by mailbox owners, delegates, and admins are automatically logged, and the corresponding mailbox audit records will be available when you search for them in the mailbox audit log. Before mailbox auditing was turned on by default, you had to manually enable it for every user mailbox in your organization.

Open Windows PowerShell on your local system, and then run the following command:
```
$UserCredential = Get-Credential
```
In the Windows PowerShell Credential Request dialog box, type your O365 user name and password, and then click OK.

To open the credentials prompt for O365, run the following commands:

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -

ConnectionUri https://outlook.office365.com/powershell-liveid/ -

Credential $UserCredential -Authentication Basic -AllowRedirection

Import-PSSession $Session

To enable the admin audit log, run the following command:

Set-AdminAuditLogConfig -UnifiedAuditLogIngestionEnabled $true

To get all mailboxes, run the following command:
```
$Mailboxes = (Get-Mailbox)
```

To group mailboxes by what is enabled, run the following commands:

$Group = $Mailboxes | Group-Object AuditEnabled,AuditDelegate | Select-

Object "Name","Count",@{Name="Account"; Expression={ $_.Group.Identity }}

$Group | Format-Table -AutoSize

To audit everything from every mailbox, run the following command:
```
(Get-Mailbox).Identity | % { Set-Mailbox -Identity $_ -AuditDelegate 
SendAs,SendOnBehalf,Create,Update,SoftDelete,HardDelete -AuditEnabled 
$true }
```
Larger enterprises may want to filter the target mailbox into smaller batches.
If new accounts are added in the future, you will need to run this command again to ensure that new mailboxes are audited.
When you are finished, disconnect the remote PowerShell session by running the following command:
```
Remove-PSSession $Session
```
Failure to disconnect could use up all your available remote PowerShell sessions, forcing you to wait for the sessions to expire.

Register an Application with Microsoft Entra

Create an Application in the Entra Admin Portal

The same application can also be used for the API - Office 365 Message Tracking (Microsoft) log source for ease of management. However, permissions must be added separately for each log source.

To open the Entra Admin Portal and create an application:

On the left-side menu in the Office 365 portal Admin app, click Show all, then click All Admin centers, and then click Microsoft Entra.
The Entra Admin Center appears.
On the left-side menu, click Applications, and then click App Registrations.
In the top menu, click New Registrations.
Complete the fields on the right side of the page:
- Name the application.
- Select a support account type.
- Provide a sign-on URL (for example, https://localhost/).
Click Register.
Your new application appears under the Display Name header.

Add O365 Management API Permissions

On the App Registrations directory page, click the name of your application.
Click API permissions in the left pane.
Click Add a permission.
Under Request API permissions, on the APIs my organization uses tab, click Office 365 Management APIs.
Click Application permissions.
Under Application Permissions, select Permissions, then expand the headers and select the following check boxes:
- ActivityFeed.Read
- ActivityFeed.ReadDlp
- ServiceHealth.Read
Click Add permissions.
Verify that your changes have been saved on the API permissions page.
Select Grant admin consent for "Organization Name" to apply the Application Permissions previously selected.
Select Yes to continue.
Successfully granted admin consent for the requested permissions appears.

Create the Client ID and Client Secret

To create the client ID and client secret, from the App Registrations screen:

Select the application created above.
In the left-hand panel, click Overview.
Under the Essentials header, copy the following strings into a text file for later use:
1. Application (client) ID (the Client ID used in the .ini configuration file).
2. Directory (tenant) ID (the Tenant ID used in the .ini configuration file).
In the left-hand panel, click Certificates and Secrets, and then Client Secrets.
Click New client secret.
The Add a client secret window appears.
Enter a Description for this client secret.
Select the desired expiry period from the Expires drop-list.
Click Add.
Copy the Value fields into a text file for later use in the .ini configuration file.

Update the office365.ini File

As of 2023 the REST API method using oAuth2 is the only collection method to use. This includes any newly onboarded sources.

Older, already in place Office365 API collections may have resumed running into this time, however, they are being gradually disabled by Microsoft. We recommend any old log sources have their .ini file and collection updated to the REST API method.

For the REST API process to work, you must set the UseAdalToken flag to False.

After LogRhythm is identified to Entra, the office365.ini file must be edited so the LogRhythm System Monitor Agent can access the Office 365 Management Activity API. The office365.ini file must be located on the host of the Agent collecting logs.

To edit the office365.ini file:

Open Windows Explorer on the host of the Agent collecting logs, and then go to the following directory:
C:\Program Files\LogRhythm\LogRhythm System Monitor\config.
Open the office365.ini file with a text editor and replace the following values:

Setting

Default Value

Description

O365Host

manage.office.com

(Enterprise plan)

Host name of the Management Activity API. The default value is for Enterprise customers. The table below indicates values for government plans.

Government Plan	Value
GCC government	manage-gcc.office.com
GCC high government	manage.office365.us
DoD government	manage.protection.apps.mil

AuditAzureActiveDirectory

true

Enable auditing of Azure Active Directory Management events.

AuditExchange

true

Enable auditing of Exchange Management events.

AuditSharepoint

true

Enable auditing of Sharepoint events.

DLPEvents

true

Enable for collection of DLP events. To disable DLP events, you must set this flag to FALSE.

AuditGeneral

true

Enable auditing of General events. To disable general audit events, you must set this flag to FALSE.

REST API Access Token Fields

Government and new customers must use the REST API process to generate an API access token. For the REST API process to work, you must set the UseAdalToken flag to False.

UseAdalToken

True

Set this flag to FALSE to enforce the use of the oAuth2 method.

ClientSecret

CHANGE_ME

The client secret value is generated in your Entra AD portal. For instructions on generating your client secret, see Create a Client ID and Client Secret.

This must be encrypted using the lrcrypt command line utility. For more information, see LogRhythm Password Encryption.

TenantID

CHANGE_ME

Obtain the Directory (tenant) ID from the Entra AD portal. This can be found in your App Registration > Overview screen (alternatively known as the Directory ID).

ClientID

CHANGE_ME

Obtain the Application (client) ID from the Entra AD portal. This can be found in your App Registration > Overview screen (alternatively known as the Application ID).

This must be encrypted using the lrcrypt command line utility. For more information, see LogRhythm Password Encryption.

TenantDomain

CHANGE_ME

Specify your domain in the following format:

<YOUR_DOMAIN>.onmicrosoft.com

LoginUrl

CHANGE_ME

Enter the value based on your plan. Example values:

Plan	Value
Enterprise	login.microsoftonline.com
GCC high government	login.microsoftonline.us

Remaining Azure Active Directory Application Fields

Timeout

300

The timeout (in seconds) to use when requesting data O365. Range: 10-300 seconds.

LogApiRequests

false

logAPIRequest used to enable/disable ApI Requests Logging. Add logger in Logger4Net with name Office365ApiRequestLogger to log in separate file.

MaxBatchSize

10

Throttling. Process number of audit contents per batch. Range: 10-100 (Default: 10).

StopCountFetchNewContentIds

1000

Throttling. Stop count for number of content Ids. Range: 1000-5000 (Default: 1000).

StopCountCacheFiles

50

Throttling. Stop count for controlling number of cache files read via flat file reader. Range: 25-100 (Default: 50).

NumOfBackMinutesData

15

Number of last minutes Office 365 data need to be fetched when configured to run. Range: 15-1440 minutes (Default: 15 minutes and maximum is 1 day/1440 minutes).

CollectionDelay

1

Number of minutes for collection delay as it sometimes takes one day (1440 minutes) for Office 365 content to be available on Azure. Range: 1-1440 minutes (Default: 1 minute).

(Optional) Proxy Settings

ProxyServer=

OPTIONAL

The IP address or DNS name of a proxy server to use for connecting to the specified endpoint.

ProxyPort=

OPTIONAL

The port to use on the proxy server.

UserName=

OPTIONAL

The user name to send if authentication is required on the proxy server. If the user name is an email account, be sure to include the full address.

Password=

OPTIONAL

The password for the specified user name.

The password must be encrypted using the lrcrypt command line utility. For more information, see LogRhythm Password Encryption.

Domain=

OPTIONAL

The domain to use for connecting to the proxy server.

3. Save and close the file.

(Optional) Add proxy setting

If a proxy is being used, please modify the following file:

C:\Program Files\LogRhythm\LogRhythm System Monitor\scsm.exe.config

Example before configuration

<!--For o365 to work with Proxy Server we need to enable this section-->

<!--<defaultProxy enabled="true" useDefaultCredentials="true">

	<proxy proxyaddress="Address:Port"/>

</defaultProxy>-->

Example after configuration

<!--For o365 to work with Proxy Server we need to enable this section-->

<defaultProxy enabled="true" useDefaultCredentials="true">

	<proxy proxyaddress="http://192.168.0.9:8080"/>

</defaultProxy>

Add a Log Source in the Client Console

Only Global Admins or Restricted Admins with elevated View and Manage privileges can perform this action.

(Optional) Create a Host Record for Office 365

We recommend you create a Host Record for Office365. You can use the Office365 Host Record as the Log Source Host when creating any Office 365 Log Sources throughout the SIEM.

On the main toolbar, click Deployment Manager.
Click the Entities tab, and then select the Entity to which you want to assign the Host.
In the Entity Hosts pane at the lower-right, click New.
The Host dialog box appears.

On the Basic Information tab, enter the following details:

Field	Description
Name (required)	The name to assign to the new host (for example, Office365). LogRhythm does not support hostnames that include spaces.
Host Zone (required)	Internal.
Operating System	The operating system of the new host. Click the ellipsis [...] button next to the Operating System box. In the Operating System Selector window, click your operating system in the list, and then click OK.
Operating System Version	The version of the selected operating system that is running on the new host.
Host Location	The geographic location of the new host. Click the ellipsis [...] button next to the Host Location box. In the Location Selector window, select the country, region, and city where the host is located.
Brief Description	An optional description of the new host.
Host Risk Level (required)	Represents the amount of risk developed if the system were to become compromised or the subject of some other issue. A value of 0 indicates that no risk is involved in the loss of this system. A value of 9 indicates the most risk would be incurred if the system were compromised. The risk level is relevant when the host is the impacted system, target, or is acted upon by external forces.
Windows Event Log Credentials	When the operating system is Windows, if you want the Agent to use different credentials for each host in the deployment when collecting Event Logs, select the Use specified credentials check box and provide the username and password to be used. If you do not select this option, the Agent uses its own service credentials. Multi-domain event log collection is only supported on Windows Vista, 7, 8, 2008, or 2012. Windows XP, 2000, and 2003 are not supported.

On the Identifiers tab, enter manage.office.com in the DNS Name field.
On the Host Roles tab, enter any relevant key contacts.
On the Threat Level tab, designate the amount of threat that is developed if the system were to be the origin of actions. Select the Add to Global Source Threat List check box if there is any treat level other than 0 (none/no risk). A value of 1 (low-low (lowest threat)) means that actions originating from this host are of little cause for alarm or are possibly commonplace, and a value of 9 (high-high (highest threat)) means that this system should not be the source of outgoing actions and that there is the greatest threat to security if such events are observed.
On the Additional Information tab, add any other useful information.
Click OK.

Add a Single Log Source

On the main toolbar, click Deployment Manager.
Click the System Monitors tab.
Double-click the System Monitor Agent that will collect the information from the Office 365 Management Activity API.
Right-click within the list of Log Message Sources, and then click New.
The Log Message Source Properties dialog box appears.
Click the icon to the right of the Log Source Host box. Assign this to be the Office365 Host created previously, then click OK.
Click the icon to the right of the Log Message Source Type box.
The Log Source Type Selector dialog box appears.
Select the Log Source type:
1. In the Record Type section on the left side, click System.
2. In the Text Filter text box, enter Office 365.
3. Click Apply.
4. In the Log Source Type section, select API - Office 365 Management Activity.
5. Click OK.
In the Log Message Processing Settings section, select the desired Log Message Processing Mode and Log MPE Policy. This can be the LogRhythm Default policy or a custom policy you create.
Click the Flat File Settings tab.
In the File Path box, enter the location of the office365.ini configuration file.
This defaults to C:\Program Files\LogRhythm\LogRhythm System Monitor\config\office365.ini.
Click OK to accept the settings.
The Log Message Source Properties box appears.

If the System Monitor Agent is already running, collection begins soon after clicking OK or Apply.

Monitor the scsm.log file for error messages until you are satisfied that the event collection has begun successfully.
Click OK

Recommendations

Create a Host Record for Office 365

We recommend you create a Host Record for Office365. You can use the Office365 Host Record as the Log Source Host when creating any Office 365 Log Sources throughout the SIEM. For more information, see Add a Log Source in the Client Console.

Create a Separate Log Source for each Office 365 Event Stream

The Office 365 Management Activity Log Source consists of multiple Event streams from within the Office 365 environment. We recommend you split these streams into separate Log Sources. This enables ease of analytics and increases Log Source throughput efficiency.

To create separate Log Sources, do the following:

Create a different office365.ini configuration file for each Events stream within Office 365. In each configuration file select one of the Events streams to be true, and all other Events streams to be false. The possible Events streams you can enable are:
- AuditAzureActiveDirectory
- AuditExchange
- AuditSharepoint
- DLPEvents
- AuditGeneral
Name each office365.ini configuration file to correspond to the Events stream you selected to be true in that file.
Example
Events stream: AuditAzureActiveDirectory
Configuration file name: Office365AuditAzureAD.ini
Configuration file settings:
- AuditAzureActiveDirectory=true
- AuditExchange=false
- AuditSharepoint=false
- DLPEvents=false
- AuditGeneral=false
Repeat this process for all of the remaining Event streams you wish to enable.
Within the LogRhythm Console, repeat the Add a Log Source in the Client Console steps within this guide to add each Events stream as a separate Log Source. Use a Log Message Source Name that is similar to the name of the Events stream.

Example
Events stream: AuditAzureActiveDirectory
Log Message Source Name: Office365 Mgmt Activity Azure AD
In the Flat File Settings tab, enter the location of the configuration file that corresponds to the Events stream.

Example
Events stream: AuditAzureActiveDirectory
File path: C:\Program Files\LogRhythm\LogRhythm System Monitor\config\Office365AuditAzureAD.ini

The Log Source type for all of the Events streams will still be API - Office 365 Management Activity