icon/x Created with Sketch.

Splunk Cookie Policy

We use our own and third-party cookies to provide you with a great online experience. We also use these cookies to improve our products and services, support our marketing campaigns, and advertise to you on our website and other websites. Some cookies may continue to collect information after you have left our website. Learn more (including how to update your settings) here.
Accept Cookie Policy

We are working on something new...

A Fresh New Splunkbase
We are designing a New Splunkbase to improve search and discoverability of apps. Check out our new and improved features like Categories and Collections. New Splunkbase is currently in preview mode, as it is under active development. We welcome you to navigate New Splunkbase and give us feedback.

Accept License Agreements

This app is provided by a third party and your right to use the app is in accordance with the license provided by that third-party licensor. Splunk is not responsible for any third-party apps and does not provide any warranty or support. If you have any questions, complaints or claims with respect to this app, please contact the licensor directly.

Thank You

Downloading Microsoft 365 Defender Add-on for Splunk
SHA256 checksum (microsoft-365-defender-add-on-for-splunk_130.tgz) 9b87bade3f27e985e90b39de0a9cb023930a3bdbc9658134e050120b70c34684 SHA256 checksum (microsoft-365-defender-add-on-for-splunk_122.tgz) 2abb9aa6b124164b848234992ca0be599d8ca8e64786f97b609eabcd3c05d6be SHA256 checksum (microsoft-365-defender-add-on-for-splunk_121.tgz) 25267ca0f25d44ba58304fdbe5d4b51215e9f3502919ef35f342e7d59ec4a6a0 SHA256 checksum (microsoft-365-defender-add-on-for-splunk_111.tgz) 71070dc619a1df378b352e5c00ebf1bda3a116fa94b549e4e55f777a08d96d73
To install your download
For instructions specific to your download, click the Details tab after closing this window.

Flag As Inappropriate

splunk

Microsoft 365 Defender Add-on for Splunk

Splunk Cloud
Splunk Labs
This app is NOT supported by Splunk. Please read about what that means for you here.
Overview
Details
The Microsoft 365 Defender Add-on for Splunk collects incidents and related information from Microsoft 365 Defender and/or alerts from Microsoft Defender for Endpoint.

Microsoft 365 Defender Incidents
* Incident (impossible travel, activity from Tor IP, suspicious inbox forwarding, successful logon using potentially stolen credentials, etc.)
* Assignee
* Classification
* Severity
* Status
* Alerts associated with the Incident

Microsoft Defender for Endpoint Alerts
* Categories (Malware, Initial Access, Execution, etc.)
* Detection source
* Evidence
* Computer name
* Related user
* Severity
* Status

Microsoft 365 Defender Add-on for Splunk

The Microsoft 365 Defender Add-on for Splunk collects incidents and related information from Microsoft 365 Defender and/or alerts from Microsoft Defender for Endpoint.

  • Microsoft 365 Defender Incidents

    • Incident (impossible travel, activity from Tor IP, suspicious inbox forwarding, successful logon using potentially stolen credentials, etc.)
    • Assignee
    • Classification
    • Severity
    • Status
    • Alerts associated with the Incident
  • Microsoft Defender for Endpoint Alerts

    • Categories (Malware, Initial Access, Execution, etc.)
    • Detection source
    • Evidence
    • Computer name
    • Related user
    • Severity
    • Status

About

  • Version: 1.3.0
  • Vendor Products:
    • Microsoft 365 Defender
    • Microsoft Defender for Endpoint
  • Splunk platform versions: 7.2 and later
  • Platforms: Platform independent
  • Visible: Yes, this add-on contains configuration

Prerequisites

  • An Azure Active Directory application registration

Refer to the following article for details on setting up an Azure Active Directory application registration with the appropriate permissions for Microsoft Defender for Endpoint:
https://docs.microsoft.com/en-us/windows/security/threat-protection/microsoft-defender-atp/api-hello-world

Refer to the following article for details on setting up an Azure Active Directory application registration with the appropriate permissions for Microsoft 365 Defender Incidents:
https://docs.microsoft.com/en-us/microsoft-365/security/defender/api-hello-world?view=o365-worldwide

Splunk Common Information Model (CIM)

Installing

Where to install this add-on

Unless otherwise noted, all supported add-ons can be safely installed to all tiers of a distributed Splunk platform deployment. See Where to install Splunk add-ons in Splunk Add-ons for more information.

This table provides a reference for installing this specific add-on to a distributed deployment of Splunk Enterprise.

Splunk platform component Supported Required Comments
Search Heads Yes Yes This add-on contains search-time knowledge. It is recommended to turn visibility off on your search heads to prevent data duplication errors that can result from running inputs on your search heads instead of (or in addition to) on your data collection node.
Heavy Forwarders Yes No (but recommended) It is recommended to install this add-on on a heavy forwarder for data collection. Data collection should be configured in only 1 place to avoid duplicates.
Indexers Yes No Not required as the parsing operations occur on the forwarders.
Universal Forwarders No No Universal forwarders are not supported for data collection because the modular inputs require Python and the Splunk REST handler.

FAQ

SSL certificate issue

If you encounter a SSL: CERTIFICATE_VERIFY_FAILED issue, the SSL certificate entry might be missing from your certificate store. Resolve the issue by adding the certificate to your add-on's trust list.

The add-on uses the Python requests library to make REST calls to Microsoft. Requests will throw this SSL error if it's unable to verify the certificate.
Reference => https://docs.python-requests.org/en/master/user/advanced/#ssl-cert-verification

  • Navigate to /opt/splunk/etc/apps/TA-MS_Defender/bin/ta_ms_defender/aob_py3/certifi
  • Edit cacert.pem
  • Paste the contents of your root certificate in the file
  • Restart Splunk

Working with multivalue fields

The Microsoft 365 Defender data is returned as JSON. The JSON data will have multivalued fields that you may want to break up into individual events at search time.

For example, if we want to turn each evidence object in an incident into an individual event to identify parent/child process, the following search can be used:

sourcetype="ms:defender:atp:alerts" id="SOME ALERT ID" | spath path=evidence{} output=evidence | mvexpand evidence | eval _raw=evidence | extract | search processId!=null | rename id AS alertId | table alertId, processId, processCreationTime, processCommandLine, parentProcessId, parentProcessCreationTime, parentProcessFileName

Explanation
The search uses the spath command to target the evidence array in the JSON data. Then, it uses the mvexpand command to turn each evidence record in the array into an individual event in the search. Next, we use a combination of manipulating the _raw field and extracting the values using the extract command. Finally, we print the results as a table. This shows us the alert ID, process details, and parent details.

CIM Compliance

Version 4.13.0

  • Alert model
  • Incident model

Third-party software attributions

https://docs.splunk.com/Documentation/AddonBuilder/3.0.1/UserGuide/Thirdpartysoftwarecredits

Release Notes

Version 1.3.0
May 21, 2021

Alert actions introduced:
Advanced Hunting alert action runs advanced hunting queries on entities to ingest additional detail
Incident Update alert action updates the Microsoft 365 Defender portal from a Splunk search

Version 1.2.2
April 16, 2021

Minor update for Splunk Cloud

Version 1.2.1
Nov. 18, 2020
  • Added links back to the Microsoft 365 Security portal from the Incident Queue and Incident Detail dashboards
  • Fixed a proxy authentication issue
Version 1.1.1
May 5, 2020
2,295
Installs
3,328
Downloads
Share Subscribe LOGIN TO DOWNLOAD

Subscribe Share

Are you a developer?

As a Splunkbase app developer, you will have access to all Splunk development resources and receive a 10GB license to build an app that will help solve use cases for customers all over the world. Splunkbase has 1000+ apps from Splunk, our partners and our community. Find an app for most any data source and user need, or simply create your own with help from our developer portal.

Follow Us:
Splunk, Splunk>,Turn Data Into Doing, Data-to-Everything, and D2E are trademarks or registered trademarks of Splunk Inc. in the United States and other countries. All other brand names,product names,or trademarks belong to their respective owners.