About the Device
Office 365 is a subscription service that combines several traditional Microsoft applications like MS Office, Powerpoint, Excel with some new ones, all of which are enabled over the cloud.
Device Information
Entity | Particulars |
---|---|
Vendor Name | Microsoft |
Product Name | Office 365 |
Type of Device | Cloud |
Collection Method
Log Type | Ingestion label | Preferred Logging Protocol | Log collection method |
---|---|---|---|
Office 365 | OFFICE_365 | API Pull JSON | C2C |
Port Requirements
Source | Destination | Port |
---|---|---|
CyberHub | Microsoft Office 365 API | 443 (TCP) |
Device Configuration
Enable Auditing in Office 365:
Login to the Microsoft Purview compliance portal at https://compliance.microsoft.com with Admin or Similar Access Privileges.
Navigate to Solutions > Audit. If the auditing isn't turned on for your organization, a banner is displayed prompting you Start recording user and admin activity.
Select the Start recording user and admin activity banner to enable Audit Logs.
Note - It may take up to 60 minutes for the change to take effect.
App registration and Generate Secret Key for Integration
Login to the Azure management portal.
Select Azure Active Directory.
Click App registrations.
Click on New registrations. Create an application as shown below
Now new registered app will get displayed under App Registration
Click on Add a permission and then provide permissions to API. (Refer below screenshot for API permissions).
Select Certificates & secrets section, click New Client Secret then provide a description and specify the validity duration in the pop-up window.
Click Add. Newly added Client secret details will be displayed as below
Copy the Secret Value displayed and not the Secret ID,
Note: Secret Value will be displayed only at the time of creation and this will be required for Adaptive MxDR integration.
To find your Microsoft 365 tenant ID in the Azure AD admin center. Your tenant ID can be found in the Directory ID box on the Properties page.
To find your Microsoft 365 Client ID (Application ID) in the Azure AD admin center
Select Azure Active Directory.
From App registrations in Azure AD, select your application.
Copy the Client ID (Application ID)
Integration Parameters
Parameters required from customer for Integration.
Property | Default Value | Description |
---|---|---|
OAuth Client ID | Custom Value | OAuth Client ID value obtained from step11 in above configuration. |
OAuth Client Secret | Custom Value | OAuth Client Secret value obtained from step9 in above configuration. |
Tenant ID | Custom Value | Tenant ID value obtained from step10 in above configuration. |