splunk
Microsoft Azure 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
This add-on collects data from Microsoft Azure including the following:
* Azure AD Data
- Users - Azure AD user data
- Sign-ins - Azure AD sign-ins including conditional access policies and MFA
- Directory audits - Azure AD directory changes including old and new values
- Devices - Registered devices in Azure AD
- Risk Detections
* Metrics
* Estimated billing and consumption
* Inventory metadata
- Resource Groups - Resource group configuration
- Virtual Machines - VM, Disk, Image, and Snapshot configurations
- Virtual Networks - VNET, NSG, and Public IP configurations
- Managed Disks
- Subscriptions - Subscription name, ID, and type
- Topology - IaaS relationships
* Azure Security Center
- Alerts
- Tasks
* Azure Resource Graph
Version 3.0.0 and later of the Microsoft Azure Add-on for Splunk is compatible only with Splunk Enterprise version 8.0.0 and above.
* Azure AD Data
- Users - Azure AD user data
- Sign-ins - Azure AD sign-ins including conditional access policies and MFA
- Directory audits - Azure AD directory changes including old and new values
- Devices - Registered devices in Azure AD
- Risk Detections
* Metrics
* Estimated billing and consumption
* Inventory metadata
- Resource Groups - Resource group configuration
- Virtual Machines - VM, Disk, Image, and Snapshot configurations
- Virtual Networks - VNET, NSG, and Public IP configurations
- Managed Disks
- Subscriptions - Subscription name, ID, and type
- Topology - IaaS relationships
* Azure Security Center
- Alerts
- Tasks
* Azure Resource Graph
Version 3.0.0 and later of the Microsoft Azure Add-on for Splunk is compatible only with Splunk Enterprise version 8.0.0 and above.
Microsoft Azure Add-on for Splunk
This add-on collects data from Microsoft Azure including the following:
- Azure AD Data
- Users - Azure AD user data
- Groups - Azure AD groups
- Sign-ins - Azure AD sign-ins including conditional access policies and MFA
- Directory audits - Azure AD directory changes including old and new values
- Devices - Registered devices in Azure AD
- Risk Detections
- Event Hubs (deprecated) - generic Event Hub collector
- Metrics
- Estimated billing and consumption
- Inventory metadata
- Resource Groups - Resource group configuration
- Virtual Machines - VM, Disk, Image, and Snapshot configurations
- Virtual Networks - VNET, NSG, and Public IP configurations
- Managed Disks
- Subscriptions - Subscription name, ID, and type
- Topology - IaaS relationships
- Azure Security Center
- Alerts
- Tasks
- Azure Resource Graph
This add-on contains the following alert actions:
- Stop Azure VM - stops an Azure Virtual Machine.
- Add member to group - adds a user to a group. This can be useful if you need to enable additional policies like MFA based on search results.
- Dismiss Azure Alert - dismisses an Azure Security Center alert.
About
- Version: 3.2.0
- Vendor Products:
- Microsoft Azure Active Directory Sign-ins, Audit, and Users
- Microsoft Azure Consumption API
- Microsoft Azure Virtual Machine API, Disks API, Network Watcher API
- Splunk platform versions: 8.0.0 and later
- Platforms: Platform independent
- Visible: Yes, this add-on contains configuration
Prerequisites
- An active Azure Subscription
- For Azure Active Directory Sign-in data, an Azure Active Directory Premium P1 or P2 edition
- An Azure Active Directory Application Registration
Required APIs and Permissions
Azure/O365 Add-on Required Permissions
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. |
Upgrading
Upgrades of the same major version are supported. For example, upgrading from version 2.0.0 to 2.1.0 will work. However, upgrading from version 2.x to 3.x will not work and will cause errors.
Configuration
Ensure the prerequisites are met above.
- Most inputs require an Azure AD application registration. Refer to the in-app documentation for details on setting this up.
CIM Compliance
Version 4.13.0
- Authentication model
- Azure AD sign-in events
- Inventory model
- Azure AD user events
- User model
- Azure AD user events
Troubleshooting
- Refer to the Troubleshooting menu in the add-on.
Privacy
Use of this add-on is permitted subject to your obligations, including data privacy obligations, under your agreement with Splunk and Splunk's Privacy Policy.
Contributors
- Jason Conger
- Ryan Lait
- Johnny Blizzard
Third-party software attributions
Refer to the README.md file included in this package for details.
Release Notes
Version 3.2.0
Sept. 2, 2021
- New input to collect Azure Active Directory Groups
- New alert action to stop an Azure Virtual Machine
- New alert action to add a user to a group
- New alert action to dismiss an Azure Security Center alert
- jQuery updates
Version 3.1.1
March 3, 2021
- Added API version selection for REST inputs
- Removed restart requirements after install
- Updated billing and consumption input
- Improved compatibility with the Splunk Add-on for Microsoft Cloud Services
Version 3.1.0
Jan. 28, 2021
- Event Hub input deprecated. Please use the Splunk Add-on for Microsoft Cloud Services https://splunkbase.splunk.com/app/3110/
- New input - Microsoft Azure Active Directory Devices
- New input - Microsoft Azure Active Directory Risk Detections
- Fixed an issue where Azure Active Directory sign-in events were truncated
Version 3.0.1
June 27, 2020
Added support for Azure Gov
Version 2.1.1
June 27, 2020
Added support for Azure Gov
Version 3.0.0
May 27, 2020
- Updated to Splunk 8 / Python 3
- Updated the Event Hub Python library to use asyncio
- Event Hub input support for Windows