Skip to main content

Microsoft Office 365 Input

Microsoft Office 365 is a widely used cloud-based suite of productivity tools. This plugin allows you to pull your organization’s Office 365 logs into Graylog for processing, monitoring, and alarming.

Note

This is a Graylog Enterprise Integrations feature and is only available since Graylog version 3.3.3. A valid Graylog Enterprise license is required.

Required Office 365 Setup​

Prerequisites​

In order to use the Office 365 plugin, you will need to create and authorize a Client Application through your organization’s Microsoft Azure portal.

It is assumed that you already have a working Office 365 subscription and access to the Microsoft Azure portal for your organization. It is also assumed you have the correct account type which allows access to the audit logs. Generally this is an E5/A5 account.

The following steps are mandatory.

Azure Configuration​

  1. Log in to Microsoft Azure

  2. Navigate to Azure Active Directory in the left-hand menu

  3. Select App Registrations under the Manage heading in the left-hand menu

  4. Select New Registration in the top of the right-hand pane

  5. Register a new application

  6. Once the application has been created, take note of the following fields, which will be needed to set up the O365 plugin:

  7. For the newly-created Application, navigate to Certificates & Secrets

  8. Click on New Client Secret

  9. Add a description for the new secret, select an expiration time, and then click Add

  10. Make a note of the generated value, you will need this to set up the O365 Plugin

Client Application Permissions in O365​

  1. For the newly-created Application, navigate to API permissions
  2. Click on Add a permission
  3. Select Office 365 Management APIs
  4. Select Application Permissions
  5. Select all available permissions on the list and click Add permissions
  6. Click on Grant admin consent for... and confirm by clicking Yes in the popup dialog

Enable Unified Audit Logging​

Navigate to the Audit Log Search page in Microsoft Office 365 and enable Unified Audit Logging. If this is the first time enabling Unified Audit Log, it can take up to 24 hours before logs start coming into Graylog.

Plugin Configuration​

Note

You will need the Client ID, Tenant ID, and Client Secret from the previous sections in order to proceed.

  • Input Name

  • Directory (tenant) ID

  • Application (client) ID

  • Client Secret

  • Subscription Type

O365 Content Subscription​

  • Log Types To Collect

  • Polling Interval

  • Drop DLP logs containing sensitive data

  • Enable Throttling

  • Store Full Message